Add live TLS certificate probing and improve restart error handling.
Configure CertificateCheckUrl per container for curl-like TLS checks, classify Sonic permission errors, and extend setup wizard for container management. Co-authored-by: Cursor <cursoragent@cursor.com>
This commit is contained in:
Cursor
@@ -0,0 +1,516 @@
|
||||
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
|
||||
<!--NewPage-->
|
||||
<HTML>
|
||||
<HEAD>
|
||||
<!-- Generated by javadoc (build 1.5.0_19) on Fri Aug 12 11:25:10 EDT 2011 -->
|
||||
<TITLE>
|
||||
MBeanServerFactory (Management Application API)
|
||||
</TITLE>
|
||||
|
||||
<META NAME="keywords" CONTENT="javax.management.MBeanServerFactory class">
|
||||
|
||||
<LINK REL ="stylesheet" TYPE="text/css" HREF="../../stylesheet.css" TITLE="Style">
|
||||
|
||||
<SCRIPT type="text/javascript">
|
||||
function windowTitle()
|
||||
{
|
||||
parent.document.title="MBeanServerFactory (Management Application API)";
|
||||
}
|
||||
</SCRIPT>
|
||||
<NOSCRIPT>
|
||||
</NOSCRIPT>
|
||||
|
||||
</HEAD>
|
||||
|
||||
<BODY BGCOLOR="white" onload="windowTitle();">
|
||||
|
||||
|
||||
<!-- ========= START OF TOP NAVBAR ======= -->
|
||||
<A NAME="navbar_top"><!-- --></A>
|
||||
<A HREF="MBeanServerFactory.html#skip-navbar_top" title="Skip navigation links"></A>
|
||||
<TABLE BORDER="0" WIDTH="100%" CELLPADDING="1" CELLSPACING="0" SUMMARY="">
|
||||
<TR>
|
||||
<TD COLSPAN=2 BGCOLOR="#EEEEFF" CLASS="NavBarCell1">
|
||||
<A NAME="navbar_top_firstrow"><!-- --></A>
|
||||
<TABLE BORDER="0" CELLPADDING="0" CELLSPACING="3" SUMMARY="">
|
||||
<TR ALIGN="center" VALIGN="top">
|
||||
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../overview-summary.html"><FONT CLASS="NavBarFont1"><B>Overview</B></FONT></A> </TD>
|
||||
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-summary.html"><FONT CLASS="NavBarFont1"><B>Package</B></FONT></A> </TD>
|
||||
<TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> <FONT CLASS="NavBarFont1Rev"><B>Class</B></FONT> </TD>
|
||||
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-tree.html"><FONT CLASS="NavBarFont1"><B>Tree</B></FONT></A> </TD>
|
||||
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../index-all.html"><FONT CLASS="NavBarFont1"><B>Index</B></FONT></A> </TD>
|
||||
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../help-doc.html"><FONT CLASS="NavBarFont1"><B>Help</B></FONT></A> </TD>
|
||||
</TR>
|
||||
</TABLE>
|
||||
</TD>
|
||||
<TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM>
|
||||
Sonic Management API</EM>
|
||||
</TD>
|
||||
</TR>
|
||||
|
||||
<TR>
|
||||
<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
|
||||
<A HREF="MBeanServerDelegateMBean.html" title="interface in javax.management"><B>PREV CLASS</B></A>
|
||||
<A HREF="MBeanServerInvocationHandler.html" title="class in javax.management"><B>NEXT CLASS</B></A></FONT></TD>
|
||||
<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
|
||||
<A HREF="../../index.html@javax%252Fmanagement%252FMBeanServerFactory.html" target="_top"><B>FRAMES</B></A>
|
||||
<A HREF="MBeanServerFactory.html" target="_top"><B>NO FRAMES</B></A>
|
||||
<SCRIPT type="text/javascript">
|
||||
<!--
|
||||
if(window==top) {
|
||||
document.writeln('<A HREF="../../allclasses-noframe.html"><B>All Classes</B></A>');
|
||||
}
|
||||
//-->
|
||||
</SCRIPT>
|
||||
<NOSCRIPT>
|
||||
<A HREF="../../allclasses-noframe.html"><B>All Classes</B></A>
|
||||
</NOSCRIPT>
|
||||
|
||||
|
||||
</FONT></TD>
|
||||
</TR>
|
||||
<TR>
|
||||
<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
|
||||
SUMMARY: NESTED | FIELD | CONSTR | <A HREF="MBeanServerFactory.html#method_summary">METHOD</A></FONT></TD>
|
||||
<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
|
||||
DETAIL: FIELD | CONSTR | <A HREF="MBeanServerFactory.html#method_detail">METHOD</A></FONT></TD>
|
||||
</TR>
|
||||
</TABLE>
|
||||
<A NAME="skip-navbar_top"></A>
|
||||
<!-- ========= END OF TOP NAVBAR ========= -->
|
||||
|
||||
<HR>
|
||||
<!-- ======== START OF CLASS DATA ======== -->
|
||||
<H2>
|
||||
<FONT SIZE="-1">
|
||||
javax.management</FONT>
|
||||
<BR>
|
||||
Class MBeanServerFactory</H2>
|
||||
<PRE>
|
||||
java.lang.Object
|
||||
<IMG SRC="../../resources/inherit.gif" ALT="extended by "><B>javax.management.MBeanServerFactory</B>
|
||||
</PRE>
|
||||
<HR>
|
||||
<DL>
|
||||
<DT><PRE>public class <B>MBeanServerFactory</B><DT>extends java.lang.Object</DL>
|
||||
</PRE>
|
||||
|
||||
<P>
|
||||
<p>Provides MBean server references. There are no instances of
|
||||
this class.</p>
|
||||
|
||||
<p>Since JMX 1.2 this class makes it possible to replace the default
|
||||
MBeanServer implementation. This is done using the
|
||||
<A HREF="MBeanServerBuilder.html" title="class in javax.management"><CODE>MBeanServerBuilder</CODE></A> class.
|
||||
The class of the initial MBeanServerBuilder to be
|
||||
instantiated can be specified through the
|
||||
<b>javax.management.builder.initial</b> system property.
|
||||
The specified class must be a public subclass of
|
||||
<A HREF="MBeanServerBuilder.html" title="class in javax.management"><CODE>MBeanServerBuilder</CODE></A>, and must have a public
|
||||
empty constructor.
|
||||
<p>By default, if no value for that property is specified, an instance of
|
||||
<A HREF="MBeanServerBuilder.html" title="class in javax.management"><CODE>javax.management.MBeanServerBuilder</CODE></A>
|
||||
is created. Otherwise, the MBeanServerFactory attempts to load the
|
||||
specified class using
|
||||
<CODE>Thread.currentThread().getContextClassLoader()</CODE>, or if that is null,
|
||||
<CODE>Class.forName()</CODE>. Then
|
||||
it creates an initial instance of that Class using
|
||||
<CODE>Class.newInstance()</CODE>. If any checked exception
|
||||
is raised during this process (e.g.
|
||||
<CODE>ClassNotFoundException</CODE>,
|
||||
<CODE>InstantiationException</CODE>) the MBeanServerFactory
|
||||
will propagate this exception from within a RuntimeException.</p>
|
||||
|
||||
<p>The <b>javax.management.builder.initial</b> system property is
|
||||
consulted every time a new MBeanServer needs to be created, and the
|
||||
class pointed to by that property is loaded. If that class is different
|
||||
from that of the current MBeanServerBuilder, then a new MBeanServerBuilder
|
||||
is created. Otherwise, the MBeanServerFactory may create a new
|
||||
MBeanServerBuilder or reuse the current one.</p>
|
||||
|
||||
<p>If the class pointed to by the property cannot be
|
||||
loaded, or does not correspond to a valid subclass of MBeanServerBuilder
|
||||
then an exception is propagated, and no MBeanServer can be created until
|
||||
the <b>javax.management.builder.initial</b> system property is reset to
|
||||
valid value.</p>
|
||||
|
||||
<p>The MBeanServerBuilder makes it possible to wrap the MBeanServers
|
||||
returned by the default MBeanServerBuilder implementation, for the purpose
|
||||
of e.g. adding an additional security layer.</p>
|
||||
<P>
|
||||
|
||||
<P>
|
||||
<HR>
|
||||
|
||||
<P>
|
||||
|
||||
<!-- ========== METHOD SUMMARY =========== -->
|
||||
|
||||
<A NAME="method_summary"><!-- --></A>
|
||||
<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
|
||||
<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
|
||||
<TH ALIGN="left" COLSPAN="2"><FONT SIZE="+2">
|
||||
<B>Method Summary</B></FONT></TH>
|
||||
</TR>
|
||||
<TR BGCOLOR="white" CLASS="TableRowColor">
|
||||
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
|
||||
<CODE>static <A HREF="MBeanServer.html" title="interface in javax.management">MBeanServer</A></CODE></FONT></TD>
|
||||
<TD><CODE><B><A HREF="MBeanServerFactory.html#createMBeanServer()">createMBeanServer</A></B>()</CODE>
|
||||
|
||||
<BR>
|
||||
Return a new object implementing the MBeanServer interface
|
||||
with a standard default domain name.</TD>
|
||||
</TR>
|
||||
<TR BGCOLOR="white" CLASS="TableRowColor">
|
||||
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
|
||||
<CODE>static <A HREF="MBeanServer.html" title="interface in javax.management">MBeanServer</A></CODE></FONT></TD>
|
||||
<TD><CODE><B><A HREF="MBeanServerFactory.html#createMBeanServer(java.lang.String)">createMBeanServer</A></B>(java.lang.String domain)</CODE>
|
||||
|
||||
<BR>
|
||||
Return a new object implementing the <A HREF="MBeanServer.html" title="interface in javax.management"><CODE>MBeanServer</CODE></A>
|
||||
interface with the specified default domain name.</TD>
|
||||
</TR>
|
||||
<TR BGCOLOR="white" CLASS="TableRowColor">
|
||||
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
|
||||
<CODE>static java.util.ArrayList</CODE></FONT></TD>
|
||||
<TD><CODE><B><A HREF="MBeanServerFactory.html#findMBeanServer(java.lang.String)">findMBeanServer</A></B>(java.lang.String agentId)</CODE>
|
||||
|
||||
<BR>
|
||||
Return a list of registered MBeanServer objects.</TD>
|
||||
</TR>
|
||||
<TR BGCOLOR="white" CLASS="TableRowColor">
|
||||
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
|
||||
<CODE>static <A HREF="https://documentation.progress.com/output/Sonic/8.5.0/Docs8.5/api/mgmt_api/javax/management/loading.ClassLoaderRepository.html" title="class or interface in javax.management">javax.management.loading.ClassLoaderRepository</A></CODE></FONT></TD>
|
||||
<TD><CODE><B><A HREF="MBeanServerFactory.html#getClassLoaderRepository(javax.management.MBeanServer)">getClassLoaderRepository</A></B>(<A HREF="MBeanServer.html" title="interface in javax.management">MBeanServer</A> server)</CODE>
|
||||
|
||||
<BR>
|
||||
Return the ClassLoaderRepository used by the given MBeanServer.</TD>
|
||||
</TR>
|
||||
<TR BGCOLOR="white" CLASS="TableRowColor">
|
||||
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
|
||||
<CODE>static <A HREF="MBeanServer.html" title="interface in javax.management">MBeanServer</A></CODE></FONT></TD>
|
||||
<TD><CODE><B><A HREF="MBeanServerFactory.html#newMBeanServer()">newMBeanServer</A></B>()</CODE>
|
||||
|
||||
<BR>
|
||||
Return a new object implementing the MBeanServer interface
|
||||
with a standard default domain name, without keeping an
|
||||
internal reference to this new object.</TD>
|
||||
</TR>
|
||||
<TR BGCOLOR="white" CLASS="TableRowColor">
|
||||
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
|
||||
<CODE>static <A HREF="MBeanServer.html" title="interface in javax.management">MBeanServer</A></CODE></FONT></TD>
|
||||
<TD><CODE><B><A HREF="MBeanServerFactory.html#newMBeanServer(java.lang.String)">newMBeanServer</A></B>(java.lang.String domain)</CODE>
|
||||
|
||||
<BR>
|
||||
Return a new object implementing the MBeanServer interface
|
||||
with the specified default domain name, without keeping an
|
||||
internal reference to this new object.</TD>
|
||||
</TR>
|
||||
<TR BGCOLOR="white" CLASS="TableRowColor">
|
||||
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
|
||||
<CODE>static void</CODE></FONT></TD>
|
||||
<TD><CODE><B><A HREF="MBeanServerFactory.html#releaseMBeanServer(javax.management.MBeanServer)">releaseMBeanServer</A></B>(<A HREF="MBeanServer.html" title="interface in javax.management">MBeanServer</A> mbeanServer)</CODE>
|
||||
|
||||
<BR>
|
||||
Remove internal MBeanServerFactory references to a created
|
||||
MBeanServer.</TD>
|
||||
</TR>
|
||||
</TABLE>
|
||||
<A NAME="methods_inherited_from_class_java.lang.Object"><!-- --></A>
|
||||
<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
|
||||
<TR BGCOLOR="#EEEEFF" CLASS="TableSubHeadingColor">
|
||||
<TH ALIGN="left"><B>Methods inherited from class java.lang.Object</B></TH>
|
||||
</TR>
|
||||
<TR BGCOLOR="white" CLASS="TableRowColor">
|
||||
<TD><CODE>equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait</CODE></TD>
|
||||
</TR>
|
||||
</TABLE>
|
||||
|
||||
<P>
|
||||
|
||||
<!-- ============ METHOD DETAIL ========== -->
|
||||
|
||||
<A NAME="method_detail"><!-- --></A>
|
||||
<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
|
||||
<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
|
||||
<TH ALIGN="left" COLSPAN="1"><FONT SIZE="+2">
|
||||
<B>Method Detail</B></FONT></TH>
|
||||
</TR>
|
||||
</TABLE>
|
||||
|
||||
<A NAME="createMBeanServer()"><!-- --></A><H3>
|
||||
createMBeanServer</H3>
|
||||
<PRE>
|
||||
public static <A HREF="MBeanServer.html" title="interface in javax.management">MBeanServer</A> <B>createMBeanServer</B>()</PRE>
|
||||
<DL>
|
||||
<DD><p>Return a new object implementing the MBeanServer interface
|
||||
with a standard default domain name. The default domain name
|
||||
is used as the domain part in the ObjectName of MBeans when the
|
||||
domain is specified by the user is null.</p>
|
||||
|
||||
<p>The standard default domain name is defined in <CODE>ServiceName.DOMAIN</CODE>.</p>
|
||||
|
||||
<p>The MBeanServer reference is internally kept. This will
|
||||
allow <CODE>findMBeanServer</CODE> to return a reference to
|
||||
this MBeanServer object.</p>
|
||||
|
||||
<p>This method is equivalent to <code>createMBeanServer(null)</code>.
|
||||
<P>
|
||||
<DD><DL>
|
||||
|
||||
<DT><B>Returns:</B><DD>the newly created MBeanServer.
|
||||
<DT><B>Throws:</B>
|
||||
<DD><CODE>java.lang.SecurityException</CODE> - if there is a SecurityManager and the
|
||||
caller's permissions do not include or imply <code><A HREF="MBeanServerPermission.html" title="class in javax.management"><CODE>MBeanServerPermission</CODE></A>("createMBeanServer")</code>.
|
||||
<DD><CODE><A HREF="JMRuntimeException.html" title="class in javax.management">JMRuntimeException</A></CODE> - if the property
|
||||
<code>javax.management.builder.initial</code> exists but the
|
||||
class it names cannot be instantiated through a public
|
||||
no-argument constructor; or if the instantiated builder returns
|
||||
null from its <A HREF="MBeanServerBuilder.html#newMBeanServerDelegate()"><CODE>newMBeanServerDelegate</CODE></A> or <A HREF="MBeanServerBuilder.html#newMBeanServer(java.lang.String, javax.management.MBeanServer, javax.management.MBeanServerDelegate)"><CODE>newMBeanServer</CODE></A> methods.
|
||||
<DD><CODE>java.lang.ClassCastException</CODE> - if the property
|
||||
<code>javax.management.builder.initial</code> exists and can be
|
||||
instantiated but is not assignment compatible with <A HREF="MBeanServerBuilder.html" title="class in javax.management"><CODE>MBeanServerBuilder</CODE></A>.</DL>
|
||||
</DD>
|
||||
</DL>
|
||||
<HR>
|
||||
|
||||
<A NAME="createMBeanServer(java.lang.String)"><!-- --></A><H3>
|
||||
createMBeanServer</H3>
|
||||
<PRE>
|
||||
public static <A HREF="MBeanServer.html" title="interface in javax.management">MBeanServer</A> <B>createMBeanServer</B>(java.lang.String domain)</PRE>
|
||||
<DL>
|
||||
<DD><p>Return a new object implementing the <A HREF="MBeanServer.html" title="interface in javax.management"><CODE>MBeanServer</CODE></A>
|
||||
interface with the specified default domain name. The given
|
||||
domain name is used as the domain part in the ObjectName of
|
||||
MBeans when the domain is specified by the user is null.</p>
|
||||
|
||||
<p>The MBeanServer reference is internally kept. This will
|
||||
allow <CODE>findMBeanServer</CODE> to return a reference to
|
||||
this MBeanServer object.</p>
|
||||
<P>
|
||||
<DD><DL>
|
||||
<DT><B>Parameters:</B><DD><CODE>domain</CODE> - the default domain name for the created
|
||||
MBeanServer. This is the value that will be returned by <A HREF="MBeanServer.html#getDefaultDomain()"><CODE>MBeanServer.getDefaultDomain()</CODE></A>.
|
||||
<DT><B>Returns:</B><DD>the newly created MBeanServer.
|
||||
<DT><B>Throws:</B>
|
||||
<DD><CODE>java.lang.SecurityException</CODE> - if there is a SecurityManager and
|
||||
the caller's permissions do not include or imply <code><A HREF="MBeanServerPermission.html" title="class in javax.management"><CODE>MBeanServerPermission</CODE></A>("createMBeanServer")</code>.
|
||||
<DD><CODE><A HREF="JMRuntimeException.html" title="class in javax.management">JMRuntimeException</A></CODE> - if the property
|
||||
<code>javax.management.builder.initial</code> exists but the
|
||||
class it names cannot be instantiated through a public
|
||||
no-argument constructor; or if the instantiated builder returns
|
||||
null from its <A HREF="MBeanServerBuilder.html#newMBeanServerDelegate()"><CODE>newMBeanServerDelegate</CODE></A> or <A HREF="MBeanServerBuilder.html#newMBeanServer(java.lang.String, javax.management.MBeanServer, javax.management.MBeanServerDelegate)"><CODE>newMBeanServer</CODE></A> methods.
|
||||
<DD><CODE>java.lang.ClassCastException</CODE> - if the property
|
||||
<code>javax.management.builder.initial</code> exists and can be
|
||||
instantiated but is not assignment compatible with <A HREF="MBeanServerBuilder.html" title="class in javax.management"><CODE>MBeanServerBuilder</CODE></A>.</DL>
|
||||
</DD>
|
||||
</DL>
|
||||
<HR>
|
||||
|
||||
<A NAME="findMBeanServer(java.lang.String)"><!-- --></A><H3>
|
||||
findMBeanServer</H3>
|
||||
<PRE>
|
||||
public static java.util.ArrayList <B>findMBeanServer</B>(java.lang.String agentId)</PRE>
|
||||
<DL>
|
||||
<DD><p>Return a list of registered MBeanServer objects. A
|
||||
registered MBeanServer object is one that was created by one of
|
||||
the <code>createMBeanServer</code> methods and not subsequently
|
||||
released with <code>releaseMBeanServer</code>.</p>
|
||||
<P>
|
||||
<DD><DL>
|
||||
<DT><B>Parameters:</B><DD><CODE>agentId</CODE> - The agent identifier of the MBeanServer to
|
||||
retrieve. If this parameter is null, all registered
|
||||
MBeanServers in this JVM are returned. Otherwise, only
|
||||
MBeanServers whose id is equal to <code>agentId</code> are
|
||||
returned. The id of an MBeanServer is the
|
||||
<code>MBeanServerId</code> attribute of its delegate MBean.
|
||||
<DT><B>Returns:</B><DD>A list of MBeanServer objects.
|
||||
<DT><B>Throws:</B>
|
||||
<DD><CODE>java.lang.SecurityException</CODE> - if there is a SecurityManager and the
|
||||
caller's permissions do not include or imply <code><A HREF="MBeanServerPermission.html" title="class in javax.management"><CODE>MBeanServerPermission</CODE></A>("findMBeanServer")</code>.</DL>
|
||||
</DD>
|
||||
</DL>
|
||||
<HR>
|
||||
|
||||
<A NAME="getClassLoaderRepository(javax.management.MBeanServer)"><!-- --></A><H3>
|
||||
getClassLoaderRepository</H3>
|
||||
<PRE>
|
||||
public static <A HREF="https://documentation.progress.com/output/Sonic/8.5.0/Docs8.5/api/mgmt_api/javax/management/loading.ClassLoaderRepository.html" title="class or interface in javax.management">javax.management.loading.ClassLoaderRepository</A> <B>getClassLoaderRepository</B>(<A HREF="MBeanServer.html" title="interface in javax.management">MBeanServer</A> server)</PRE>
|
||||
<DL>
|
||||
<DD>Return the ClassLoaderRepository used by the given MBeanServer.
|
||||
This method is equivalent to <A HREF="MBeanServer.html#getClassLoaderRepository()"><CODE>server.getClassLoaderRepository()</CODE></A>.
|
||||
<P>
|
||||
<DD><DL>
|
||||
<DT><B>Parameters:</B><DD><CODE>server</CODE> - The MBeanServer under examination. Since JMX 1.2,
|
||||
if <code>server</code> is <code>null</code>, the result is a
|
||||
<CODE>NullPointerException</CODE>. This behaviour differs from what
|
||||
was implemented in JMX 1.1 - where the possibility to use
|
||||
<code>null</code> was deprecated.
|
||||
<DT><B>Returns:</B><DD>The Class Loader Repository used by the given MBeanServer.
|
||||
<DT><B>Throws:</B>
|
||||
<DD><CODE>java.lang.SecurityException</CODE> - if there is a SecurityManager and
|
||||
the caller's permissions do not include or imply <code><A HREF="MBeanPermission.html" title="class in javax.management"><CODE>MBeanPermission</CODE></A>("getClassLoaderRepository")</code>.
|
||||
<DD><CODE>java.lang.NullPointerException</CODE> - if <code>server</code> is null.<DT><B>Since:</B></DT>
|
||||
<DD>JMX 1.1</DD>
|
||||
</DL>
|
||||
</DD>
|
||||
</DL>
|
||||
<HR>
|
||||
|
||||
<A NAME="newMBeanServer()"><!-- --></A><H3>
|
||||
newMBeanServer</H3>
|
||||
<PRE>
|
||||
public static <A HREF="MBeanServer.html" title="interface in javax.management">MBeanServer</A> <B>newMBeanServer</B>()</PRE>
|
||||
<DL>
|
||||
<DD><p>Return a new object implementing the MBeanServer interface
|
||||
with a standard default domain name, without keeping an
|
||||
internal reference to this new object. The default domain name
|
||||
is used as the domain part in the ObjectName of MBeans when the
|
||||
domain is specified by the user is null.</p>
|
||||
|
||||
<p>The standard default domain name is defined in <CODE>ServiceName.DOMAIN</CODE>.</p>
|
||||
|
||||
<p>No reference is kept. <CODE>findMBeanServer</CODE> will not
|
||||
be able to return a reference to this MBeanServer object, but
|
||||
the garbage collector will be able to remove the MBeanServer
|
||||
object when it is no longer referenced.</p>
|
||||
|
||||
<p>This method is equivalent to <code>newMBeanServer(null)</code>.</p>
|
||||
<P>
|
||||
<DD><DL>
|
||||
|
||||
<DT><B>Returns:</B><DD>the newly created MBeanServer.
|
||||
<DT><B>Throws:</B>
|
||||
<DD><CODE>java.lang.SecurityException</CODE> - if there is a SecurityManager and the
|
||||
caller's permissions do not include or imply <code><A HREF="MBeanServerPermission.html" title="class in javax.management"><CODE>MBeanServerPermission</CODE></A>("newMBeanServer")</code>.
|
||||
<DD><CODE><A HREF="JMRuntimeException.html" title="class in javax.management">JMRuntimeException</A></CODE> - if the property
|
||||
<code>javax.management.builder.initial</code> exists but the
|
||||
class it names cannot be instantiated through a public
|
||||
no-argument constructor; or if the instantiated builder returns
|
||||
null from its <A HREF="MBeanServerBuilder.html#newMBeanServerDelegate()"><CODE>newMBeanServerDelegate</CODE></A> or <A HREF="MBeanServerBuilder.html#newMBeanServer(java.lang.String, javax.management.MBeanServer, javax.management.MBeanServerDelegate)"><CODE>newMBeanServer</CODE></A> methods.
|
||||
<DD><CODE>java.lang.ClassCastException</CODE> - if the property
|
||||
<code>javax.management.builder.initial</code> exists and can be
|
||||
instantiated but is not assignment compatible with <A HREF="MBeanServerBuilder.html" title="class in javax.management"><CODE>MBeanServerBuilder</CODE></A>.</DL>
|
||||
</DD>
|
||||
</DL>
|
||||
<HR>
|
||||
|
||||
<A NAME="newMBeanServer(java.lang.String)"><!-- --></A><H3>
|
||||
newMBeanServer</H3>
|
||||
<PRE>
|
||||
public static <A HREF="MBeanServer.html" title="interface in javax.management">MBeanServer</A> <B>newMBeanServer</B>(java.lang.String domain)</PRE>
|
||||
<DL>
|
||||
<DD><p>Return a new object implementing the MBeanServer interface
|
||||
with the specified default domain name, without keeping an
|
||||
internal reference to this new object. The given domain name
|
||||
is used as the domain part in the ObjectName of MBeans when the
|
||||
domain is specified by the user is null.</p>
|
||||
|
||||
<p>No reference is kept. <CODE>findMBeanServer</CODE> will not
|
||||
be able to return a reference to this MBeanServer object, but
|
||||
the garbage collector will be able to remove the MBeanServer
|
||||
object when it is no longer referenced.</p>
|
||||
<P>
|
||||
<DD><DL>
|
||||
<DT><B>Parameters:</B><DD><CODE>domain</CODE> - the default domain name for the created
|
||||
MBeanServer. This is the value that will be returned by <A HREF="MBeanServer.html#getDefaultDomain()"><CODE>MBeanServer.getDefaultDomain()</CODE></A>.
|
||||
<DT><B>Returns:</B><DD>the newly created MBeanServer.
|
||||
<DT><B>Throws:</B>
|
||||
<DD><CODE>java.lang.SecurityException</CODE> - if there is a SecurityManager and the
|
||||
caller's permissions do not include or imply <code><A HREF="MBeanServerPermission.html" title="class in javax.management"><CODE>MBeanServerPermission</CODE></A>("newMBeanServer")</code>.
|
||||
<DD><CODE><A HREF="JMRuntimeException.html" title="class in javax.management">JMRuntimeException</A></CODE> - if the property
|
||||
<code>javax.management.builder.initial</code> exists but the
|
||||
class it names cannot be instantiated through a public
|
||||
no-argument constructor; or if the instantiated builder returns
|
||||
null from its <A HREF="MBeanServerBuilder.html#newMBeanServerDelegate()"><CODE>newMBeanServerDelegate</CODE></A> or <A HREF="MBeanServerBuilder.html#newMBeanServer(java.lang.String, javax.management.MBeanServer, javax.management.MBeanServerDelegate)"><CODE>newMBeanServer</CODE></A> methods.
|
||||
<DD><CODE>java.lang.ClassCastException</CODE> - if the property
|
||||
<code>javax.management.builder.initial</code> exists and can be
|
||||
instantiated but is not assignment compatible with <A HREF="MBeanServerBuilder.html" title="class in javax.management"><CODE>MBeanServerBuilder</CODE></A>.</DL>
|
||||
</DD>
|
||||
</DL>
|
||||
<HR>
|
||||
|
||||
<A NAME="releaseMBeanServer(javax.management.MBeanServer)"><!-- --></A><H3>
|
||||
releaseMBeanServer</H3>
|
||||
<PRE>
|
||||
public static void <B>releaseMBeanServer</B>(<A HREF="MBeanServer.html" title="interface in javax.management">MBeanServer</A> mbeanServer)</PRE>
|
||||
<DL>
|
||||
<DD>Remove internal MBeanServerFactory references to a created
|
||||
MBeanServer. This allows the garbage collector to remove the
|
||||
MBeanServer object.
|
||||
<P>
|
||||
<DD><DL>
|
||||
<DT><B>Parameters:</B><DD><CODE>mbeanServer</CODE> - the MBeanServer object to remove.
|
||||
<DT><B>Throws:</B>
|
||||
<DD><CODE>java.lang.IllegalArgumentException</CODE> - if
|
||||
<code>mbeanServer</code> was not generated by one of the
|
||||
<code>createMBeanServer</code> methods, or if
|
||||
<code>releaseMBeanServer</code> was already called on it.
|
||||
<DD><CODE>java.lang.SecurityException</CODE> - if there is a SecurityManager and
|
||||
the caller's permissions do not include or imply <code><A HREF="MBeanServerPermission.html" title="class in javax.management"><CODE>MBeanServerPermission</CODE></A>("releaseMBeanServer")</code>.</DL>
|
||||
</DD>
|
||||
</DL>
|
||||
<!-- ========= END OF CLASS DATA ========= -->
|
||||
<HR>
|
||||
|
||||
|
||||
<!-- ======= START OF BOTTOM NAVBAR ====== -->
|
||||
<A NAME="navbar_bottom"><!-- --></A>
|
||||
<A HREF="MBeanServerFactory.html#skip-navbar_bottom" title="Skip navigation links"></A>
|
||||
<TABLE BORDER="0" WIDTH="100%" CELLPADDING="1" CELLSPACING="0" SUMMARY="">
|
||||
<TR>
|
||||
<TD COLSPAN=2 BGCOLOR="#EEEEFF" CLASS="NavBarCell1">
|
||||
<A NAME="navbar_bottom_firstrow"><!-- --></A>
|
||||
<TABLE BORDER="0" CELLPADDING="0" CELLSPACING="3" SUMMARY="">
|
||||
<TR ALIGN="center" VALIGN="top">
|
||||
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../overview-summary.html"><FONT CLASS="NavBarFont1"><B>Overview</B></FONT></A> </TD>
|
||||
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-summary.html"><FONT CLASS="NavBarFont1"><B>Package</B></FONT></A> </TD>
|
||||
<TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> <FONT CLASS="NavBarFont1Rev"><B>Class</B></FONT> </TD>
|
||||
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-tree.html"><FONT CLASS="NavBarFont1"><B>Tree</B></FONT></A> </TD>
|
||||
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../index-all.html"><FONT CLASS="NavBarFont1"><B>Index</B></FONT></A> </TD>
|
||||
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../help-doc.html"><FONT CLASS="NavBarFont1"><B>Help</B></FONT></A> </TD>
|
||||
</TR>
|
||||
</TABLE>
|
||||
</TD>
|
||||
<TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM>
|
||||
Sonic Management API</EM>
|
||||
</TD>
|
||||
</TR>
|
||||
|
||||
<TR>
|
||||
<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
|
||||
<A HREF="MBeanServerDelegateMBean.html" title="interface in javax.management"><B>PREV CLASS</B></A>
|
||||
<A HREF="MBeanServerInvocationHandler.html" title="class in javax.management"><B>NEXT CLASS</B></A></FONT></TD>
|
||||
<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
|
||||
<A HREF="../../index.html@javax%252Fmanagement%252FMBeanServerFactory.html" target="_top"><B>FRAMES</B></A>
|
||||
<A HREF="MBeanServerFactory.html" target="_top"><B>NO FRAMES</B></A>
|
||||
<SCRIPT type="text/javascript">
|
||||
<!--
|
||||
if(window==top) {
|
||||
document.writeln('<A HREF="../../allclasses-noframe.html"><B>All Classes</B></A>');
|
||||
}
|
||||
//-->
|
||||
</SCRIPT>
|
||||
<NOSCRIPT>
|
||||
<A HREF="../../allclasses-noframe.html"><B>All Classes</B></A>
|
||||
</NOSCRIPT>
|
||||
|
||||
|
||||
</FONT></TD>
|
||||
</TR>
|
||||
<TR>
|
||||
<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
|
||||
SUMMARY: NESTED | FIELD | CONSTR | <A HREF="MBeanServerFactory.html#method_summary">METHOD</A></FONT></TD>
|
||||
<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
|
||||
DETAIL: FIELD | CONSTR | <A HREF="MBeanServerFactory.html#method_detail">METHOD</A></FONT></TD>
|
||||
</TR>
|
||||
</TABLE>
|
||||
<A NAME="skip-navbar_bottom"></A>
|
||||
<!-- ======== END OF BOTTOM NAVBAR ======= -->
|
||||
|
||||
<HR>
|
||||
<font size="-1">Copyright © 2001-2011
|
||||
<a href="http://www.progress.com" target="_top"> Progress Software Corporation</a>. All Rights Reserved.
|
||||
<br>HTML formatted on 12-Aug-2011.</font>
|
||||
</BODY>
|
||||
</HTML>
|
||||
Reference in New Issue
Block a user