Class TcpOutputStream

java.lang.Object
java.io.OutputStream
org.jboss.logmanager.handlers.TcpOutputStream
All Implemented Interfaces:
Closeable, Flushable, AutoCloseable, FlushableCloseable
Direct Known Subclasses:
SslTcpOutputStream

public class TcpOutputStream extends OutputStream implements FlushableCloseable
An output stream that writes data to a socket.

If an IOException occurs during a write(byte[], int, int) and a socket factory was defined the stream will attempt to reconnect indefinitely. By default additional writes are discarded when reconnecting. If you set the block on reconnect to true, then the reconnect will indefinitely block until the TCP stream is reconnected.

You can optionally get a collection of the errors that occurred during a write or reconnect.

  • Field Details

    • retryTimeout

      private static final long retryTimeout
      See Also:
    • maxRetryTimeout

      private static final long maxRetryTimeout
      See Also:
    • maxErrors

      private static final int maxErrors
      See Also:
    • outputLock

      protected final Object outputLock
    • socketFactory

      private final SocketFactory socketFactory
    • address

      private final InetAddress address
    • port

      private final int port
    • errors

      private final Deque<Exception> errors
    • reconnectThread

      private Thread reconnectThread
    • blockOnReconnect

      private boolean blockOnReconnect
    • socket

      private Socket socket
    • connected

      private boolean connected
  • Constructor Details

    • TcpOutputStream

      public TcpOutputStream(InetAddress address, int port) throws IOException
      Creates a TCP output stream.

      Uses the default socket factory to create the socket.

      Parameters:
      address - the address to connect to
      port - the port to connect to
      Throws:
      IOException - no longer throws an exception. If an exception occurs while attempting to connect the socket a reconnect will be attempted on the next write.
    • TcpOutputStream

      public TcpOutputStream(InetAddress address, int port, boolean blockOnReconnect) throws IOException
      Creates a TCP output stream.

      Uses the default socket factory to create the socket.

      Parameters:
      address - the address to connect to
      port - the port to connect to
      blockOnReconnect - true to block when attempting to reconnect the socket or false to reconnect asynchronously
      Throws:
      IOException - no longer throws an exception. If an exception occurs while attempting to connect the socket a reconnect will be attempted on the next write.
    • TcpOutputStream

      @Deprecated protected TcpOutputStream(Socket socket)
      Creates a new TCP output stream.

      Using this constructor does not allow for any kind of reconnect if the connection is dropped.

      Parameters:
      socket - the socket used to write the output to
    • TcpOutputStream

      protected TcpOutputStream(SocketFactory socketFactory, InetAddress address, int port) throws IOException
      Creates a new TCP output stream.

      Creates a socket from the socketFactory argument.

      Parameters:
      socketFactory - the factory used to create the socket
      address - the address to connect to
      port - the port to connect to
      Throws:
      IOException - no longer throws an exception. If an exception occurs while attempting to connect the socket a reconnect will be attempted on the next write.
    • TcpOutputStream

      protected TcpOutputStream(SocketFactory socketFactory, InetAddress address, int port, boolean blockOnReconnect) throws IOException
      Creates a new TCP output stream.

      Creates a socket from the socketFactory argument.

      Parameters:
      socketFactory - the factory used to create the socket
      address - the address to connect to
      port - the port to connect to
      blockOnReconnect - true to block when attempting to reconnect the socket or false to reconnect asynchronously
      Throws:
      IOException - no longer throws an exception. If an exception occurs while attempting to connect the socket a reconnect will be attempted on the next write.
  • Method Details

    • write

      public void write(int b) throws IOException
      Specified by:
      write in class OutputStream
      Throws:
      IOException
    • write

      public void write(byte[] b) throws IOException
      Overrides:
      write in class OutputStream
      Throws:
      IOException
    • write

      public void write(byte[] b, int off, int len) throws IOException
      Overrides:
      write in class OutputStream
      Throws:
      IOException
    • flush

      public void flush() throws IOException
      Specified by:
      flush in interface Flushable
      Overrides:
      flush in class OutputStream
      Throws:
      IOException
    • close

      public void close() throws IOException
      Specified by:
      close in interface AutoCloseable
      Specified by:
      close in interface Closeable
      Overrides:
      close in class OutputStream
      Throws:
      IOException
    • isBlockOnReconnect

      public boolean isBlockOnReconnect()
      Indicates whether or not the output stream is set to block when attempting to reconnect a TCP connection.
      Returns:
      true if blocking is enabled, otherwise false
    • setBlockOnReconnect

      public void setBlockOnReconnect(boolean blockOnReconnect)
      Enables or disables blocking when attempting to reconnect the socket.

      If set to true the write methods will block when attempting to reconnect. This is only advisable to be set to true if using an asynchronous handler.

      Parameters:
      blockOnReconnect - true to block when reconnecting or false to reconnect asynchronously discarding any new messages coming in
    • isConnected

      public boolean isConnected()
      Returns the connected state of the TCP stream.

      The stream is said to be disconnected when an IOException occurs during a write. Otherwise a stream is considered connected.

      Returns:
      true if the stream is connected, otherwise false
    • getErrors

      public Collection<Exception> getErrors()
      Retrieves the errors occurred, if any, during a write or reconnect.
      Returns:
      a collection of errors or an empty list
    • addError

      private void addError(Exception e)
    • isReconnectAllowed

      private boolean isReconnectAllowed()
      Invocations of this method must be locked by the outputLock.
    • checkReconnect

      private void checkReconnect()
      Attempts to reconnect the socket if required and allowed. Invocations of this method must be locked by the outputLock.
    • createThread

      private Thread createThread()
    • safeClose

      private static void safeClose(Closeable closeable)