文档章节

JEESZ REST服务接口文档

 惜0623
发布于 2017/05/05 14:38
字数 1606
阅读 10
收藏 0

目    录

  • 1、     引言..........................................................................................................
  • 1.1、  REST介绍................................................................................................
  • 1.2、  编写目的…………………………………………………………………………...
  • 1.3、  编写原则..................................................................................................
  • 1.4、  变更历史..................................................................................................
  • 2、     服务使用说明
  •  2.1、 当前系统已经提供的服务…………………………………………………....
  •  2.2、 GET方式调用服务………………………………………………………………
  •  2.3、  POST方式调用服务…………………………………………………………...
  • 3、      我的收藏服务列表................................................................................
  • 3.1、   添加标签分类.........................................................................................
  • 3.2、   删除分类标签........................................................................................
  • 3.3、   更新分类标签........................................................................................

 

1、            引言

1.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 )的使用减少了序列化和反序列化过程的复杂性,并且不再需要其他作用相同的第三方库。

 

1.2、   编写目的

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

1.3、   编写原则

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

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

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

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

连通性(Connectedness任何基于 REST 的系统都应该预见到客户机需要访问相关的资源,应该在返回的资源具象中包含这些资源。例如,可以以超链接的形式包含特定 RESTful 服务的操作序列中的相关步骤,让客户机可以根据需要访问它们。基于 REST 的 Web 服务日益成为后端企业服务集成的

1.4、   变更历史

序号

变更人员

变更时间

变更内容

1

Jeesz

 2014-10-02

我的收藏服务3.1、3.2、4.3、5.4(仅仅以我的收藏部分服务为实例),用户根据自己的业务编写相关的服务文档即可

 

2、      服务使用说明

2.1、 当前系统已经提供的服务

2.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格式返回给客户端

2.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格式返回给客户端


3、      服务列表(这边以我的收藏服务为例)

 

3.1、 添加标签分类

 

请求方式

PUT

服务URL

http://localhost:8080/jeesz-service-web/rest/bookmark/save

路径参数?*描述

参数类型(Type)

application/json

参数描述

{“name”:”jeesz”}

备注:

name:标签名称

返回值类型(Type)

application/json

描述

添加成功:

{result:”添加成功”,

”name”:”jeesz”,” bookmarkTagId”:”123456789”}

提示:返回结果由用户根据自己的业务去扩充


3.2、 删除分类标签

 

请求方式

DELETE

服务URL

/bookmark/delete? bookmarkTagId =xxxx

路径参数?*描述

bookmarkTagId:分类标签id

参数类型(Type)

String

返回值类型(Type)

application/json

描述

添加成功:{“result”:”删除成功”}

提示:返回结果由用户根据自己的业务去扩充

 

3.3、 更新分类标签

请求方式

POST

服务URL

/bookmark/update

路径参数?*描述

参数类型(Type)

application/json

参数描述

{“id”:”标签id”,“name”:”标签name”}

备注:

id:标签id

name:标签名称

返回值类型(Type)

application/json

描述

添加成功:{“result”:”更新成功”}

提示:返回结果由用户根据自己的业务去扩充

 

3.4、 获取分类标签列表

请求方式

GET

服务URL

/bookmark/list?pageNo=1&pageSize=3

路径参数?*描述

pageNo:当前页

pageSize:每页显示多少条

参数类型(Type)

参数描述

通过request获取参数(根据自己的业务,可以通过其他方式获取,如路径参数?*、路径拼接参数等)

返回值类型(Type)

application/json

描述

 

{"pageNo":1,"pageSize":1,"count":42,

"list":[{"id":"de0163b614b34c0ba99590e8e63b9e3e",

"isNewRecord":false,"createDate":"2016-02-28 21:40:36","updateDate":"2016-02-28 21:40:36","bookmarktagname":"jeesz"}]

想了解更多详细请点击源码地址获取mingli

有兴趣的朋友们可以前往球球哦~一起分享学习技术:2042849237

© 著作权归作者所有

粉丝 1
博文 44
码字总数 73777
作品 0
惠州
私信 提问
JEESZ分布式框架简介---技术介绍文档

摘要: Jeesz主要定位于互联网企业架构,已内置企业信息化系统的基础功能和高效的代码生成工具,包括:系统权限组件、数据权限组件、数据字典组件、核心工具 组件、视图操作组件、工作流组件、...

qq593e3b758e013
2017/06/12
0
0
JEESZ分布式框架--技术介绍文档

摘要: 1.Eclipse IDE:采用Maven项目管理,模块化。 2.代码生成:通过界面方式简单配置,自动生成相应代码,目前包括三种生成方式(增删改查):单表、一对多、树结构。生成后的代码如果不需...

qq592fbb5b34ad7
2018/07/02
0
0
JEESZ分布式框架--技术介绍文档

摘要: 1.Eclipse IDE:采用Maven项目管理,模块化。 2.代码生成:通过界面方式简单配置,自动生成相应代码,目前包括三种生成方式(增删改查):单表、一对多、树结构。生成后的代码如果不需...

qq592fbb5b34ad7
2018/07/02
0
0
JEESZ分布式架构平台介绍

1. 项目核心代码结构截图 jeesz-utils jeesz-config jeesz-framework jeesz-core-cms

愉快的鱼儿
2017/06/12
0
0
SSM组合+ springmvc+mybatis+shiro+restful+bootstrap

介绍 1. 项目核心代码结构截图 jeesz-utils jeesz-config jeesz-framework jeesz-core-cms

qq59225f73c290b
2017/05/22
0
0

没有更多内容

加载失败,请刷新页面

加载更多

入坑-双鹰咔哒C61016保时捷919赛车积木

原帖于ZDM首发 https://post.smzdm.com/p/amm53q8k/ 前几天 无意中逛ZDM 发现有条好价, C61016 标准版(无动力组件)狗东店家双十一活动, 原价249元, 现价219元, 还有199-100专享卷.到手119. ...

云逸清风
29分钟前
5
0
Centos7安装Redis5

一、安装gcc依赖 由于 redis 是用 C 语言开发,安装之前必先确认是否安装 gcc 环境(gcc -v),如果没有安装,执行以下命令进行安装 [root@localhost local]# yum install -y gcc  二、下载...

小致Daddy
30分钟前
5
0
软件开发和用户体验结合——Cresense和Symbio达成战略合作伙伴关系

软件开发和质量保证公司Symbio和用户体验设计机构Cresense达成战略合作伙伴关系。通过创新的软件开发和用户体验结合,打造以客户为核心的优质服务。 Symbio与Cresense已经合作多年。联合技术...

symbiochina88
36分钟前
5
0
Sass 简介

概念 Sass由hampton catlin设计,natalie weizenbaum于2006年开发,它可以免费下载和使用。 Sass是一个将脚本解析成CSS的脚本语言(SassScript),也是一款CSS预处理器,它减少了CSS的重复,...

凌兮洛
38分钟前
5
0
Java自学指南五、编码工具

工欲善其事,必先利其器... 想要高效率编码输出和快速处理文本,需要 熟悉编程语言的语法 盲打 至少需要熟练使用一种文本编辑器 至少熟练熟练使用一种 IDE (集成开发环境) 现实中,看到过二指...

ConstXiong
今天
6
0

没有更多内容

加载失败,请刷新页面

加载更多

返回顶部
顶部