JavaEE的RESTful标准技术JAX-RS，jersey-client客户端使用介绍【享学Java】(上)

前言

在Spring大行其道的今天，很多人对Java的RESTful规范JAX-RS可能比较陌生甚至未曾听闻，当然这也是能被“理解”的，毕竟Spring似乎现在已是JavaEE的事实标准。

现在有越来越多的公司希望能以简单而又贴合Web架构本身的方式公开Web API，因此REST变得越来越重要和流行。使用Ajax进行通信的富浏览器端也在朝这个目标不断迈进。这个架构原则提升了万维网的可伸缩性，无论何种应用都能从该原则中受益无穷。

正文

其实关于JAX-RS的资料并不算多，根据存在即合理原则我们需要承认它的重要性肯定比不上Spring，但是由于老外一般喜欢使用JavaEE规范技术，所以使得一些开源社区框架使用的均是基于JAX-RS的实现，因此对它来个简单的了解还是很有必要的。

何为JAX-RS（1.0和2.0）

JAX-RS是JAVA EE6引入的一个新技术，它的英文全称为Java API for RESTful Web Services，它的核心概念是Resource，即面向资源。JavaEE 6于2019年12月份正式发布。

JSR 311

它被称为JAX-RS 1.0标准，它提供一套JSR311标准API：

<dependency>
    <groupId>javax.ws.rs</groupId>
    <artifactId>jsr311-api</artifactId>
    <version>1.1.1</version>
</dependency>

这些注解和Spring MVC的@RequestMapping、@RequestParam、@PathVariable...何其相似，各位可以类比起来学习，本处不必一一展开。但是注意一点，SpringMVC在开发REST应用时，是不支持JSR311标准的。

JSR 339

它是JAX-RS 2.0版本，于2018年发布。它不仅定义了一套用于构建 RESTful 网络服务的 API，同时也通过增强客户端 API 功能简化了REST 客户端的构建过程。

<dependency>
    <groupId>jakarta.ws.rs</groupId>
    <artifactId>jakarta.ws.rs-api</artifactId>
    <version>2.1.6</version>
</dependency>

规范API的向下兼容度还是非常好的，它在1.0规范的基础上对Client的构建做了增强，如提供了javax.ws.rs.client.ClientBuilder、javax.ws.rs.client.WebTarget等实用API。

落地产品

每个JavaEE规范都应对应其落地产品的实现，就像JPA的实现落地实现有Hibernate、TopLink等。基于JAX-RS实现的框架有Jersey、RESTEasy，当然还有Apache CXF。但是，因为Jersey是最早的实现（出现得比JSR311还早），是JSR311参考的主要对象，所以，可以说Jersey就是事实上的标准，就像Hibernate是JPA的事实标准一样~

值得一提的是：RESTEasy是由JBoss公司开发的，所以将用RESTEasy框架实现的应用部署到JBoss服务器上，可以实现很多额外的功能（但很显然，JBoss已经退出了历史舞台）。

Jersey

Jersey是一个REST框架，既然是REST框架，那自然提供了REST服务相关的一切东西。因此在使用过程中，你可以同Spring MVC做对比，部署到Servlet容器上即可运行，形如这样：

@Path("/api/v1/user")
public class UserResource{
    @GET
    @Path("/{username}")
    @Consumes({"application/json", "application/xml"})
    @Produces("application/json")
    public String getUser(@PathParam("username") String username){
        ...
    }
}

作为服务端，它使用的库是：

1.x：
<dependency>
    <groupId>com.sun.jersey</groupId>
    <artifactId>jersey-servlet</artifactId>
    <version>1.19.4</version>
</dependency>
2.x：
<dependency>
    <groupId>org.glassfish.jersey.containers</groupId>
    <artifactId>jersey-container-servlet</artifactId>
    <version>2.30.1</version>
</dependency>