org.apache.geronimo.remoting.transport
Interface TransportServer

All Superinterfaces:

org.apache.geronimo.core.service.Component

All Known Implementing Classes:

AbstractServer

public interface TransportServer

extends org.apache.geronimo.core.service.Component

Version:

$Revision: 1.3 $ $Date: 2004/03/10 09:59:20 $

Method Summary

void	bind(URI bindURI, Router dispatcher) Configures and otatains any resources needed to start accepting client requests.
void	dispose() Rleases all resources that were obtained during the life of the server.
URI	getClientConnectURI() Once the bind() call has been done, this method will return a URI that can be used by a client to connect to the server.
void	start() Enables the server to start accepting new client requests.
void	stop() Stops the server from accepting new client requests.

Methods inherited from interface org.apache.geronimo.core.service.Component

getContainer, setContainer

Method Detail

bind

public void bind(URI bindURI,
                 Router dispatcher)
          throws Exception

Configures and otatains any resources needed to start accepting client requests. The bindURI argument will configure the interface/port etc. that the server will use to service requests. The sever should pass all requests and datagrams to the dispatcher.

Parameters:

bindURI -

Throws:

Exception

getClientConnectURI

public URI getClientConnectURI()

Once the bind() call has been done, this method will return a URI that can be used by a client to connect to the server.

Returns:

null if server has not been bound.

start

public void start()
           throws Exception

Enables the server to start accepting new client requests.

Throws:

Exception

stop

public void stop()
          throws Exception

Stops the server from accepting new client requests. start() may be called at a later time to start processing requests again.

Throws:

Exception

dispose

public void dispose()
             throws Exception

Rleases all resources that were obtained during the life of the server. Once disposed, the sever instance cannot be used again.

Throws:

Exception