|
|||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
| SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | ||||||||
java.lang.Objectjavax.management.MBeanServerFactory
public class MBeanServerFactory
Creates and maintains a set of MBeanServer instances.
Server instances, as of JMX 1.2, are created using a subclass
of MBeanServerBuilder. The exact class used is controlled
by the property javax.management.builder.initial,
and allows the instances created by MBeanServerBuilder
to be wrapped, thus providing additional functionality.
The property is used as follows:
MBeanServerBuilder is used.Thread.currentThread().getContextClassLoader(), or,
if this is null, by Class.forName().Class.newInstance() is used to create an instance
of the class. The class must be public and have a public empty
constructor. If an exception is thrown, it is propogated as
a JMRuntimeException and no new server instances may be
created until the property is set to a valid value.MBeanServerBuilder, then the value is used to create
a new instance.
| Method Summary | |
|---|---|
static MBeanServer |
createMBeanServer()
Returns a server implementation using the default domain name of "DefaultDomain". |
static MBeanServer |
createMBeanServer(String domain)
Returns a server implementation using the default domain name given, or "DefaultDomain" if this is null. |
static ArrayList<MBeanServer> |
findMBeanServer(String id)
Returns the specified server, or, if id is null,
a list of all registered servers. |
static ClassLoaderRepository |
getClassLoaderRepository(MBeanServer server)
Returns the class loader repository used by the specified server. |
static MBeanServer |
newMBeanServer()
Returns a server implementation using the default domain name of "DefaultDomain". |
static MBeanServer |
newMBeanServer(String domain)
Returns a server implementation using the default domain name given, or "DefaultDomain" if this is null. |
static void |
releaseMBeanServer(MBeanServer server)
Removes the reference to the specified server, thus allowing it to be garbage collected. |
| Methods inherited from class java.lang.Object |
|---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
| Method Detail |
|---|
public static MBeanServer createMBeanServer()
"DefaultDomain". The default domain name is
used when the domain name specified by the user is nullfindMBeanServer(java.lang.String).
Calling this method is equivalent to calling
createMBeanServer(String) with a null value.
- Returns:
- a new
MBeanServer instance.
- Throws:
SecurityException - if a security manager exists and the
caller's permissions don't imply MBeanServerPermission(String)("createMBeanServer")
JMRuntimeException - if the property
javax.management.builder.initial
exists but names a class which either can not be
instantiated or provides an implementation that returns
null from either
MBeanServerBuilder.newMBeanServerDelegate()
or MBeanServerBuilder#newMBeanServer()
ClassCastException - if the property
javax.management.builder.initial
exists but names a class which is not a subclass
of MBeanServerBuilder.- See Also:
createMBeanServer(String)
public static MBeanServer createMBeanServer(String domain)
"DefaultDomain" if this is null.
The default domain name is used when the domain name specified by
the user is nullfindMBeanServer(java.lang.String).
- Parameters:
domain - the default domain name of the server.
- Returns:
- a new
MBeanServer instance.
- Throws:
SecurityException - if a security manager exists and the
caller's permissions don't imply MBeanServerPermission(String)("createMBeanServer")
JMRuntimeException - if the property
javax.management.builder.initial
exists but names a class which either can not be
instantiated or provides an implementation that returns
null from either
MBeanServerBuilder.newMBeanServerDelegate()
or MBeanServerBuilder#newMBeanServer()
ClassCastException - if the property
javax.management.builder.initial
exists but names a class which is not a subclass
of MBeanServerBuilder.
public static ArrayList<MBeanServer> findMBeanServer(String id)
id is null,
a list of all registered servers. A registered server is one that
was created using createMBeanServer() or
createMBeanServer(String) and has not yet been released
using releaseMBeanServer(MBeanServer).
id - the id of the server to retrieve, or null
to return all servers.
MBeanServers.
SecurityException - if a security manager exists and the
caller's permissions don't imply MBeanServerPermission(String)("findMBeanServer")public static ClassLoaderRepository getClassLoaderRepository(MBeanServer server)
MBeanServer.getClassLoaderRepository()
on the given server.
server - the server whose class loader repository should be
retrieved.
NullPointerException - if server is null.
SecurityException - if a security manager exists and the
caller's permissions don't imply {@link
MBeanPermission(String,String,ObjectName,String)
MBeanPermission(null, null, null,
"getClassLoaderRepository")public static MBeanServer newMBeanServer()
"DefaultDomain". The default domain name is
used when the domain name specified by the user is nullfindMBeanServer(java.lang.String).
Calling this method is equivalent to calling
newMBeanServer(String) with a null value.
- Returns:
- a new
MBeanServer instance.
- Throws:
SecurityException - if a security manager exists and the
caller's permissions don't imply MBeanServerPermission(String)("newMBeanServer")
JMRuntimeException - if the property
javax.management.builder.initial
exists but names a class which either can not be
instantiated or provides an implementation that returns
null from either
MBeanServerBuilder.newMBeanServerDelegate()
or MBeanServerBuilder#newMBeanServer()
ClassCastException - if the property
javax.management.builder.initial
exists but names a class which is not a subclass
of MBeanServerBuilder.- See Also:
newMBeanServer(String)
public static MBeanServer newMBeanServer(String domain)
"DefaultDomain" if this is null.
The default domain name is used when the domain name specified by
the user is nullfindMBeanServer(java.lang.String).
- Parameters:
domain - the default domain name of the server.
- Returns:
- a new
MBeanServer instance.
- Throws:
SecurityException - if a security manager exists and the
caller's permissions don't imply MBeanServerPermission(String)("newMBeanServer")
JMRuntimeException - if the property
javax.management.builder.initial
exists but names a class which either can not be
instantiated or provides an implementation that returns
null from either
MBeanServerBuilder.newMBeanServerDelegate()
or MBeanServerBuilder#newMBeanServer()
ClassCastException - if the property
javax.management.builder.initial
exists but names a class which is not a subclass
of MBeanServerBuilder.
public static void releaseMBeanServer(MBeanServer server)
server - the server to remove.
IllegalArgumentException - if a reference to the server is not
held (i.e. it wasn't created by
createMBeanServer(String)
or this method has already been called
on it.
SecurityException - if a security manager exists and the
caller's permissions don't imply MBeanServerPermission(String)("releaseMBeanServer")
|
|||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
| SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | ||||||||