如何处理客户端上 Rest 中的每个谓词权限



>假设我们在URL上有一个资源,如下所示:foo.com/api/bar假设可能允许用户获取该资源,但不允许用户发布到该资源。

我可以通过为每个谓词指定不同的权限来轻松解决这个问题。但是,如果允许客户端执行 POST,客户端应该如何知道呢?

假设我们在页面上有一个"保存"按钮,如果用户缺少进行 POST 的权限,则不应启用该按钮。

我知道 HATEOAS/超媒体约束,并且可以将不同操作的链接列表与资源一起传递。但是 AFAIK,它不携带有关使用什么动词的信息,只包含不同操作的 URL。是否包含动词的其他变体?

如果您不想用各种元数据使资源混乱,还有其他方法吗?

在HAL讨论论坛上被问了很多 https://groups.google.com/forum/#!forum/hal-discuss

动词不返回的事实取决于您使用的超媒体格式,我猜是 HAL(或者可能是 collection+json)。 某些格式确实包含谓词信息。

HAL 实际上允许您根据需要在链接对象上包含自定义字段,但我不鼓励这样做,因为任何标准客户端都不知道如何解释这一点。

但我也发现这个动词最终毫无价值。

首先,在人机2机器中,用户将阅读文档。HAL 具有它的所有链接取消引用(通过 CURIE,因为它们目前是 naemd)到人类可读的文档,这些文档应该描述使用不同参数、动词、标头等请求该链接的效果。

接下来是,为了使您的应用程序真正具有 RESTful,您应该响应所有动词......您可能只是没有回应动词没问题。 对于基于 HTTP 的应用程序,返回 405 是非常合适的。 返回 404 不是! 500 会更糟! 405 应包括可用于所请求资源的方法。

接下来,在机器 2 机器(和一点 h2m)的情况下,您的应用程序通过 HTTP 访问时(我尽量在我的答案中避免使用 http,因为 RESTful 应用程序不一定是 HTTP。虽然我会说其中 101% 是)应该对资源 URL 使用 OPTIONS 方法 (http://www.w3.org/Protocols/rfc2616/rfc2616-sec9.html),以便获得可能的描述。

这就是我看到很多人被绊倒的地方,OPTIONS 的反应应该是什么? 好吧,人们忘记了内容类型协商! 请求者应说明他们期望的选项信息的格式。 接受:some-machine-language/xml 或application/language+json。 某些 RFC 或标准定义了这些内容类型,您的 API 可以识别它支持的格式。 我建议您包含对 text/html 的支持,以便您可以返回有关支持哪些动词的人类可读文档。 这很好地涵盖了h2m场景。

在返回有关不支持的方法的信息时,相同的内容类型协商可能很有用。 服务器可以发送客户端可以理解的内容类型,该内容类型在语义上描述允许的方法。

我想指出的最后一件事是,方法暗示了客户端意图。 我想放置此资源或删除该资源。 服务器应接受请求并返回响应,指示由于该请求而发生的状态转换。 因此,让 API 识别每个请求的客户端可能意图有点愚蠢。 客户知道它想做什么,它应该尝试,如果它不能,那么它应该处理它。

HTTP 动词

是纯传输协议动词。这些可能不是执行应用程序功能的正确动词,正是因为您在问题中提到的问题。因此,让我们看看是否可以在不使用http动词的情况下以不同的方式解决这个问题。执行 http 动词来执行应用操作可能会限制我们的 tommorrow,因为我们可能需要从 http 移动到另一个协议。

我们举个例子来说明。假设我们正在谈论使用HATEOAS的更新删除应用程序。所以在这种情况下,如果有两个产品,则由URL表示 www.abc.com/product/001 和 www.abc.com/product/002。在真正的 HATEOAS 情况下,如果必须查看两个产品 product/001 和 product/002 的响应,则显示客户端屏幕。

因此,如果对 product/001 的响应具有响应产品/001/

delete,product/001/change 和 product/002 具有响应产品/002/更改,则客户端将仅显示 product/001 的删除,并更改其他两个产品。

所以在回答你的问题时。通过适当地识别产品中的操作,现在可以执行基于角色的操作。

我希望我已经回答了你的问题。

最新更新