【科普】RestFul服务基本介绍

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)获取标签列表

-----------------------------------------------------------------------

完整的项目源码来源  欢迎大家一起学习研究相关技术,源码获取请加求求:2670716182

原文地址:https://www.cnblogs.com/didida/p/9234591.html

时间: 2024-11-07 07:50:39

【科普】RestFul服务基本介绍的相关文章

RestFul服务介绍--JEESZ

1. REST介绍 REpresentational State Transfer (REST) 是一种架构原则,其中将 web 服务视为资源,可以由其 URL 唯一标识. RESTful Web 服务的关键特点是明确使用 HTTP 方法来表示不同的操作的调用. REST 的基本设计原则对典型 CRUD 操作使用 HTTP 协议方法: POST - 创建资源 GET - 检索资源 PUT – 更新资源 DELETE - 删除资源 REST 服务的主要优势在于: 它们是跨平台 (Java..net

RestFul服务介绍

1. REST介绍 REpresentational State Transfer (REST)是一种架构原则,其中将web服务视为资源,可以由其URL唯一标识. RESTful Web服务的关键特点是明确使用HTTP方法来表示不同的操作的调用. REST的基本设计原则对典型CRUD操作使用HTTP协议方法: POST -创建资源 GET -检索资源 PUT–更新资源 DELETE -删除资源 REST服务的主要优势在于: 它们是跨平台(Java..net.PHP等)高度可重用的,因为它们都依赖

jeesz分布式架构-RestFul服务

摘要: REpresentational State Transfer (REST) 是一种架构原则,其中将 web 服务视为资源,可以由其 URL 唯一标识. RESTful Web 服务的关键特点是明确使用 HTTP 方法来表示不同的操作的调用. REST 的基本设计原则对典型 CRUD 操作使用 HTTP 协议方法: POST - 创建资源 GET - 检索资源 PUT – 更新资源 DELETE - 删除资源 REST 服务的主要优势在于: 1. REST介绍 REpresentatio

使用ASP.Net WebAPI构建REST-ful 服务(一)——简单的示例

由于给予REST的Web服务非常简单易用,它越来越成为企业后端服务集成的首选方法.本文这里介绍一下如何通过微软的Asp.Net WebAPI快速构建REST-ful 服务. 首先创建一个Asp.Net Web应用程序(我这里用的是Visual Studio 2013,它已经内置了Web API2). 在出来的模板中选择Empty(空项目),并勾选WebAPI.点击确定后,就创建了一个空的WebAPI服务. 此时只有一个空项目,还没有任何功能,在进行下一步之前,首先我们来看一下REST的基本操作模

用 NetBeans 快速开发 Java JAX-RS RESTful 服务

有很多IDE可以开发Java RESTful服务,Eclipse.NetBeans等,个人偏好使用NetBeans,本文介绍使用NetBeans开发的入门步骤. <理解RESTful架构>.<RESTful API 设计指南>.<RESTful API 设计最佳实践>这三篇文章是介绍RESTful架构比较经典的文章,推荐对RESTful有兴趣的可以读一下. 我也整理的阅读笔记在GitHub上:https://github.com/yulongyz/Reading/blo

Maven + Jetty + Jersey搭建RESTful服务

IntelliJ IDEA + Maven + Jetty + Jersey搭建RESTful服务 本文参考以下内容: 使用Jersey实现RESTful风格的webservice(一) Starting out with Jersey & Apache Tomcat using IntelliJ --------------------------------------------------正文------------------------------------------------

RESTful 服务示例

WCF服务轻量级服务,可供JS调用 返回值格式:XML.Json 工程结构: 示例代码: 1 using System; 2 using System.Collections.Generic; 3 using System.Linq; 4 using System.Web; 5 6 namespace RESTfulWebServices 7 { 8 public class UserInfo 9 { 10 public string Name { get; set; } 11 public i

REST,Web 服务,REST-ful 服务

介绍 REpresentational State Transfer (REST) 是一种架构原则,其中将 web 服务视为资源,可以由其 URL 唯一标识.RESTful Web 服务的关键特点是明确使用 HTTP 方法来表示不同的操作的调用. REST 的基本设计原则对典型 CRUD 操作使用 HTTP 协议方法: POST - 创建资源 GET - 检索资源 PUT – 更新资源 DELETE - 删除资源 REST 服务的主要优势在于: 它们是跨平台 (Java..net.PHP 等)高

在ASP.NET Core Web API中为RESTful服务增加对HAL的支持

HAL(Hypertext Application Language,超文本应用语言)是一种RESTful API的数据格式风格,为RESTful API的设计提供了接口规范,同时也降低了客户端与服务端接口的耦合度.很多当今流行的RESTful API开发框架,包括Spring REST,也都默认支持HAL规范,当RESTful API被调用后,服务端就会返回ContentType为application/hal+json的JSON内容,例如: { "_links": { "