概述

Jersey RESTful 框架是開源的RESTful框架, 實(shí)現(xiàn)了JAX-RS (JSR 311 & JSR 339) 規(guī)范。它擴(kuò)展了JAX-RS 參考實(shí)現(xiàn)， 提供了更多的特性和工具， 可以進(jìn)一步地簡(jiǎn)化 RESTful service 和 client 開發(fā)。盡管相對(duì)年輕，它已經(jīng)是一個(gè)產(chǎn)品級(jí)的 RESTful service 和 client 框架。與Struts類似，它同樣可以和hibernate,spring框架整合。

成都創(chuàng)新互聯(lián)專注于企業(yè)成都全網(wǎng)營(yíng)銷推廣、網(wǎng)站重做改版、余杭網(wǎng)站定制設(shè)計(jì)、自適應(yīng)品牌網(wǎng)站建設(shè)、H5技術(shù)、商城建設(shè)、集團(tuán)公司官網(wǎng)建設(shè)、外貿(mào)營(yíng)銷網(wǎng)站建設(shè)、高端網(wǎng)站制作、響應(yīng)式網(wǎng)頁(yè)設(shè)計(jì)等建站業(yè)務(wù)，價(jià)格優(yōu)惠性價(jià)比高，為余杭等各大城市提供網(wǎng)站開發(fā)制作服務(wù)。

jersey1.X使用的是sun的com.sun.jersey

jersey2.X使用的是glassfish的org.glassfish.jersey

Jersey與JAX-RS的關(guān)系：

Jersey是一個(gè)框架，實(shí)現(xiàn)了restful風(fēng)格；JAX-RS也實(shí)現(xiàn)了restful風(fēng)格。那么Jersey與JAX-RS是什么關(guān)系呢？我們可以這樣理解：JAX-RS是java自己的一個(gè)小的框架，實(shí)現(xiàn)了restful風(fēng)格，只不過功能不是很強(qiáng)大；而Jersey呢，它是一個(gè)比較成熟的restful框架了，它在設(shè)計(jì)的時(shí)候，是基于JAX-RS的，它使用了java的JAX-RS的一些注解，當(dāng)然了，他也有自己的特有注解，以及其他更強(qiáng)大的功能。

如果你更喜歡REST端點(diǎn)的JAX-RS編程模型，則可以使用可用的實(shí)現(xiàn)之一，而不是Spring MVC。Jersey和Apache CXF開箱即用就可以很好地工作。CXF要求你在應(yīng)用程序上下文中將其Servlet或過濾器注冊(cè)為@Bean。Jersey原生支持Spring，所以我們?cè)赟pring Boot中也為它提供了自動(dòng)配置支持，還有一個(gè)starter。

要開始使用Jersey，需要把spring-boot-starter-jersey作為依賴，然后需要一個(gè)ResourceConfig類型的@Bean，用來注冊(cè)所有端點(diǎn)，如下面的例子所示:

示例：?

@Component
public class MyJerseyConfig extends ResourceConfig {
  public MyJerseyConfig() {
    register(MyEndpoint.class);
  }
}

Jersey對(duì)掃描可執(zhí)行檔案的支持相當(dāng)有限。例如，當(dāng)運(yùn)行一個(gè)可執(zhí)行的war文件時(shí)，它不能掃描在完全可執(zhí)行的jar文件或WEB-INF/classes中找到的包中的端點(diǎn)。為了避免這種限制，不應(yīng)該使用packages方法，而應(yīng)該使用register方法單獨(dú)注冊(cè)端點(diǎn)，如上例所示。

對(duì)于更高級(jí)的定制，你還可以注冊(cè)任意數(shù)量實(shí)現(xiàn)了ResourceConfigCustomizer的bean。所有注冊(cè)的Endpoint都應(yīng)該是帶有HTTP資源注解的@Components (@GET等)，如下面的例子所示:?

@Component
@Path("/hello")
public class MyEndpoint {
  @GET
  public String message() {
    return "Hello";
  }
}

JAX-RS注解

一、@Path

一個(gè)Java類要能夠處理REST請(qǐng)求，則這個(gè)類必須至少添加一個(gè)@Path("/")的注解；對(duì)于方法，這個(gè)注解是可選的，如果不添加，則繼承類的定義。

