Name of the attribute that specifies the authenticator for a connector server. The value associated with this attribute, if any, must be an object that implements the interface JMXAuthenticator .

 public JMXConnectorServer() 
{
        this(null);
}

Constructs a connector server that will be registered as an MBean in the MBean server it is attached to. This constructor is typically called by one of the createMBean methods when creating, within an MBean server, a connector server that makes it available remotely.

 public JMXConnectorServer(MBeanServer mbeanServer) 
{
        this.mbeanServer = mbeanServer;
}

Constructs a connector server that is attached to the given MBean server. A connector server that is created in this way can be registered in a different MBean server, or not registered in any MBean server.

Parameters:

mbeanServer - the MBean server that this connector server is attached to. Null if this connector server will be attached to an MBean server by being registered in it.

 protected  void connectionClosed(String connectionId,
    String message,
    Object userData) 
{
        if (connectionId == null)
            throw new NullPointerException("Illegal null argument");
        synchronized (connectionIds) {
            connectionIds.remove(connectionId);
        }
        sendNotification(JMXConnectionNotification.CLOSED, connectionId,
                         message, userData);
}

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

 protected  void connectionFailed(String connectionId,
    String message,
    Object userData) 
{
        if (connectionId == null)
            throw new NullPointerException("Illegal null argument");
        synchronized (connectionIds) {
            connectionIds.remove(connectionId);
        }
        sendNotification(JMXConnectionNotification.FAILED, connectionId,
                         message, userData);
}

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

 protected  void connectionOpened(String connectionId,
    String message,
    Object userData) 
{
        if (connectionId == null)
            throw new NullPointerException("Illegal null argument");
        synchronized (connectionIds) {
            connectionIds.add(connectionId);
        }
        sendNotification(JMXConnectionNotification.OPENED, connectionId,
                         message, userData);
}

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

 public String[] getConnectionIds() 
{
        synchronized (connectionIds) {
            return connectionIds.toArray(new String[connectionIds.size()]);
        }
}

 public synchronized MBeanServer getMBeanServer() 
{
        return mbeanServer;
}

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

 public MBeanNotificationInfo[] getNotificationInfo() 
{
        final String[] types = {
            JMXConnectionNotification.OPENED,
            JMXConnectionNotification.CLOSED,
            JMXConnectionNotification.FAILED,
        };
        final String className = JMXConnectionNotification.class.getName();
        final String description =
            "A client connection has been opened or closed";
        return new MBeanNotificationInfo[] {
            new MBeanNotificationInfo(types, className, description),
        };
}

Returns an array indicating the notifications that this MBean sends. The implementation in JMXConnectorServer returns an array with one element, indicating that it can emit notifications of class JMXConnectionNotification with the types defined in that class. A subclass that can emit other notifications should return an array that contains this element plus descriptions of the other notifications.

 public  void postDeregister() 
{
        myName = null;
}

 public  void postRegister(Boolean registrationDone) 
{
        // do nothing
}

 public synchronized  void preDeregister() throws Exception 
{
        if (myName != null && isActive()) {
            stop();
            myName = null; // just in case stop is buggy and doesn't stop
        }
}

Called by an MBean server when this connector server is unregistered from that MBean server. If this connector server was attached to that MBean server by being registered in it, and if the connector server is still active, then unregistering it will call the stop method. If the stop method throws an exception, the unregistration attempt will fail. It is recommended to call the stop method explicitly before unregistering the MBean.

 public synchronized ObjectName preRegister(MBeanServer mbs,
    ObjectName name) 
{
        if (mbs == null || name == null)
            throw new NullPointerException("Null MBeanServer or ObjectName");
        if (mbeanServer == null) {
            mbeanServer = mbs;
            myName = name;
        }
        return name;
}

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

 public synchronized  void setMBeanServerForwarder(MBeanServerForwarder mbsf) 
{
        if (mbsf == null)
            throw new IllegalArgumentException("Invalid null argument: mbsf");
        if (mbeanServer !=  null) mbsf.setMBeanServer(mbeanServer);
        mbeanServer = mbsf;
}

 public JMXConnector toJMXConnector(Map<String, ?> env) throws IOException 
{
        if (!isActive()) throw new
            IllegalStateException("Connector is not active");
        JMXServiceURL addr = getAddress();
        return JMXConnectorFactory.newJMXConnector(addr, env);
}

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 #getAddress and JMXConnectorFactory to generate the stub, with code equivalent to the following:

JMXServiceURL addr = getAddress() ;
return Map)
         env) ;

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