REST接口设计
REST接口设计
##为什么要有REST
在传统上,软件和网络是两个不同的领域,很少有交集;软件开发主要针对单机环境,网络则主要研究系统之间的通信。互联网的兴起,使得这两个领域开始融合,现在我们必须考虑,如何开发“在互联网环境中使用的软件”。RESTful架构,就是目前最流行的一种互联网软件架构。
Web,iOS,Android 作为同等公民调用服务器提供的 API,各自有着各自实现方式。如图
REST的解释
Representational State Transfer (资源表现层状态转化)
资源(Resources)
网络上的一个具体信息。它可以是一段文本、一张图片、一首歌曲、一种服务。你可以用一个URI指向它,每种资源对应一个特定的URI。要获取这个资源,访问它的URI就可以,因此URI就成了每一个资源的地址或独一无二的识别符。
"上网",就是与互联网上一系列的"资源"互动,调用它的URI。
表现层(Representation)
"资源"具体呈现出来的形式
比如,文本可以用txt格式表现,也可以用HTML格式、XML格式、JSON格式表现,甚至可以采用二进制格式;图片可以用JPG格式表现,也可以用PNG格式表现。
状态转换(State Transfer)
访问一个网站,就代表了客户端和服务器的一个互动过程。在这个过程中,势必涉及到数据和状态的变化。
因此,如果客户端通过"某种手段"操作服务器,服务器端就会发生"状态转化",而这种转化是建立在表现层之上的。具体实例中的"某种手段",就是HTTP协议(里面四个表示操作方式的动词:GET、POST、PUT、DELETE。它们分别对应四种基本操作:GET用来获取资源,POST用来新建资源,PUT用来更新资源,DELETE用来删除资源。
总结一下RESTful架构:
一个URI代表一种资源;
客户端和服务器之间,传递的是这种资源的某种表现层;
客户端通过“某种手段”,对服务器端资源进行操作,实现"状态转化"。
这是一组架构约束条件和原则,不是一种标准,不这么做你也可以完成任务,只不过你的接口得不到应有的好处。
举个例子
####获取用户信息
访问地址:
http://domian/restapi/user.json?id=1
http://domian/restapi/user/1.json
http://domian/restapi/user.json?name=foo&addr=bar
访问方法:HTTP GET
返回格式:
{
"id": 1,
"name": "Jack",
"addr": "block"
}
增加用户信息
访问方法:HTTP POST
发送数据:
{
"name": "Jack1",
"addr": "block1"
}
返回格式:
{
"id": 2,
"name": "Jack1",
"addr":"block1"
}
修改用户信息
访问地址:
http://domian/restapi/user.json?id=1
http://domian/restapi/user/1.json
http://domian/restapi/user.json?name=foo&addr=bar
访问方法:HTTP PUT
发送数据:
{
"id": 2,
"addr":"bar2"
}
返回格式:
{
"id": 2,
"name": "Jack1",
"addr":"bar2"
}
删除用户信息
访问地址:
http://domian/restapi/user.json?id=1
http://domian/restapi/user/1.json
http://domian/restapi/user.json?name=foo&addr=bar
访问方法:HTTP DELETE
返回格式:
{
"detail": "....."
}
最新文章
- C/C++: C++变量和基本类型
- make 和 makefile 的关系
- NSDecimalNumber用于精度准确的计算
- js时间倒计时
- 泥泞的道路(codevs 1183)
- cocos2dx 搭建 android 平台 -2
- 如何通过 jQuery text() 和 html()
- 跟随屏幕滚动层、遮罩层、获取Div相对定位、整个屏幕、html文档的jquery基本操作
- php构造函数construct用法注意事项
- Fragment详解
- JVM内存模型以及垃圾收集策略解析
- codeforce --- 340D
- JAVA 对象内存分析
- [LeetCode]题解(python):095-Unique Binary Search Trees II
- mybatis 批量插入值的sql
- 磁盘阵列raid类型及含义
- 家庭记账本小程序之删(java web基础版四)
- redis各类错误可能的解决方案
- jmeter csv中获取带引号的数据详情
- Sring 类的例子