一、REST 的基础知识

我敢打赌这并不是你第一次听到或读到REST这个词。当讨论REST时,有一种常见的错误就是将其视为“基于URL的Web服务”—— 将REST作为另一种类型的RPC机制,只不过是通过简单的HTTP URL来触发。恰好相反,REST 和 RPC 几乎没有任何关系。RPC 是面向服务的,并关注于行为和动作;而REST 是面向资源的,强调描述应用程序的事物和名词。

REST(Representational State Transfer)表述性状态转移,已信息为中心,为了理解REST是什么,我们将它的首字母缩写拆分为不同的构成部分:

表述性(Representational):REST资源实际上可以用各种形式来进行表述,包括XML、JSON(JavaScript Object Notation)甚至HTML——最适合资源使用者的任意形式;
状态(State):当使用REST的时候,我们更关注资源的状态而不是对资源采取的行为;
转移(Transfer):REST涉及到转移资源数据,它以某种表述性形式从一个应用转移到另一个应用。

更简洁地讲,REST就是将资源的状态以最适合客户端或服务端的形式从服务器端转移到客户端(或者反过来)。其实就是,比如我想要 application/json 格式的数据,REST服务就能为我提供JSON格式的数据;我想要 application/xml 格式的数据,REST服务就能为了提供XML格式的数据(或者反过来)。

在REST中,资源通过URL进行识别和定位。至于RESTful URL的结构并没有严格的限制,但是URL应该能够识别资源,而不是简单的发一条命名到服务器上:

Create:POST
Read:GET
Update:PUT或PATCH
Delete:DELETE

tips:实际上,POST请求非幂等性的特点使其成为一个非常灵活的方法,对于无法适应其他HTTP方法的语义的操作,它都能胜任。

二、Spring MVC 构建 REST API

Spring 对 REST 提供了良好的支持,支持以下方式来创建 REST 资源:

  • 控制器可以处理所有的HTTP方法,包含四个主要的REST方法:GET、PUT、DELETE以及POST。
  • 消息转换器(Message conversion)将资源的Java表述形式转换为发送给客户端的表述形式。
  • 借助于 SpringMVC 的一系列注解,构建 REST API
  • 借助 RestTemplate,Spring应用能够方便地使用REST资源。

1、消息转换器(Message conversion)

消息转换(message conversion)提供了一种更为直接的方式,它能够将控制器产生的数据转换为服务于客户端的表述形式。当使用消息转换功能时,DispatcherServlet不再需要那么麻烦地将模型数据传送到视图中。实际上,这里根本就没有模型,也没有视图,只有控制器产生的数据,以及消息转换器(message converter)转换数据之后所产生的资源表述。

Spring 自带了各种各样的转换器,如下使用了 MappingJackson2HttpMessageConverter,并由它转换为返回客户端的JSON表述形式。

    <mvc:annotation-driven>
<!--使用HTTP信息转换器-->
<mvc:message-converters>
<!--读取或写入Resource-->
<bean class="org.springframework.http.converter.ResourceHttpMessageConverter"/>
<!--在JSON和类型化的对象或非类型化的HashMap间互相读取和写入-->
<bean class="org.springframework.http.converter.json.MappingJackson2HttpMessageConverter">
<!--服务端支持返回的资源形式-->
<property name="supportedMediaTypes">
<list>
<value>text/html;charset=UTF-8</value>
<value>application/json;charset=UTF-8</value>
</list>
</property>
</bean>
</mvc:message-converters>
</mvc:annotation-driven>

2、SpringMVC 的 REST 注解

@PathVariable:控制器能够处理参数化的URL(将变量输入作为URL的一部分);
@ResponseBody:告诉Spring跳过正常的模型/视图流程,并使用消息转换器。它将会告知Spring,我们将要返回的对象作为资源发送给客户端,并将其转换为客户端可接受的形式。
@RequestBody:告诉Spring查找一个消息转换器,将来自客户端的资源表述转换为对象。
@RestController:如果在控制器类上使用@RestController来代替@Controller的话,Spring将会为该控制器的所有处理方法应用消息转换功能。我们不必为每个方法都添加@ResponseBody了。
@ResponseStatus:指定返回的状态码。
@ResponseEntity:作为@ResponseBody的替代方案,控制器方法可以返回一个ResponseEntity对象。ResponseEntity中可以包含响应相关的元数据(如头部信息和状态码)以及要转换成资源表述的对象。

    @RequestMapping(
value = "listUserDTO"
, method = RequestMethod.POST
, consumes = "application/json")
public ResponseEntity<UserDTO> saveUserDto(@RequestBody UserDTO userDTO, UriComponentsBuilder ucb) {
UserDTO user = userService.saveUser(userDTO);
HttpHeaders headers = new HttpHeaders();
URI uri = ucb.path("/").path(user.getName()).build().toUri();
headers.setLocation(uri);
ResponseEntity<UserDTO> userDTOResponseEntity = new ResponseEntity<>(user, headers, HttpStatus.CREATED);
return userDTOResponseEntity;
}

