MBean interface for connector servers. A JMX API connector server is attached to an MBean server, and establishes connections to that MBean server for remote clients.
A newly-created connector server is inactive, and does
not yet listen for connections. Only when its start
method has been called does it start listening for connections.
Modifier and Type | Method and Description |
---|---|
public JMXServiceURL | Returns: the address of this connector server, or null if it does not have one.The address of this connector server. |
public Map | Returns: a read-only map containing the attributes for this connector server. Attributes whose values are not serializable are omitted from this map. If there are no serializable attributes, the returned map is empty.The attributes for this connector server. |
public String[] | Returns: a new string array containing the list of IDs. If there are no currently-open connections, this array will be empty.The list of IDs for currently-open connections to this connector server. |
public boolean | Returns: true if the connector server is active.Determines whether the connector server is active. |
public void | setMBeanServerForwarder(MBeanServerForwarder
the new mbsf)MBeanServerForwarder .Inserts an object that intercepts requests for the MBean server that arrive through this connector server. |
public void | |
public void | |
public JMXConnector | Returns: a client stub that can be used to make a new connection to this connector server.client connection parameters of the same sort that
can be provided to env)JMXConnector. . Can be null, which is equivalent
to an empty map.Returns a client stub for this connector server. |
getAddress | back to summary |
---|---|
public JMXServiceURL getAddress() The address of this connector server.
The address returned may not be the exact original Note that the address returned may be
|
getAttributes | back to summary |
---|---|
public Map The attributes for this connector server. |
getConnectionIds | back to summary |
---|---|
public String[] getConnectionIds() The list of IDs for currently-open connections to this connector server.
|
isActive | back to summary |
---|---|
public boolean isActive() Determines whether the connector server is active. A connector
server starts being active when its
|
setMBeanServerForwarder | back to summary |
---|---|
public void setMBeanServerForwarder(MBeanServerForwarder mbsf) Inserts an object that intercepts requests for the MBean server
that arrive through this connector server. This object will be
supplied as the This method can be called more than once with different
|
start | back to summary |
---|---|
public void start() throws IOException Activates the connector server, that is, starts listening for
client connections. Calling this method when the connector
server is already active has no effect. Calling this method
when the connector server has been stopped will generate an
|
stop | back to summary |
---|---|
public void stop() throws IOException Deactivates the connector server, that is, stops listening for client connections. Calling this method will also close all client connections that were made by this server. After this method returns, whether normally or with an exception, the connector server will not create any new client connections. Once a connector server has been stopped, it cannot be started again. Calling this method when the connector server has already been stopped has no effect. Calling this method when the connector server has not yet been started will disable the connector server object permanently. If closing a client connection produces an exception, that
exception is not thrown from this method. A Closing a connector server is a potentially slow operation. For example, if a client machine with an open connection has crashed, the close operation might have to wait for a network protocol timeout. Callers that do not want to block in a close operation should do it in a separate thread.
|
toJMXConnector | back to summary |
---|---|
public JMXConnector toJMXConnector(Map<String, ?> env) throws IOException Returns a client stub for this connector server. A client
stub is a serializable object whose A given connector need not support the generation of client stubs. However, the connectors specified by the JMX Remote API do (JMXMP Connector and RMI Connector).
|