您的当前位置:首页正文

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

2022-06-15 来源:知库网

设计表述

客户端所关心的资源是一个抽象的实体,它是用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 基于表述的交换,对于错误来说也是如此,当服务器发生错误时,都会返回一个反映错误在的表述。

显示全文