OpenRasta URI 和方法绑定说明 - RESTful Web 服务

Question

我正在使用 Openrasta 作为我的 RESTful Web 服务，并且我对方法参数和 URI 有一点疑问，

例如：我遵循了用户实体的设置。

配置：

 ResourceSpace.Has.ResourcesOfType<User>()
          .AtUri("/user")
          .And.AtUri("/user/{userId}")
          .HandledBy<UserHandler>()
          .AsJsonDataContract()
          .And.AsXmlDataContract();

PUT 的处理程序方法：

public OperationResult Put(long userId, User user){}

相同的 URI 将为 http://localhost/User/1

请求正文将为包含如下 JSON：

{
  "userId":1,
  "userName":"FirstName"
}

这里，我的问题是： 使用两个参数定义 PUT 方法是否正确？如果这是正确的方法，那么 PUT 方法中的 userId 参数将包含与 User 实体属性 UserId 相同的值。

并且，在 PUT 方法中，我需要验证这两个值是否相同，如果它们不同，我将返回 BadRequest，指出 URI 与请求中提供的实体不匹配。为什么我们应该明确地执行此操作，为什么不能在处理请求时处理它并让 PUT 方法仅将 User 实体作为参数？我是否遗漏了任何东西，或者我对这个设计的理解完全错误？请问有什么想法或意见吗？

Answer 1

有几个原因。

首先，这是一次处理 URI 参数并将其与输入一个变量进行匹配的技术限制。这同样适用于键/值编解码器，因此应该让您拥有一个 User 对象。但是当您使用 json 编解码器时，我们会返回一个完整的对象，因此最终会覆盖 User 。

第二个问题是我从未尝试解决该问题，主要是因为组合 uri 参数和响应主体会导致一大堆隐藏的安全问题，您可能希望远离这些问题。

最后也是同样重要的一点，从建模的角度来看，ReST API 应该使用 URI 作为标识符和链接，而不是外键，因此如果您已经有了标识符（URI），那么就没有理由在实体主体中对其进行建模。