三、RestTemplate API

RestTemplate 定义了36种与REST资源交互的形式(其实只有11个独立的方法,10个被重载了3次,另外一个被重载了6次),其中大多数都对应于HTTP的方法。大多数HTTP方法都以三种方法进行了重载:

# 1. 一个使用String作为URL格式,并使用可变参数列表指明URL参数。
# url 参数指定访问的地址, responseType 参数定义该方法的返回类型, urlVariables 参数为 url 中占位符对应的参数。
getForObject (String url, Class responseType, Object... urlVariables): # 2. 一个使用String作为URL格式,并使用Map指明URL参数。
#在该函数中,使用 Map 类型的 urlVariables 替代上面数组形式的 urlVariables,因此使用时在 url 中需要将占位符的名称与 Map 类型中的 key一一对应设置。
getForObject(String url, Class responseType, Map urlVariables): # 3. 一个使用 java.net.URL 作为 URL格式,不支持参数化URL;
# 使用 URI 对象来替代之前的 url和urlVariables 参数使用。
getForObject(URI url, Class responseType)

RestTemplate定义了11个独立的操作,而每一个都有重载,这样一共是36个方法 :

-- postForEntity() :POST数据到一个URL,返回包含一个对象的ResponseEntity,这个对象是从响应体中映射得到的。
-- postForLocation() :POST数据到一个URL,返回新创建资源的URL。
-- postForObject() :POST数据到一个URL,返回根据响应体匹配形成的对象。

# 需要注意的是新增加的 request 参数,该参数可以是一个普通对象,也可以是一个 HttpEntity 对象。
# 如果是一个普通对象,而非 HttpEntity 对象的时候,RestTemplate会将请求对象转换为一个 HttpEntity 对象来处理,其中 Object 就是 request的类型,request内容会被视作完整的body来处理;
# 如果 request 是一个HttpEntity对象,那么就会被当作一个完成的 HTTP 请求对象来处理,这个 request 中不仅包含了 body 的内容, 也包含了 header 的内容。
postForObject(String url, Object request, Class responseType, Map uriVariables)

-- delete() :在特定的URL上对资源执行HTTP DELETE操作。
-- put() :PUT资源到特定的URL。
-- getForEntity() :发送一个HTTP GET请求,返回的ResponseEntity包含了响应体所映射成的对象。
-- getForObject() :发送一个HTTP GET请求,返回的请求体将映射为一个对象。
-- headForHeaders() :发送HTTP HEAD请求,返回包含特定资源URL的HTTP头。
-- optionsForAllow() :发送HTTP OPTIONS请求,返回对特定URL的Allow头信息。
-- exchange() :在URL上执行特定的HTTP方法,返回包含对象的ResponseEntity,这个对象是从响应体中映射得到的。
-- execute() :在URL上执行特定的HTTP方法,返回一个从响应体映射得到的对象。

RestTemplate 的相关操作以及如何使用 SpringMVC创建REST端点可参考:https://github.com/JMCuixy/SpringMvcForRest

