javax.management: public class: MBeanServerBuilder

javax.management
public class: MBeanServerBuilder [javadoc | source]

java.lang.Object
   javax.management.MBeanServerBuilder

This class represents a builder that creates a default javax.management.MBeanServer implementation. The JMX javax.management.MBeanServerFactory allows applications to provide their custom MBeanServer implementation by providing a subclass of this class.

Also see:

MBeanServer

MBeanServerFactory

since: 1.5 -

Constructor:
public MBeanServerBuilder() { } Public default constructor.

Constructor:

 public MBeanServerBuilder() {

}

Public default constructor.

Method from javax.management.MBeanServerBuilder Summary:
newMBeanServer, newMBeanServerDelegate

Methods from java.lang.Object:
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method from javax.management.MBeanServerBuilder Detail:
public MBeanServer newMBeanServer(String defaultDomain, MBeanServer outer, MBeanServerDelegate delegate) { // By default, MBeanServerInterceptors are disabled. // Use com.sun.jmx.mbeanserver.MBeanServerBuilder to obtain // MBeanServers on which MBeanServerInterceptors are enabled. return JmxMBeanServer.newMBeanServer(defaultDomain,outer,delegate, false); } This method creates a new MBeanServer implementation object. When creating a new MBeanServer the javax.management.MBeanServerFactory first calls `newMBeanServerDelegate()` in order to obtain a new javax.management.MBeanServerDelegate for the new MBeanServer. Then it calls `newMBeanServer(defaultDomain,outer,delegate)` passing the `delegate` that should be used by the MBeanServer implementation. Note that the passed `delegate` might not be directly the MBeanServerDelegate that was returned by this implementation. It could be, for instance, a new object wrapping the previously returned delegate. The `outer` parameter is a pointer to the MBeanServer that should be passed to the javax.management.MBeanRegistration interface when registering MBeans inside the MBeanServer. If `outer` is `null`, then the MBeanServer implementation must use its own `this` reference when invoking the javax.management.MBeanRegistration interface. This makes it possible for a MBeanServer implementation to wrap another MBeanServer implementation, in order to implement, e.g, security checks, or to prevent access to the actual MBeanServer implementation by returning a pointer to a wrapping object.
public MBeanServerDelegate newMBeanServerDelegate() { return JmxMBeanServer.newMBeanServerDelegate(); } This method creates a new MBeanServerDelegate for a new MBeanServer. When creating a new MBeanServer the javax.management.MBeanServerFactory first calls this method in order to create a new MBeanServerDelegate. Then it calls `newMBeanServer(defaultDomain,outer,delegate)` passing the `delegate` that should be used by the MBeanServer implementation. Note that the passed `delegate` might not be directly the MBeanServerDelegate that was returned by this method. It could be, for instance, a new object wrapping the previously returned object.

Method from javax.management.MBeanServerBuilder Detail:

 public MBeanServer newMBeanServer(String defaultDomain,
    MBeanServer outer,
    MBeanServerDelegate delegate) {
        // By default, MBeanServerInterceptors are disabled.
        // Use com.sun.jmx.mbeanserver.MBeanServerBuilder to obtain
        // MBeanServers on which MBeanServerInterceptors are enabled.
        return JmxMBeanServer.newMBeanServer(defaultDomain,outer,delegate,
                                             false);
}

javax.management.MBeanServerFactory

newMBeanServerDelegate()

javax.management.MBeanServerDelegate

newMBeanServer(defaultDomain,outer,delegate)

delegate

Note that the passed delegate might not be directly the MBeanServerDelegate that was returned by this implementation. It could be, for instance, a new object wrapping the previously returned delegate.

The outer parameter is a pointer to the MBeanServer that should be passed to the javax.management.MBeanRegistration interface when registering MBeans inside the MBeanServer. If outer is null, then the MBeanServer implementation must use its own this reference when invoking the javax.management.MBeanRegistration interface.

This makes it possible for a MBeanServer implementation to wrap another MBeanServer implementation, in order to implement, e.g, security checks, or to prevent access to the actual MBeanServer implementation by returning a pointer to a wrapping object.

 public MBeanServerDelegate newMBeanServerDelegate() {
        return JmxMBeanServer.newMBeanServerDelegate();
}

javax.management.MBeanServerFactory

newMBeanServer(defaultDomain,outer,delegate)

delegate

Note that the passed delegate might not be directly the MBeanServerDelegate that was returned by this method. It could be, for instance, a new object wrapping the previously returned object.