【好书推荐】JAVA技术探讨：基于Jersey如何实现REST式的Web服务？

王楠w_n

话题背景:REST对当前软件开发非常重要，除了我们一直了解的Service API、Open API、移动端对后端的Gatway API调用（这些基本都是REST模式设计的），现在很多的DevOps操作也是通过REST API完成的，如我们了解的Docker和SpringBoot Actuator API都是REST风格的，另外HTTP/2的逐步采用，也为REST带来更多的功能和性能的提升。


讨论话题:
1. 我们都知道REST服务是通过资源定位实现对接口的解析，你知道如何设计一个接口，使其支持变长的地址查询吗？比如输入 /path/big-data 输出全部大数据相关的产品描述JSON，而输入/path/big-data/search-engine 输出大数据产品中全部的搜索引擎产品JSON。
2. 你知道Jersey和SpringBoot默认的JSON解析工具是什么吗？
3. 我们都知道，在Servlet容器中，filter的实现采用的是责任链模式。那么，在REST服务的开发过程中，如何在基于annotation方式下，实现指定两个给定filter的顺序呢？
4. 能列举Spring Cloud为开发REST服务带来的好处吗？


活动时间:2016年8月18日—9月18日


活动奖励:

活动结束后，我们将选取5位亮点回复，送技术图书《Java Restful Web Service实战（第2版）》一本。




