Connection (dcm4che DICOM toolkit and utilities 3.3.9-SNAPSHOT API)

java.lang.Object
- org.dcm4che3.net.Connection

All Implemented Interfaces:

Serializable
```
public class Connection
extends Object
implements Serializable
```
A DICOM Part 15, Annex H compliant class, NetworkConnection encapsulates the properties associated with a connection to a TCP/IP network.
The network connection describes one TCP port on one network device. This can be used for a TCP connection over which a DICOM association can be negotiated with one or more Network AEs. It specifies 8 the hostname and TCP port number. A network connection may support multiple Network AEs. The Network AE selection takes place during association negotiation based on the called and calling AE-titles.

Author:

Gunter Zeilinger

See Also:

Serialized Form

Nested Class Summary

Nested Classes
Modifier and Type Class and Description

static class Connection.Protocol

Nested Classes
Modifier and Type	Class and Description
`static class`	`Connection.Protocol`

Field Summary

Fields
Modifier and Type	Field and Description
`private int`	`acceptTimeout`
`private int`	`backlog`
`private InetAddress`	`bindAddr`
`private String`	`bindAddress`
`private String[]`	`blacklist`
`private List<InetAddress>`	`blacklistAddrs`
`private InetAddress`	`clientBindAddr`
`private String`	`clientBindAddress`
`private String`	`commonName`
`private Boolean`	`connectionInstalled`
`private int`	`connectTimeout`
`static int`	`DEF_BACKLOG`
`static int`	`DEF_BUFFERSIZE`
`static String`	`DEF_BUFFERSIZE_STR`
`static int`	`DEF_MAX_PDU_LENGTH`
`static int`	`DEF_SOCKETDELAY`
`private static String[]`	`DEFAULT_TLS_PROTOCOLS`
`private Device`	`device`
`private Map<Class<? extends ConnectionExtension>,ConnectionExtension>`	`extensions`
`private InetAddress`	`hostAddr`
`private String`	`hostname`
`private String`	`httpProxy`
`private String`	`httpProxyProviderName`
`private String`	`httpProxyProviderVersion`
`private int`	`idleTimeout`
`private Listener`	`listener`
`static Logger`	`LOG`
`private int`	`maxOpsInvoked`
`private int`	`maxOpsPerformed`
`static int`	`NO_TIMEOUT`
`static String`	`NO_TIMEOUT_STR`
`static int`	`NOT_LISTENING`
`private String`	`olockHash`
`private boolean`	`packPDV`
`private int`	`port`
`private Connection.Protocol`	`protocol`
`private boolean`	`rebindNeeded`
`private int`	`receiveBufferSize`
`private int`	`receivePDULength`
`private int`	`releaseTimeout`
`private int`	`requestTimeout`
`private int`	`responseTimeout`
`private int`	`retrieveTimeout`
`private int`	`sendBufferSize`
`private int`	`sendPDULength`
`private static long`	`serialVersionUID`
`private int`	`socketCloseDelay`
`private int`	`socketTimeout`
`static int`	`SYNCHRONOUS_MODE`
`private static EnumMap<Connection.Protocol,TCPProtocolHandler>`	`tcpHandlers`
`private boolean`	`tcpNoDelay`
`static String`	`TLS_RSA_WITH_3DES_EDE_CBC_SHA`
`static String`	`TLS_RSA_WITH_AES_128_CBC_SHA`
`static String`	`TLS_RSA_WITH_NULL_SHA`
`private String[]`	`tlsCipherSuites`
`private boolean`	`tlsNeedClientAuth`
`private String[]`	`tlsProtocols`
`private static EnumMap<Connection.Protocol,UDPProtocolHandler>`	`udpHandlers`
`private String`	`uuid`

Constructor Summary

Constructors
Constructor and Description
`Connection()`
`Connection(String commonName, String hostname)`
`Connection(String commonName, String hostname, int port)`
`Connection(String commonName, String hostname, int port, int timeout)`

Method Summary

