Socket

Creates a new unconnected socket. When a SocketImplFactory is defined it creates the internal socket implementation, otherwise the default socket implementation will be used for this socket.

Creates a new unconnected socket using the given proxy type. When a SocketImplFactory is defined it creates the internal socket implementation, otherwise the default socket implementation will be used for this socket.

Example that will create a socket connection through a SOCKS proxy server:
Socket sock = new Socket(new Proxy(Proxy.Type.SOCKS, new InetSocketAddress("test.domain.org", 2130)));

Creates a new streaming socket connected to the target host specified by the parameters dstName and dstPort. The socket is bound to any available port on the local host.

This implementation tries each IP address for the given hostname (in RFC 3484 order) until it either connects successfully or it exhausts the set.

Creates a new streaming socket connected to the target host specified by the parameters dstName and dstPort. On the local endpoint the socket is bound to the given address localAddress on port localPort. If host is null a loopback address is used to connect to.

This implementation tries each IP address for the given hostname (in RFC 3484 order) until it either connects successfully or it exhausts the set.

Creates a new streaming or datagram socket connected to the target host specified by the parameters hostName and port. The socket is bound to any available port on the local host.

This implementation tries each IP address for the given hostname (in RFC 3484 order) until it either connects successfully or it exhausts the set.

Creates a new streaming socket connected to the target host specified by the parameters dstAddress and dstPort. The socket is bound to any available port on the local host.

Creates a new streaming socket connected to the target host specified by the parameters dstAddress and dstPort. On the local endpoint the socket is bound to the given address localAddress on port localPort.

Creates a new streaming or datagram socket connected to the target host specified by the parameters addr and port. The socket is bound to any available port on the local host.

Creates an unconnected socket with the given socket implementation.

Binds this socket to the given local host address and port specified by the SocketAddress localAddr. If localAddr is set to null, this socket will be bound to an available local address on any free port.

Closes the socket. It is not possible to reconnect or rebind to this socket thereafter which means a new socket instance has to be created.

Connects this socket to the given remote host address and port specified by the SocketAddress remoteAddr with the specified timeout. The connecting method will block until the connection is established or an error occurred.

Connects this socket to the given remote host address and port specified by the SocketAddress remoteAddr.

Returns this socket's SocketChannel, if one exists. A channel is available only if this socket wraps a channel. (That is, you can go from a channel to a socket and back again, but you can't go from an arbitrary socket to a channel.) In practice, this means that the socket must have been created by accept() or open().

Returns the IP address of the target host this socket is connected to, or null if this socket is not yet connected.

Returns an input stream to read data from this socket. If the socket has an associated SocketChannel and that channel is in non-blocking mode then reads from the stream will throw a IllegalBlockingModeException.

Returns this socket's SO_KEEPALIVE setting.

Returns the local IP address this socket is bound to, or an address for which isAnyLocalAddress() returns true if the socket is closed or unbound.

Returns the local port this socket is bound to, or -1 if the socket is unbound. If the socket has been closed this method will still return the local port the socket was bound to.

Returns the local address and port of this socket as a SocketAddress or null if the socket has never been bound. If the socket is closed but has previously been bound then an address for which isAnyLocalAddress() returns true will be returned with the previously-bound port. This is useful on multihomed hosts.

Returns this socket's SO_OOBINLINE setting.

Returns an output stream to write data into this socket. If the socket has an associated SocketChannel and that channel is in non-blocking mode then writes to the stream will throw a IllegalBlockingModeException.

Returns the port number of the target host this socket is connected to, or 0 if this socket is not yet connected.

Returns this socket's receive buffer size.

Returns the remote address and port of this socket as a SocketAddress or null if the socket is not connected.

Returns this socket's SO_REUSEADDR setting.

Returns this socket's send buffer size.

Returns this socket's linger timeout in seconds, or -1 for no linger (i.e. close will return immediately).

Returns this socket's receive timeout.

Returns this socket's SocketOptions#TCP_NODELAY setting.

Returns this socket's setting.

Returns whether this socket is bound to a local address and port.

Returns whether this socket is closed.

Returns whether this socket is connected to a remote host.

Returns whether the incoming channel of the socket has already been closed.

Returns whether the outgoing channel of the socket has already been closed.

Sends the given single byte data which is represented by the lowest octet of value as "TCP urgent data".

Sets this socket's SO_KEEPALIVE option.

Sets this socket's SO_OOBINLINE option.

Sets performance preferences for connectionTime, latency and bandwidth.

This method does currently nothing.

Sets this socket's receive buffer size.

Sets this socket's SO_REUSEADDR option.

Sets this socket's send buffer size.

Sets this socket's linger timeout in seconds. If on is false, timeout is irrelevant.

Sets this socket's read timeout in milliseconds. Use 0 for no timeout. To take effect, this option must be set before the blocking method was called.

Sets the internal factory for creating socket implementations. This may only be executed once during the lifetime of the application.

Sets this socket's TCP_NODELAY option.

Sets this socket's IP_TOS value for every packet sent by this socket.

Closes the input stream of this socket. Any further data sent to this socket will be discarded. Reading from this socket after this method has been called will return the value EOF.

Closes the output stream of this socket. All buffered data will be sent followed by the termination sequence. Writing to the closed output stream will cause an IOException.

Returns a String containing a concise, human-readable description of the socket.