[成都|]JAVA-|2020年05月27日的日报-技能树.IT修真院

发表于： 2020-05-27 22:52:55

1 1624

今天完成的事情：今天办理入学，然后了解下restful风格，规划了任务二的安排。
明天计划的事情：明天继续学SpringMVC
遇到的问题：暂无
收获：

1.RESTful架构

如果一个架构符合REST（表现层状态转化）原则，就称它为RESTful架构。

"表现层"其实指的是"资源"（Resources）的"表现层"，把"资源"具体呈现出来的形式，叫做它的"表现层"（Representation）。比如，文本可以用txt格式表现，也可以用HTML格式、XML格式、JSON格式表现，甚至可以采用二进制格式；图片可以用JPG格式表现，也可以用PNG格式表现。

所谓"资源"，就是网络上的一个实体，或者说是网络上的一个具体信息。它可以是一段文本、一张图片、一首歌曲、一种服务，总之就是一个具体的实在。你可以用一个URI（统一资源定位符）指向它，每种资源对应一个特定的URI。要获取这个资源，访问它的URI就可以，因此URI就成了每一个资源的地址或独一无二的识别符。

所谓"上网"，就是与互联网上一系列的"资源"互动，调用它的URI。这句话很直白解释，比较喜欢

状态转化：访问一个网站，此时客户端和服务器会有一个交互过程，这中间的数据和状态的变化。

客户端是通过HTTP无状态协议进行传输，会有GET,POST,PUT,DELETE操作方式，服务器则通过状态的转化进行响应。

（1）每一个URI代表一种资源；

（2）客户端和服务器之间，传递这种资源的某种表现层；

（3）客户端通过四个HTTP动词，对服务器端资源进行操作，实现"表现层状态转化"。

2..接口规范参照了师兄的博客。后面自己动手写。

https://blog.csdn.net/qq_26892215/article/details/81985784

接口文档内容：

1.接口功能
2.接口路径
3.接口入参
4.接口出参
5.各字段说明、约定值、是否必填、默认参数
6.复杂数据结构给出出范例

1）URL不能是动词，应该是名词，动词应该放在HTTP中

错误的URL: POST /accounts/1/transfer/500/to/2

正确的URL：POST /transaction HTTP/1.1
　　 Host: 127.0.0.1
　　
　　 from=1&to=2&amount=500.00

2）HTTP动词

GET（SELECT）：从服务器取出资源（一项或多项）。
POST（CREATE）：在服务器新建一个资源。
PUT（UPDATE）：在服务器更新资源（客户端提供改变后的完整资源）。
PATCH（UPDATE）：在服务器更新资源（客户端提供改变的属性）。
DELETE（DELETE）：从服务器删除资源。

3）过滤信息

如果记录数量很多，服务器不可能都将它们返回给用户。API应该提供参数，过滤返回结果。

下面是一些常见的参数。

?limit=10：指定返回记录的数量
?offset=10：指定返回记录的开始位置。
?page=2&per_page=100：指定第几页，以及每页的记录数。
?sortby=name&order=asc：指定返回结果按照哪个属性排序，以及排序顺序。
?animal_type_id=1：指定筛选条件

4）状态码，4**是客户端的，5**是服务器的