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


Copyright © 2003-2005 Apache Software Foundation. All Rights Reserved.