Skip navigation links

Oracle® Coherence Java API Reference
Release 3.7.0.0

E18683-01


com.tangosol.net
Class NonBlockingTcpDatagramSocket

java.lang.Object
  extended by java.net.DatagramSocket
      extended by com.tangosol.net.TcpDatagramSocket
          extended by com.tangosol.net.NonBlockingTcpDatagramSocket


public class NonBlockingTcpDatagramSocket
extends TcpDatagramSocket

TCP based non-blocking datagram socket implementation. In order to provide a non-blocking API this implementation may drop packets if the underlying TCP transfer buffers are full.

Author:
mf 2009.12.16

Nested Class Summary
static class NonBlockingTcpDatagramSocket.Impl
          A specialization of TcpDatagramSocket.Impl which provides non-blocking functionality, see NonBlockingTcpDatagramSocket.Impl.send(DatagramPacket).

 

Field Summary
static boolean SPLIT
          Flag indicating if split sockets should be used for TcpDatagram sockets.

 

Fields inherited from class com.tangosol.net.TcpDatagramSocket
IO_EXCEPTIONS_LOG_LEVEL, m_impl

 

Constructor Summary
  NonBlockingTcpDatagramSocket()
          Create a new NonBlockingTcpDatagramSocket that with a wildcard address bound to an ephemeral port.
  NonBlockingTcpDatagramSocket(int nPort)
          Creates a new NonBlockingTcpDatagramSocket using the wildcard address and the specified port number.
  NonBlockingTcpDatagramSocket(int nPort, java.net.InetAddress addr)
          Creates a new NonBlockingTcpDatagramSocket using an address and a port number.
protected NonBlockingTcpDatagramSocket(NonBlockingTcpDatagramSocket.Impl impl)
          Creates a new NonBlockingTcpDatagramSocket around an NonBlockingTcpDatagramSocket.Impl.
  NonBlockingTcpDatagramSocket(java.net.SocketAddress addr)
          Creates a new NonBlockingTcpDatagramSocket which will be bound to the specified address.
  NonBlockingTcpDatagramSocket(SocketProvider provider)
          Creates a new NonBlockingTcpDatagramSocket using the provider.

 

Method Summary

 

Methods inherited from class com.tangosol.net.TcpDatagramSocket
bind, isBound, provider, receive, send, setAdvanceFrequency, setListenBacklog, setPacketMagic, setSocketOptions, toString

 

Methods inherited from class java.net.DatagramSocket
close, connect, connect, disconnect, getBroadcast, getChannel, getInetAddress, getLocalAddress, getLocalPort, getLocalSocketAddress, getPort, getReceiveBufferSize, getRemoteSocketAddress, getReuseAddress, getSendBufferSize, getSoTimeout, getTrafficClass, isClosed, isConnected, setBroadcast, setDatagramSocketImplFactory, setReceiveBufferSize, setReuseAddress, setSendBufferSize, setSoTimeout, setTrafficClass

 

Field Detail

SPLIT

public static final boolean SPLIT
Flag indicating if split sockets should be used for TcpDatagram sockets. While this should ideally never be needed, testing on Linux has shown that under heavy packet loads the socket can appear to stall and refuse to accept or emit data. Worse still while the socket is in this state the NIC is transmitting ~300,000 packets/second, even when the process is paused CTRL+Z'd. This setting is conceptually similar to the "tangosol.coherence.datagram.splitsocket" but only applies to TcpDatagram sockets. Additionally it does not require multiple listening ports, just multiple connections. As of 3.6.1 this value defaults to false. This became "safe" in 3.6.1 since this version began using multiple listening sockets, and avoids the case which would be likely to trigger the Linux stall issue.

Constructor Detail

NonBlockingTcpDatagramSocket

public NonBlockingTcpDatagramSocket()
                             throws java.net.SocketException
Create a new NonBlockingTcpDatagramSocket that with a wildcard address bound to an ephemeral port.
Throws:
java.net.SocketException - if any error happens during the bind, or if the port is unavailable

NonBlockingTcpDatagramSocket

public NonBlockingTcpDatagramSocket(java.net.SocketAddress addr)
                             throws java.net.SocketException
Creates a new NonBlockingTcpDatagramSocket which will be bound to the specified address.
Parameters:
addr - the address to bind
Throws:
java.net.SocketException - if any error happens during the bind, or if the port is unavailable

NonBlockingTcpDatagramSocket

public NonBlockingTcpDatagramSocket(int nPort)
                             throws java.net.SocketException
Creates a new NonBlockingTcpDatagramSocket using the wildcard address and the specified port number.

The port number should be between 0 and 65535. Zero means that the system will pick an ephemeral port during the bind operation.

Parameters:
nPort - the port to bind to
Throws:
java.net.SocketException - if any error happens during the bind, or if the port is unavailable

NonBlockingTcpDatagramSocket

public NonBlockingTcpDatagramSocket(int nPort,
                                    java.net.InetAddress addr)
                             throws java.net.SocketException
Creates a new NonBlockingTcpDatagramSocket using an address and a port number.

If null is specified as the address assigned will be the wildcard address.

The port number should be between 0 and 65535. Zero means that the system will pick an ephemeral port during the bind operation.

Parameters:
nPort - the port number
addr - the IP address
Throws:
java.net.SocketException - if any error happens during the bind, or if the port is unavailable

NonBlockingTcpDatagramSocket

public NonBlockingTcpDatagramSocket(SocketProvider provider)
                             throws java.net.SocketException
Creates a new NonBlockingTcpDatagramSocket using the provider.
Parameters:
provider - the provider to be used
Throws:
java.net.SocketException - if any error happens during the bind, or if the port is unavailable

NonBlockingTcpDatagramSocket

protected NonBlockingTcpDatagramSocket(NonBlockingTcpDatagramSocket.Impl impl)
Creates a new NonBlockingTcpDatagramSocket around an NonBlockingTcpDatagramSocket.Impl.
Parameters:
impl - a NonBlockingTcpDatagramSocket.Impl

Skip navigation links

Oracle® Coherence Java API Reference
Release 3.7.0.0

E18683-01


Copyright © 2000, 2011, Oracle and/or its affiliates. All rights reserved.