Spec-Zone .ru
спецификации, руководства, описания, API
Please note that this documentation is not final and is subject to change.

Java™ Platform
Standard Ed. 7

DRAFT ea-b76

javax.management.namespace
Interface JMXRemoteNamespaceMBean

All Superinterfaces:
JMXNamespaceMBean
All Known Implementing Classes:
JMXRemoteNamespace

public interface JMXRemoteNamespaceMBean
extends JMXNamespaceMBean

A JMXNamespaceMBean that will connect to a remote MBeanServer by creating a JMXConnector from a JMXServiceURL. You can call connect() and close() several times.

Since:
1.7

Method Summary
Modifier and Type Method and Description
 void close()
          Closes the connection with the remote source name space.
 void connect()
          Connects to the underlying remote source name space, if not already connected.
 JMXServiceURL getAddress()
          Returns the JMXServiceURL address that points to the remote name space mirrored by this JMXNamespace MBean, if available.
 boolean isConnected()
          Tells whether the connection to the remote source name space is opened.
 
Methods inherited from interface javax.management.namespace.JMXNamespaceMBean
getDefaultDomain, getDomains, getMBeanCount, getUUID
 

Method Detail

connect

void connect()
             throws IOException
Connects to the underlying remote source name space, if not already connected. If connected, do nothing. Otherwise, creates a new connector from the JMXServiceURL provided at creation time, and connects to the remote source name space.

The source MBeans will not appear in the target name space until the JMXRemoteNamespaceMBean is connected.

It is possible to call connect(), close(), and connect() again. However, closing the connection with the remote name space may cause notification listeners to be lost, unless the client explicitly uses the new JMX event service.

Throws:
IOException - if connection to the remote source name space fails.
See Also:
isConnected

close

void close()
           throws IOException
Closes the connection with the remote source name space. If the connection is already closed, do nothing. Otherwise, closes the underlying JMXConnector.

Once closed, it is possible to reopen the connection by calling connect.

Throws:
IOException - if the connection to the remote source name space can't be closed properly.
See Also:
isConnected

isConnected

boolean isConnected()
Tells whether the connection to the remote source name space is opened.

Returns:
true if connected.
See Also:
connect, close

getAddress

JMXServiceURL getAddress()
Returns the JMXServiceURL address that points to the remote name space mirrored by this JMXNamespace MBean, if available.

Returns:
The JMXServiceURL address that points to the remote name space mirrored by this JMXNamespace MBean, or null.

Java™ Platform
Standard Ed. 7

DRAFT ea-b76

Submit a bug or feature

Copyright 2009 Sun Microsystems, Inc. All Rights Reserved. Use is subject to license terms.

free hit counter