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 类调用后端业务服务进行处理。

原文地址:https://www.cnblogs.com/madyina/p/3420131.html