All Methods Static Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`void`	`addExtension(ConnectionExtension connectionExtension)`
`boolean`	`bind()` Bind this network connection to a TCP port and start a server socket accept loop.
`private InetAddress`	`bindAddr()`
`private List<InetAddress>`	`blacklistAddrs()`
`private void`	`checkCompatible(Connection remoteConn)`
`private void`	`checkInstalled()`
`private InetAddress`	`clientBindAddr()`
`void`	`close(Socket s)`
`Socket`	`connect(Connection remoteConn)`
`DatagramSocket`	`createDatagramSocket()`
`private SSLSocket`	`createTLSSocket(Socket s, Connection remoteConn)`
`(package private) boolean`	`equalsRDN(Connection other)`
`int`	`getAcceptTimeout()`
`int`	`getBacklog()`
`String`	`getBindAddress()` Bind address of listening socket or `null`.
`InetSocketAddress`	`getBindPoint()`
`String[]`	`getBlacklist()` Get a list of IP addresses from which we should ignore connections.
`String`	`getClientBindAddress()` Bind address of outgoing connections, `"0.0.0.0"` or `null`.
`InetSocketAddress`	`getClientBindPoint()`
`String`	`getCommonName()` An arbitrary name for the Network Connections object.
`Boolean`	`getConnectionInstalled()`
`int`	`getConnectTimeout()`
`Device`	`getDevice()` Get the `Device` object that this Network Connection belongs to.
`InetSocketAddress`	`getEndPoint()`
`<T> T`	`getExtension(Class<T> clazz)`
`Map<Class<? extends ConnectionExtension>,ConnectionExtension>`	`getExtensions()`
`String`	`getHostname()` This is the DNS name for this particular connection.
`String`	`getHttpProxy()`
`String`	`getHttpProxyProviderName()`
`String`	`getHttpProxyProviderVersion()`
`int`	`getIdleTimeout()`
`Listener`	`getListener()`
`int`	`getMaxOpsInvoked()`
`int`	`getMaxOpsPerformed()`
`String`	`getOlockHash()`
`int`	`getPort()` The TCP port that the AE is listening on or `-1` for a network connection that only initiates associations.
`Connection.Protocol`	`getProtocol()`
`ProxyManager`	`getProxyManager()`
`int`	`getReceiveBufferSize()` Get the SO_RCVBUF socket value in KB.
`int`	`getReceivePDULength()`
`int`	`getReleaseTimeout()` Timeout in ms for receiving A-RELEASE-RP, 5000 by default.
`int`	`getRequestTimeout()` Timeout in ms for receiving A-ASSOCIATE-RQ, 5000 by default
`int`	`getResponseTimeout()`
`int`	`getRetrieveTimeout()`
`int`	`getSendBufferSize()` Get the SO_SNDBUF socket option value in KB,
`int`	`getSendPDULength()`
`int`	`getSocketCloseDelay()` Delay in ms for Socket close after sending A-ABORT, 50ms by default.
`int`	`getSocketTimeout()`
`String[]`	`getTlsCipherSuites()` The TLS CipherSuites that are supported on this particular connection.
`String[]`	`getTlsProtocols()`
`String`	`getUuid()`
`private boolean`	`hasCommon(String[] ss1, String[] ss2)`
`private InetAddress`	`hostAddr()`
`private static String[]`	`intersect(String[] ss1, String[] ss2)`
`boolean`	`isBlackListed(InetAddress ia)`
`boolean`	`isCompatible(Connection remoteConn)`
`boolean`	`isInstalled()` True if the Network Connection is installed on the network.
`boolean`	`isListening()`
`boolean`	`isPackPDV()`
`(package private) boolean`	`isRebindNeeded()`
`boolean`	`isServer()`
`boolean`	`isTcpNoDelay()` Determine if this network connection is using Nagle's algorithm as part of its network communication.
`boolean`	`isTls()`
`boolean`	`isTlsNeedClientAuth()`
`(package private) void`	`needRebind()`
`StringBuilder`	`promptTo(StringBuilder sb, String indent)`
`(package private) void`	`rebind()`
`(package private) void`	`reconfigure(Connection from)`
`private void`	`reconfigureExtensions(Connection from)`
`static TCPProtocolHandler`	`registerTCPProtocolHandler(Connection.Protocol protocol, TCPProtocolHandler handler)`
`static UDPProtocolHandler`	`registerUDPProtocolHandler(Connection.Protocol protocol, UDPProtocolHandler handler)`
`void`	`setAcceptTimeout(int timeout)`
`void`	`setBacklog(int backlog)`
`void`	`setBindAddress(String bindAddress)` Bind address of listening socket or `null`.
`void`	`setBlacklist(String[] blacklist)` Set a list of IP addresses from which we should ignore connections.
`void`	`setClientBindAddress(String bindAddress)` Bind address of outgoing connections, `"0.0.0.0"` or `null`.
`void`	`setCommonName(String name)` An arbitrary name for the Network Connections object.
`void`	`setConnectionInstalled(Boolean installed)` True if the Network Connection is installed on the network.
`void`	`setConnectTimeout(int timeout)`
`void`	`setDevice(Device device)` Set the `Device` object that this Network Connection belongs to.
`void`	`setExtensions(Map<Class<? extends ConnectionExtension>,ConnectionExtension> extensions)`
`void`	`setHostname(String hostname)` This is the DNS name for this particular connection.
`void`	`setHttpProxy(String proxy)`
`void`	`setHttpProxyProviderName(String httpProxyProviderName)`
`void`	`setHttpProxyProviderVersion(String httpProxyProviderVersion)`
`void`	`setIdleTimeout(int idleTimeout)`
`void`	`setMaxOpsInvoked(int maxOpsInvoked)`
`void`	`setMaxOpsPerformed(int maxOpsPerformed)`
`void`	`setOlockHash(String olockHash)`
`void`	`setPackPDV(boolean packPDV)`
`void`	`setPort(int port)` The TCP port that the AE is listening on or `0` for a network connection that only initiates associations.
`void`	`setProtocol(Connection.Protocol protocol)`
`void`	`setReceiveBufferSize(DatagramSocket ds)`
`void`	`setReceiveBufferSize(int size)` Set the SO_RCVBUF socket option to specified value in KB.
`(package private) void`	`setReceiveBufferSize(ServerSocket ss)`
`private void`	`setReceiveBufferSize(Socket s)`
`void`	`setReceivePDULength(int receivePDULength)`
`void`	`setReleaseTimeout(int timeout)` Timeout in ms for receiving A-RELEASE-RP, 5000 by default.
`void`	`setRequestTimeout(int timeout)` Timeout in ms for receiving A-ASSOCIATE-RQ, 5000 by default
`void`	`setResponseTimeout(int timeout)`
`void`	`setRetrieveTimeout(int timeout)`
`void`	`setSendBufferSize(int size)` Set the SO_SNDBUF socket option to specified value in KB,
`void`	`setSendPDULength(int sendPDULength)`
`void`	`setSocketCloseDelay(int delay)` Delay in ms for Socket close after sending A-ABORT, 50ms by default.
`(package private) void`	`setSocketSendOptions(Socket s)`
`void`	`setSocketTimeout(int socketTimeout)`
`void`	`setTcpNoDelay(boolean tcpNoDelay)` Set whether or not this network connection should use Nagle's algorithm as part of its network communication.
`void`	`setTlsCipherSuites(String... tlsCipherSuites)` The TLS CipherSuites that are supported on this particular connection.
`void`	`setTlsNeedClientAuth(boolean tlsNeedClientAuth)`
`void`	`setTlsProtocols(String... tlsProtocols)`
`void`	`setUuid(String uuid)`
`String[]`	`tlsProtocols()`
`String`	`toString()`
`void`	`unbind()`
`static TCPProtocolHandler`	`unregisterTCPProtocolHandler(Connection.Protocol protocol)`
`static UDPProtocolHandler`	`unregisterUDPProtocolHandler(Connection.Protocol protocol)`
`boolean`	`useHttpProxy()`

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Field Detail

