RESTFUL服务中的注意事项

1. POST/PUT/PATCH方法的区别

• POST：新增一个资源，不用携带id
• PUT：新增或完整的更新一个资源，必须要携带id及所有属性，如果没有传递某项属性，则表示删除该属性的值
• PATCH：局部的更新一个资源，必须要携带id及需要修改的属性，如果没有传递某项属性，则表示不改变某项属性的值

特别注意：PUT和PATCH特性的不同，在实现上也有很大区别

在这里思考一种场景：我们需要把一个对象中的部分属性置空，同时改变另一些属性的值，并且我们不希望传递整个对象，该怎么办？

1. 关于PATCH的深入思考，很深刻：
   《在 RESTful API 设计中使用 PATCH 的最佳实践》 ==> 《原文（好像打不开了）》，《译文》

   文章的主要思想：给接口中的每一个参数都配一个字段，用来表示该参数需要进行操作是：新增值，覆盖原值，合并原值，还是删除原值等等。如下图所示，图标来自原文。
   

2. 我的一点思考，为了应对上述场景，可以对接口进行设计：

   • 当某个字段为null时（即没有传递该字段），表示忽略该字段（即不改变原值）；
   • 当某个字段为空（空字符串）时，表示将该字段置null（即删除原值）；
   • 当某个字段不为空时，表示修改该字段。
   • 但是，这样也有问题，接口的所有参数都只能先设为字符串类型，然后在用的时候再进行转换。
   • 另一个问题是，这样一来，想把某个字符串类型的属性保存为空字符串就不可能了，对于一些数据库中有的字符串类型的特殊属性而言，null和空字符串都有意义，都有用。
3. 小结：强行实现这种场景，实际上是对现有的PATCH语义进行了扩充，以实现一种灵活的更新资源的方法。但是我们知道灵活度和复杂度是同生兄弟。灵活度的越高，实现起来越复杂。所以，遵守现有的语义也是一个不错的选择。如果想要对资源进行复杂的跟新操作用PUT，如果只是想简单的更新一些属性用PATCH。