文档章节

JEESZ RestFul服务介绍

 浪漫人生
发布于 2017/05/11 11:22
字数 1044
阅读 4
收藏 0

 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

© 著作权归作者所有

粉丝 4
博文 16
码字总数 27689
作品 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
JEESZ分布式框架简介---技术介绍文档

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

qq593e3b758e013
2017/06/12
0
0
JEESZ 分布式架构平台介绍

项目核心代码结构截图 <!-- jeesz 工具jar --> <module>jeesz-utils</module> <!-- jeesz 公共配置jar --> <module>jeesz-config</module> <!-- jeesz 核心框架jar --> <module>jeesz-frame......

明理萝
2018/08/01
0
1
j2ee分布式架构 dubbo + springmvc + mybatis + ehcache + redis 分布式架构

介绍 jeesz-utils jeesz-config jeesz-framework jeesz-core-cms

qq58edeba279279
2018/06/26
0
0

没有更多内容

加载失败,请刷新页面

加载更多

Jenkins系列_插件安装及报错处理

进入Jenkins之后我们可以进行插件的安装,插件管理位于以下模块: 发现上面报了一堆错误,是因为插件的依赖没有安装好,那么这一节,就先把这些错误解决掉吧。解决完成后,也就基本会使用插件...

shzwork
今天
2
0
mysql mysql的所有查询语句和聚合函数(整理一下,忘记了可以随时看看)

查询所有字段 select * from 表名; 查询自定字段 select 字段名 from 表名; 查询指定数据 select * from 表名 where 条件; 带关键字IN的查询 select * from 表名 where 条件 [not] in(元素...

edison_kwok
昨天
9
0
解决多线程并行加载缓存问题(利用guava实现)

依赖 com.google.guava:guava:20.0 import com.google.common.cache.Cache;import com.google.common.cache.CacheBuilder;import java.util.concurrent.ExecutionException;import j......

暗中观察
昨天
3
0
利用VisualVM 内存查看

准备工作,建几个测试类。等下就是要查看这几个类里面的属性 package visualvm;public class MultiObject { private String str; private int i; MultiObject(String str...

冷基
昨天
2
0
组装一台工作游戏两用机

一、配置清单如下: 分类 项目 价格(元) 主板 华硕(ASUS)TUF Z370-PLUS GAMING II 电竞特工 Z370二代 支持9代CPU 1049 CPU 英特尔(Intel) i7 8700K 酷睿六核 盒装CPU处理器 2640 风扇 九...

mbzhong
昨天
4
0

没有更多内容

加载失败,请刷新页面

加载更多

返回顶部
顶部