- Rest关键词解释
- REST概念
- REST遇到的问题及示例
- 总结
一. Rest关键词解释
- REST(Representational State Transfer):表述性状态转移
- Rest是web服务的一种架构风格,一种轻量级,跨平台,跨语言的架构设计;
二. Rest概念
在RESTful架构中,每个网址代表一种资源(resource),所有网址请求接口中不能有动词,只能有名词,这点和数据库设计风格很像。
那么可能有同学会问了?动词怎么来表示呢?
常用的HTTP动词有五个,对应sql中命令。也就是说我们定义接口url中一般不会出现动词,都是使用名词,而动词使用HTTP请求方式来表示。
- GET(SELECT):从服务器取出资源(一项或多项)。
- POST(CREATE):在服务器新建一个资源。
- PUT(UPDATE):在服务器更新资源(客户端提供改变后的完整资源)。
- PATCH(UPDATE):在服务器更新资源(客户端提供改变的属性)。
- DELETE(DELETE):从服务器删除资源。
三. REST遇到的问题
复数形式怎么表示?
- https://api.example.com/v1/zoos
- https://api.example.com/v1/animals
- https://api.example.com/v1/employees
版本怎么表示(演示中我们参考github的风格)?
其实一般互联网技术类公司都有自己的风格,这个参考就好
- https://developer.github.com/v3/media/#request-specific-version (Github采用这种做法)
例子
- GET /zoos:列出所有动物园
- POST /zoos:新建一个动物园
- GET /zoos/ID:获取某个指定动物园的信息
- PUT /zoos/ID:更新某个指定动物园的信息(提供该动物园的全部信息)
- PATCH /zoos/ID:更新某个指定动物园的信息(提供该动物园的部分信息)
- DELETE /zoos/ID:删除某个动物园
- GET /zoos/ID/animals:列出某个指定动物园的所有动物
- DELETE /zoos/ID/animals/ID:删除某个指定动物园的指定动物