Restful levels and Hateoas
Levels的意义
Level 1 解释了如何通过分治法(Divide and Conquer)来处理复杂问题,将一个大型的服务端点(Service Endpoint)分解成多个资源。
Level 2 引入了一套标准的动词,用来以相同的方式应对类似的场景,移除不要的变化。
Level 3 引入了可发现性(Discoverability),它可以使协议拥有自我描述(Self-documenting)的能力。
这一模型帮助我们思考我们想要提供的HTTP服务是何种类型的,同时也勾勒出人们和它进行交互时的期望。
应用分析
一、REST描述的是在网络中client和server的一种交互形式;REST本身不实用,实用的是如何设计 RESTful API(REST风格的网络接口);
二、Server提供的RESTful API中,URL中只使用名词来指定资源,原则上不使用动词。“资源”是REST架构或者说整个网络处理的核心。
URL定位资源,用HTTP动词(GET,POST,DELETE,DETC)描述操作。
1、看Url就知道要什么
2、看http method就知道干什么
3、看http status code就知道结果如何
比如:
http://api.qc.com/v1/newsfeed: 获取某人的新鲜;
http://api.qc.com/v1/friends: 获取某人的好友列表;
http://api.qc.com/v1/profile: 获取某人的详细信息;
三、用HTTP协议里的动词来实现资源的添加,修改,删除等操作。即通过HTTP动词来实现资源的状态扭转:
GET 用来获取资源,
POST 用来新建资源(也可以用于更新资源),
PUT 用来更新资源,
DELETE 用来删除资源。
比如:
DELETE http://api.qc.com/v1/friends: 删除某人的好友 (在http parameter指定好友id)
POST http://api.qc.com/v1/friends: 添加好友
UPDATE http://api.qc.com/v1/profile: 更新个人资料
四、Server和Client之间传递某资源的一个表现形式,比如用JSON,XML传输文本,或者用JPG,WebP传输图片等。当然还可以压缩HTTP传输时的数据(on-wire data compression)。
五、用 HTTP Status Code传递Server的状态信息。比如最常用的 200 表示成功,500 表示Server内部错误等。
HATEOAS:HATEOAS代表“超媒体作为应用程序状态的引擎”
它是一个复杂的缩写。
你在访问网页时看到了什么?
您想要查看的数据。这就是全部?您还会看到链接和按钮以查看相关数据。
例如,如果你去学生页面,你会看到
- 学生档案
- 编辑和删除学生详细信息的链接
- 链接以查看其他学生的详细信息
- 链接以查看学生的课程和成绩的详细信息
HATEOAS为RESTful Web服务带来了相同的概念。
当请求资源的某些详细信息时,您将提供资源详细信息以及相关资源的详细信息以及您可以对资源执行的可能操作。例如,在请求有关facebook用户的信息时,REST服务可以返回以下内容
- 用户详情
- 获取最近帖子的链接
- 得到他最近评论的链接
- 检索他朋友列表的链接。