JMXConnectorServer JDK 1.6)

Methods

public void addNotificationListener (NotificationListener listener, NotificationFilter filter, Object handback) [Inherited From NotificationBroadcasterSupport]

Adds a listener.

protected void connectionClosed (String connectionId, String message, Object userData)

Called by a subclass when a client connection is closed normally.

Called by a subclass when a client connection is closed normally. Removes connectionId from the list returned by JMXConnectorServer.getConnectionIds(), then emits a JMXConnectionNotification with type JMXConnectionNotification.CLOSED.

Parameters:
- connectionId - the ID of the closed connection.
- message - the message for the emitted {@link JMXConnectionNotification}. Can be null. See {@link Notification#getMessage()}.
- userData - the userData for the emitted {@link JMXConnectionNotification}. Can be null. See {@link Notification#getUserData()}.
Throws:
- NullPointerException - if connectionId is null.

protected void connectionFailed (String connectionId, String message, Object userData)

Called by a subclass when a client connection fails.

Called by a subclass when a client connection fails. Removes connectionId from the list returned by JMXConnectorServer.getConnectionIds(), then emits a JMXConnectionNotification with type JMXConnectionNotification.FAILED.

Parameters:
- connectionId - the ID of the failed connection.
- message - the message for the emitted {@link JMXConnectionNotification}. Can be null. See {@link Notification#getMessage()}.
- userData - the userData for the emitted {@link JMXConnectionNotification}. Can be null. See {@link Notification#getUserData()}.
Throws:
- NullPointerException - if connectionId is null.

protected void connectionOpened (String connectionId, String message, Object userData)

Called by a subclass when a new client connection is opened.

Called by a subclass when a new client connection is opened. Adds connectionId to the list returned by JMXConnectorServer.getConnectionIds(), then emits a JMXConnectionNotification with type JMXConnectionNotification.OPENED.

Parameters:
- connectionId - the ID of the new connection. This must be different from the ID of any connection previously opened by this connector server.
- message - the message for the emitted {@link JMXConnectionNotification}. Can be null. See {@link Notification#getMessage()}.
- userData - the userData for the emitted {@link JMXConnectionNotification}. Can be null. See {@link Notification#getUserData()}.
Throws:
- NullPointerException - if connectionId is null.

public String getConnectionIds () [Specified in JMXConnectorServerMBean]

publicsynchronized MBeanServer getMBeanServer ()

Returns the MBean server that this connector server is attached to.

public MBeanNotificationInfo getNotificationInfo () [Overrides NotificationBroadcasterSupport]

Returns an array indicating the notifications that this MBean sends.

protected void handleNotification (NotificationListener listener, Notification notif, Object handback) [Inherited From NotificationBroadcasterSupport]

This method is called by sendNotification for each listener in order to send the notification to that listener.

This method is called by sendNotification for each listener in order to send the notification to that listener. It can be overridden in subclasses to change the behavior of notification delivery, for instance to deliver the notification in a separate thread.

The default implementation of this method is equivalent to

 listener.handleNotification(notif, handback);

Parameters:
- listener - the listener to which the notification is being delivered.
- notif - the notification being delivered to the listener.
- handback - the handback object that was supplied when the listener was added.

public void postDeregister () [Specified in MBeanRegistration]

public void postRegister (Boolean registrationDone) [Specified in MBeanRegistration]

publicsynchronized void preDeregister () throws Exception [Specified in MBeanRegistration]

Called by an MBean server when this connector server is unregistered from that MBean server.

publicsynchronized ObjectName preRegister (MBeanServer mbs, ObjectName name) [Specified in MBeanRegistration]

Called by an MBean server when this connector server is registered in that MBean server.

Called by an MBean server when this connector server is registered in that MBean server. This connector server becomes attached to the MBean server and its JMXConnectorServer.getMBeanServer() method will return mbs.

If this connector server is already attached to an MBean server, this method has no effect. The MBean server it is attached to is not necessarily the one it is being registered in.

Returns: The name under which the MBean is to be registered.
Parameters:
- mbs - the MBean server in which this connection server is being registered.
- name - The object name of the MBean.
Throws:
- NullPointerException - if mbs or name is null.

public void removeNotificationListener (NotificationListener listener) throws ListenerNotFoundException [Inherited From NotificationBroadcasterSupport]

public void removeNotificationListener (NotificationListener listener, NotificationFilter filter, Object handback) throws ListenerNotFoundException [Inherited From NotificationBroadcasterSupport]

public void sendNotification (Notification notification) [Inherited From NotificationBroadcasterSupport]

Sends a notification.

Sends a notification.

If an Executor was specified in the constructor, it will be given one
task per selected listener to deliver the notification to that listener.
Parameters:
- notification - The notification to send.

publicsynchronized void setMBeanServerForwarder (MBeanServerForwarder mbsf) [Specified in JMXConnectorServerMBean]

public JMXConnector toJMXConnector (Map<String, Object> env) throws IOException [Specified in JMXConnectorServerMBean]

Returns a client stub for this connector server.

Returns a client stub for this connector server. A client stub is a serializable object whose connect method can be used to make one new connection to this connector server.

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).

The default implementation of this method uses JMXConnectorServerMBean.getAddress() and JMXConnectorFactory to generate the stub, with code equivalent to the following:

 JMXServiceURL addr = getAddress();
 return JMXConnectorFactory.newJMXConnector(addr, env);

A connector server for which this is inappropriate must override this method so that it either implements the appropriate logic or throws UnsupportedOperationException.

Returns: a client stub that can be used to make a new connection to this connector server.
Parameters:
- env - client connection parameters of the same sort that could be provided to {@link JMXConnector#connect(Map) JMXConnector.connect(Map)}. Can be null, which is equivalent to an empty map.
Throws:
- UnsupportedOperationException - if this connector server does not support the generation of client stubs.
- IllegalStateException - if the JMXConnectorServer is not started (see {@link JMXConnectorServerMBean#isActive()}).
- IOException - if a communications problem means that a stub cannot be created.