org.apache.commons.httpclient
Class DefaultHttpMethodRetryHandler

java.lang.Object
  org.apache.commons.httpclient.DefaultHttpMethodRetryHandler

All Implemented Interfaces:

HttpMethodRetryHandler

public class DefaultHttpMethodRetryHandler
extends Object
implements HttpMethodRetryHandler

The default HttpMethodRetryHandler used by HttpMethods.

Author:

Michael Becke, Oleg Kalnichevski

Constructor Summary

DefaultHttpMethodRetryHandler()
Creates a new DefaultHttpMethodRetryHandler that retries up to 3 times but does not retry methods that have successfully sent their requests.

DefaultHttpMethodRetryHandler(int retryCount, boolean requestSentRetryEnabled)
Creates a new DefaultHttpMethodRetryHandler.

Method Summary

int	getRetryCount()
boolean	isRequestSentRetryEnabled()
boolean	retryMethod(HttpMethod method, IOException exception, int executionCount) Use retryCount and requestSentRetryEnabled to determine if the given method should be retried.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

DefaultHttpMethodRetryHandler

public DefaultHttpMethodRetryHandler(int retryCount,
                                     boolean requestSentRetryEnabled)

Creates a new DefaultHttpMethodRetryHandler.

Parameters:

retryCount - the number of times a method will be retried

requestSentRetryEnabled - if true, methods that have successfully sent their request will be retried

DefaultHttpMethodRetryHandler

public DefaultHttpMethodRetryHandler()

Creates a new DefaultHttpMethodRetryHandler that retries up to 3 times but does not retry methods that have successfully sent their requests.

Method Detail

retryMethod

public boolean retryMethod(HttpMethod method,
                           IOException exception,
                           int executionCount)

Use retryCount and requestSentRetryEnabled to determine if the given method should be retried.

If the method has not been aborted, true is returned for all IOExceptions except for instances of:

• InterruptedIOException (timeout)
• UnknownHostException
• SSLException
• SocketException

Specified by:

retryMethod in interface HttpMethodRetryHandler

Parameters:

method - the method being executed

exception - the exception that occurred

executionCount - the number of times this method has been unsuccessfully executed

Returns:

true if the method should be retried, false otherwise

See Also:

HttpMethodRetryHandler.retryMethod(HttpMethod, IOException, int)

isRequestSentRetryEnabled

public boolean isRequestSentRetryEnabled()

Returns:

true if this handler will retry methods that have successfully sent their request, false otherwise

getRetryCount

public int getRetryCount()

Returns:

the maximum number of times a method will be retried