RESTful架构
概述
REST这个词,是Roy Thomas Fielding在他2000年的博士论文中提出的。Fielding将他对互联网软件的架构原则,定名为REST,即REpresentational State Transfer的缩写,中文通常翻译为"表现层状态转化"。如果一个架构符合REST原则,就称它为RESTful架构。
REST的名称"表现层状态转化"中,省略了主语。"表现层"其实指的是"资源"(Resources)的"表现层"。所谓"资源",就是网络上的一个实体,或者说是网络上的一个具体信息。它可以是一段文本、一张图片、一首歌曲、一种服务,总之就是一个具体的实在。你可以用一个URI(统一资源定位符)指向它,每种资源对应一个特定的URI。要获取这个资源,访问它的URI就可以,因此URI就成了每一个资源的地址或独一无二的识别符。我们在使用互联网时会跟互联网上一系列的"资源"进行互动,具体的形式就是访问资源的URI。
"资源"是一种信息实体,它可以有多种外在表现形式。我们把"资源"具体呈现出来的形式,叫做它的"表现层"(Representation)。比如,文本可以用txt格式表现,也可以用HTML格式、XML格式、JSON格式表现,甚至可以采用二进制格式;图片可以用JPG格式表现,也可以用PNG格式表现。URI只代表资源的实体,不代表它的形式。严格地说,有些网址最后的".html"后缀名是不必要的,因为这个后缀名表示格式,属于"表现层"范畴,而URI应该只代表"资源"的位置。它的具体表现形式,应该在HTTP请求的头信息中用Accept和Content-Type字段指定,这两个字段才是对"表现层"的描述。
访问一个网站,就代表了客户端和服务器的一个互动过程。在这个过程中,势必涉及到数据和状态的变化。互联网通信协议HTTP协议,是一个无状态协议。这意味着,所有的状态都保存在服务器端。因此,如果客户端想要操作服务器,必须通过某种手段,让服务器端发生"状态转化"(State Transfer)。而这种转化是建立在表现层之上的,所以就是"表现层状态转化"。客户端用到的手段,只能是HTTP协议。具体来说,就是HTTP协议里面,四个表示操作方式的动词:GET、POST、PUT(或PATCH)、DELETE。它们分别对应四种基本操作:GET用来获取资源,POST用来新建资源(也可以用于更新资源),PUT(或PATCH)用来更新资源,DELETE用来删除资源。
简单的说RESTful架构就是:每一个URI代表一种资源;客户端通过四个HTTP动词,对服务器端资源进行操作,实现"表现层状态转化"。
Spring对REST的支持
Spring从3.0版本开始通过对Spring MVC的增强对REST提供了良好的支持,在当前的版本中可以通过以下方式来创建REST资源:
- 控制器可以处理所有的HTTP方法,主要包括GET、PUT(PATCH)、DELETE、POST
- 借助@PathVariable可以将参数作为URL的一部分
- 借助视图解析器,资源能够以多种方式进行表述,包括将模型渲染为XML、JSON等。
- 可以使用ContentNegotiatingViewResolver来选择最适合客户端的表示层。
- 借助@ResponseBody注解和各种HttpMessageConverter来替换基于视图的渲染方案。
- 借助RestTemplate可以让Spring应用方便的使用REST资源。
Spring注解
@RestController
支持REST架构
这个注解打过@Controller
和@ResponseBody
Http与服务器交互
方法:
- Get(Select):从服务器取出资源(一项或多项)
- Post(Create):在服务器新建一个资源
- Put(Update):在服务器更新资源(客户端提供改变后的完整资源)
- Patch(Update):在服务器更新资源(客户端提供改变的属性)
- Delete(Delete):从服务器删除资源
浏览器请求
浏览器只能发Get和Post请求。
将Post请求处理成 Delete等 请求
需要将web.xml添加一个过滤器
<filter>
<filter-name>method</filter-name>
<filter-class>org.springframework.web.filter.HiddenHttpMethodFilter</filter-class>
</filter>
<filter-mapping>
<filter-name>method</filter-name>
<url-pattern>/*</url-pattern>
</filter-mapping>
例子1:使用表单
<form id="form" action="" method="post">
<input type="hidden" name="_method" value="DELETE">
Id: <input type="text" name="id" id="bookId">
<input type="submit" value="Delete">
</form>
<script src="js/jquery-1.11.1.min.js"></script>
<script >
$('#form').on('submit', function() {
var id = $('#bookId').val();
$(this).attr('action', 'book/' + id);
});
</script>
例子2:使用js,发生ajax请求
<button id="getBtn">Get</button>
<button id="delBtn">Delete</button>
<form action="book/save" method="post" id="save">
书名: <input type="text" name="name"> <br>
作者: <input type="text" name="author"> <br>
价格: <input type="text" name="price"> <br>
<input type="submit" value="save">
</form>
<script src="js/jquery-1.11.1.min.js"></script>
<script >
$('#delBtn').on('click', function() {
$.ajax({
url: 'book/35',
type: 'POST',
data: {'_method': 'DELETE'},
success: function(data) {
window.alert(data);
}
});
});
$('#getBtn').on('click', function() {
$.getJSON('book/29', function(book) {
window.alert(book.name);
window.alert(book.author);
window.alert(book.price);
});
});
/* $('#save').on('submit', function() {
$(this).attr('action', 'book/save');
}); */
网友评论