Package org.jboss.logmanager.handlers

Interface ClientSocketFactory

public interface ClientSocketFactory

A factory used to create writable sockets.

Author:

James R. Perkins

Method Summary

Modifier and Type	Method	Description
java.net.DatagramSocket	createDatagramSocket()	Creates a datagram socket for UDP communication.
java.net.Socket	createSocket()	Creates a TCP socket.
java.net.InetAddress	getAddress()	Returns the address being used to create sockets.
int	getPort()	Returns the port being used to create sockets.
default java.net.SocketAddress	getSocketAddress()	A convenience method to return the socket address.
static ClientSocketFactory	of(java.net.InetAddress address, int port)	Creates a new default implementation of the factory which uses SocketFactory.getDefault() for TCP sockets and new DatagramSocket() for UDP sockets.
static ClientSocketFactory	of(javax.net.SocketFactory socketFactory, java.net.InetAddress address, int port)	Creates a new default implementation of the factory which uses the provided socket factory to create TCP connections and new DatagramSocket() for UDP sockets.

Method Detail

createDatagramSocket

java.net.DatagramSocket createDatagramSocket()
                                      throws java.net.SocketException

Creates a datagram socket for UDP communication.

Returns:

the newly created socket

Throws:

java.net.SocketException - if binding the socket fails

createSocket

java.net.Socket createSocket()
                      throws java.io.IOException

Creates a TCP socket.

Returns:

the newly created socket

Throws:

java.io.IOException - if an error occurs creating the socket

getAddress

java.net.InetAddress getAddress()

Returns the address being used to create sockets.

Returns:

the address being used

getPort

int getPort()

Returns the port being used to create sockets.

Returns:

the port being used

getSocketAddress

default java.net.SocketAddress getSocketAddress()

A convenience method to return the socket address.

The default implementation simply returns new InetSocketAddress(getAddress(), getPort()).

Returns:

a socket address

of

static ClientSocketFactory of(java.net.InetAddress address,
                              int port)

Creates a new default implementation of the factory which uses SocketFactory.getDefault() for TCP sockets and new DatagramSocket() for UDP sockets.

Parameters:

address - the address to bind to

port - the port to bind to

Returns:

the client socket factory

of

static ClientSocketFactory of(javax.net.SocketFactory socketFactory,
                              java.net.InetAddress address,
                              int port)

Creates a new default implementation of the factory which uses the provided socket factory to create TCP connections and new DatagramSocket() for UDP sockets.

Parameters:

socketFactory - the socket factory used for TCP connections, if null the default socket factory will be used

address - the address to bind to

port - the port to bind to

Returns:

the client socket factory