HttpRetryException (Java Platform SE 8 ) (original) (raw)

• java.lang.Object

• • java.lang.Throwable
  • • java.lang.Exception
      • • java.io.IOException
          * * java.net.HttpRetryException

• All Implemented Interfaces:
  Serializable

public class HttpRetryException
extends IOException
Thrown to indicate that a HTTP request needs to be retried but cannot be retried automatically, due to streaming mode being enabled.
Since:
1.5
See Also:
Serialized Form

• • Constructor Summary

  Constructors

  Constructor	Description
  HttpRetryException(String detail, int code)	Constructs a new HttpRetryException from the specified response code and exception detail message
  HttpRetryException(String detail, int code,String location)	Constructs a new HttpRetryException with detail message responseCode and the contents of the Location response header field.

  • Method Summary

  All Methods Instance Methods Concrete Methods

  Modifier and Type	Method	Description
  String	getLocation()	Returns the value of the Location header field if the error resulted from redirection.
  String	getReason()	Returns a string explaining why the http request could not be retried.
  int	responseCode()	Returns the http response code

     * ### Methods inherited from class java.lang.[Throwable](../../java/lang/Throwable.html "class in java.lang")  
     `[addSuppressed](../../java/lang/Throwable.html#addSuppressed-java.lang.Throwable-), [fillInStackTrace](../../java/lang/Throwable.html#fillInStackTrace--), [getCause](../../java/lang/Throwable.html#getCause--), [getLocalizedMessage](../../java/lang/Throwable.html#getLocalizedMessage--), [getMessage](../../java/lang/Throwable.html#getMessage--), [getStackTrace](../../java/lang/Throwable.html#getStackTrace--), [getSuppressed](../../java/lang/Throwable.html#getSuppressed--), [initCause](../../java/lang/Throwable.html#initCause-java.lang.Throwable-), [printStackTrace](../../java/lang/Throwable.html#printStackTrace--), [printStackTrace](../../java/lang/Throwable.html#printStackTrace-java.io.PrintStream-), [printStackTrace](../../java/lang/Throwable.html#printStackTrace-java.io.PrintWriter-), [setStackTrace](../../java/lang/Throwable.html#setStackTrace-java.lang.StackTraceElement:A-), [toString](../../java/lang/Throwable.html#toString--)`  
     * ### Methods inherited from class java.lang.[Object](../../java/lang/Object.html "class in java.lang")  
     `[clone](../../java/lang/Object.html#clone--), [equals](../../java/lang/Object.html#equals-java.lang.Object-), [finalize](../../java/lang/Object.html#finalize--), [getClass](../../java/lang/Object.html#getClass--), [hashCode](../../java/lang/Object.html#hashCode--), [notify](../../java/lang/Object.html#notify--), [notifyAll](../../java/lang/Object.html#notifyAll--), [wait](../../java/lang/Object.html#wait--), [wait](../../java/lang/Object.html#wait-long-), [wait](../../java/lang/Object.html#wait-long-int-)`

• • Constructor Detail

     * #### HttpRetryException  
     public HttpRetryException([String](../../java/lang/String.html "class in java.lang") detail,  
                               int code)  
     Constructs a new `HttpRetryException` from the specified response code and exception detail message  
     Parameters:  
     `detail` \- the detail message.  
     `code` \- the HTTP response code from server.  
     * #### HttpRetryException  
     public HttpRetryException([String](../../java/lang/String.html "class in java.lang") detail,  
                               int code,  
                               [String](../../java/lang/String.html "class in java.lang") location)  
     Constructs a new `HttpRetryException` with detail message responseCode and the contents of the Location response header field.  
     Parameters:  
     `detail` \- the detail message.  
     `code` \- the HTTP response code from server.  
     `location` \- the URL to be redirected to  

  • Method Detail

    * #### responseCode  
    public int responseCode()  
    Returns the http response code  
    Returns:  
    The http response code.  
    * #### getReason  
    public [String](../../java/lang/String.html "class in java.lang") getReason()  
    Returns a string explaining why the http request could not be retried.  
    Returns:  
    The reason string  
    * #### getLocation  
    public [String](../../java/lang/String.html "class in java.lang") getLocation()  
    Returns the value of the Location header field if the error resulted from redirection.  
    Returns:  
    The location string

Submit a bug or feature
For further API reference and developer documentation, see Java SE Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.
Copyright © 1993, 2025, Oracle and/or its affiliates. All rights reserved. Use is subject to license terms. Also see the documentation redistribution policy.