每天一道Java题[7]

题目

什么是REST原则,请解释RESTful架构,以及其设计思想?

解答

REST,全称为Representation State Transfer,是一种互联网软件的架构原则。凡是满足REST原则的,我们都称它为RESTful架构。

对RESTful架构的理解,有以下几点:

  1. 资源,网络上的一个实体,或者是一个具体的信息。通常使用一个URI来表示一种资源。
  2. Representation,可理解为资源的表现层,资源的具体表现形式。在http请求的头信息Accept和Content-Type字段指定具体表现形式,如application/json
  3. State Transfer,可理解为状态转移,客户端要对服务器资源进行操作,必须通过某种手段,让服务器上的资源发生状态变化,这就是所谓的state Transfer了。通常客户端通过四个HTTP动词(GET、PUT、POST、DELETE),对服务端资源进行操作,实现State Transfer。

理解上述几点,基本就对RESTful架构有了大概的了解了。

RESTful API设计思想关键点如下:

  1. 一定要使用https,不要http重定向
  2. 标明专属api域名或者子目录,如https://www.huangzijian.me/api/
  3. 表明版本号,如https://www.huangzijian.me/api/v1/
  4. 因为每一个URI表示的是一个资源,故路径上应该采用名词来表示,而不要用动词。由于通常情况下均表示一类资源,因此要采用复数,如https://www.huangzijian.me/api/v1/exams
  5. 采用HTTP动词的GET、POST、PUT、DELETE分表表示资源的获取、新增、更新和删除。
  6. 注意服务器向客户端返回的状态码及其提示信息。
  7. 建议传输的数据格式采用JSON。

参考资料

1.RESTful API 设计指南(http://www.ruanyifeng.com/blog/2014/05/restful_api.html)

2.理解RESTful架构(http://www.ruanyifeng.com/blog/2011/09/restful)

上一篇:FTP 上传文件


下一篇:自定义Filter服务