Springboot整合Jersey实现REST full风格API及原理

Jersey RESTful 框架是开源的RESTful框架, 实现了JAX-RS (JSR 311 & JSR 339) 规范。它扩展了JAX-RS 参考实现, 提供了更多的特性和工具, 可以进一步地简化 RESTful service 和 client 开发。尽管相对年轻,它已经是一个产品级的 RESTful service 和 client 框架。与Struts类似,它同样可以和hibernate,spring框架整合。,jersey1.X使用的是sun的com.sun.jersey,jersey2.X使用的是glassfish的org.glassfish.jersey,Jersey是一个框架,实现了restful风格;JAX-RS也实现了restful风格。那么Jersey与JAX-RS是什么关系呢?我们可以这样理解:JAX-RS是java自己的一个小的框架,实现了restful风格,只不过功能不是很强大;而Jersey呢,它是一个比较成熟的restful框架了,它在设计的时候,是基于JAX-RS的,它使用了java的JAX-RS的一些注解,当然了,他也有自己的特有注解,以及其他更强大的功能。,如果你更喜欢REST端点的JAX-RS编程模型,则可以使用可用的实现之一,而不是Spring MVC。Jersey和Apache CXF开箱即用就可以很好地工作。CXF要求你在应用程序上下文中将其Servlet或过滤器注册为@Bean。Jersey原生支持Spring,所以我们在Spring Boot中也为它提供了自动配置支持,还有一个starter。,要开始使用Jersey,需要把spring-boot-starter-jersey作为依赖,然后需要一个ResourceConfig类型的@Bean,用来注册所有端点,如下面的例子所示:,示例:​,Jersey对扫描可执行档案的支持相当有限。例如,当运行一个可执行的war文件时,它不能扫描在完全可执行的jar文件或WEB-INF/classes中找到的包中的端点。为了避免这种限制,不应该使用packages方法,而应该使用register方法单独注册端点,如上例所示。,对于更高级的定制,你还可以注册任意数量实现了ResourceConfigCustomizer的bean。所有注册的Endpoint都应该是带有HTTP资源注解的@Components (@GET等),如下面的例子所示:​,一个Java类要能够处理REST请求,则这个类必须至少添加一个@Path(“/”)的注解;对于方法,这个注解是可选的,如果不添加,则继承类的定义。,@Path里的值可以是一个复杂的表达式,例如@Path(“/{id}”) ,其中 {id}表达式表示一个路径请求的一部分。,@Path也支持正则表达式,例如: @Path(“{id: \\d+}”) ,其中 \\d+ 表示一个数字。,一个方法上只有添加了某个Http Method的注解,例如@GET,才会生效。,对于资源的具体操作类型,由HTTP动词表示。,常用的HTTP动词有下面五个:,GET(SELECT):从服务器取出资源(一项或多项),POST(CREATE):在服务器新建一个资源,PUT(UPDATE):在服务器更新资源(客户端提供改变后的完整资源),PATCH(UPDATE):在服务器更新资源(客户端提供改变的属性),DELETE(DELETE):从服务器删除资源,还有两个不常用的Method。,HEAD:获取资源的元数据,OPTIONS:一般由浏览器自动发起,用于描述目标资源的通信选项。,下面是一些例子:,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表示客户端发送给服务器端的数据格式。,定义资源类或javax.ws.rs.ext.MessageBodyWriter的方法可以生成的媒体类型。如果没有指定,那么容器将假定可以生成任何类型。方法级注释覆盖类级注释。容器负责确保调用的方法能够生成HTTP请求中请求的一种媒体类型。如果没有这样的方法可用,容器必须以RFC 2616指定的HTTP“406 Not accepted”作为响应。,有几种格式如下:,@Produces(“text/plain”) 文本类型,@Produces(“text/html”) Html类型,@Produces({“application/xml”}) Xml类型,@Produces({ “application/json”}) Json类型,可以一次注解两种或多种的MIME类型,格式如:{“application/xml”, “application/json”}这表示两者都可以使用,但是选择的时候一般会选择前者,即application/xml,因为它第一次出现。,定义资源类或javax.ws.rs.ext.MessageBodyReader的方法可以接受的媒体类型。如果没有指定,容器将假定任何媒体类型都是可接受的。方法级注释覆盖类级注释。容器负责确保所调用的方法能够使用HTTP请求实体的媒体类型。如果没有这样的方法可用,容器必须按照RFC 2616的规定,以HTTP“415 Unsupported Media Type”作为响应。,@QueryParam:指定的是URL中的参数是以键值对的形式出现的,而在程序中,@QueryParam(“id”) Integer id获取请求参数id,如:URL输入为:/api/users?id=1,@PathParam:参数作为路径的一部分,如:/api/users/1,Jersey详细配置,在SpringBoot中引入如下依赖​,引入上面的依赖后,接下来我们只需要定义继承ResourceConfig类型的Bean即可。Jersey的自动配置其中有一个条件就是当前的CLASSPATH中有ResourceConfig类型的Bean才生效,如下:​,其中@ConditionalOnBean条件限制了只有当前容器中有ResourceConfig类型的Bean该自动配置才会生效。,注册继承ResourceConfig后请求又是如何被匹配的?,当上面的自动配置生效后,默认情况下会注册一个Servlet:​,上面列出了Filter及Servlet,根据上面的配置知道,在没有手动在配置文件中设置spring.jersey.type=filter,那么默认就是servlet生效。,向容器注册了ServletContainer Servlet程序,该Servlet程序传入了自定义的ResourceConfig及默认的该Servlet请求Mapping地址默认是/*。,ServletContainer,该Servlet传入了ResourceConfig:​,个性化配置ResourceConfig,要想个性化定制配置,可以注册任意数量的实现ResourceConfigCustomizer的bean。​,配置应用请求路径,配置文件方式​,示例:​,完毕!!!

文章版权声明

 1 原创文章作者:cmcc,如若转载,请注明出处: https://www.52hwl.com/17849.html

 2 温馨提示:软件侵权请联系469472785#qq.com(三天内删除相关链接)资源失效请留言反馈

 3 下载提示:如遇蓝奏云无法访问,请修改lanzous(把s修改成x)

 免责声明:本站为个人博客,所有软件信息均来自网络 修改版软件,加群广告提示为修改者自留,非本站信息,注意鉴别

(0)
打赏 微信扫一扫 微信扫一扫 支付宝扫一扫 支付宝扫一扫
上一篇 2023年3月5日 上午12:00
下一篇 2023年3月7日 下午10:34