浅谈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访问资源。

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 159,835评论 4 364
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 67,598评论 1 295
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 109,569评论 0 244
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 44,159评论 0 213
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 52,533评论 3 287
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 40,710评论 1 222
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 31,923评论 2 313
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 30,674评论 0 203
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 34,421评论 1 246
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 30,622评论 2 245
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 32,115评论 1 260
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 28,428评论 2 254
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 33,114评论 3 238
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 26,097评论 0 8
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 26,875评论 0 197
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 35,753评论 2 276
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 35,649评论 2 271

推荐阅读更多精彩内容

  • Spring Cloud为开发人员提供了快速构建分布式系统中一些常见模式的工具(例如配置管理,服务发现,断路器,智...
    卡卡罗2017阅读 134,100评论 18 139
  • 一说到REST,我想大家的第一反应就是“啊,就是那种前后台通信方式。”但是在要求详细讲述它所提出的各个约束,以及如...
    时待吾阅读 3,339评论 0 19
  • 越来越多的人开始意识到,网站即软件,而且是一种新型的软件。 这种"互联网软件"采用客户端/服务器模式,建立在分布式...
    产码Shelby阅读 286评论 0 0
  • 越来越多的人开始意识到,网站即软件,而且是一种新型的软件。这种"互联网软件"采用客户端/服务器模式,建立在分布式体...
    灬感同身受灬阅读 218评论 0 0
  • 《转》,非原创 越来越多的人开始意识到,网站即软件,而且是一种新型的软件。 这种"互联网软件"采用客户端/服务器模...
    原军锋阅读 282评论 0 0