Method Detail

• prepare

  void prepare(boolean reload)
               throws IOException

  Prepare by setting up any connections to servers, etc., ahead of call(int) invocation.

  Parameters:

  reload - Set this to true if need to requery locations

  Throws:

  IOException - e

• throwable

  void throwable(Throwable t,
               boolean retrying)

  Called when call(int) throws an exception and we are going to retry; take action to make it so we succeed on next call (clear caches, do relookup of locations, etc.).

  Parameters:

  t -

  retrying - True if we are in retrying mode (we are not in retrying mode when max retries == 1; we ARE in retrying mode if retries > 1 even when we are the last attempt)

• call

  T call(int callTimeout)
         throws Exception

  Computes a result, or throws an exception if unable to do so.

  Parameters:

  callTimeout - - the time available for this call. 0 for infinite.

  Returns:

  computed result

  Throws:

  Exception - if unable to compute a result

• getExceptionMessageAdditionalDetail

  String getExceptionMessageAdditionalDetail()

  Returns:

  Some details from the implementation that we would like to add to a terminating exception; i.e. a fatal exception is being thrown ending retries and we might like to add more implementation-specific detail on to the exception being thrown.

• sleep

  long sleep(long pause,
           int tries)

  Parameters:

  pause -

  tries -

  Returns:

  Suggestion on how much to sleep between retries