@Path里的值可以是一個(gè)復(fù)雜的表達(dá)式，例如@Path("/{id}") ，其中 {id}表達(dá)式表示一個(gè)路徑請(qǐng)求的一部分。

@Path也支持正則表達(dá)式，例如： @Path("{id: \\d+}") ，其中 \\d+ 表示一個(gè)數(shù)字。

二、@Method

一個(gè)方法上只有添加了某個(gè)Http Method的注解，例如@GET，才會(huì)生效。

對(duì)于資源的具體操作類型，由HTTP動(dòng)詞表示。

常用的HTTP動(dòng)詞有下面五個(gè)：

GET（SELECT）：從服務(wù)器取出資源（一項(xiàng)或多項(xiàng)）

POST（CREATE）：在服務(wù)器新建一個(gè)資源

PUT（UPDATE）：在服務(wù)器更新資源（客戶端提供改變后的完整資源）

PATCH（UPDATE）：在服務(wù)器更新資源（客戶端提供改變的屬性）

DELETE（DELETE）：從服務(wù)器刪除資源

還有兩個(gè)不常用的Method。

HEAD：獲取資源的元數(shù)據(jù)

OPTIONS：一般由瀏覽器自動(dòng)發(fā)起，用于描述目標(biāo)資源的通信選項(xiàng)。

下面是一些例子：

GET /uses：列出所有用戶

POST /users：新建用戶

GET /users/ID：獲取指定id用戶的信息

PUT /users/ID：更新指定id用戶的信息

PATCH /users/ID：更新指定id用戶的信息

DELETE /users/ID：刪除指定id用戶

GET /users/ID/addresses：列出指定id用戶的所有住址信息

DELETE /users/ID/addresses/ID：刪除指定id用戶下的指定地址id信息

三：Accept和Content-Type的區(qū)別

Accept就表示接口要返回給客戶端的數(shù)據(jù)格式，

Content-Type表示客戶端發(fā)送給服務(wù)器端的數(shù)據(jù)格式。

四：@Produces

定義資源類或javax.ws.rs.ext.MessageBodyWriter的方法可以生成的媒體類型。如果沒有指定，那么容器將假定可以生成任何類型。方法級(jí)注釋覆蓋類級(jí)注釋。容器負(fù)責(zé)確保調(diào)用的方法能夠生成HTTP請(qǐng)求中請(qǐng)求的一種媒體類型。如果沒有這樣的方法可用，容器必須以RFC 2616指定的HTTP“406 Not accepted”作為響應(yīng)。

有幾種格式如下：

@Produces("text/plain") 文本類型

@Produces("text/html") Html類型

@Produces({"application/xml"}) Xml類型

@Produces({ "application/json"}) Json類型

可以一次注解兩種或多種的MIME類型，格式如：{"application/xml", "application/json"}這表示兩者都可以使用，但是選擇的時(shí)候一般會(huì)選擇前者，即application/xml,因?yàn)樗谝淮纬霈F(xiàn)。

五：@Consumes

定義資源類或javax.ws.rs.ext.MessageBodyReader的方法可以接受的媒體類型。如果沒有指定，容器將假定任何媒體類型都是可接受的。方法級(jí)注釋覆蓋類級(jí)注釋。容器負(fù)責(zé)確保所調(diào)用的方法能夠使用HTTP請(qǐng)求實(shí)體的媒體類型。如果沒有這樣的方法可用，容器必須按照RFC 2616的規(guī)定，以HTTP“415 Unsupported Media Type”作為響應(yīng)。

六：@QueryParam與@PathParam區(qū)別

@QueryParam：指定的是URL中的參數(shù)是以鍵值對(duì)的形式出現(xiàn)的,而在程序中

@QueryParam("id") Integer id獲取請(qǐng)求參數(shù)id

如：URL輸入為:/api/users?id=1

@PathParam：參數(shù)作為路徑的一部分

如：/api/users/1

Jersey詳細(xì)配置

在SpringBoot中引入如下依賴?

  org.springframework.boot
  spring-boot-starter-jersey

引入上面的依賴后，接下來我們只需要定義繼承ResourceConfig類型的Bean即可。Jersey的自動(dòng)配置其中有一個(gè)條件就是當(dāng)前的CLASSPATH中有ResourceConfig類型的Bean才生效，如下：?

