org.jgroups.util

Interface SocketFactory

All Known Implementing Classes:

DefaultSocketFactory

public interface SocketFactory

Factory to create various types of sockets. For socket creation, a service name can be passed as argument: an implementation could look up a service description (e.g. port) and create the socket, ignoring the passed port and possibly also the bind address.

Ephemeral ports can be created by passing 0 as port, or (if the port is ignored), an implementation could pass in a special service name (e.g. "EPHEMERAL"), this is implementation dependent.

The socket creation methods have the same parameter lists as the socket constructors, e.g. createServerSocket(String, int, int) is the same as java.net.ServerSocket(int,int).

Author:

Bela Ban

Method Summary

Methods

Modifier and Type	Method and Description
void	close(DatagramSocket sock)
void	close(ServerSocket sock)
void	close(Socket sock)
DatagramSocket	createDatagramSocket(String service_name)
DatagramSocket	createDatagramSocket(String service_name, int port)
DatagramSocket	createDatagramSocket(String service_name, int port, InetAddress laddr)
DatagramSocket	createDatagramSocket(String service_name, SocketAddress bindaddr)
MulticastSocket	createMulticastSocket(String service_name)
MulticastSocket	createMulticastSocket(String service_name, int port)
MulticastSocket	createMulticastSocket(String service_name, SocketAddress bindaddr)
ServerSocket	createServerSocket(String service_name)
ServerSocket	createServerSocket(String service_name, int port)
ServerSocket	createServerSocket(String service_name, int port, int backlog)
ServerSocket	createServerSocket(String service_name, int port, int backlog, InetAddress bindAddr)
Socket	createSocket(String service_name)
Socket	createSocket(String service_name, InetAddress address, int port)
Socket	createSocket(String service_name, InetAddress address, int port, InetAddress localAddr, int localPort)
Socket	createSocket(String service_name, String host, int port)
Socket	createSocket(String service_name, String host, int port, InetAddress localAddr, int localPort)
Map<Object,String>	getSockets() Returns all open sockets.

Method Detail

createSocket

Socket createSocket(String service_name)
                    throws IOException

Throws:

IOException

createSocket

Socket createSocket(String service_name,
                  String host,
                  int port)
                    throws IOException

Throws:

IOException

createSocket

Socket createSocket(String service_name,
                  InetAddress address,
                  int port)
                    throws IOException

Throws:

IOException

createSocket

Socket createSocket(String service_name,
                  String host,
                  int port,
                  InetAddress localAddr,
                  int localPort)
                    throws IOException

Throws:

IOException

createSocket

Socket createSocket(String service_name,
                  InetAddress address,
                  int port,
                  InetAddress localAddr,
                  int localPort)
                    throws IOException

Throws:

IOException

createServerSocket

ServerSocket createServerSocket(String service_name)
                                throws IOException

Throws:

IOException

createServerSocket

ServerSocket createServerSocket(String service_name,
                              int port)
                                throws IOException

Throws:

IOException

createServerSocket

ServerSocket createServerSocket(String service_name,
                              int port,
                              int backlog)
                                throws IOException

Throws:

IOException

createServerSocket

ServerSocket createServerSocket(String service_name,
                              int port,
                              int backlog,
                              InetAddress bindAddr)
                                throws IOException

Throws:

IOException

createDatagramSocket

DatagramSocket createDatagramSocket(String service_name)
                                    throws SocketException

Throws:

SocketException

createDatagramSocket

DatagramSocket createDatagramSocket(String service_name,
                                  SocketAddress bindaddr)
                                    throws SocketException

Throws:

SocketException

createDatagramSocket

DatagramSocket createDatagramSocket(String service_name,
                                  int port)
                                    throws SocketException

Throws:

SocketException

createDatagramSocket

DatagramSocket createDatagramSocket(String service_name,
                                  int port,
                                  InetAddress laddr)
                                    throws SocketException

Throws:

SocketException

createMulticastSocket

MulticastSocket createMulticastSocket(String service_name)
                                      throws IOException

Throws:

IOException

createMulticastSocket

MulticastSocket createMulticastSocket(String service_name,
                                    int port)
                                      throws IOException

Throws:

IOException

createMulticastSocket

MulticastSocket createMulticastSocket(String service_name,
                                    SocketAddress bindaddr)
                                      throws IOException

Throws:

IOException

close

void close(Socket sock)
           throws IOException

Throws:

IOException

close

void close(ServerSocket sock)
           throws IOException

Throws:

IOException

close

void close(DatagramSocket sock)

getSockets

Map<Object,String> getSockets()

Returns all open sockets. This method can be used to list or close all open sockets.

Returns:

A map of open sockets; keys are Sockets, ServerSockets, DatagramSockets or MulticastSockets, values are the service names.