serialVersionUID
```
private static final long serialVersionUID
```
See Also:

Constant Field Values

LOG
```
public static final Logger LOG
```

NO_TIMEOUT_STR

public static final String NO_TIMEOUT_STR

See Also:: Constant Field Values

NO_TIMEOUT
```
public static final int NO_TIMEOUT
```

SYNCHRONOUS_MODE
```
public static final int SYNCHRONOUS_MODE
```
See Also:

Constant Field Values

NOT_LISTENING
```
public static final int NOT_LISTENING
```
See Also:

Constant Field Values

DEF_BACKLOG
```
public static final int DEF_BACKLOG
```
See Also:

Constant Field Values

DEF_SOCKETDELAY
```
public static final int DEF_SOCKETDELAY
```
See Also:

Constant Field Values

DEF_BUFFERSIZE_STR

public static final String DEF_BUFFERSIZE_STR

See Also:: Constant Field Values

DEF_BUFFERSIZE
```
public static final int DEF_BUFFERSIZE
```

DEF_MAX_PDU_LENGTH
```
public static final int DEF_MAX_PDU_LENGTH
```
See Also:

Constant Field Values

TLS_RSA_WITH_NULL_SHA

public static final String TLS_RSA_WITH_NULL_SHA

See Also:: Constant Field Values