@Configuration(proxyBeanMethods = false)
@ConditionalOnBean(type = "org.glassfish.jersey.server.ResourceConfig")
@EnableConfigurationProperties(JerseyProperties.class)
public class JerseyAutoConfiguration implements ServletContextAware {
}

其中@ConditionalOnBean條件限制了只有當(dāng)前容器中有ResourceConfig類型的Bean該自動(dòng)配置才會(huì)生效。

注冊(cè)繼承ResourceConfig后請(qǐng)求又是如何被匹配的？

當(dāng)上面的自動(dòng)配置生效后，默認(rèn)情況下會(huì)注冊(cè)一個(gè)Servlet：?

public class JerseyAutoConfiguration implements ServletContextAware {
  @Bean
  @ConditionalOnMissingBean
  public JerseyApplicationPath jerseyApplicationPath() {
    return new DefaultJerseyApplicationPath(this.jersey.getApplicationPath(), this.config);
  }
  @Bean
  @ConditionalOnMissingBean(name = "jerseyFilterRegistration")
  @ConditionalOnProperty(prefix = "spring.jersey", name = "type", havingValue = "filter")
  public FilterRegistrationBean jerseyFilterRegistration(JerseyApplicationPath applicationPath) {
    FilterRegistrationBean registration = new FilterRegistrationBean<>();
    registration.setFilter(new ServletContainer(this.config));
    // ...
    return registration;
  }
  @Bean
  @ConditionalOnMissingBean(name = "jerseyServletRegistration")
  @ConditionalOnProperty(prefix = "spring.jersey", name = "type", havingValue = "servlet", matchIfMissing = true)
  public ServletRegistrationBean jerseyServletRegistration(JerseyApplicationPath applicationPath) {
    ServletRegistrationBean registration = new ServletRegistrationBean<>(
      new ServletContainer(this.config), applicationPath.getUrlMapping());
    addInitParameters(registration);
    registration.setName(getServletRegistrationName());
    registration.setLoadOnStartup(this.jersey.getServlet().getLoadOnStartup());
    return registration;
  }
}

上面列出了Filter及Servlet，根據(jù)上面的配置知道，在沒有手動(dòng)在配置文件中設(shè)置spring.jersey.type=filter，那么默認(rèn)就是servlet生效。

向容器注冊(cè)了ServletContainer Servlet程序，該Servlet程序傳入了自定義的ResourceConfig及默認(rèn)的該Servlet請(qǐng)求Mapping地址默認(rèn)是/*。

ServletContainer

該Servlet傳入了ResourceConfig：?

public class JerseyAutoConfiguration implements ServletContextAware {
  // 通過構(gòu)造函數(shù)注入ResourceConfig類型的Bean
  private final ResourceConfig config;
  public JerseyAutoConfiguration(JerseyProperties jersey, ResourceConfig config,
    ObjectProvider customizers) {
    this.jersey = jersey;
    this.config = config;
    customizers.orderedStream().forEach((customizer) -> customizer.customize(this.config));
  }
}

個(gè)性化配置ResourceConfig

要想個(gè)性化定制配置，可以注冊(cè)任意數(shù)量的實(shí)現(xiàn)ResourceConfigCustomizer的bean。?

@Component
public class CustomResourceConfigCustomizer implements ResourceConfigCustomizer {

  @Override
  public void customize(ResourceConfig config) {
    // 個(gè)性化定制配置
  }

}

配置應(yīng)用請(qǐng)求路徑

@Component
// 添加此注解所有的api接口都需要添加/api前綴
@ApplicationPath("/api")
public class JerseyConfig extends ResourceConfig {
}

配置文件方式?

spring:
  jersey:
    type: servlet
    # 該配置會(huì)覆蓋@ApplicationPath
    application-path: /api-a

示例：?

@Component
@Path("/users")
public class UserEndpoint {

  @Path("/{id}")
  @GET
  @Produces({"application/json"})
  public User queryUser(@PathParam("id") Integer id) {
    return new User(id, "姓名 - " + id, 6 + id) ;
  }
  
}

完畢?。?！

文章題目：Springboot整合Jersey實(shí)現(xiàn)RESTfull風(fēng)格API及原理
本文來源：http://uogjgqi.cn/article/cdpigsd.html