SpringBoot2.x系列教程38--整合JAX-RS之利用Jersey框架实现RESTful
SpringBoot2.x系列教程38--整合JAX-RS之利用Jersey框架实现RESTful
作者:一一哥
一. JAX-RS与Jersey简介
1. JAX-RS简介
在Java EE 6 中引入了对 JSR-311 的支持。JSR-311(也就是JAX-RS:Java API for RESTful Web Services)旨在定义一个统一的规范,它的核心概念是resource,也就是面向资源。JAX-RS使得 Java 程序员可以使用一套固定的接口来开发 REST 应用,避免了依赖于第三方框架。同时,JAX-RS 使用 POJO 编程模型和基于注解的配置,并集成了 JAXB,从而可以有效缩短 REST 应用的开发周期。
JAX-RS 定义的 API 位于 javax.ws.rs 包中,其中一些主要的接口、注解和抽象类如下图所示。
javax.ws.rs 包概况:

可以把 JAX-RS 理解为是一套开发协议,该协议具体的实现由第三方来完成,例如 Sun 的实现 Jersey框架、Apache 的 CXF框架 以及 JBoss 的 RESTEasy框架。
其中Jersey,RESTEasy这两个框架创建的应用,可以很方便地部署到Servlet 容器中,比如Tomcat,JBoss等。
2. Jersey框架简介
Jersey是对JAX-RS(JSR311)协议的实现,用于构建RESTful Web Service,可以进一步地简化 RESTful service 和 client 的开发。
也就是说Jersey是一个RESTful框架,与SpringMVC框架类似,但是使用上面和SpringMVC又有不同。此外Jersey还提供一些额外的API和扩展机制,所以我们可以按照自己的需要对Jersey进行扩展。
Jersey的一大特点就是,基于Jersey的REST应用,可以运行在Servlet环境下面,也可以脱离该环境。
3. Jersey常用注解
@Path
@Path注解的值是一个相对的URI路径。@Path的有没有/开头是一样的,同理,结尾有没有包含/也是一样的。
请求类注解
@GET, @PUT, @POST, @DELETE, … (HTTP Methods)
@GET, @PUT, @POST, @DELETE, @HEAD这些注解称为resource method designator,与HTTP规范中定义的方法一致。这些方法决定资源的行为。
@Produce
@Produce注解指定返回给客户端的MIME媒体类型。可以用于注解类或者注解方法。如果类中的方法没有指定,则默认使用类级别的@Produce值。@Produce注解可以指定多个值,同时可以指定quality factor:
@Produces({"application/xml; qs=0.9", "application/json"})
@Consumes
该注解用于指定可以接受的客户端请求的MIME媒体类型:
@POST
@Consumes("text/plain")
public void postClichedMessage(String message) {// Store the message
参数注解(@*Param)
参数注解用于从请求中提取参数,例如上面的@PathParam用于提取路径中的参数。
@QueryParam
@QueryParam注解用于提取查询参数。
@MatrixParam
从url片段中提取参数,即url中冒号后面的参数。
@HeaderParam
从请求的头部提取Header。
@CookieParam
提取cookie。
@FormParam
用于提取请求中媒体类型为”application/x-www-form-urlencoded” 的参数,根据相应的表单类型提取其中的参数。
@BeanParam
该注解用于从请求的各部分中提取参数,并注入到对应的Bean中。
@Context的使用
Context注解一般用于获取request或者response相关的上下文,例如UriInfo。
三. Jersey框架实现RESTful
1. 创建web项目(略)
我们首先创建一个web项目,并将该项目改造成一个Spring boot项目,具体依赖包请参考之前的章节,此处略过!
2. 引入jersey的依赖包
<dependency><groupId>org.springframework.boot</groupId><artifactId>spring-boot-starter-jersey</artifactId>
</dependency>
3. 创建service接口
3.1 创建IHelloService接口类:
package com.yyg.boot.service;/*** @Description Description* @Author 一一哥Sun* @Date Created in 2020/3/28*/
public interface IHelloService {void sayHi(String msg);}
3.2 创建HelloServiceImpl实现类:
package com.yyg.boot.service.impl;import com.yyg.boot.service.IHelloService;
import lombok.extern.slf4j.Slf4j;
import org.springframework.stereotype.Service;/*** @Description Description* @Author 一一哥Sun* @Date Created in 2020/3/28*/
@Slf4j
@Service
public class HelloService implements IHelloService {@Overridepublic void sayHi(String msg) {log.warn("展示信息:" + msg);}}
4. 创建Resource资源类
package com.yyg.boot.web;import com.yyg.boot.service.IHelloService;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Component;import javax.ws.rs.GET;
import javax.ws.rs.Path;
import javax.ws.rs.Produces;
import javax.ws.rs.QueryParam;
import javax.ws.rs.core.MediaType;
import java.awt.*;/*** @Description Description* @Author 一一哥Sun* @Date Created in 2020/3/28*/
@Component
@Path("hello")
public class HelloResource {@Autowiredprivate IHelloService helloService;/*** @Produces(value =MediaType.APPLICATION_JSON):设置输出内容为json格式,且可以解决中文乱码问题;* @Path("sayHi"):设置资源的请求路径;* @GET:设置请求方式为get请求.*/@Produces(value =MediaType.APPLICATION_JSON)@Path("sayHi")@GETpublic String sayHi(@QueryParam("msg") String msg) {this.helloService.sayHi(msg);return "success--->"+msg;}}
5. 对Jersey进行配置
Springboot中对Jersey的配置有三种方式:
- 第一种方式创建一个自定义的ResourceConfig;
- 第二种方式,返回一个ResourceConfig类型的@Bean;
- 第三种方式,配置一组ResourceConfigCustomizer对象。
我们这里以第一种配置方式来讲解如何实现配置。
package com.yyg.boot.config;import com.yyg.boot.web.HelloResource;
import org.glassfish.jersey.server.ResourceConfig;
import org.springframework.context.annotation.Configuration;import javax.ws.rs.ApplicationPath;/*** @Description Description* @Author 一一哥Sun* @Date Created in 2020/3/28* @ApplicationPath("shop")资源根路径。*/
@Configuration
@ApplicationPath("shop")
public class JerseyConfig extends ResourceConfig {public JerseyConfig() {register(HelloResource.class);}}
Springboot默认把Jersey的根路径映射在/*上;如果要更改默认的根路径设置,对于自定义的ResourceConfig方式来说,可以在类上面添加一个@ApplicationPath注解即可。
我们也可以在application.properties中添加配置来改变项目的根路径:
spring.jersey.application-path=shop
另外,Spring Boot建议在使用ResourceConfig添加资源类的时候,不要使用ResourceConfig类的packages方法去自动扫描,建议还是手动添加。
官方的解释为:
Jersey’s support for scanning executable archives is rather limited. For example, it cannot scan for endpoints in a package found in WEB-INF/classes when running an executable war file. To avoid this limitation, the packages method should not be used and endpoints should be registered individually using the register method
也就是使用Jersey的packages是比较有局限的,比如在应用运行在war包中的时候,就不能扫描到其中的包。所以建议单独的为每一个资源类独立使用register方法注册。
6. 创建入口类
package com.yyg.boot;import com.yyg.boot.service.impl.HelloService;
import com.yyg.boot.web.HelloResource;
import org.glassfish.jersey.server.ResourceConfig;
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.context.annotation.Bean;/*** @Description Description* @Author 一一哥Sun* @Date Created in 2020/3/28*/
@SpringBootApplication
public class JerseyApplication {/*** 第二种方式,使用@Bean创建一个ResourceConfig类实例*/
// @Bean
// public ResourceConfig resourceConfig() {
// ResourceConfig config = new ResourceConfig();
// config.register(HelloResource.class);
// return config;
// }public static void main(String[] args){SpringApplication.run(JerseyApplication.class,args);}}
7. 项目结构
8. 启动项目,测试接口
我们在浏览器中输入地址:
http://localhost:8080/shop/hello/sayHi?msg=%E4%B8%80%E4%B8%80%E5%93%A5
如果出现如下内容,说明我们的jersey与Spring Boot成功的实现了整合。

9. 其他细节
9.1 Jersey注册方式
Jersey和Springboot的集成有两种方式,一种是使用Filter的方式注册,一种是使用Servlet的方式注册,默认使用的是Servlet的方式,也可以通过spring.jersey.type=filter或者通过spring.jersey.type=servlet来控制。
spring.jersey.type=servlet
9.2 更改延迟启动
如果使用Servlet的方式启动,默认是使用的延迟启动。
jerseyServletRegistration方法的代码就可以看出来:
registration.setName(getServletRegistrationName());registration.setLoadOnStartup(this.jersey.getServlet().getLoadOnStartup());
return registration;
第二句代码setLoadOnStartup方法,调用的是this.jersey.getServlet().getLoadOnStartup(),而这个地方的jersey就是JerseyProperties对象:
@ConfigurationProperties(prefix = "spring.jersey")
public class JerseyProperties {...}
其中servlet的类代码为:
public static class Servlet {/*** Load on startup priority of the Jersey servlet.*/private int loadOnStartup = -1;public int getLoadOnStartup() {return this.loadOnStartup;}public void setLoadOnStartup(int loadOnStartup) {this.loadOnStartup = loadOnStartup;}}
可以看到,默认值为-1。

那么我们只需要在application.properties中配置spring.jersey.servlet.loadOnStartup=1即可立即让Jersey的Servlet实例化。
application.properties中配置spring.jersey.servlet.loadOnStartup=1

SpringBoot2.x系列教程38--整合JAX-RS之利用Jersey框架实现RESTful相关推荐
- SpringBoot2.x系列教程75--SpringBoot整合JPA、Redis实现分布式的Session共享
SpringBoot2.x系列教程75--SpringBoot整合JPA.Redis实现分布式的Session共享 一.SpringBoot整合JPA.Redis实现分布式的Session共享 1. ...
- springboot接收文件_SpringBoot2.x系列教程61--SpringBoot整合MQ之ActiveMQ实现消息传递
SpringBoot2.x系列教程61--SpringBoot整合消息队列之ActiveMQ代码实现消息传递 作者:一一哥 我在上一章节中,给大家介绍了ActiveMQ,本节中我会介绍Spring B ...
- elasticsearch 9300端口连接不上_SpringBoot2.x系列教程54--SpringBoot整合ElasticSearch方式一...
SpringBoot2.x系列教程54--NoSQL之SpringBoot整合ElasticSearch方式一 作者:一一哥 一. Elastic Search 1. Elastic Search简介 ...
- STM32 基础系列教程 38 - Lwip_http
前言 HTTP协议(HyperText Transfer Protocol,超文本传输协议)是因特网上应用最为广泛的种网络传输协议,所有的WWW文件都必须遵守这个标准.HTTP是一个基于TCP/IP通 ...
- SpringBoot2.x系列教程10--小花样之SpringBoot配置自定义Banner
SpringBoot系列教程10--小花样之SpringBoot配置自定义Banner 作者:一一哥 一. Spring Boot 常用配置 本章节主要介绍一下 Spring Boot 中的一些常用配 ...
- SpringBoot2.x系列教程11--小花样之SpringBoot其他常用配置
SpringBoot系列教程11--小花样之SpringBoot其他常用配置 作者:一一哥 一. 修改端口号和访问路径 在Spring Boot 项目中会使用一个全局的配置文件application. ...
- 讲给后台程序员看的前端系列教程(38)——事件处理
C语言自学完备手册(33篇) Android多分辨率适配框架 HTML5前端开发实战系列教程 MySQL数据库实操教程(35篇图文版) 推翻自己和过往--自定义View系列教程(10篇) 走出思维困境 ...
- larvel 中的api.php_Laravel API 系列教程(一): 基于 Laravel 5.5 构建 测试 RESTful API...
Laravel API 系列教程(一): 基于 Laravel 5.5 构建 & 测试 RESTful API 由 学院君 创建于2年前, 最后更新于 9个月前 版本号 #3 171702 v ...
- SpringBoot专栏 | SpringBoot2.x系列教程之花样配置--自定义Banner
前言 在前面的几个章节中,壹哥 带大家认识了SpringBoot的由来.优缺点,以及在SpringBoot中创建Web项目的3种方式. 既然我们现在已经把SpringBoot项目创建出来了,那么Spr ...
最新文章
- Activiti——数据表结构
- java中Hashtable中的t为什么是小写(转)
- python 静态方法 类方法 的作用_Python实例方法、类方法、静态方法的区别与作用详解...
- QRadioButton 使用方法
- 微信小程序(6)模板详解 template
- 如何把握创业时机:当前的痛点也许是巨大的风险
- Java类类getClassLoader()方法及示例
- centos 搭建Jenkins
- 关于SQL Server 2005 的自动远程数据库备份
- 【报告分享】2021年度私域经营洞察报告.pdf(附下载链接)
- 冲刺个税递延,第三批养老目标基金正式获批!合计已达40只
- 为什么MyBatis配置映射器只有四种
- MD5加密算法特点及简单实现(Java)
- 文章中如何将章节分页——段前分页
- Google 阅读器键盘快捷键
- Android 白天黑夜模式切换适配及引起的Activity销毁重启解决
- 内存不够清理方法,costdown项目时如果裁剪不下来,也可以参考
- 人工智能的高层建筑取决于数据基础设施
- word中图片变为灰度图像 黑白图像 黑白图片
- android9.0 SystemUI锁屏页面固定横屏