初识REST

REST(表述性状态传递)由Roy Fileding于2000年在他的博士论文中引入。REST是一种分布式系统的设计风格。它不是一个标准而是一系列约束的集合,例如无状态,客户单/服务器关系,以及统一接口等。REST并不一定要和HTTP严格相关,只是大部分的时候和HTTP联系在一起。

REST的原则

  • Resources 暴露在容易理解的目录结构的URI中。
  • Representations 是使用JSON或者是XML来描述数据对象和属性。
  • Messages 显示地使用HTTP方法(例如,GET,POST,PUT和DELETE)。
  • Stateless 和请求交互的服务器不储存客户端的上下文。状态依赖限制和约束伸缩性。客户端持有会话状态。

HTTP方法

使用HTTP方法在请求中映射CRUD(创建,查询,更新,删除)操作。

GET

检索信息。GET请求必须是安全和幂等的,这就意味着无论使用相同的参数重复多少次,请求的结果都是相同的。它们可能会有副作用,但是用户不希望那样,因此他们不能是对系统至关重要的操作。请求也可以是部分的或者是有条件的。

检索ID为1的地址:

GET / addresses/1

POST

使用提供的实体对URI上的资源做一些事情。POST经常被用来创建一个新的实体,但是也可以用来更新一个实体。

创建一个地址:

POST /addresses

PUT

在一个URI上存储一个实体。PUT能够创建一个实体或者是更新一个已经存在的实体。一个PUT请求也是幂等的。幂等性是POST和PUT请求的主要区别。

修改ID为1的地址:

PUT /addresses/1
注意:PUT只替换已经存在的实体。如果只有一个数据元素的子集被提供,那么剩下的部分将会替换成空或者null。

PATCH

只更新URI上实体的指定字段。一个PATCH请求也是幂等的。幂等性是POST和PATCH请求的主要区别。

DELETE

被请求的资源将被移除。然而,资源不必被立刻移除。因此请求可以是异步的或者是长连接的。

删除ID为1的地址:

DELETE /addresses/1

HTTP状态码

状态码决定HTTP请求的结果.

  • 1XX - 信息类
  • 2XX - 成功
  • 3XX - 跳转
  • 4XX - 客户端错误
  • 5XX - 服务器错误

媒体类型

在HTTP请求中HTTP头AcceptContent-Type可以用来描述被发送的或者是被请求的内容。客户端可以设置Acceptapplication/json如果当前请求的响应为JSON格式的话。相反的,设置Content-Typeapplication/xml则告知客户端发送数据的请求是XML格式。

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

推荐阅读更多精彩内容

  • Spring Cloud为开发人员提供了快速构建分布式系统中一些常见模式的工具(例如配置管理,服务发现,断路器,智...
    卡卡罗2017阅读 134,566评论 18 139
  • 一说到REST,我想大家的第一反应就是“啊,就是那种前后台通信方式。”但是在要求详细讲述它所提出的各个约束,以及如...
    时待吾阅读 3,400评论 0 19
  • API定义规范 本规范设计基于如下使用场景: 请求频率不是非常高:如果产品的使用周期内请求频率非常高,建议使用双通...
    有涯逐无涯阅读 2,517评论 0 6
  • REST,直译过来就是“表述性状态传递”。然而,这到底是个什么鬼?它又有什么卵用呢?(写这篇博客的笔者此时有点烦躁...
    Oliver_Le阅读 5,103评论 3 5
  • 原文链接:https://https://howardwchen.com/2017/09/18/talk-abou...
    守望者Howard阅读 6,315评论 1 6