HTTP-RPC：轻量级跨平台REST框架

核心要点

\

• HTTP-RPC是一个开发RESTful应用的轻量级开源框架，同时符合RPC隐喻的做法； \
• 提供了服务端和客户端的API； \
• 支持各种操作系统和设备； \
• 支持多种语言，包括Java、Objective-C/Swift和JavaScript。

HTTP-RPC是一个开源框架，致力于简化基于REST的应用开发。它允许开发人员创建和访问基于HTTP的Web服务，这个过程会使用便利的、类似于RPC隐喻的做法，同时还能保留基础的REST理念，比如无状态和统一资源访问。\

目前，这个项目支持使用Java来实现REST服务，使用Java、Objective-C/Swift或JavaScript来消费服务。相对于基于Java的更大的REST框架，服务端组件提供了一种轻量级的替代方案，对于微服务和物联网（Internet of Things，IOT）应用来说，这是一个理想的选择。统一的跨平台客户端API能够使与服务的交互变得非常容易，不用关心目标设备或操作系统是什么。\

概览

\

HTTP-RPC服务要通过HTTP动作来进行访问，比如对目标资源的GET或POST请求。目标是通过路径来进行指定的，路径代表了资源的名称，通常会使用一个名词来组成URL，比如/calendar或/contacts。\

参数会通过查询字符串或类似于HTML表单那样的请求体的方式来提供。结果通常会返回JSON格式，当然不返回任何值的操作也是支持的。\

例如，如下的请求将会得到两个数字的和，这两个数字分别是通过a和b这两个查询参数指定的：

GET /math/sum?a=2\u0026amp;b=4

\

除此之外，参数值也可以通过一个列表来指定，而不是两个固定的变量：

GET /math/sum?values=1\u0026amp;values=2\u0026amp;values=3

\

在这两种情况下，服务都会在响应中返回6这个值。\

POST、PUT和DELETE操作的行为与之类似。\

实现服务

\

HTTP-RPC的服务端库是以一个JAR文件的形式来进行分发的，这个库只有32KB，并没有外部的依赖。它包含了如下的包/类：\

org.httprpc\

WebService——HTTP-RPC所提供的RPC服务的抽象基础类，为其添加注解就能指定“远程方法调用”或服务方法。\

org.httprpc.beans\

BeanAdapter——适配器类，将Java Bean实例的内容呈现为一个Map，适用于序列化为JSON的场景。\

org.httprpc.sql\

ResultSetAdapter——适配器类，它代表了JDBC结果集的内容，将其作为一个可迭代的列表，适用于将流（streaming）转换为JSON。\

Parameters——用于简化预处理语句（prepared statement）执行的类。\

org.httprpc.util\

IteratorAdapter——适配器类，它以一个可迭代列表的形式展现迭代器中的内容，适用于将流（streaming）转换为JSON。\

上述的每个类都会在后文中进行更详细的讨论。\

WebService类

\

WebService类是一个用于实现HTTP-RPC Web服务的基础抽象类。我们定义服务操作的方式就是为某个具体的服务实现添加公开方法。\

@RPC注解用来标记某个方法可以进行远程访问。这个注解会为方法关联一个HTTP动作和资源路径。当服务发布之后，所有带有注解的公开方法将会自动允许远程执行。\

例如，如下的类可以用于实现我们前文所述的简单加法操作：

public class MathService extends WebService {\    @RPC(method=\"GET\