Java Restful Web Service 学习指南

时间:2022-04-27 21:16:19

Restful是一种架构style,目前常说的有restful web service, resultful http。现在热搜榜的微服务,大多数会采用Restful方式。

JAX-RS 作为一个Restful 风格WebService规范,目前已发展到了2.0版本,目前比较常用的两个版本是JAX-RS1.1(jsr-311)、 JAX-RS2.0(jsr-339) 。

规范地址:https://jax-rs-spec.java.net/ 。现在已有很多实现:

Jersey:是jax-rs的标准实现,对规范的支持自然是最快的(JAX-RS1.1、 JAX-RS2.0)。它支持多种Servlet容器、并可以与Grizzly、Netty等结合使用,性能也是很不错的。网上有人说它是一个参考实现,但它真的不仅仅是一个参考实现而已,Kafka Connect采用了它。 支持与Spring 集成。

https://jersey.java.net/

CXF:apache下的一个开源的services框架,支持多种协议( SOAP, XML/HTTP, RESTful HTTP, or CORBA),同时也支持多种传输协议:(HTTP, JMS or JBI)。

支持的Java规范(jsr)有:JAX-WS、JAX-RS、SAAJ 。 对于JAX-RS,支持目前JAX-RS1.1、 JAX-RS2.0。 支持与Spring集成。

http://cxf.apache.org/docs/restful-services.html

http://cxf.apache.org/docs/overview.html

RestEasy:它是JBoss社区的一个开源项目,已支持2.0规范。据说是性能最好的,我没有测试过。

http://docs.jboss.org/resteasy/docs/3.1.1.Final/userguide/html/index.html

Restlet:支持JAX-RS,支持与Spring集成。

https://restlet.com/open-source/features

这里有一篇网友的性能测试博客:http://www.tuicool.com/articles/UziAZ3u

这里是一篇网友的8个restful框架对比的博客:http://developer.51cto.com/art/201511/497863.htm

题外话说了这么多,言归正传,既然他们都实现了jax-rs规范,那么我们只需要学习了标准规范,并使用规范中的API来编程,那么我们的程序就可以与这些实现结合使用。

为了快速学习规范:我们可以参考: 1)标准规范 2)入门教程:Java Restful WebService 实战  3) API  Docs

下面提供前两者的下载链接:

链接:http://pan.baidu.com/s/1kVkb7CF 密码:vrln

Jersey2.x用户指南:https://github.com/waylau/Jersey-2.x-User-Guide

下面总结了如何学习JAX-RS,进行Restful WebService编程:

第一步: 了解规范中各个组件、API处理流程

JAX-RS中组件:

1)Resource :代表资源,用于在接收到资源请求后,调用相应的方法处理。

资源分类:Resource、SubResouce。如何编写一个Resource Class、Resource Method?如何定位一个Resource?Resource的生命周期如何?等等问题都将在jsr手册里提到。

2)AOP:包括Filter、Interceptor。用于在Client、Container中读写请求之前做一些处理。

3)Provider:Provider提供某种东西的。有下列Provider:

MessageBodyReader:从InputStream中读取数据转换成Java对象。也就是常说的反序列化。

MessageBodyWriter:把Java对象写到OutputStream中,也就是常说的序列化。

ExceptionMapper:把指定的Exception映射到一个Response对象。

ContextResolver:用于解析Resource中需要用的上下文。参见:@Context

这些接口的实现,注册到JAX-RS容器里,通常有两种方法:1)使用@Provider让容器自动扫描,2)通过编程的方式注册。

4)Client:发起请求,处理响应。

每一种JAX-RS实现都要遵循的处理流程:

Java Restful Web Service 学习指南

第二步:结合DI容器,并采用分层思想(Resource、Service、DAO)进行业务系统编写。

目前流行的DI容器有:Spring、Guice、HK2等等。

第三步:和其他容器结合,部署项目。

譬如说Servlet容器、Grizzly等。