我正在为客户管理系统编写一个RESTful服务，并试图找到部分更新记录的最佳实践。例如，我希望调用者能够使用GET请求读取完整的记录。但是为了更新它，只允许对记录进行某些操作，比如将状态从ENABLED更改为DISABLED。(我有比这更复杂的场景)
出于安全原因，我不希望调用者只提交更新字段的整个记录(这也感觉有点过分)。
是否有构造uri的推荐方法?在阅读REST书籍时，RPC样式的调用似乎是不受欢迎的。
如果下面的调用返回id为123的客户的完整客户记录
GET /customer/123
<customer>
{lots of attributes}
<status>ENABLED</status>
{even more attributes}
</customer>
我该如何更新状态?
POST /customer/123/status
<status>DISABLED</status>
POST /customer/123/changeStatus
DISABLED
...
更新:扩充问题。如何将“业务逻辑调用”合并到REST api中?有没有大家都同意的做法?并非所有的方法本质上都是CRUD。有些更复杂，如“sendEmailToCustomer(123)”，“mergeCustomers(123, 456)”，“countCustomers()”
POST /customer/123?cmd=sendEmail
POST /cmd/sendEmail?customerId=123
GET /customer/count
使用PUT更新不完整/部分的资源。
您可以接受jObject作为参数，并解析其值以更新资源。
下面是你可以参考的Java函数:
public IHttpActionResult Put(int id, JObject partialObject) {
Dictionary < string, string > dictionaryObject = new Dictionary < string, string > ();
foreach(JProperty property in json.Properties()) {
dictionaryObject.Add(property.Name.ToString(), property.Value.ToString());
}
int id = Convert.ToInt32(dictionaryObject["id"]);
DateTime startTime = Convert.ToDateTime(orderInsert["AppointmentDateTime"]);
Boolean isGroup = Convert.ToBoolean(dictionaryObject["IsGroup"]);
//Call function to update resource
update(id, startTime, isGroup);
return Ok(appointmentModelList);
}
没关系。就REST而言，你不能做GET，因为它不是可缓存的，但不管你使用POST, PATCH, PUT或其他什么都没关系，URL看起来是什么也没关系。如果您正在使用REST，那么重要的是当您从服务器获得资源的表示时，该表示能够提供客户端状态转换选项。
如果您的GET响应有状态转换，客户机只需要知道如何读取它们，服务器可以根据需要更改它们。这里的更新是使用POST完成的，但是如果它被更改为PATCH，或者如果URL更改了，客户端仍然知道如何进行更新:
{
"customer" :
{
},
"operations":
[
"update" :
{
"method": "POST",
"href": "https://server/customer/123/"
}]
}
你可以列出必要的/可选的参数，让客户端反馈给你。这取决于应用程序。
就业务操作而言，这可能是与客户资源链接的不同资源。如果你想发送一封电子邮件给客户，也许该服务是它自己的资源，你可以POST，所以你可以在客户资源中包括以下操作:
"email":
{
"method": "POST",
"href": "http://server/emailservice/send?customer=1234"
}
以下是演示者REST架构的一些优秀视频和示例。Stormpath只使用GET/POST/DELETE，这很好，因为REST与你使用的操作或url的外观没有任何关系(除了GET应该是可缓存的):
https://www.youtube.com/watch?v=pspy1H6A3FM,
https://www.youtube.com/watch?v=5WXYw4J4QOU,
http://docs.stormpath.com/rest/quickstart/
对于修改状态，我认为RESTful方法是使用描述资源状态的逻辑子资源。当你有一个减少的状态集时，这个IMO非常有用和干净。它使您的API更具表现力，而无需强制对客户资源进行现有操作。
例子:
POST /customer/active <-- Providing entity in the body a new customer
{
... // attributes here except status
}
POST服务应该返回新创建的带有id的客户:
{
id:123,
... // the other fields here
}
创建的资源的GET将使用资源位置:
GET /customer/123/active
GET /customer/123/inactive应该返回404
对于PUT操作，如果不提供Json实体，它只会更新状态
PUT /customer/123/inactive <-- Deactivating an existing customer
提供实体将允许您更新客户的内容并同时更新状态。
PUT /customer/123/inactive
{
... // entity fields here except id and status
}
您正在为客户资源创建概念子资源。这也符合Roy Fielding对资源的定义:“……资源是到一组实体的概念映射，而不是在任何特定时间点对应映射的实体……”在本例中，概念映射是ACTIVE -customer到status=ACTIVE的客户。
读操作:
GET /customer/123/active
GET /customer/123/inactive
如果您在另一个调用之后进行这些调用，其中一个必须返回状态404，那么成功的输出可能不包括状态，因为它是隐式的。当然你仍然可以使用GET /customer/123?status=ACTIVE|INACTIVE，直接查询客户资源。
DELETE操作很有趣，因为语义可能令人困惑。但是您可以选择不发布这个概念资源的操作，或者根据您的业务逻辑使用它。
DELETE /customer/123/active
它可以将您的客户带到DELETED/DISABLED状态或相反的状态(ACTIVE/INACTIVE)。