作者： 韩陆   
丛书名： Java核心技术系列
出版社：机械工业出版社
ISBN：9787111542131
上架时间：2016-7-27
出版日期：2016 年8月
开本：16开
版次：2-1
所属分类：计算机 > 软件与程序设计 > JAVA(J#) > Java

购书链接：http://item.jd.com/12000164.html

内容简介：

本书系统、深度讲解了如何基于Java标准规范实现REST风格的Web服务，由拥有10余年开发经验的阿里云大数据架构师撰写，第1版上市后广获赞誉，成为该领域的畅销书。第2版对全书进行了优化和重构，不仅根据最新的技术版本对原有过时内容进行了更新，而且还根据整个技术领域的发展增添了新的内容。除此之外，还对第1版中存在的不足进行了优化，使得内容更加与时具进、更加有价值。不仅深刻解读了最新的JAX-RS标准和其API设计，以及Jersey的使用要点和实现原理，还系统讲解了REST的基本理论，更重要的是从实践角度深度讲解了如何基于Jersey实现完整的、安全的、高性能的REST式的Web服务，书中包含大量示例代码，实战性强。全书共10章，包括JAX-RS2入门、REST API设计、REST请求处理、REST服务与异步、REST客户端、REST测试、微服务、容器化、JAX-RS调优、REST安全等内容。书中从基础概念开始，结合大量示例和实现代码，将REST理论与Java实现相结合，循序渐进地阐述Java REST式服务，为读者提供更精炼、更准确、更全面的参考。

试读样章： Java RESTful Web Service实战（第2版）.pdf (2.65 MB, 下载次数: 257)

2016-08-18 11:02 上传

点击文件名下载附件

jieforest

这本书挺想看的，占位。

---------------
1. 我们都知道REST服务是通过资源定位实现对接口的解析，你知道如何设计一个接口，使其支持变长的地址查询吗？比如输入“/path/big-data” 输出全部大数据相关的产品描述JSON，而输入“/path/big-data/search-engine” 输出大数据产品中全部的搜索引擎产品JSON。

假设我们采用Jersey库开发这个接口，接口及路由的实现大致是这样的：

1. @Path("/path")
   
2. public class BigdataResource {
   
3.     @GET
   
4.     @Path("/big-data")
   
5.     @Produces("application/json")
   
6.     public WebResourceList getAllBigdataProducts() {
   
7.         ...
   
8.     }
   
9. 
   
10.     @GET
    
11.     @Path("/bigdata/search-engine")
    
12.     @Produces("application/json")
    
13.     public WebResourceList getAllSearchEngineProducts() {
    
14.         ...
    
15.     }
    
16. 
    
17. }

复制代码

2. 你知道Jersey和SpringBoot默认的JSON解析工具是什么吗？
显然是Jackson库。

3. 我们都知道，在Servlet容器中，filter的实现采用的是责任链模式。那么，在REST服务的开发过程中，如何在基于annotation方式下，实现指定两个给定filter的顺序呢？
过滤器Filter的顺序是受@Priortiy注解（即javax.annotation.Priority）的控制的，@Priortiy注解接收整数形式的参数，此整数表示过滤器的优先级。
这里还分两种情况：
1）对于容器请求过滤器ContainerRequestFilter和客户端请求过滤器ClientRequestFilter来说，拦截器是以升序的方式来处理过滤器的优先级的。因此@Priority(200)注解的过滤器会在@Priority(500)注解的过滤器之前先执行。
2）而对于容器响应过滤器ContainerResponseFilter和客户端响应过滤器ClientResponseFilter来说，拦截器是以降序的方式来处理过滤器的优先级的。因此@Priority(500)注解的过滤器会在@Priority(200)注解的过滤器之前先执行。

4. 能列举Spring Cloud为开发REST服务带来的好处吗？
Spring Cloud为开发者提供了在构建分布式系统所需的常用模式，包括：配置管理、服务发现、断路器、智能路由、微代理、控制总线、一次性令牌Token、全局锁、选举策略、分布式会话、集群状态等。
分布式系统的协调是一个非常关键的因素，实现的不好会导致系统出现瓶颈。因此Spring Cloud就提供了构建分布式系统所需的常用模式，一方面促进了开发者的开发效率，使得开发者无需花费精力来构建和实现这些模式，并让开发分布式应用变得像开发本地应用一样简单；另一方面通过统一、一致的Spring Cloud库，使得整个分布式系统更具备健壮性，整个系统更加可靠、安全。

sjf0115

不错的书呀

1. 我们都知道REST服务是通过资源定位实现对接口的解析，你知道如何设计一个接口，使其支持变长的地址查询吗？比如输入 /path/big-data 输出全部大数据相关的产品描述JSON，而输入/path/big-data/search-engine 输出大数据产品中全部的搜索引擎产品JSON。

1. <web-app>
   
2.   <display-name>RESTfulWS</display-name>
   
3.   <servlet>
   
4.     <servlet-name>Jersey REST Service</servlet-name>
   
5.     <servlet-class>org.glassfish.jersey.servlet.ServletContainer</servlet-class>
   
6.     <init-param>
   
7.       <param-name>jersey.config.server.provider.packages</param-name>
   
8.       <param-value>com.sjf.open</param-value>
   
9.     </init-param>
   
10.     <load-on-startup>1</load-on-startup>
    
11.   </servlet>
    
12.   <servlet-mapping>
    
13.     <servlet-name>Jersey REST Service</servlet-name>
    
14.     <url-pattern>/jersey/*</url-pattern>
    
15.   </servlet-mapping>
    
16. </web-app>
    

复制代码

1. package com.sjf.open;
   
2. 
   
3. 
   
4. import javax.ws.rs.GET;
   
5. import javax.ws.rs.Path;
   
6. import javax.ws.rs.PathParam;
   
7. import javax.ws.rs.Produces;
   
8. import javax.ws.rs.core.MediaType;
   
9. 
   
10. import com.google.common.collect.Lists;
    
11. import com.sjf.open.model.BigDataResource;
    
12. 
    
13. import java.util.List;
    
14. 
    
15. /**
    
16. * Created by xiaosi on 16-9-5.
    
17. */
    
18. @Path("path")
    
19. public class BigDataResourceService {
    
20. 
    
21. 
    
22.     private static List<BigDataResource> bigDataResourceList = Lists.newArrayList();
    
23. 
    
24.     static {
    
25.         BigDataResource bigDataResource1 = new BigDataResource("Datameer", "machine-learning", "Datameer发布了面向企业用户的Datameer 3.0数据集成和分析软件。该版本增加了“智能分析”功能，可以从Hadoop中保存的大量复杂数据中自动找出模型和关联性");
    
26.         BigDataResource bigDataResource2 = new BigDataResource("Hortonwork", "search-engine", "Hortonworks将在社区中预览下一代支持Yarn(下一代Hadoop数据处理框架)的Hortonworks Data Platform。");
    
27.         BigDataResource bigDataResource3 = new BigDataResource("Kognitio", "data-analysis", "Kognitio推出了新一代的Kognitio Analytic Platform，加强了多种编程语言之间的连接性，并提高了性能");
    
28.         BigDataResource bigDataResource4 = new BigDataResource("Pentaho", "data-integration", "添加大数据平台集成能力");
    
29. 
    
30.         bigDataResourceList.add(bigDataResource1);
    
31.         bigDataResourceList.add(bigDataResource2);
    
32.         bigDataResourceList.add(bigDataResource3);
    
33.         bigDataResourceList.add(bigDataResource4);
    
34.     }
    
35. 
    
36.     /**
    
37.      * 查询全部
    
38.      * @return
    
39.      */
    
40.     @GET
    
41.     @Path("/big-data")
    
42.     @Produces({MediaType.APPLICATION_JSON})
    
43.     public List<BigDataResource> getAllProducts() {
    
44.         return bigDataResourceList;
    
45.     }
    
46. 
    
47.     /**
    
48.      * 根据type查询
    
49.      * @return
    
50.      */
    
51.     @GET
    
52.     @Path("/big-data/{type}")
    
53.     @Produces("application/json")
    
54.     public BigDataResource getAllProductsByType(@PathParam("type") final String type) {
    
55.         for(BigDataResource bigDataResource : bigDataResourceList){
    
56.             if(bigDataResource.getType().equals(type)){
    
57.                 return bigDataResource;
    
58.             }
    
59.         }
    
60.         return null;
    
61.     }
    
62. }
    

复制代码

2. 你知道Jersey和SpringBoot默认的JSON解析工具是什么吗？

jackson

demilich

1. 我们都知道REST服务是通过资源定位实现对接口的解析，你知道如何设计一个接口，使其支持变长的地址查询吗？比如输入 /path/big-data 输出全部大数据相关的产品描述JSON，而输入/path/big-data/search-engine 输出大数据产品中全部的搜索引擎产品JSON。
@Path注解的时候,使用区间路径和正则表达式配合,实现对动态资源地址的查询

2. 你知道Jersey和SpringBoot默认的JSON解析工具是什么吗？
Jersey2.0默认应该是MOXy,SprintBoot是Jackson

3. 我们都知道，在Servlet容器中，filter的实现采用的是责任链模式。那么，在REST服务的开发过程中，如何在基于annotation方式下，实现指定两个给定filter的顺序呢？
使用@Priority, 跟上优先级,你就可以定义filter的顺序了 ...

4. 能列举Spring Cloud为开发REST服务带来的好处吗？
- Spring为REST提供了一个restTemplate,提高开发的效率 ... 别的不知道了

vermouth

翻了一半，基本不懂。。。

chenxing2

1. 我们都知道REST服务是通过资源定位实现对接口的解析，你知道如何设计一个接口，使其支持变长的地址查询吗？比如输入 /path/big-data 输出全部大数据相关的产品描述JSON，而输入/path/big-data/search-engine 输出大数据产品中全部的搜索引擎产品JSON。

这个REST服务的开源实现有很多种，基本都是类似的。
类头部定义本类的总path，方法上定义具体的paht，分类清晰

1. @Path("/ry")
   
2. public class RonYun {
   
3.        
   
4.         /** 日志 */
   
5.         private static Logger logger = LoggerFactory.getLogger(RonYun.class);
   
6. 
   
7.         /**
   
8.          * <I>获取AppKey</I>
   
9.          * <P><B>API:/ry/getToken</B></P>
   
10.          * <P>example：/ry/getToken?id=id3&amp;name=小李&amp;pic=</P>
    
11.          *
    
12.          * @param id        用户ID
    
13.          * @param name        用户姓名
    
14.          * @param pic        用户图片
    
15.          * @return        {"data" : {"token":"TOKEN"},"info":"成功","status":"0"}
    
16.          */
    
17.         @GET
    
18.         @Path("/getToken")
    
19.         @Produces(MediaType.APPLICATION_JSON)
    
20.         public AppResult getToken(@QueryParam("uid") String uid, @QueryParam("name") String name,
    
21.                                                                 @DefaultValue("") @QueryParam("pic") String pic) {
    
22.     //
    
23. }
    
24. }

复制代码

2. 你知道Jersey和SpringBoot默认的JSON解析工具是什么吗？
    只用过Jersey2，默认是jackson；spring-boot也是默认jackson。很多开源都使用jackson包。
    当时用grizzly2+Jersery2+mongoDB3做的项目，JSON解析我给改成fastjson了
    通过实现javax.ws.rs.ext.MessageBody* 相关的接口，主要是那个jackson带了一大堆包，看着碍眼

3. 我们都知道，在Servlet容器中，filter的实现采用的是责任链模式。那么，在REST服务的开发过程中，如何在基于annotation方式下，实现指定两个给定filter的顺序呢？
    这个通过@Priority实现


4. 能列举Spring Cloud为开发REST服务带来的好处吗？
    Spring Cloud带来的好处啊，这个这么说吧
Spring Cloud继承了Spring Source整合一切的作风，以标准化的姿态将一些微服务架构的成熟产品与框架揉为一体，并继承了Spring Boot简单配置、快速开发、轻松部署的特点，让原本复杂的架构工作变得相对容易上手一些。
    最大的好处是提供服务治理相关的继承，在微服务开发中提供很大的便利。
   像服务注册发现，服务注册中心，通过spring-boot开发，只需在入口类增加@EnableEurekaServer注解即可，无需做其他操作。然后去实现服务提供这和消费者即可，代码也只需一点就可以了。

   对于rest的服务开发，有一个文档化的痛点，随着开发的进行，文档与接口会变得不一致，会导致后续一些问题。通过spring-boot开发的话，可以很方便的整合swagger2来完善这点。
   
   

王楠w_n

回复

fenyun689

刚开始解除rest。还不熟。
送我一本吧。

王楠w_n

回复的有点多回复 9# fenyun689

fenyun689

回复 10# 王楠w_n

我临阵磨枪试下。

1：REST 概念

REST 就是Web（World Wide Web，简称Web 或者WWW）本身的架构风格，是设计、 开发 Web 相关规范、Web 应用、Web 服务的指导原则。不符合 REST 风格要求的架构和技术， 很难在Web 这个生态系统中得到繁荣发展。

REST（Representational State Transfer）翻译为表述性状态转移，源自Roy Thomas Fielding 博士在2000 年就读加州大学欧文分校期间发表的一篇学术论文《Architectural Styles and the Design of Network-based Software Architectures》。

REST 之父在该论文中提出 了 REST 的 6 个特点，分别是：客户端 – 服务器的、无状态的、可缓存的、统一接口、分层 系统和按需编码。 REST 具有跨平台、跨语言的优势。从其诞生开始，就得到了诸多语言的快速支持， 最著名的是ROR（Ruby on Rails）框架。新兴的语言（比如NodeJs、Golang）、工具平台 （Docker、Spark）和公有云，更是将 REST 默认为服务的开放形式。


2：Jersey的模块

Jersey 框架是由核心模块、容器模块、连接器模块、Media 模块、扩展模块、测试框架 模块、安全模块以及 Glassfish Bundle 模块等 8 个大的模块组成。详情请读者浏览官方文档： https://jersey.java.net/document ... d-dependencies.html。 Jersey 核心模块包括3 个子模块，分别是通用包、服务器端实现包和客户端实现包。 Jersey 提供了3 种 HTTP 容器，分别是Grizzly2、JDK-HTTP 和 SIMPLE-HTTP，Grizzly2 同 时提供了Servlet 容器。Jersey 客户端底层依赖于连接器来实现网络通信，如果标准的客户端 模块功能不能满足业务需求，读者可以考虑引入 Grizzly 连接器包或者 Apache 连接器包。