JAX-RS 代表RESTful Web服务的JAVA API. JAX-RS是一种基于JAVA的编程语言API和规范,用于为创建的RESTful Web服务提供支持.它的2.0版本于2013年5月24日发布.JAX-RS使用Java SE 5提供的注释来简化基于JAVA的Web服务创建和部署的开发.它还为为RESTful Web服务创建客户端提供支持.
规范
以下是将资源映射为Web服务的最常用注释资源.
Sr.No. | 注释&描述 |
---|---|
1 | @Path 资源类/方法的相对路径. |
2 | @GET HTTP获取请求,用于获取资源. |
3 | @PUT HTTP PUT请求,用于创建资源. |
4 | @POST HTTP POST请求,用于创建/更新资源. |
5 | @DELETE HTTP DELETE请求,用于删除资源. |
6 | @HEAD HTTP HEAD请求,用于获取方法可用性的状态. |
7 | @Produces 说明Web服务生成的HTTP响应.例如,APPLICATION/XML,TEXT/HTML,APPLICATION/JSON等. |
8 | @Consumes 说明HTTP请求类型.例如,application/x-www-formurlencoded用于在POST请求期间接受HTTP正文中的表单数据. |
9 | @PathParam 将传递给方法的参数绑定到路径中的值. |
10 | @QueryParam 将传递给method的参数绑定到路径中的查询参数. |
11 | @MatrixParam 将传递给方法的参数绑定到路径中的HTTP矩阵参数. |
12 | @HeaderParam 绑定参数传递给H的方法TTP标题. |
13 | @CookieParam 绑定传递给方法的参数. |
14 | @FormParam 将传递给方法的参数绑定到表单值. |
15 | @DefaultValue 为传递给方法的参数指定默认值. |
16 | @Context 资源的上下文.例如,HTTPRequest作为上下文. |
注意 : 我们在 RESTful Web Services - First Application 和 RESTful Web Services - Methods 章节.