RESTFul Web Api 服务框架（一）

简介：

基于 REST 的 Web 服务日益成为后端企业服务集成的首选，因为它比 SOAP 更加简单。这篇文章介绍了一

个简单的可扩展框架，使用Asp.net Web Api作为 REST 服务的实现。它详细描述了设计细节，并探讨了各种可扩展性方法。

概念

REpresentational State Transfer (REST) 是一种架构原则，其中将 web 服务视为资源，可以由其 URL 唯一标识。RESTful Web 服务的关键特点是明确使用 HTTP 方法来表示不同的操作的调用。

设计原则：

REST 的基本设计原则对典型 CRUD 操作使用 HTTP 协议方法：

POST - 创建资源

GET - 检索资源

PUT – 更新资源

DELETE - 删除资源

优势：

REST 服务的主要优势在于：

它们是跨平台 (Java、.net、PHP 等）高度可重用的，因为它们都依赖基本 HTTP 协议。

它们使用基本的 XML，而不是复杂的 SOAP XML，使用非常方便。

基于 REST 的 web 服务日益成为后端企业服务集成的首选方法。与基于 SOAP 的 web 服务相比，它的编程模型简

单，而本机 XML（而不是 SOAP ）的使用减少了序列化和反序列化过程的复杂性，并且不再需要其他作用相同的第

三方库。

支持：

当前用于构建 RESTful 服务，比如 .Net平台下基于asp.net api的实现 和 REST 支持使用Microsoft Visual Studio 2012 MVC 4.0模拟支持和Microsoft Visual Studio2013原生支持。

因此本文建议使用更简单的可扩展框架将业务服务公开为类 REST 服务。该框架是轻量级的，采用标准的 Front Controller（前端控制器）模式，非常便于理解。它也是可扩展的，可以通过 API 或任何其他集成模式（如 ESB）集

成后端服务。通过使用自定义 XML 序列化程序、json 或任何其他对象到 XML 转换工具，可以方便地配置数据交换模型。

概述：

在以前的应用程序中，服务通常公开为SOAP web 服务。在这些服务与使用非.Net 技术 （如 Java 或 PHP）的客户端应用程序集成时，处理 SOAP Web 服务将变得非常麻烦，还涉及到大量的开发和配置工作。

这里提到的方法通常用于有很多服务、服务可以重复使用，但使用 SOAP 创建快速集成障碍的互操作性和开发成本很大的组织，帮助它们进行服务集成。此外，在内部治理组织不会在企业 ESB 或 EAI 上公开服务的情况下，很难以点到点的方式集成两种不同的技术服务。

该架构包括 Front Controller，作为接收请求并向客户端提供响应的中心点。Front Controller 将请求处理委托给包含此框架处理逻辑的 ActionController。ActionController 执行验证，将请求映射到相应的 Action，并调用生成响应的动作。为请求处理、日志记录和异常处理这些可以被单个 Action 以及 ActionController 使用的动作提供了各种 Helper Service。

Front Controller 通过让单个控制器负责传输所有请求，从而解决了在 Page Controller 中存在的分散化问题。控制器本身通常分为以下两部分实现：

处理程序和命令层次结构:

处理程序具有以下两项职责：

检索参数：处理程序接收来自 Web 服务器的 HTTP Post 或 Get 请求，并从请求中检索相关参数。

选择命令：处理程序首先使用请求中的参数选择正确的命令，然后将控制权转移给该命令以便执行处理。

框架组件

处理典型 POST 请求的这些组件之间的交互如下所示：

如上图所示，REST 服务配置最初加载，并缓存到 RESTConfiguration 组件中。对于 REST 服务的每个 HTTP 请求，RESTServiceServlet 组件将请求委托到 RESTActionController，它又会检索相应的映射、验证请求、创建ActionContext 组件以及路径和查询输入，并调用 Action 类 （例如，createUserAction）。Action 类调用后端业务服务进行处理。