org.sapia.ubik.rmi.server.transport

Interface TransportProvider

All Known Implementing Classes:

HttpTransportProvider, InMemoryTransportProvider, MultiplexSocketTransportProvider, NioTcpTransportProvider, ServletTransportProvider, SocketTransportProvider

public interface TransportProvider

This interface abstracts the transport layer's implementation.

Author:

Yanick Duchesne

Method Summary

Methods

Modifier and Type	Method and Description
Connections	getPoolFor(ServerAddress address) Returns a client connection pool to the given server address.
String	getTransportType() Returns this instance's "transport type".
Server	newDefaultServer() This method is called by Ubik RMI's runtime when a server is needed on the client side to recieve asynchronous responses (i.e.: callbacks).
Server	newServer(Properties props) Returns a server implementation.
void	shutdown() Shuts down this provider.

Method Detail

getPoolFor

Connections getPoolFor(ServerAddress address)
                       throws RemoteException

Returns a client connection pool to the given server address.

Parameters:

address - a ServerAddress.

Returns:

a ConnectionOptionsException.

Throws:

RemoteException - if a problem occurs creating the connection.

newServer

Server newServer(Properties props)
                 throws RemoteException

Returns a server implementation.

Parameters:

props - the Properties used to create the server.

Returns:

a Server instance.

Throws:

RemoteException

newDefaultServer

Server newDefaultServer()
                        throws RemoteException

This method is called by Ubik RMI's runtime when a server is needed on the client side to recieve asynchronous responses (i.e.: callbacks). Implementations must in this case provide a "default" Server instance.

Returns:

a Server.

Throws:

RemoteException

getTransportType

String getTransportType()

Returns this instance's "transport type".

Returns:

a transport type.

shutdown

void shutdown()

Shuts down this provider.