• root
• java
• j2se
• 1.6
• javax.management.remote
• JMXConnectorServer

Methods

• JMXConnectorServertop

  public JMXConnectorServer()

  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.

  Related Links:

  Google Code Search

  Stack Overflow

• JMXConnectorServertop

  public JMXConnectorServer(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.

  Parameters:

  @param 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.

  Related Links:

  Google Code Search

  Stack Overflow

• connectionClosedtop

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

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

  Parameters:

  @param connectionId the ID of the closed connection.

  @param message the message for the emitted javax.management.remote.JMXConnectionNotification . Can be null. See javax.management.Notification.getMessage() .

  @param userData the userData for the emitted javax.management.remote.JMXConnectionNotification . Can be null. See javax.management.Notification.getUserData() .

  Exceptions:

  @exception NullPointerException if connectionId is null.

  Related Links:

  Google Code Search

  Stack Overflow

• connectionFailedtop

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

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

  Parameters:

  @param connectionId the ID of the failed connection.

  @param message the message for the emitted javax.management.remote.JMXConnectionNotification . Can be null. See javax.management.Notification.getMessage() .

  @param userData the userData for the emitted javax.management.remote.JMXConnectionNotification . Can be null. See javax.management.Notification.getUserData() .

  Exceptions:

  @exception NullPointerException if connectionId is null.

  Related Links:

  Google Code Search

  Stack Overflow

• connectionOpenedtop

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

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

  Parameters:

  @param connectionId the ID of the new connection. This must be different from the ID of any connection previously opened by this connector server.

  @param message the message for the emitted javax.management.remote.JMXConnectionNotification . Can be null. See javax.management.Notification.getMessage() .

  @param userData the userData for the emitted javax.management.remote.JMXConnectionNotification . Can be null. See javax.management.Notification.getUserData() .

  Exceptions:

  @exception NullPointerException if connectionId is null.

  Related Links:

  Google Code Search

  Stack Overflow

• getConnectionIdstop

  public String[] getConnectionIds()

  The list of IDs for currently-open connections to this connector server.

  Return:

  @return a new string array containing the list of IDs. If there are no currently-open connections, this array will be empty.

  Specified by:

  getConnectionIds from JMXConnectorServerMBean

  Related Links:

  Google Code Search

  Stack Overflow

• getMBeanServertop

  public synchronized MBeanServer getMBeanServer()

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

  Return:

  @return the MBean server that this connector server is attached to, or null if it is not yet attached to an MBean server.

  Related Links:

  Google Code Search

  Stack Overflow

• getNotificationInfotop

  public MBeanNotificationInfo[] getNotificationInfo()

  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 javax.management.remote.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.

  Return:

  @return the array of possible notifications.

  Specified by:

  getNotificationInfo from NotificationBroadcaster

  Override hierarchy:

  getNotificationInfo from NotificationBroadcasterSupport

  Related Links:

  Google Code Search

  Stack Overflow

• getNotificationSourcetop

  synchronized private Object getNotificationSource()

  Related Links:

  Google Code Search

  Stack Overflow

• nextSequenceNumbertop

  static private long nextSequenceNumber()

  Related Links:

  Google Code Search

  Stack Overflow

• postDeregistertop

  public void postDeregister()
  Allows the MBean to perform any operations needed after having been unregistered in the MBean server.

  Specified by:

  postDeregister from MBeanRegistration

  Related Links:

  Google Code Search

  Stack Overflow

• postRegistertop

  public void postRegister(Boolean registrationDone)
  Allows the MBean to perform any operations needed after having been registered in the MBean server or after the registration has failed.

  Parameters:

  @param registrationDone Indicates whether or not the MBean has been successfully registered in the MBean server. The value false means that the registration phase has failed.

  Specified by:

  postRegister from MBeanRegistration

  Related Links:

  Google Code Search

  Stack Overflow

• preDeregistertop

  public synchronized void preDeregister() throws Exception

  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.

  Exceptions:

  @exception IOException if thrown by the stop method.

  @exception Exception This exception will be caught by the MBean server and re-thrown as an javax.management.MBeanRegistrationException .

  Specified by:

  preDeregister from MBeanRegistration

  Related Links:

  Google Code Search

  Stack Overflow

• preRegistertop

  public synchronized ObjectName preRegister(MBeanServer mbs, ObjectName 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 javax.management.remote.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.

  Parameters:

  @param mbs the MBean server in which this connection server is being registered.

  @param name The object name of the MBean.

  Return:

  @return The name under which the MBean is to be registered.

  Exceptions:

  @exception NullPointerException if mbs or name is null.

  Specified by:

  preRegister from MBeanRegistration

  Related Links:

  Google Code Search

  Stack Overflow

• sendNotificationtop

  private void sendNotification(String type, String connectionId, String message, Object userData)

  Related Links:

  Google Code Search

  Stack Overflow

• setMBeanServerForwardertop

  public synchronized void setMBeanServerForwarder(MBeanServerForwarder mbsf)

  Adds an object that intercepts requests for the MBean server that arrive through this connector server. This object will be supplied as the MBeanServer for any new connection created by this connector server. Existing connections are unaffected.

  If this connector server is already associated with an MBeanServer object, then that object is given to mbsf.setMBeanServer. If doing so produces an exception, this method throws the same exception without any other effect.

  If this connector is not already associated with an MBeanServer object, or if the mbsf.setMBeanServer call just mentioned succeeds, then mbsf becomes this connector server's MBeanServer.

  Parameters:

  @param mbsf the new MBeanServerForwarder.

  Specified by:

  setMBeanServerForwarder from JMXConnectorServerMBean

  Related Links:

  Google Code Search

  Stack Overflow

• toJMXConnectortop

  public JMXConnector toJMXConnector(Map<?> env) throws IOException

  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 javax.management.remote.JMXConnectorServerMBean.getAddress() and javax.management.remote.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.

  Parameters:

  @param env client connection parameters of the same sort that could be provided to JMXConnector.connect(Map) . Can be null, which is equivalent to an empty map.

  Return:

  @return a client stub that can be used to make a new connection to this connector server.

  Exceptions:

  @exception UnsupportedOperationException if this connector server does not support the generation of client stubs.

  @exception IllegalStateException if the JMXConnectorServer is not started (see javax.management.remote.JMXConnectorServerMBean.isActive() ).

  @exception IOException if a communications problem means that a stub cannot be created.

  Specified by:

  toJMXConnector from JMXConnectorServerMBean

  Related Links:

  Google Code Search

  Stack Overflow