org.rvpf.base.rmi

Class ClientSocketFactory

Object

ClientSocketFactory

All Implemented Interfaces:

Serializable, RMIClientSocketFactory

Direct Known Subclasses:

SecureClientSocketFactory

@ThreadSafe
public class ClientSocketFactory
extends Object
implements RMIClientSocketFactory, Serializable

Client socket factory.

This implementation of RMIClientSocketFactory uses the UUID provided by a ClientSecurityContext to get the security informations needed to create Sockets. The association is done by a call to the static register(org.rvpf.base.rmi.SessionClientContext) method by the ClientSecurityContext itself before the connection to a server object.

This socket factory is created for each new session and is not reused.

See Also:

Serialized Form

Constructor Summary

Constructors

Constructor and Description
ClientSocketFactory(UUID uuid) Constructs an instance.

Method Summary

Modifier and Type	Method and Description
Socket	createSocket(String host, int port)
boolean	equals(Object other)
protected SessionClientContext	getContext() Gets the context.
int	hashCode()
protected Socket	newSocket(String host, int port) Create a client socket connected to the specified host and port.

Methods inherited from class Object

clone, finalize, getClass, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

ClientSocketFactory

public ClientSocketFactory(@Nonnull
                           UUID uuid)

Constructs an instance.

Parameters:

uuid - The UUID identifying the context.

Method Detail

createSocket

public final Socket createSocket(String host,
                                 int port)
                          throws IOException

Specified by:

createSocket in interface RMIClientSocketFactory

Throws:

IOException

equals

public final boolean equals(Object other)

Overrides:

equals in class Object

hashCode

public final int hashCode()

Overrides:

hashCode in class Object

getContext

@Nonnull
 @CheckReturnValue
protected SessionClientContext getContext()
                                                                 throws IOException

Gets the context.

The context is cached to allow the RMI distributed garbage collector to still be able to connect to the server for 'clean' requests even after the context has been unregistered.

Returns:

The context.

Throws:

IOException - If the context is unknown.

newSocket

@Nonnull
 @CheckReturnValue
protected Socket newSocket(@Nonnull
                                                         String host,
                                                         int port)
                                                  throws IOException

Create a client socket connected to the specified host and port.

Parameters:

host - The host name.

port - The port number.

Returns:

A socket connected to the specified host and port.

Throws:

IOException - When an I/O error occurs during socket creation.