com.wavefront.sdk.common

Class ReconnectingSocket

java.lang.Object

com.wavefront.sdk.common.ReconnectingSocket

public class ReconnectingSocket
extends java.lang.Object

Creates a TCP client suitable for the WF proxy. That is: a client which is long-lived and semantically one-way. This client tries persistently to reconnect to the given host and port if a connection is ever broken. If the server (in practice, the WF proxy) sends a TCP FIN or TCP RST, we will treat it as a "broken connection" and just try to connect again on the next call to write(). This means each ReconnectingSocket has a polling thread for the server to listen for connection resets.

Version:

$Id: $Id

Author:

Mori Bellamy (mori@wavefront.com).

Constructor Summary

Constructors

Constructor and Description
ReconnectingSocket(java.net.InetSocketAddress address, javax.net.SocketFactory socketFactory, WavefrontSdkMetricsRegistry sdkMetricsRegistry, java.lang.String entityPrefix) Attempts to open a connected socket to the specified address.
ReconnectingSocket(java.lang.String host, int port, javax.net.SocketFactory socketFactory, WavefrontSdkMetricsRegistry sdkMetricsRegistry, java.lang.String entityPrefix) Attempts to open a connected socket to the specified host and port.

Method Summary

Modifier and Type	Method and Description
void	close() close.
void	flush() Flushes the outputStream best-effort.
void	write(java.lang.String message) Try to send the given message.

Methods inherited from class java.lang.Object

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

Constructor Detail

ReconnectingSocket

public ReconnectingSocket(java.lang.String host,
                          int port,
                          javax.net.SocketFactory socketFactory,
                          WavefrontSdkMetricsRegistry sdkMetricsRegistry,
                          java.lang.String entityPrefix)
                   throws java.io.IOException

Attempts to open a connected socket to the specified host and port.

Parameters:

host - The name of the remote host.

port - The remote port.

socketFactory - The SocketFactory used to create the underlying socket.

sdkMetricsRegistry - The WavefrontSdkMetricsRegistry for internal metrics.

entityPrefix - A prefix for internal metrics pertaining to this instance.

Throws:

java.io.IOException - When we cannot open the remote socket.

ReconnectingSocket

public ReconnectingSocket(java.net.InetSocketAddress address,
                          javax.net.SocketFactory socketFactory,
                          WavefrontSdkMetricsRegistry sdkMetricsRegistry,
                          java.lang.String entityPrefix)
                   throws java.io.IOException

Attempts to open a connected socket to the specified address.

Parameters:

address - The InetSocketAddress of the server to connect to.

socketFactory - The SocketFactory used to create the underlying socket.

sdkMetricsRegistry - The WavefrontSdkMetricsRegistry for internal metrics.

entityPrefix - A prefix for internal metrics pertaining to this instance.

Throws:

java.io.IOException - When we cannot open the remote socket.

Method Detail

write

public void write(java.lang.String message)
           throws java.lang.Exception

Try to send the given message. On failure, reset and try again. If _that_ fails, just rethrow the exception.

Parameters:

message - a String object

Throws:

java.lang.Exception - when a single retry is not enough to have a successful write to the remote host.

flush

public void flush()
           throws java.io.IOException

Flushes the outputStream best-effort. If that fails, we reset the connection.

Throws:

java.io.IOException - if any.

close

public void close()
           throws java.io.IOException

close.

Throws:

java.io.IOException - if any.