RESTful (Web API) 服务中的非 CRUD 操作

Question

我正在通过将现有 WCF 服务转换为 WebAPI 来学习 WebAPI（以及一般的 REST）。在此过程中，我对处理非 CRUD 操作的最佳方式感到困惑。这是我的服务合同：

[ServiceContract]
public interface IProxyHelper
{
    [OperationContract]
    List<ProxyInfo> GetUsersCurrentUserCanActAsProxyFor(int positionId, int appId);

    [OperationContract]
    void DeleteProxy(int id);

    [OperationContract]
    List<ProxyInfo> GetProxyData(int appId);

    [OperationContract]
    bool CanPositionProxy(int positionId, int appId);

    [OperationContract]
    void AddProxy(
      string userRacf,
      string proxyAsRacf,
      int userPositionId,
      int proxyPositionId,
      string requestedByRacf,
      int appId);

    [OperationContract]
    int GetPositionIdByRacf(string racf);

    [OperationContract]
    string GetRacfByPositionId(int positionId);
}

一些方法，例如 DeleteProxy 和 AddProxy，我可以轻松地转向基于 CRUD 的方法。

问题出现在：

GetProxyData - 代理系统被多个应用程序使用，虽然我可以做 api/Proxy/1，但我觉得那是“作弊”，因为这应该是为了获取 ProxyId 1，而不是应用程序 1 的代理。

GetUsersCurrentUserCanActAsProxyFor - 这对我来说在多个层面上都令人困惑。我应该如何处理多个参数？而且它也不完全属于 CRUD 方法。

这是否意味着我应该放弃 WebAPI 转换？如果不是，我应该如何处理这些非标准方法？

Answer 1

我认为您将 RESTful 服务与 CRUD 混淆了。两者并不相同，尽管很明显将 CRUD 转换为 REST 非常简单（资源和动词都有明确的映射）。

RESTful 架构的最大区别在于它是面向资源的。第二个是您利用传输 (HTTPs) 协议对这些资源采取行动——在 REST 的情况下是 GET、POST、PUT 和 DELETE。

转到您的示例，您最大的麻烦似乎是决定使用哪个 URI 方案来支持此服务。我是否可以建议，对于分层信息，这应该是直截了当的。例如，应用程序代理：

/application/<id>/proxies

并且用户当前用户可以充当代理：

/user/<id>/proxy-users 或取决于您的风格/user/<id>/proxy/users

或类似的东西。你想到了关系和基础资源。许多 URI 可以指向同一个资源。

请注意，正如@dtb 在他的评论中提到的那样，URI 和/或（不太理想的）cookie 在每个请求中都包含所有需要的信息。所以CurrentUser 有点黑。

随着您的转化过程，您可能还会发现这个有趣的阅读：Non-CRUD operations in a RESTful service