浅谈RESTful架构

图片来自网络 - REST所继承的架构风格约束

一、现如今我了解到的有这三种基于网络应用的架构风格：

• 1、RPC架构风格：SOAP就是RPC风格的一种架构。过程是动词性的（做某件事），因此RPC建模是以动词为中心的。

• 2、分布式对象架构风格

• 3、REST架构风格：将服务器抽象为一组离散资源的集合。REST建模是以名词为中心的。

我对REST架构的理解就是将所有的服务对象都看成一个个的资源文件，我们在定义URL或URI时，直接以资源名访问。简单地说：每一个URI代表一种资源；客户端通过四个HTTP动词，对服务器端资源进行操作，实现"表现层状态转化"。

二、REST

图片来自网络 - REST架构风格

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资源：

1. 控制器可以处理所有的HTTP方法，主要包括GET、PUT（PATCH）、DELETE、POST
2. 借助@PathVariable可以将参数作为URL的一部分
3. 借助视图解析器，资源能够以多种方式进行表述，包括将模型渲染为XML、JSON等。
4. 可以使用ContentNegotiatingViewResolver来选择最适合客户端的表示层。
5. 借助@ResponseBody注解和各种HttpMessageConverter来替换基于视图的渲染方案。
6. 借助RestTemplate可以让Spring应用方便的使用REST资源。

五、想要深入了解REST架构可以去一下文章：

1、理解本真的REST架构风格
2、Architectural Styles and the Design of Network-based Software Architectures

六、简单Java代码示例

首先配置一个消息转换器

<!-- 消息转换器 -->
    <mvc:annotation-driven>
        <mvc:message-converters>
            <bean class="org.springframework.http.converter.json.MappingJackson2HttpMessageConverter"/>
            <bean class="org.springframework.http.converter.StringHttpMessageConverter"/>
            <bean class="org.springframework.http.converter.BufferedImageHttpMessageConverter"/>
        </mvc:message-converters>
    </mvc:annotation-driven>

还得在项目的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>

剩下的交给controller

package com.qfedu.ssm.controller;

import java.util.List;

import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.web.bind.annotation.DeleteMapping;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.PathVariable;
import org.springframework.web.bind.annotation.PostMapping;
import org.springframework.web.bind.annotation.PutMapping;
import org.springframework.web.bind.annotation.RestController;

import com.qfedu.ssm.biz.BookService;
import com.qfedu.ssm.entity.Book;
import com.qfedu.ssm.entity.BookType;

@RestController
public class BookController {
    
    @Autowired
    private BookService bookService;
    
    @GetMapping("/book/type/{id}")
    public List<Book> showBooksWithType(@PathVariable("id") int typeId) {
        return bookService.getBooksByType(new BookType(typeId));        
    }
    
    @DeleteMapping("/book/{id}")
    public String deleteWithId(@PathVariable int id) {
        return bookService.removeBookById(id) ? 
                "搞定" : "崩了" ;
    }

    @GetMapping("/book/{id}")
    public Book showBookWithId(@PathVariable int id) {
        return bookService.getBookById(id);
    }

这只是一个简单的实验，使用那个rest架构风格的URI访问资源。