有没有办法使用 Java 11 的 HttpClient 从 HTTP 1.1 响应的状态行中获取 Reason-Phrase？

Question

有了Java的java.net.HttpURLConnection就有了getResponseMessage() method to retrieve any Reason-Phrase text (as specified by RFC2616 6.1 Status Line).

在较新的 Java 11 HttpClient 中，java.net.http.HttpResponse 只有一个 statusCode() 方法。

有没有办法使用这个 API 获取状态行末尾返回的文本？如果没有，为什么不包括在内？（我知道 HTTP 2 does not define 这个值，但大多数应用程序仍然使用 HTTP 1.1，它仍然有效。）

Answer 1

如您所见，HttpResponse 没有提供任何 API 来获取原因短语。没有隐藏的方法来获得它。您是否有这样一个用例，其中在 HttpResponse 中使用原因短语的访问器会有用？

Answer 2

Is there a way to obtain text returned on the end of the status line using this API?

没有

If not, why was it not included?

我们无法告诉您实际原因，因为尚未发布详细的设计原理。

但是，我想原因/推理是这样的：

因为文本经常被客户忽略。（多多包涵...）
因为文字很少包含有用的东西。它通常只是与响应代码对应的标准（推荐）文本消息。（这是客户经常忽略文本的一个原因。）
因为如果 Web 应用程序要提供有意义的解释，它很可能会在有效负载中进行。（因为1。但也加强了它。）
因为一些网络堆栈不允许网络应用设置原因文本。
因为某些 HTTP 1.1 Web 服务器通常会完全忽略原因文本！（例如，Tomcat 8.0.x 没有消息，而 Tomcat 8.5.x 有一个启用它的选项。）

(I know that HTTP 2 does not define this value, but most applications still use HTTP 1.1 where it remains valid.)

那是现在... ¹.

这实际上是（新）Web 应用程序不尝试在原因文本中传递有用信息并且在 API 中不支持它的另一个原因。

最终，大多数应用程序将使用 HTTP 2 或更高版本。或者至少，足够多的人会使用它，依赖于对 HTTP 1.x 功能的良好支持可能会给您的应用程序带来问题。

请记住，HTTP 3 现在正在筹备中。没有人能看到足够远的未来来准确预测在（比如说）5 年内有多少比例的 Web 服务器将使用什么版本的 HTTP。

^{1 - Server-side 采用率呈上升趋势，但因服务器平台而异。有关一些数据点，请参阅 2020 Web Almanac。}

鉴于上述情况，如果您使客户端代码依赖于查看特定原因文本……或根本看不到任何文本……那么对于某些 Web 服务器来说，它可能会崩溃。

因此，我想说 Java 11 的 HttpClient API 设计师 没有向 client-side代码。

您可以不同意...并使用其他 HTTP 客户端库。

我的建议是顺其自然。如果您不尝试使用原因文本（客户端或服务器端），那么您将不必处理使用它会带来的问题。问题只会越来越严重。

Answer 3

我在 Java 中寻找 http 状态代码原因短语，并在 Google 搜索期间找到了这个讨论。我最终编写了自己的函数，我想分享它以防其他人发现它有用。它可能不完整，但它符合我的目的。

public static String getReasonPhrase(int statusCode) {
    switch(statusCode) {
        case (200): return "OK";
        case (201): return "Created";
        case (202): return "Accepted";
        case (203): return "Non Authoritative Information";
        case (204): return "No Content";
        case (205): return "Reset Content";
        case (206): return "Partial Content";
        case (207): return "Partial Update OK";
        case (300): return "Mutliple Choices";
        case (301): return "Moved Permanently";
        case (302): return "Moved Temporarily";
        case (303): return "See Other";
        case (304): return "Not Modified";
        case (305): return "Use Proxy";
        case (307): return "Temporary Redirect";
        case (400): return "Bad Request";
        case (401): return "Unauthorized";
        case (402): return "Payment Required";
        case (403): return "Forbidden";
        case (404): return "Not Found";
        case (405): return "Method Not Allowed";
        case (406): return "Not Acceptable";
        case (407): return "Proxy Authentication Required";
        case (408): return "Request Timeout";
        case (409): return "Conflict";
        case (410): return "Gone";
        case (411): return "Length Required";
        case (412): return "Precondition Failed";
        case (413): return "Request Entity Too Large";
        case (414): return "Request-URI Too Long";
        case (415): return "Unsupported Media Type";
        case (416): return "Requested Range Not Satisfiable";
        case (417): return "Expectation Failed";
        case (418): return "Reauthentication Required";
        case (419): return "Proxy Reauthentication Required";
        case (422): return "Unprocessable Entity";
        case (423): return "Locked";
        case (424): return "Failed Dependency";
        case (500): return "Server Error";
        case (501): return "Not Implemented";
        case (502): return "Bad Gateway";
        case (503): return "Service Unavailable";
        case (504): return "Gateway Timeout";
        case (505): return "HTTP Version Not Supported";
        case (507): return "Insufficient Storage";
        default: return "";
    }
}

有没有办法使用 Java 11 的 HttpClient 从 HTTP 1.1 响应的状态行中获取 Reason-Phrase？

Is there a way to fetch the Reason-Phrase from the status line of a HTTP 1.1 response with Java 11's HttpClient?

java

java-http-client