com.launchdarkly.eventsource.ConnectionErrorHandler Maven / Gradle / Ivy

Go to download

Show more of this group Show more artifacts with this name
Show all versions of okhttp-eventsource Show documentation

EventSource Implementation built on OkHttp

There is a newer version: 4.1.1

package com.launchdarkly.eventsource;

import java.io.EOFException;

/**
 * Interface for an object that will be notified when EventSource encounters a socket connection
 * error or receives an error response. This is different from {@link EventHandler#onError(Throwable)}
 * in two ways:
 * 
 *  It has the ability to tell EventSource to shut down instead of reconnecting.
 * 
 If the server simply ends the stream, the {@code ConnectionErrorHandler} is called with
 * an {@code EOFException}; {@code onError} is not called in this case.
 * 
 */
public interface ConnectionErrorHandler {
  /**
   * Return values of {@link ConnectionErrorHandler#onConnectionError(Throwable)} indicating what
   * action the {@link EventSource} should take after an error.
   */
  public static enum Action {
    /**
     * Specifies that the error should be logged normally and dispatched to the {@link EventHandler}.
     * Connection retrying will proceed normally if appropriate.
     */
    PROCEED,
    /**
     * Specifies that the connection should be immediately shut down and not retried.  The error
     * will not be dispatched to the {@link EventHandler}.
     */
    SHUTDOWN
  };
  
  /**
   * This method is called synchronously for all exceptions that occur on the socket connection
   * (including an {@link UnsuccessfulResponseException} if the server returns an unexpected HTTP
   * status, or {@link EOFException} if the streaming response has ended).
   * 
   * It must not take any direct action to affect the state of the connection, nor do any I/O of
   * its own, but it can return {@link Action#SHUTDOWN} to cause the connection to close.
   * 
   * @param t  a {@code Throwable} object
   * @return an {@link Action} constant
   */
  Action onConnectionError(Throwable t);
  
  /**
   * Default handler that does nothing.
   */
  public static final ConnectionErrorHandler DEFAULT = new ConnectionErrorHandler() {
    @Override
    public Action onConnectionError(Throwable t) {
      return Action.PROCEED;
    }
  };
}