TLS_RSA_WITH_3DES_EDE_CBC_SHA

public static final String TLS_RSA_WITH_3DES_EDE_CBC_SHA

See Also:: Constant Field Values

TLS_RSA_WITH_AES_128_CBC_SHA

public static final String TLS_RSA_WITH_AES_128_CBC_SHA

See Also:: Constant Field Values

DEFAULT_TLS_PROTOCOLS

private static final String[] DEFAULT_TLS_PROTOCOLS

device
```
private Device device
```

commonName
```
private String commonName
```

hostname
```
private String hostname
```

olockHash
```
private String olockHash
```

uuid
```
private String uuid
```

bindAddress
```
private String bindAddress
```

clientBindAddress
```
private String clientBindAddress
```

httpProxy
```
private String httpProxy
```

port
```
private int port
```

backlog
```
private int backlog
```

connectTimeout
```
private int connectTimeout
```

requestTimeout
```
private int requestTimeout
```

acceptTimeout
```
private int acceptTimeout
```

releaseTimeout
```
private int releaseTimeout
```

responseTimeout
```
private int responseTimeout
```

retrieveTimeout
```
private int retrieveTimeout
```

idleTimeout
```
private int idleTimeout
```

socketTimeout
```
private int socketTimeout
```

socketCloseDelay
```
private int socketCloseDelay
```

sendBufferSize
```
private int sendBufferSize
```

receiveBufferSize
```
private int receiveBufferSize
```

sendPDULength
```
private int sendPDULength
```

receivePDULength
```
private int receivePDULength
```

maxOpsPerformed
```
private int maxOpsPerformed
```

maxOpsInvoked
```
private int maxOpsInvoked
```

packPDV
```
private boolean packPDV
```

tcpNoDelay
```
private boolean tcpNoDelay
```

tlsNeedClientAuth
```
private boolean tlsNeedClientAuth
```

tlsCipherSuites
```
private String[] tlsCipherSuites
```

httpProxyProviderName
```
private String httpProxyProviderName
```

httpProxyProviderVersion

private String httpProxyProviderVersion

tlsProtocols
```
private String[] tlsProtocols
```

blacklist
```
private String[] blacklist
```

connectionInstalled
```
private Boolean connectionInstalled
```

extensions

private Map<Class<? extends ConnectionExtension>,ConnectionExtension> extensions

protocol
```
private Connection.Protocol protocol
```

tcpHandlers

private static final EnumMap<Connection.Protocol,TCPProtocolHandler> tcpHandlers

udpHandlers

private static final EnumMap<Connection.Protocol,UDPProtocolHandler> udpHandlers

blacklistAddrs

private transient List<InetAddress> blacklistAddrs

hostAddr
```
private transient InetAddress hostAddr
```

bindAddr
```
private transient InetAddress bindAddr
```

clientBindAddr

private transient InetAddress clientBindAddr

listener

private transient volatile Listener listener

rebindNeeded
```
private transient boolean rebindNeeded
```

Constructor Detail

Connection
```
public Connection()
```

Connection

public Connection(String commonName,
                  String hostname)

Connection

public Connection(String commonName,
                  String hostname,
                  int port)

Connection

public Connection(String commonName,
                  String hostname,
                  int port,
                  int timeout)

Parameters:: commonName -; hostname -; port -; timeout - value in seconds to assign to all timeouts

Method Detail
- getUuid
```
public String getUuid()
```
- setUuid
```
public void setUuid(String uuid)
```
- registerTCPProtocolHandler
```
public static TCPProtocolHandler registerTCPProtocolHandler(Connection.Protocol protocol,
                                                            TCPProtocolHandler handler)
```
- unregisterTCPProtocolHandler
```
public static TCPProtocolHandler unregisterTCPProtocolHandler(Connection.Protocol protocol)
```
- registerUDPProtocolHandler
```
public static UDPProtocolHandler registerUDPProtocolHandler(Connection.Protocol protocol,
                                                            UDPProtocolHandler handler)
```
- unregisterUDPProtocolHandler
```
public static UDPProtocolHandler unregisterUDPProtocolHandler(Connection.Protocol protocol)
```
- getDevice
```
public Device getDevice()
```
  Get the Device object that this Network Connection belongs to.
  
  Returns:
  
  Device
