Restful web Services ----第3章 笔记

设计表述

客户端所关心的资源是一个抽象的实体,它是用URI来标识的。另一方面,表述是具体而真实的,你在客户端和服务器上针对它编写代码,进行操作。
HTTP在请求和响应中为表述提供了一种包装格式。设计表述设计:
1.使用HTTP提供的格式包含正确的标头,
2.当表述有正文时,为正文选择合适的媒体类型并设计一种格式。

如何使用实体头来注解表述

表述不仅仅是以某种格式序列化后的数据,它是一连串字节加上用于描述那些字节的元数据。在HTTP中,表述元数据是由使用实体头的名值对来实现的。
使用以下标头来注解包含消息正文的表述:

  • Conent-Type,用于描述表述类型,包含charset 参数或其他针对该媒体类型而定义的参数。
  • Content-Length,用于指定表述正文的字节大小。HTTP1.1支持一种更有效的机制,名为分块转移编码(chuncked transfer encoding)
  • Content-Language,如果您以某种语言对表述进行本地化,用该标头来指定语言。
  • Content-MD5,工具/软件 在处理或存储表述时,可能存在错误,需要提供一致性校验,用该标头来包含一个表述正文的MD5摘要,在进行内容编码(gzip,compress等)之后,转移编码(即chunked)之前计算摘要值。请注意,TCP使用checksum在传输层提供一致性校验。
  • Content-Encoding,当你使用gzip,compress或deflate对表述正文进行编码时,使用该标头。
  • Last-Modified ,用来说明服务器修改表述或资源的最后时间。

HTTP的设计是这样的,发送方可以用一系列名为实体头的标头来描述表述
正文(也称为实体正文或消息正文)。有了这些标头,接收方可以在无须查看正文的情况下决定如何处理正文。它们还可以将解析正文所需要提前了解及猜测的内容减到最小程度。

如何解释实体头

当服务器或客户端接受到表述时,在处理请求前正确地解释实体头是很重要的。本节讨论了如何从所包含的标头中解释表述。

  • Content-Type :接收到不带Content-Type的表述时,客户端将其视为不正确的响应,服务器返回错误码400
  • Content-Length在没有确定接受到的表述不带Transfer-Encoding:chunked前,不要检查Content-Length头是否存在。
  • Content-Encoding 让您的网络库代码来解压那些压缩过的表述。
  • Content-Language 如果存在该标头,读取并存储它的值,记录下所使用的语言。

3.6如何设计JSON表述

在每个表述中,包含一个指向该资源的self链接,对于那些组成资源的应用程序领域实体,在表述中包含它们的标识符。如果表述中的对象是本地化的,添加一个属性来表示本地化内容的语言。

如何设计集合表述

客户端会在集合成员中进行迭代,由于某些集合会包含大量成员资源,客户端需要对集合进行分页或滚动显示,在每个集合表述中包含以下内容:

  • 一个指向集合资源的self链接
  • 如果集合是分页的,并且还有下一页,要有一个指向下一页的链接。
  • 如果集合是分页的,并且还有上一页,要有一个指向上一页的链接。
  • 一个集合大小的指示符

3.11如何在表述中编码二进制数据

使用multipart/mixed,multipart/related 或multipart/alternative这样的分段媒体类型,避免使用Base64编码将二进制数据与文本格式编码在一起。
分段消息让你能把不同格式的数据整合到一个HTTP消息中。一个分段消息包含多个消息部分,由边界进行分割,每个部分都可以包含不同媒体类型的消息。

--abcd
Content-type:application/xml;charset=UTF-8
<movie> ... <./movie>
--abcd
Content-type:video/mpeg
<video></video>
--abcd--

该分段消息有两个部分,一部分包含了一个XML文档,另一部分包含一个视频。
分段媒体类型:
multipart/form-data 把键值对数据与任意媒体类型的数据编码在一起,与您用HTML表单上传文件时的用法一致。
multipart/mixed 分段消息把application/xml表示的电影元数据和video/mpeg表示的视频整合进了一个HTTP消息中
multipart/alternative
multipart/related 当消息的各个部分是互相关联的,而且需要一起处理这些部分时,使用该媒体类型,第一部分是根,可以通过Content-ID头引用其他部分

如何返回错误

HTTP 基于表述的交换,对于错误来说也是如此,当服务器发生错误时,都会返回一个反映错误在的表述。

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

推荐阅读更多精彩内容

  • API定义规范 本规范设计基于如下使用场景: 请求频率不是非常高:如果产品的使用周期内请求频率非常高,建议使用双通...
    有涯逐无涯阅读 2,519评论 0 6
  • Spring Cloud为开发人员提供了快速构建分布式系统中一些常见模式的工具(例如配置管理,服务发现,断路器,智...
    卡卡罗2017阅读 134,596评论 18 139
  • Android 自定义View的各种姿势1 Activity的显示之ViewRootImpl详解 Activity...
    passiontim阅读 171,451评论 25 707
  • 年幼的羊迷失在草原 乐不思蜀的人也会孤单 从五岁到二十五岁,渐渐死亡 并且习惯在深夜呜咽 偶尔仰望繁星,叹息渺小 ...
    一页北风阅读 318评论 2 4
  • 什么是生,什么是死,什么是时间,什么是空间。 伸出颤抖的手,触摸星空,感触时间,空间。 在这里生,在那里灭。 在这...
    我不是君子阅读 232评论 0 1