http - HTTP API 状态代码的自定义文本

Question

我正在我的 HTTP 服务中编写一个新端点，该端点基于 Play框架，并为特定错误返回自定义状态代码(在本例中为 442)。当我用 cURL 测试端点时，我收到了预期的错误代码:

...
< HTTP/1.1 442 Client Error (442)
....

与Postman REST Client相同:

我想做的是自定义“客户端错误”文本，这样响应实际上会显示如下内容:

442 Forced Password Reset

这是否可能，或者是否在规范中某处规定 4xx 类的任何自定义状态代码都将被所有客户端简单地解释为“客户端错误”？

(我一直在查看 relevant Play documentation on Statuses，但没有看到任何自定义文本的选项——只有状态代码整数本身。)

Answer 1

查看源代码，我很快就找到了以下内容:

1. Play 只是将状态码存储在 RepsonseHeader 中，而不是字符串
2. Play 使用 Netty，并使用 valueOf 将状态代码转换为 HttpResponseStatus，这基本上只是状态代码的 case 语句，如果不标准则根据范围进行默认设置。
3. 虽然您可以使用所需的原因短语定义一个新的 Netty HttpResponseStatus，但没有任何方法可以将它添加到 valueOf 方法(它是静态的)。

因此，如果不重写 Play! 的某些部分，就没有任何真正好的解决方案。

您也许可以使用某种后置过滤器来修改响应并更改原因短语，但我不知道它是如何工作的，或者即使可以在 Play 中编写这些类型的过滤器!

最后，原因短语并不是那么重要，因为客户通常不会(也不应该)实际解析它。