JEESZ RestFul服务介绍

美好部落

1. REST介绍

RESTful Web 服务的关键特点是明确使用 HTTP 方法来表示不同的操作的调用。

POST - 创建资源

PUT – 更新资源

REST 服务的主要优势在于：

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

2. 编写目的

3. 编写原则

REST 中的所有东西都基于资源 的概念。资源与 OOP 中的对象或其他名词不同，它是一种抽象，必须可以通过 URI 寻址或访问。

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

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

客户机总是与资源的某种具象交互，绝不会直接与资源本身交互。同一资源还可以有多个具象。理论上说，持有资源的具象的任何客户机应该有操纵底层资源的足够信息。

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

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

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

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

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

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

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

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

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

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