公园 - 云代码空间
——
摘要: RESTful Web 服务的关键特点是明确使用 HTTP 方法来表示不同的操作的调用。 REST 的基本设计...
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.请求URLrest服务请求地址,对应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.请求URLrest服务请求地址,对应XXXServiceResource.java的mapping配置中的value
@RequestMapping(value = " save",method = RequestMethod.PUT))
4.返回的结果以json格式返回给客户端
5. 服务列表仅仅列举实例
1)添加标签
2)删除标签
3)更新标签
4)获取标签列表
欢迎大家一起学习研究相关技术愿意了解框架技术或者源码的朋友直接加求求企鹅2042849237
更多详细源码参考来源http://minglisoft.cn/technology