org.jminor.common.remote

Class Servers

java.lang.Object

org.jminor.common.remote.Servers

public final class Servers
extends java.lang.Object

A utility class for working with Server instances.

Method Summary

Modifier and Type	Method and Description
static java.rmi.registry.Registry	getRegistry(int port)
static <T extends java.rmi.Remote,A extends java.rmi.Remote> Server<T,A>	getServer(java.lang.String serverHostName, java.lang.String serverNamePrefix, int registryPort, int requestedServerPort) Retrieves a Server from a registry running on the given host, using the given server name prefix as a condition.
static java.rmi.registry.Registry	initializeRegistry(int port) Initializes a Registry if one is not running
static RemoteClient	remoteClient(ConnectionRequest connectionRequest) Instantiates a new RemoteClient
static RemoteClient	remoteClient(ConnectionRequest connectionRequest, User databaseUser) Instantiates a new RemoteClient
static RemoteClient	remoteClient(RemoteClient remoteClient, User databaseUser) Instantiates a new RemoteClient based on the given client but with the specified database user
static void	resolveTrustStoreFromClasspath(java.lang.String temporaryFileNamePrefix) Reads the trust store specified by "javax.net.ssl.trustStore" from the classpath, copies it to a temporary file and sets the trust store property so that it points to that temporary file.

Methods inherited from class java.lang.Object

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

Method Detail

remoteClient

public static RemoteClient remoteClient(ConnectionRequest connectionRequest)

Instantiates a new RemoteClient

Parameters:

connectionRequest - the connection request

Returns:

a new RemoteClient instance

remoteClient

public static RemoteClient remoteClient(ConnectionRequest connectionRequest,
                                        User databaseUser)

Instantiates a new RemoteClient

Parameters:

connectionRequest - the connection request

databaseUser - the user to use when connecting to the underlying database

Returns:

a new RemoteClient instance

remoteClient

public static RemoteClient remoteClient(RemoteClient remoteClient,
                                        User databaseUser)

Instantiates a new RemoteClient based on the given client but with the specified database user

Parameters:

remoteClient - the remote client to copy

databaseUser - the database user to use

Returns:

a new RemoteClient instance

initializeRegistry

public static java.rmi.registry.Registry initializeRegistry(int port)
                                                     throws java.rmi.RemoteException

Initializes a Registry if one is not running

Parameters:

port - the port on which to look for (or create) a registry

Returns:

the Registry

Throws:

java.rmi.RemoteException - in case of an exception

getRegistry

public static java.rmi.registry.Registry getRegistry(int port)
                                              throws java.rmi.RemoteException

Parameters:

port - the port on which to look for a registry

Returns:

the registry

Throws:

java.rmi.RemoteException - in case of an exception

getServer

public static <T extends java.rmi.Remote,A extends java.rmi.Remote> Server<T,A> getServer(java.lang.String serverHostName,
                                                                                          java.lang.String serverNamePrefix,
                                                                                          int registryPort,
                                                                                          int requestedServerPort)
                                                                                   throws java.rmi.RemoteException,
                                                                                          java.rmi.NotBoundException

Retrieves a Server from a registry running on the given host, using the given server name prefix as a condition. Returns the first server satisfying the condition.

Type Parameters:

T - the Remote object type served by the server

A - the server admin type supplied by the server

Parameters:

serverHostName - the name of the host

serverNamePrefix - the server name prefix, an empty string results in all servers being returned

registryPort - the port on which to lookup the registry

requestedServerPort - the required server port, -1 for any port

Returns:

the servers having a name with the given prefix

Throws:

java.rmi.RemoteException - in case of a remote exception

java.rmi.NotBoundException - in case no such server is found

resolveTrustStoreFromClasspath

public static void resolveTrustStoreFromClasspath(java.lang.String temporaryFileNamePrefix)

Reads the trust store specified by "javax.net.ssl.trustStore" from the classpath, copies it to a temporary file and sets the trust store property so that it points to that temporary file. If the trust store file specified is not found on the classpath this method has no effect.

Parameters:

temporaryFileNamePrefix - the prefix to use for the temporary filename

See Also:

Server.TRUSTSTORE