- setDevice
```
public void setDevice(Device device)
```
  Set the Device object that this Network Connection belongs to.
  
  Parameters:
  
  device - The owning Device object.
- getHostname
```
public final String getHostname()
```
  This is the DNS name for this particular connection. This is used to obtain the current IP address for connections. Hostname must be sufficiently qualified to be unambiguous for any client DNS user.
  
  Returns:
  
  A String containing the host name.
- getHttpProxyProviderName
```
public String getHttpProxyProviderName()
```
- getHttpProxyProviderVersion
```
public String getHttpProxyProviderVersion()
```
- setHostname
```
public final void setHostname(String hostname)
```
  This is the DNS name for this particular connection. This is used to obtain the current IP address for connections. Hostname must be sufficiently qualified to be unambiguous for any client DNS user.
  
  Parameters:
  
  hostname - A String containing the host name.
- getBindAddress
```
public final String getBindAddress()
```
  Bind address of listening socket or null. If null, bind listening socket to getHostname(). This is the default.
  The bind address can also include system properties with the ${system.property} syntax, that need to be resolved.
  
  Returns:
  
  Bind address of the connection or null
- setBindAddress
```
public final void setBindAddress(String bindAddress)
```
  Bind address of listening socket or null. If null, bind listening socket to getHostname().
  The bind address can also include system properties with the ${system.property} syntax, that will be resolved.
  
  Parameters:
  
  bindAddress - Bind address of listening socket or null
- getClientBindAddress
```
public String getClientBindAddress()
```
  Bind address of outgoing connections, "0.0.0.0" or null. If "0.0.0.0" the system pick up any local ip for outgoing connections. If null, bind outgoing connections to getHostname(). This is the default.
  
  Returns:
  
  Bind address of outgoing connection, 0.0.0.0 or null
- getProxyManager
```
public ProxyManager getProxyManager()
```
- setClientBindAddress
```
public void setClientBindAddress(String bindAddress)
```
  Bind address of outgoing connections, "0.0.0.0" or null. If "0.0.0.0" the system pick up any local ip for outgoing connections. If null, bind outgoing connections to getHostname().
  
  Parameters:
  
  bindAddress - Bind address of outgoing connection or null
- getProtocol
```
public Connection.Protocol getProtocol()
```
- setProtocol
```
public void setProtocol(Connection.Protocol protocol)
```
- isRebindNeeded
```
boolean isRebindNeeded()
```
- needRebind
```
void needRebind()
```
- getCommonName
```
public final String getCommonName()
```
  An arbitrary name for the Network Connections object. Can be a meaningful name or any unique sequence of characters.
  
  Returns:
  
  A String containing the name.
- setCommonName
```
public final void setCommonName(String name)
```
  An arbitrary name for the Network Connections object. Can be a meaningful name or any unique sequence of characters.
  
  Parameters:
  
  name - A String containing the name.
- getPort
```
public final int getPort()
```
  The TCP port that the AE is listening on or -1 for a network connection that only initiates associations.
  
  Returns:
  
  An int containing the port number or -1.
- setPort
```
public final void setPort(int port)
```
  The TCP port that the AE is listening on or 0 for a network connection that only initiates associations.
  A valid port value is between 0 and 65535.
  
  Parameters:
  
  port - The port number or -1.
