Interface SocketConnector

All Superinterfaces:
Callable<Socket>
All Known Implementing Classes:
DefaultSocketConnector

public interface SocketConnector extends Callable<Socket>
A Runnable that (re)connects a socket.

An implementation of this interface is responsible for repeatedly attempting to create a socket connection to a remote host.

Author:
Carl Harris
  • Nested Class Summary

    Nested Classes
    Modifier and Type
    Interface
    Description
    static interface 
    An exception handler that is notified of all exceptions that occur during the (re)connection process.
  • Method Summary

    Modifier and Type
    Method
    Description
    Blocks the calling thread until a connection is successfully established.
    void
    Sets the connector's exception handler.
    void
    Sets the connector's socket factory.
  • Method Details

    • call

      Blocks the calling thread until a connection is successfully established.
      Specified by:
      call in interface Callable<Socket>
      Returns:
      the connected socket
      Throws:
      InterruptedException
    • setExceptionHandler

      void setExceptionHandler(SocketConnector.ExceptionHandler exceptionHandler)
      Sets the connector's exception handler.

      The handler must be set before the call() method is invoked.

      Parameters:
      exceptionHandler - the handler to set
    • setSocketFactory

      void setSocketFactory(SocketFactory socketFactory)
      Sets the connector's socket factory.

      If no factory is configured that connector will use the platform's default factory.

      Parameters:
      socketFactory - the factory to set