十次方前端系统开发v1.0--第2章.pdf

第2章 A PI文档与模拟数据接口 学习目标： 理解RESTful架构 运用Swagger编写A PI文档 掌握Mock.j s基本语法 运用easy Mock实现模拟接口的编写 1 RESTful 1.1 什么是RESTful架构 ​ RESTful架构，就是目前最流行的一种互联网软件架构。它结构清晰、符合标准、易 于理解、扩展方便，所以正得到越来越多网站的采用。REST这个词，是Roy Thomas Fielding在他2000年的博士论文中提出的 北京市昌平区建材城西路金燕龙办公楼一层 电话：400-618-9090 ​ Fielding是一个非常重要的人，他是HTT P协议 （1.0版和1.1版）的主要设计者、 A pache服务器软件的作者之一、A pache基金会的第一任主席。所以，他的这篇论文一经 发表，就引起了关注，并且立即对互联网开发产生了深远的影响。 ​ Fielding将他对互联网软件的架构原则，定名为REST ，即Representational State Transfer的缩写。我对这个词组的翻译是表现层状态转化。如果一个架构符合REST原 则，就称它为RESTful架构。 1.2 理解RESTful架构 要理解RESTful架构，最好的方法就是去理解Representational State Transfer这个 词组到底是什么意思，它的每一个词代表了什么涵义。 （1）资源 （Resources ） REST 的名称表现层状态转化中，省略了主语。表现层其实指的是资 源 （Resources ）的表现层。 所谓资源，就是网络上的一个实体，或者说是网络上的一个具体信息。它可以是一段 文本、一张图片、一首歌曲、一种服务，总之就是一个具体的实在。你可以用一个 URI （统一资源定位符）指向它，每种资源对应一个特定的URI。要获取这个资源，访问 它的URI就可以，因此URI就成了每一个资源的地址或独一无二的识别符。 所谓上网，就是与互联网上一系列的资源互动，调用它的URI。 （2 ）表现层 （Representation） 资源是一种信息实体，它可以有多种外在表现形式。我们把资源具体呈现出来的形 式，叫做它的表现层 （Representation）。 比如，文本可以用txt格式表现，也可以用HT ML格式、X ML格式、J SON格式表现，甚至 可以采用二进制格式；图片可以用J PG格式表现，也可以用PNG格式表现。 URI只代表资源的实体，不代表它的形式。严格地说，有些网址最后的.html后缀名是不 必要的，因为这个后缀名表示格式，属于表现层范畴，而URI应该只代表资源的位 置。它的具体表现形式，应该在HTT P请求的头信息中用Accept和Content-Type字段指 定，这两个字段才是对表现层的描述。 （3 ）状态转化 （State Transfer） 北京市昌平区建材城西路金燕龙办公楼一层 电话：400-618-9090 访问一个网站，就代表了客户端和服务器的一个互动过程。在这个过程中，势必涉及到 数据和状态的变化。 互联网通信协议HTT P协议，是一个无状态协议。这意味着，所有的状态都保存在服务器 端。因此，如果客户端想要操作服务器，必须通过某种手段，让服务器端发生状态转 化 （State Transfer）。而这种转化是建立在表现层之上的，所以就是表现层状态转 化。 客户端用到的手段，只能是HTT P协议。具体来说，就是HTT P协议里面，四个表示操作方 式的动词：GET 、POST 、PUT 、DELET E。它们分别对应四种基本操作：GET用来获取资 源，POST用来新建资源 （也可以用于更新资源），PUT用来更新资源，DELETE用来删 除资源。 综合上面的解释，我们总结一下什么是RESTful架构：