RestFul服务介绍

摘要: RESTful Web 服务的关键特色是明确使用 HTTP 方法来表示不一样的操做的调用。 REST 的基本设计原则对典型 CRUD

操做使用 HTTP 协议方法： POST - 建立资源 GET - 检索资源 PUT – 更新资源 DELETE - 删除资源

1. 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 ）的使用减小了序列化和反序列化过程的复杂性，而且再也不须要其余做用相同的第三方库。

2. 编写目的

编写本文的目的是为了将系统功能进行模块化、服务化，将用户的操做以服务的方式提供。系统与系统之间遵循服务规范，将系统与系统之间的交互转为定制化服务交互，以实现系统与系统之间的集成

3. 编写原则

可寻址性（Addressability）

REST 中的全部东西都基于资源 的概念。资源与 OOP 中的对象或其余名词不一样，它是一种抽象，必须能够经过 URI 寻址或访问。

接口一致性（Interface uniformity）

与 SOAP 或其余标准不一样，REST 要求用来操纵资源的方法或动词不是任意的。这意味着 RESTful 服务的开发人员只能使用 HTTP 支持的方法，好比GET、PUT、POST、DELETE等等。所以不须要使用 WSDL 等服务描述语言

无状态（Statelessness）

为了加强可伸缩性，服务器端不存储客户机的状态信息。这使服务器不与特定的客户机相绑定，负载平衡变得简单多了。这还让服务器更容易监视、更可靠

具象（Representational）

客户机老是与资源的某种具象交互，毫不会直接与资源自己交互。同一资源还能够有多个具象。理论上说，持有资源的具象的任何客户机应该有操纵底层资源的足够信息。

连通性（Connectedness）

任何基于 REST 的系统都应该预见到客户机须要访问相关的资源，应该在返回的资源具象中包含这些资源。例如，能够以超连接的形式包含特定 RESTful 服务的操做序列中的相关步骤，让客户机能够根据须要访问它们。

4. 服务使用说明

1) 当前系统已经提供的服务

 

2)  GET方式调用服务

 

说明：

1.请求方式包括：GET (这里以area服务为实例，GET对应每个服务Resource中的@RequestMapping(value = "treeData",method = RequestMethod.GET))

2.请求URL：rest服务请求地址,对应XXXServiceResource.java的mapping配置中的value

@RequestMapping(value = "treeData", method = RequestMethod.GET))

3.其中GET请求只包含了请求方式和请求的URL，返回的结果以json格式返回给客户端

3) POST、DELETE、UPDATE方式调用服务

 

说明：

1.请求方式选择POST、DELETE、UPDATE(这里以保存收藏功能为例（PUT请求），对应每个服Resource中的@RequestMapping(value = "save",method = RequestMethod.PUT))

2.Json参数： 其中POST、DELETE、UPDATE可能传递参数经过json，也可能经过路径直接拼接参数，这边以传递json到服务端为实例，对应服务端代码：

public JSONObject save(@RequestBody JSONObject obj,BookmarkTag bookmarkTag) {

3.请求URL：rest服务请求地址,对应XXXServiceResource.java的mapping配置中的value

@RequestMapping(value = " save",method = RequestMethod.PUT))

4.返回的结果以json格式返回给客户端

5.  服务列表（仅仅列举实例）

1)添加标签

 

2)删除标签

 

3)更新标签

 

4)获取标签列表

欢迎你们一块儿学习研究相关技术愿意了解框架技术或者源码的朋友直接求求2042849237

更多详细源码参考来源：http://minglisoft.cn/technology