org.sapia.ubik.rmi.server.transport
Interface TransportProvider

All Known Implementing Classes:

HttpTransportProvider, MultiplexSocketTransportProvider, NioTcpTransportProvider, ServletTransportProvider, SocketTransportProvider

public interface TransportProvider

This interface abstracts the transport layer's implementation.

Author:

Yanick Duchesne

Copyright:

Copyright © 2002-2003 Sapia Open Source Software. All Rights Reserved.

License:

Read the license.txt file of the jar or visit the license page at the Sapia OSS web site

Method Summary

Connections	getPoolFor(ServerAddress address) Returns a client connection pool to the given server address.
java.lang.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(java.util.Properties props) Returns a server implementation.
void	shutdown() Shuts down this provider.

Method Detail

getPoolFor

Connections getPoolFor(ServerAddress address)
                       throws java.rmi.RemoteException

Returns a client connection pool to the given server address.

Parameters:

address - a ServerAddress.

Returns:

a Connection.

Throws:

java.rmi.RemoteException - if a problem occurs creating the connection.

newServer

Server newServer(java.util.Properties props)
                 throws java.rmi.RemoteException

Returns a server implementation.

Parameters:

props - the Properties used to create the server.

Returns:

a Server instance.

Throws:

java.rmi.RemoteException

newDefaultServer

Server newDefaultServer()
                        throws java.rmi.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:

java.rmi.RemoteException

getTransportType

java.lang.String getTransportType()

Returns this instance's "transport type".

Returns:

a transport type.

shutdown

void shutdown()

Shuts down this provider.