Further clarify semantics of HttpMethod.valueOf()

See gh-36652

(cherry picked from commit cb320468db)
This commit is contained in:
Sam Brannen
2026-04-14 16:19:43 +02:00
parent f182f9a76b
commit 69068ba33d
@@ -111,8 +111,12 @@ public final class HttpMethod implements Comparable<HttpMethod>, Serializable {
* Return an {@code HttpMethod} object for the given value.
* <p>Note that this lookup is case-sensitive. For predefined constants,
* the method value must be provided in uppercase (e.g., {@code "GET"},
* {@code "POST"}). If no predefined constant matches, a new
* {@code HttpMethod} instance is returned for the given value as-is.
* {@code "POST"}). If no predefined constant matches, a new {@code HttpMethod}
* instance is returned for the given value as-is. For example,
* {@code HttpMethod.valueOf("GET")} resolves to {@link HttpMethod#GET}, while
* {@code HttpMethod.valueOf("get")} resolves to {@code new HttpMethod("get")},
* and the two resulting {@code HttpMethod} instances are not
* {@linkplain #equals(Object) equal} and do not {@linkplain #matches(String) match}.
* @param method the method value as a String
* @return the corresponding {@code HttpMethod}
*/