- getExtensions
```
public Map<Class<? extends ConnectionExtension>,ConnectionExtension> getExtensions()
```
- setExtensions
```
public void setExtensions(Map<Class<? extends ConnectionExtension>,ConnectionExtension> extensions)
```
- getExtension
```
public <T> T getExtension(Class<T> clazz)
```
- addExtension
```
public void addExtension(ConnectionExtension connectionExtension)
```
- setHttpProxyProviderName
```
public void setHttpProxyProviderName(String httpProxyProviderName)
```
- setHttpProxyProviderVersion
```
public void setHttpProxyProviderVersion(String httpProxyProviderVersion)
```
- reconfigureExtensions
```
private void reconfigureExtensions(Connection from)
```
- getHttpProxy
```
public final String getHttpProxy()
```
- setHttpProxy
```
public final void setHttpProxy(String proxy)
```
- useHttpProxy
```
public final boolean useHttpProxy()
```
- isServer
```
public final boolean isServer()
```
- getBacklog
```
public final int getBacklog()
```
- setBacklog
```
public final void setBacklog(int backlog)
```
- getConnectTimeout
```
public final int getConnectTimeout()
```
- setConnectTimeout
```
public final void setConnectTimeout(int timeout)
```
- getRequestTimeout
```
public final int getRequestTimeout()
```
  Timeout in ms for receiving A-ASSOCIATE-RQ, 5000 by default
  
  Returns:
  
  An int value containing the milliseconds.
- setRequestTimeout
```
public final void setRequestTimeout(int timeout)
```
  Timeout in ms for receiving A-ASSOCIATE-RQ, 5000 by default
  
  Parameters:
  
  timeout - An int value containing the milliseconds.
- getAcceptTimeout
```
public final int getAcceptTimeout()
```
- setAcceptTimeout
```
public final void setAcceptTimeout(int timeout)
```
- getReleaseTimeout
```
public final int getReleaseTimeout()
```
  Timeout in ms for receiving A-RELEASE-RP, 5000 by default.
  
  Returns:
  
  An int value containing the milliseconds.
- setReleaseTimeout
```
public final void setReleaseTimeout(int timeout)
```
  Timeout in ms for receiving A-RELEASE-RP, 5000 by default.
  
  Parameters:
  
  timeout - An int value containing the milliseconds.
- getSocketCloseDelay
```
public final int getSocketCloseDelay()
```
  Delay in ms for Socket close after sending A-ABORT, 50ms by default.
  
  Returns:
  
  An int value containing the milliseconds.
- setSocketCloseDelay
```
public final void setSocketCloseDelay(int delay)
```
  Delay in ms for Socket close after sending A-ABORT, 50ms by default.
  
  Parameters:
  
  delay - An int value containing the milliseconds.
- setResponseTimeout
```
public final void setResponseTimeout(int timeout)
```
- getResponseTimeout
```
public final int getResponseTimeout()
```
- getRetrieveTimeout
```
public final int getRetrieveTimeout()
```
- setRetrieveTimeout
```
public final void setRetrieveTimeout(int timeout)
```
- getIdleTimeout
```
public final int getIdleTimeout()
```
- setIdleTimeout
```
public final void setIdleTimeout(int idleTimeout)
```
- getSocketTimeout
```
public final int getSocketTimeout()
```
- setSocketTimeout
```
public final void setSocketTimeout(int socketTimeout)
```
- getTlsCipherSuites
```
public String[] getTlsCipherSuites()
```
  The TLS CipherSuites that are supported on this particular connection. TLS CipherSuites shall be described using an RFC-2246 string representation (e.g. 'SSL_RSA_WITH_3DES_EDE_CBC_SHA')
  
  Returns:
  
  A String array containing the supported cipher suites
- setTlsCipherSuites
```
public void setTlsCipherSuites(String... tlsCipherSuites)
```
  The TLS CipherSuites that are supported on this particular connection. TLS CipherSuites shall be described using an RFC-2246 string representation (e.g. 'SSL_RSA_WITH_3DES_EDE_CBC_SHA')
  
  Parameters:
  
  tlsCipherSuites - A String array containing the supported cipher suites
- isTls
```
public final boolean isTls()
```
- tlsProtocols
```
public final String[] tlsProtocols()
```
- getTlsProtocols
```
public final String[] getTlsProtocols()
```
- setTlsProtocols
```
public final void setTlsProtocols(String... tlsProtocols)
```
- isTlsNeedClientAuth
```
public final boolean isTlsNeedClientAuth()
```
- setTlsNeedClientAuth
```
public final void setTlsNeedClientAuth(boolean tlsNeedClientAuth)
```
- getReceiveBufferSize
```
public final int getReceiveBufferSize()
```
  Get the SO_RCVBUF socket value in KB.
  
  Returns:
  
  An int value containing the buffer size in KB.
- setReceiveBufferSize
```
public final void setReceiveBufferSize(int size)
```
  Set the SO_RCVBUF socket option to specified value in KB.
  
  Parameters:
  
  size - An int value containing the buffer size in KB.
