Enum HttpClient.Redirect
- java.lang.Object
-
- java.lang.Enum<HttpClient.Redirect>
-
- java.net.http.HttpClient.Redirect
- All Implemented Interfaces:
-
Serializable
,Comparable<HttpClient.Redirect>
- Enclosing class:
- HttpClient
public static enum HttpClient.Redirect extends Enum<HttpClient.Redirect>
Defines the automatic redirection policy.
The automatic redirection policy is checked whenever a 3XX
response code is received. If redirection does not happen automatically, then the response, containing the 3XX
response code, is returned, where it can be handled manually.
Redirect
policy is set through the Builder.followRedirects method.
- Implementation Note:
- When automatic redirection occurs, the request method of the redirected request may be modified depending on the specific
30X
status code, as specified in RFC 7231. In addition, the301
and302
status codes cause aPOST
request to be converted to aGET
in the redirected request. - Since:
- 11
Enum Constant Summary
Enum Constant | Description |
---|---|
ALWAYS | Always redirect. |
NEVER | Never redirect. |
NORMAL | Always redirect, except from HTTPS URLs to HTTP URLs. |
Method Summary
Modifier and Type | Method | Description |
---|---|---|
static HttpClient.Redirect | valueOf(String name) | Returns the enum constant of this type with the specified name. |
static HttpClient.Redirect[] | values() | Returns an array containing the constants of this enum type, in the order they are declared. |
Methods declared in class java.lang.Enum
clone, compareTo, equals, finalize, getDeclaringClass, hashCode, name, ordinal, toString, valueOf
Methods declared in class java.lang.Object
getClass, notify, notifyAll, wait, wait, wait
Enum Constant Detail
NEVER
public static final HttpClient.Redirect NEVER
Never redirect.
ALWAYS
public static final HttpClient.Redirect ALWAYS
Always redirect.
NORMAL
public static final HttpClient.Redirect NORMAL
Always redirect, except from HTTPS URLs to HTTP URLs.
Method Detail
values
public static HttpClient.Redirect[] values()
Returns an array containing the constants of this enum type, in the order they are declared. This method may be used to iterate over the constants as follows:
for (HttpClient.Redirect c : HttpClient.Redirect.values()) System.out.println(c);
- Returns:
- an array containing the constants of this enum type, in the order they are declared
valueOf
public static HttpClient.Redirect valueOf(String name)
Returns the enum constant of this type with the specified name. The string must match exactly an identifier used to declare an enum constant in this type. (Extraneous whitespace characters are not permitted.)
- Parameters:
-
name
- the name of the enum constant to be returned. - Returns:
- the enum constant with the specified name
- Throws:
-
IllegalArgumentException
- if this enum type has no constant with the specified name -
NullPointerException
- if the argument is null