com.sun.jmx.remote.generic
Interface SynchroMessageConnectionServer

All Known Implementing Classes:

SynchroMessageConnectionServerImpl

public interface SynchroMessageConnectionServer

Interface specifying how a connector server creates new connections to clients.

Method Summary

ServerSynchroMessageConnection	accept() Listens for a connection to be made to this server and accepts it.
JMXServiceURL	getAddress() The address of this connection server.
void	start(Map env) Activates this server for new client connections.
void	stop() Terminates this server.

Method Detail

start

void start(Map env)
           throws IOException

Activates this server for new client connections. Before this call is made, new client connections are not accepted. The behavior is unspecified if this method is called more than once.

Parameters:

env - the properties of the connector server.

Throws:

IOException - if the server cannot be activated.

accept

ServerSynchroMessageConnection accept()
                                      throws IOException

Listens for a connection to be made to this server and accepts it. The method blocks until a connection is made.

Returns:

a new SynchroMessageConnection object.

Throws:

IOException - if an I/O error occurs when waiting for a connection.

stop

void stop()
          throws IOException

Terminates this server. On return from this method, new connection attempts are refused. Existing connections are unaffected by this call. The behavior is unspecified if this method is called before the start(java.util.Map) method.

Throws:

IOException - if an I/O error occurs when stopping the server. A best effort will have been made to clean up the server's resources. The caller will not call accept() after stop(), whether or not it gets IOException.

getAddress

JMXServiceURL getAddress()

The address of this connection server.

Returns:

the address of this connection server.