SpringMVC 与 REST.的更多相关文章

  1. 【分享】标准springMVC+mybatis项目maven搭建最精简教程

    文章由来:公司有个实习同学需要做毕业设计,不会搭建环境,我就代劳了,顺便分享给刚入门的小伙伴,我是自学的JAVA,所以我懂的.... (大图直接观看显示很模糊,请在图片上点击右键然后在新窗口打开看) ...

  2. Springmvc数据校验

    步骤一:导入四个jar包 <?xml version="1.0" encoding="UTF-8"?> <beans xmlns=" ...

  3. 为什么做java的web开发我们会使用struts2,springMVC和spring这样的框架?

    今年我一直在思考web开发里的前后端分离的问题,到了现在也颇有点心得了,随着这个问题的深入,再加以现在公司很多web项目的控制层的技术框架由struts2迁移到springMVC,我突然有了一个新的疑 ...

  4. 【SSM框架】Spring + Springmvc + Mybatis 基本框架搭建集成教程

    本文将讲解SSM框架的基本搭建集成,并有一个简单demo案例 说明:1.本文暂未使用maven集成,jar包需要手动导入. 2.本文为基础教程,大神切勿见笑. 3.如果对您学习有帮助,欢迎各种转载,注 ...

  5. 快速搭建springmvc+spring data jpa工程

    一.前言 这里简单讲述一下如何快速使用springmvc和spring data jpa搭建后台开发工程,并提供了一个简单的demo作为参考. 二.创建maven工程 http://www.cnblo ...

  6. redis集成到Springmvc中及使用实例

    redis是现在主流的缓存工具了,因为使用简单.高效且对服务器要求较小,用于大数据量下的缓存 spring也提供了对redis的支持: org.springframework.data.redis.c ...

  7. 流程开发Activiti 与SpringMVC整合实例

    流程(Activiti) 流程是完成一系列有序动作的概述.每一个节点动作的结果将对后面的具体操作步骤产生影响.信息化系统中流程的功能完全等同于纸上办公的层级审批,尤其在oa系统中各类电子流提现较为明显 ...

  8. springMVC学习笔记--知识点总结1

    以下是学习springmvc框架时的笔记整理: 结果跳转方式 1.设置ModelAndView,根据view的名称,和视图渲染器跳转到指定的页面. 比如jsp的视图渲染器是如下配置的: <!-- ...

  9. springMVC初探--环境搭建和第一个HelloWorld简单项目

    注:此篇为学习springMVC时,做的笔记整理. MVC框架要做哪些事情? a,将url映射到java类,或者java类的方法上 b,封装用户提交的数据 c,处理请求->调用相关的业务处理—& ...

  10. springmvc的拦截器

    什么是拦截器                                                         java里的拦截器是动态拦截action调用的对象.它提供了一种机制可以使 ...

随机推荐

  1. 在Docker容器中搭建MXNet/Gluon开发环境

    在这篇文章中没有直接使用MXNet官方提供的docker image,而是从一个干净的nvidia/cuda镜像开始,一步一步部署mxnet需要的相关软件环境,这样做是为了更加细致的了解mxnet的运 ...

  2. Java 使用 Jxl 实现 Excel 导入导出

    开发过程中经常需要用到数据的导入导出功能,之前用的是POI,这次使用JXL,JXL相对于POI来说要轻量简洁许多,在数据量不大的情况下还是非常实用的.这里做一下使用JXL的学习记录.首先需要导入相应的 ...

  3. Javascript高级编程学习笔记(78)—— 表单(6)HTML约束验证API

    自动切换焦点 使用JS可以极大地提升表单的易用性 其中最常用的一种就是当用户填写完当前字段后焦点自动切换到下一个字段 以下方的HTML代码为例: <input type="text&q ...

  4. JavaScript实现input输入框限制输入值的功能

    限制只能输入正整数 <input type="text" onkeyup="if(this.value.length==1){this.value=this.val ...

  5. python 将一个列表去重,并且不打乱它原有的排列顺序

    old_lst = [2, 2, 1, 1, 3, 4] new_lst = list(set(old_lst)) new_lst.sort(key=old_lst.index) print(new_ ...

  6. Spring Boot到底是怎么运行的,你知道吗?

    导读 Spring Boot方式的项目开发已经逐步成为Java应用开发领域的主流框架,它不仅可以方便地创建生产级的Spring应用程序,还能轻松地通过一些注解配置与目前比较流行的微服务框架Spring ...

  7. 【jQuery】(2)---Jquery过滤选择器

                         1.基础选择器: 名称 说明 举例 #id 根据元素Id选择 $("divId") 选择ID为divId的元素 element 根据元素的 ...

  8. [Android 泥水匠] Android基础 之一:浅谈Android架构到HelloWorld案例的剖析

    作者:泥沙砖瓦浆木匠网站:http://blog.csdn.net/jeffli1993个人签名:打算起手不凡写出鸿篇巨作的人,往往坚持不了完成第一章节. 交流QQ群:[编程之美 365234583] ...

  9. .Net和C#介绍

    一.前言 本文主要针对刚入门以及还需要对基础进行恶补一下的兄弟进行基础介绍,并尽可能的做到客观,如有错误也虚心接受高手门的纠正. 二..Net平台简介 .net即DotNet,首先我先给出微软的定义: ...

  10. Win32编程之静态库编写与使用.动态链接库的编写与使用

    Win32编程之静态库编写与使用.动态链接库的编写与使用 一丶什么是静态库.什么是动态链接库. 静态库其实就是解决模块开发的一种解决方案.在以前.我们写代码的时候.每个人都可以独立写一个项目.但是现在 ...