RESTful Web 服务 - Java (JAX-RS)


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 服务资源的最常用注释。

先生。 注释和描述

1

@小路

资源类/方法的相对路径。

2

@得到

HTTP Get请求,用于获取资源。

3

@放

HTTP PUT 请求,用于更新资源。

4

@邮政

HTTP POST 请求,用于创建新资源。

5

@删除

HTTP DELETE 请求,用于删除资源。

6

@头

HTTP HEAD 请求,用于获取方法可用性的状态。

7

@产品

说明 Web 服务生成的 HTTP 响应。例如,应用程序/XML、文本/HTML、应用程序/JSON 等。

8

@消耗

说明 HTTP 请求类型。例如,application/x-www-formurlencoded 用于在 POST 请求期间接受 HTTP 正文中的表单数据。

9

@路径参数

将传递给方法的参数绑定到路径中的值。

10

@查询参数

将传递给方法的参数绑定到路径中的查询参数。

11

@MatrixParam

将传递给方法的参数绑定到路径中的 HTTP 矩阵参数。

12

@HeaderParam

将传递给方法的参数绑定到 HTTP 标头。

13

@CookieParam

将传递给该方法的参数绑定到 Cookie。

14

@FormParam

将传递给该方法的参数绑定到表单值。

15

@默认值

为传递给该方法的参数分配默认值。

16

@语境

资源的上下文。例如,HTTPRequest 作为上下文。

注- 我们在RESTful Web 服务 - 第一个应用程序RESTful Web 服务 - 方法章节中使用了 Jersey,它是 Oracle 的 JAX-RS 2.0 的参考实现。