REST Service 开发 - 客户端

REST Service 开发 - 客户端

【摘要】REST Service 的客户端开发是比较简单的，每种框架都提供了各种访问服务端的实现，如 Apache Httpclient, JAX-RS2 client，Feign Client。本文重点罗列客户端异步服务编排技术，服务端异步技术，这些将使得你的云服务更加健壮、高效。

1、Rest 客户端概述

Restful Sevice 客户端没有什么特别，普通 HTTP 访问协议即可。从 Apache Httpclient 开始，出现了各种方便使用的客户端，如基于 build pattern 设计的 JAX-RS2 client；基于 template 设计的 Feign。这些技术对于软件设计者都是必须掌握的实用的方法。

1.1 Apache Httpclient

Apache Httpclient 是采用 Socket 的 stream 访问 HTTP 应用，高效是它的特点。Apache HttpClient 分为新版和旧版，参见： http://hc.apache.org/httpcomponents-client-ga/

cxf 演示程序使用的是旧版，maven、与程序见 domo 代码：

• maven 依赖 commons-httpclient.3.1。案例配置
• 客户端代码。案例代码

1.2 JAX-RS2.0 Client

为了简化 REST 客户端开发，RS2.0 提供 javax.ws.rs.client 包，它提供了构建 REST 客户端需要的两个类 ClientBuilder 和 Entity。这个包不仅定义了同步访问客户端标准，也包括异步访问客户端的标准。javax.ws.rs.client API

让我们看标准提供的一段代码，创建一个 REST 客户端访问 REST 服务：

   Client client = ClientBuilder.newClient();
   Response res = client.target("http://example.org/hello").request("text/plain").get();

简单直接。ClientBuilder -> Client -> WebTarget -> Invocation.Builder/SyncInvoker -> Response。这种链式反应过程，很易于理解。

上述代码标准与风格，无论 cxf 或 jersey 都是支持的。详细：

• cxf 客户端文档
• jersey 客户端文档

1.3 Feign HttpApi

REST Service 开发 - Quick Start

2、异步访问 REST 服务

2.1 同步与异步 web 服务的区别

要知道什么是异步模式，就先要知道什么是同步模式，先看最典型的同步模式：

上图所示，请求处理线程会在Call了之后等待Return，自身处于阻塞状态。这也是绝大多数Web服务器的做法，一般来说这样做也够了，为啥？一来“长时间处理服务”调用通常不多，二来请求数其实也不多。要不是这样的话，这种模式会出现什么问题呢？——会出现的问题就是请求处理线程的短缺！因为请求处理线程的总数是有限的，如果类似的请求多了，所有的处理线程处于阻塞的状态，那新的请求也就无法处理了，也就所谓影响了服务器的吞吐能力。要更加好地发挥服务器的全部性能，就要使用异步模式。

2.2 Reactive Jersey Client API

原文：Chapter 6. Reactive Jersey Client API

问题陈述

旅游代理编排服务（下图）：

如何编排（Orchestration）这些服务呢？

解决方案

• 按顺序编排，同步访问；
• 按服务之间数据依赖编排，使用 JAX-RS2.0 异步访问机制；
• 使用 RxJava 响应式编排。

同步编排如下：

异步编排如下：

请实现不同方式的编排。（官网案例）

2.3 异步服务端

JAX-RS2.0 提供 javax.ws.rs.container 包，规范 REST 服务对容器异步服务的支持。其中，最重要的接口是 AsyncResponse 和 CompletionCallback、ConnectionCallback 接口。

其中：

• AsyncResponse：异步返回响应
• CompletionCallback：任务完成或失败的回调
• ConnectionCallback：客户连接丢失

Jersey 和 CXF 都由不错的支持：

• Jersey Chapter 11. Asynchronous Services and Clients
• Cxf Suspended invocations

注意：服务端异步支持受服务容器限制，tomcat 和 jetty 都是不错的选择。

3、Feign-Hystrix 云服务访问

官方文档

4、小结

尽管远端访问不难，但是异步编排是非常重要的技术。从我们罗列的资料来看，完全掌握也不是一件容易的事情。