- getSendBufferSize
```
public final int getSendBufferSize()
```
  Get the SO_SNDBUF socket option value in KB,
  
  Returns:
  
  An int value containing the buffer size in KB.
- setSendBufferSize
```
public final void setSendBufferSize(int size)
```
  Set the SO_SNDBUF socket option to specified value in KB,
  
  Parameters:
  
  size - An int value containing the buffer size in KB.
- getSendPDULength
```
public final int getSendPDULength()
```
- setSendPDULength
```
public final void setSendPDULength(int sendPDULength)
```
- getReceivePDULength
```
public final int getReceivePDULength()
```
- setReceivePDULength
```
public final void setReceivePDULength(int receivePDULength)
```
- getMaxOpsPerformed
```
public final int getMaxOpsPerformed()
```
- setMaxOpsPerformed
```
public final void setMaxOpsPerformed(int maxOpsPerformed)
```
- getMaxOpsInvoked
```
public final int getMaxOpsInvoked()
```
- setMaxOpsInvoked
```
public final void setMaxOpsInvoked(int maxOpsInvoked)
```
- isPackPDV
```
public final boolean isPackPDV()
```
- setPackPDV
```
public final void setPackPDV(boolean packPDV)
```
- isTcpNoDelay
```
public final boolean isTcpNoDelay()
```
  Determine if this network connection is using Nagle's algorithm as part of its network communication.
  
  Returns:
  
  boolean True if TCP no delay (disable Nagle's algorithm) is used.
- setTcpNoDelay
```
public final void setTcpNoDelay(boolean tcpNoDelay)
```
  Set whether or not this network connection should use Nagle's algorithm as part of its network communication.
  
  Parameters:
  
  tcpNoDelay - boolean True if TCP no delay (disable Nagle's algorithm) should be used.
- isInstalled
```
public boolean isInstalled()
```
  True if the Network Connection is installed on the network. If not present, information about the installed status of the Network Connection is inherited from the device.
  
  Returns:
  
  boolean True if the NetworkConnection is installed on the network.
- getConnectionInstalled
```
public Boolean getConnectionInstalled()
```
- setConnectionInstalled
```
public void setConnectionInstalled(Boolean installed)
```
  True if the Network Connection is installed on the network. If not present, information about the installed status of the Network Connection is inherited from the device.
  
  Parameters:
  
  installed - True if the NetworkConnection is installed on the network.
  
  Throws:
  
  GeneralSecurityException
- rebind
```
void rebind()
     throws IOException,
            GeneralSecurityException
```
  Throws:
  
  IOException
  
  GeneralSecurityException
- getBlacklist
```
public final String[] getBlacklist()
```
  Get a list of IP addresses from which we should ignore connections. Useful in an environment that utilizes a load balancer. In the case of a TCP ping from a load balancing switch, we don't want to spin off a new thread and try to negotiate an association.
  
  Returns:
  
  Returns the list of IP addresses which should be ignored.
- setBlacklist
```
public final void setBlacklist(String[] blacklist)
```
  Set a list of IP addresses from which we should ignore connections. Useful in an environment that utilizes a load balancer. In the case of a TCP ping from a load balancing switch, we don't want to spin off a new thread and try to negotiate an association.
  
  Parameters:
  
  blacklist - the list of IP addresses which should be ignored.
- toString
```
public String toString()
```
  Overrides:
  
  toString in class Object
- promptTo
```
public StringBuilder promptTo(StringBuilder sb,
                              String indent)
```
- setSocketSendOptions
```
void setSocketSendOptions(Socket s)
                   throws SocketException
```
  Throws:
  
  SocketException
- setReceiveBufferSize
```
private void setReceiveBufferSize(Socket s)
                           throws SocketException
```
  Throws:
  
  SocketException
- setReceiveBufferSize
```
void setReceiveBufferSize(ServerSocket ss)
                   throws SocketException
```
  Throws:
  
  SocketException
- setReceiveBufferSize
```
public void setReceiveBufferSize(DatagramSocket ds)
                          throws SocketException
```
  Throws:
  
  SocketException
- hostAddr
```
private InetAddress hostAddr()
                      throws UnknownHostException
```
  Throws:
  
  UnknownHostException
- bindAddr
```
private InetAddress bindAddr()
                      throws UnknownHostException
```
  Throws:
  
  UnknownHostException
- clientBindAddr
```
private InetAddress clientBindAddr()
                            throws UnknownHostException
```
  Throws:
  
  UnknownHostException
- blacklistAddrs
```
private List<InetAddress> blacklistAddrs()
```
- getEndPoint
```
public InetSocketAddress getEndPoint()
                              throws UnknownHostException
```
  Throws:
  
  UnknownHostException
- getBindPoint
```
public InetSocketAddress getBindPoint()
                               throws UnknownHostException
```
  Throws:
  
  UnknownHostException
- getClientBindPoint
```
public InetSocketAddress getClientBindPoint()
                                     throws UnknownHostException
```
  Throws:
  
  UnknownHostException
- checkInstalled
```
private void checkInstalled()
```
- checkCompatible
```
private void checkCompatible(Connection remoteConn)
                      throws IncompatibleConnectionException
```
  Throws:
  
  IncompatibleConnectionException
- bind
```
public boolean bind()
             throws IOException,
                    GeneralSecurityException
```
  Bind this network connection to a TCP port and start a server socket accept loop.
  
  Throws:
  
  IOException - If there is a problem with the network interaction.
  
  GeneralSecurityException
- isListening
```
public final boolean isListening()
```
- isBlackListed
```
public boolean isBlackListed(InetAddress ia)
```
- unbind
```
public void unbind()
```
- connect
```
public Socket connect(Connection remoteConn)
               throws IOException,
                      IncompatibleConnectionException,
                      GeneralSecurityException
```
  Throws:
  
  IOException
  
  IncompatibleConnectionException
  
  GeneralSecurityException
- createDatagramSocket
```
public DatagramSocket createDatagramSocket()
                                    throws IOException
```
  Throws:
  
  IOException
- getListener
```
public Listener getListener()
```
- createTLSSocket
```
private SSLSocket createTLSSocket(Socket s,
                                  Connection remoteConn)
                           throws GeneralSecurityException,
                                  IOException
```
  Throws:
  
  GeneralSecurityException
  
  IOException
- close
```
public void close(Socket s)
```
- isCompatible
```
public boolean isCompatible(Connection remoteConn)
```
- hasCommon
```
private boolean hasCommon(String[] ss1,
                          String[] ss2)
```
- intersect
```
private static String[] intersect(String[] ss1,
                                  String[] ss2)
```
- equalsRDN
```
boolean equalsRDN(Connection other)
```
- getOlockHash
```
public String getOlockHash()
```
- setOlockHash
```
public void setOlockHash(String olockHash)
```
- reconfigure
```
void reconfigure(Connection from)
```

Class Connection

Nested Class Summary

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

serialVersionUID

LOG

NO_TIMEOUT_STR

NO_TIMEOUT

SYNCHRONOUS_MODE

NOT_LISTENING

DEF_BACKLOG

DEF_SOCKETDELAY

DEF_BUFFERSIZE_STR

DEF_BUFFERSIZE

DEF_MAX_PDU_LENGTH

TLS_RSA_WITH_NULL_SHA

TLS_RSA_WITH_3DES_EDE_CBC_SHA

TLS_RSA_WITH_AES_128_CBC_SHA

DEFAULT_TLS_PROTOCOLS

device

commonName

hostname

olockHash

uuid

bindAddress

clientBindAddress

httpProxy

port

backlog

connectTimeout

requestTimeout

acceptTimeout

releaseTimeout

responseTimeout

retrieveTimeout

idleTimeout

socketTimeout

socketCloseDelay

sendBufferSize

receiveBufferSize

sendPDULength

receivePDULength

maxOpsPerformed

maxOpsInvoked

packPDV

tcpNoDelay

tlsNeedClientAuth

tlsCipherSuites

httpProxyProviderName

httpProxyProviderVersion

tlsProtocols

blacklist

connectionInstalled

extensions

protocol

tcpHandlers

udpHandlers

blacklistAddrs

hostAddr

bindAddr

clientBindAddr

listener

rebindNeeded

Constructor Detail

Connection

Connection

Connection

Connection

Method Detail

getUuid

setUuid

registerTCPProtocolHandler

unregisterTCPProtocolHandler

registerUDPProtocolHandler

unregisterUDPProtocolHandler

getDevice

setDevice