mx4j.remote
Class ConnectionResolver
public abstract class ConnectionResolver
ConnectionResolver handles the details of creating connections for different protocols.
Subclasses for the specific protocol are instantiated using a mechanism very similar to the
one specified by
javax.management.remote.JMXConnectorFactory
. Here a subclass
has a fully qualified name specified like this:
.resolver..Resolver, for example
Resolver
This class is used from both the client and the server.
The former uses it to lookup stubs or connections to the server side; the latter uses it
to create server instances and make them availale to clients, for example via JNDI.
The client and server methods have not been splitted into 2 different interfaces because
most of the times they share common code, although it may have been a better design.
abstract Object | bindClient(Object client, Map environment) - Connects the client returned by
lookupClient(JMXServiceURL,Map) to the server side.
|
abstract javax.management.remote.JMXServiceURL | bindServer(Object server, javax.management.remote.JMXServiceURL url, Map environment) - Binds the server created by
createServer(JMXServiceURL,Map) to a place specified by the JMXServiceURL.
|
abstract Object | createServer(javax.management.remote.JMXServiceURL url, Map environment) - Creates an instance of the server as specified in the given JMXServiceURL.
|
abstract void | destroyServer(Object server, javax.management.remote.JMXServiceURL url, Map environment) - Destroys the server created by
createServer(JMXServiceURL,Map) , by cleaning up resources it may have requested
at creation time
|
abstract Object | lookupClient(javax.management.remote.JMXServiceURL url, Map environment) - Looks up a connection with the server side as specified in the given JMXServiceURL.
|
static ConnectionResolver | newConnectionResolver(String proto, Map environment) - Returns a subclass of ConnectionResolver for the specified protocol.
|
abstract void | unbindServer(Object server, javax.management.remote.JMXServiceURL address, Map environment) - Unbinds the server bound by
bindServer(Object,JMXServiceURL,Map) from the place specified by the JMXServiceURL.
|
bindClient
public abstract Object bindClient(Object client,
Map environment)
throws IOException
- An object of the same type as the client passed in; normally the client object itself
bindServer
public abstract javax.management.remote.JMXServiceURL bindServer(Object server,
javax.management.remote.JMXServiceURL url,
Map environment)
throws IOException
- a new JMXServiceURL that specifies where the server has been bound to.
createServer
public abstract Object createServer(javax.management.remote.JMXServiceURL url,
Map environment)
throws IOException
Creates an instance of the server as specified in the given JMXServiceURL.
It is only a factory method, it should just return a fresh instance of the server;
other methods are responsible to make it available to clients (for example exporting it).
This method is used in implementations of javax.management.remote.JMXConnectorServer.start
.
destroyServer
public abstract void destroyServer(Object server,
javax.management.remote.JMXServiceURL url,
Map environment)
throws IOException
lookupClient
public abstract Object lookupClient(javax.management.remote.JMXServiceURL url,
Map environment)
throws IOException
Looks up a connection with the server side as specified in the given JMXServiceURL.
This method is used in implementations of javax.management.remote.JMXConnector.connect()
.
newConnectionResolver
public static ConnectionResolver newConnectionResolver(String proto,
Map environment)
Returns a subclass of ConnectionResolver for the specified protocol.
unbindServer
public abstract void unbindServer(Object server,
javax.management.remote.JMXServiceURL address,
Map environment)
throws IOException
Copyright © 2001-2005 The MX4J Contributors. All Rights Reserved.