RestfulApi接口规范

Restful Api介绍:

        1.rest:英文名representational state transfer直译为表现层状态转移，或者表述性状态转移；

        2.Rest是web服务的一种架构风格,一种设计风格一种思想;同时Rest不是针对某一种编程语言的.

        3.Restful:用URL定位资源,用http动词(GET,POST,PUT,DETELE)描述操作.用http STATUS/CODE定义操作结果.

以webService为例通俗易懂解释

非Rest设计,我们一般写为:

            以不同的URL动词进行不同的操作            

（查询用户）http://localhost:8080/admin/getUser 

（新增用户）http://localhost:8080/admin/addUser 

（更新用户）http://localhost:8080/admin/updateUser

（删除用户）http://localhost:8080/admin/deleteUser 

Rest架构:

   URL只指定资源,以HTTP方法动词进行不同的操作.用HTTP STATUS/CODE操作结果    

 GET http://localhost:8080/admin/user （查询用户）

 POST http://localhost:8080/admin/user （新增用户）

 PUT http://localhost:8080/admin/user （更新用户）

 DELETE http://localhost:8080/admin/user （删除用户）

总结:Restful：遵守了rest风格的web服务便可称为Restful。

为什么需要Restful?

1.从以上方式可以看出遵守rest风格的web服务URL具有很强的可读性,具有自描述性,你也不想写URL的时候一些就是一大堆吧

2.规范化请求过程和返回结果

3.资源描述和视图的松耦合

.

4.可提供OpenApi,便于第三方系统集成,提高交互性

.

5.提供无状态的服务接口,降低复杂度,可提高应用的水平扩展性