Package java.net.http

Enum 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, the 301 and 302 status codes cause a POST request to be converted to a GET in the redirected request.
    Since:
    11
    • 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