mbeanserverconnection.html

j2ee api,很好的api。我这现在有

<DT><B>Throws:</B>
<DD><CODE><A HREF="../../javax/management/ReflectionException.html" title="class in javax.management">ReflectionException</A></CODE> - Wraps a
 <CODE>java.lang.ClassNotFoundException</CODE> or a
 <CODE>java.lang.Exception</CODE> that occurred when trying to
 invoke the MBean's constructor.
<DD><CODE><A HREF="../../javax/management/InstanceAlreadyExistsException.html" title="class in javax.management">InstanceAlreadyExistsException</A></CODE> - The MBean is already
 under the control of the MBean server.
<DD><CODE><A HREF="../../javax/management/MBeanRegistrationException.html" title="class in javax.management">MBeanRegistrationException</A></CODE> - The
 <CODE>preRegister</CODE> (<CODE>MBeanRegistration</CODE>
 interface) method of the MBean has thrown an exception. The
 MBean will not be registered.
<DD><CODE><A HREF="../../javax/management/MBeanException.html" title="class in javax.management">MBeanException</A></CODE> - The constructor of the MBean has
 thrown an exception
<DD><CODE><A HREF="../../javax/management/NotCompliantMBeanException.html" title="class in javax.management">NotCompliantMBeanException</A></CODE> - This class is not a JMX
 compliant MBean
<DD><CODE><A HREF="../../javax/management/RuntimeOperationsException.html" title="class in javax.management">RuntimeOperationsException</A></CODE> - Wraps a
 <CODE>java.lang.IllegalArgumentException</CODE>: The className
 passed in parameter is null, the <CODE>ObjectName</CODE> passed
 in parameter contains a pattern or no <CODE>ObjectName</CODE>
 is specified for the MBean.
<DD><CODE><A HREF="http://java.sun.com/j2se/1.4/docs/api/java/io/IOException.html" title="class or interface in java.io">IOException</A></CODE> - A communication problem occurred when
 talking to the MBean server.</DL>
</DD>
</DL>
<HR>

<A NAME="createMBean(java.lang.String, javax.management.ObjectName, javax.management.ObjectName, java.lang.Object[], java.lang.String[])"><!-- --></A><H3>
createMBean</H3>
<PRE>
public <A HREF="../../javax/management/ObjectInstance.html" title="class in javax.management">ObjectInstance</A> <B>createMBean</B>(<A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/String.html" title="class or interface in java.lang">String</A>&nbsp;className,
                                  <A HREF="../../javax/management/ObjectName.html" title="class in javax.management">ObjectName</A>&nbsp;name,
                                  <A HREF="../../javax/management/ObjectName.html" title="class in javax.management">ObjectName</A>&nbsp;loaderName,
                                  <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/Object.html" title="class or interface in java.lang">Object</A>[]&nbsp;params,
                                  <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/String.html" title="class or interface in java.lang">String</A>[]&nbsp;signature)
                           throws <A HREF="../../javax/management/ReflectionException.html" title="class in javax.management">ReflectionException</A>,
                                  <A HREF="../../javax/management/InstanceAlreadyExistsException.html" title="class in javax.management">InstanceAlreadyExistsException</A>,
                                  <A HREF="../../javax/management/MBeanRegistrationException.html" title="class in javax.management">MBeanRegistrationException</A>,
                                  <A HREF="../../javax/management/MBeanException.html" title="class in javax.management">MBeanException</A>,
                                  <A HREF="../../javax/management/NotCompliantMBeanException.html" title="class in javax.management">NotCompliantMBeanException</A>,
                                  <A HREF="../../javax/management/InstanceNotFoundException.html" title="class in javax.management">InstanceNotFoundException</A>,
                                  <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/io/IOException.html" title="class or interface in java.io">IOException</A></PRE>
<DL>
<DD>Instantiates and registers an MBean in the MBean server.  The
 class loader to be used is identified by its object name. An
 object name is associated to the MBean. If the object name of
 the loader is not specified, the ClassLoader that loaded the
 MBean server will be used.  If the MBean object name given is
 null, the MBean must provide its own name by implementing the
 <A HREF="../../javax/management/MBeanRegistration.html" title="interface in javax.management"><CODE>MBeanRegistration</CODE></A>
 interface and returning the name from the <A HREF="../../javax/management/MBeanRegistration.html#preRegister(javax.management.MBeanServer, javax.management.ObjectName)"><CODE>preRegister</CODE></A> method.
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>className</CODE> - The class name of the MBean to be instantiated.<DD><CODE>name</CODE> - The object name of the MBean. May be null.<DD><CODE>params</CODE> - An array containing the parameters of the
 constructor to be invoked.<DD><CODE>signature</CODE> - An array containing the signature of the
 constructor to be invoked.<DD><CODE>loaderName</CODE> - The object name of the class loader to be used.
<DT><B>Returns:</B><DD>An <CODE>ObjectInstance</CODE>, containing the
 <CODE>ObjectName</CODE> and the Java class name of the newly
 instantiated MBean.  If the contained <code>ObjectName</code>
 is <code>n</code>, the contained Java class name is
 <code><A HREF="../../javax/management/MBeanServerConnection.html#getMBeanInfo(javax.management.ObjectName)"><CODE>getMBeanInfo(n)</CODE></A>.getClassName()</code>.
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../javax/management/ReflectionException.html" title="class in javax.management">ReflectionException</A></CODE> - Wraps a
 <CODE>java.lang.ClassNotFoundException</CODE> or a
 <CODE>java.lang.Exception</CODE> that occurred when trying to
 invoke the MBean's constructor.
<DD><CODE><A HREF="../../javax/management/InstanceAlreadyExistsException.html" title="class in javax.management">InstanceAlreadyExistsException</A></CODE> - The MBean is already
 under the control of the MBean server.
<DD><CODE><A HREF="../../javax/management/MBeanRegistrationException.html" title="class in javax.management">MBeanRegistrationException</A></CODE> - The
 <CODE>preRegister</CODE> (<CODE>MBeanRegistration</CODE>
 interface) method of the MBean has thrown an exception. The
 MBean will not be registered.
<DD><CODE><A HREF="../../javax/management/MBeanException.html" title="class in javax.management">MBeanException</A></CODE> - The constructor of the MBean has
 thrown an exception
<DD><CODE><A HREF="../../javax/management/NotCompliantMBeanException.html" title="class in javax.management">NotCompliantMBeanException</A></CODE> - This class is not a JMX
 compliant MBean
<DD><CODE><A HREF="../../javax/management/InstanceNotFoundException.html" title="class in javax.management">InstanceNotFoundException</A></CODE> - The specified class loader
 is not registered in the MBean server.
<DD><CODE><A HREF="../../javax/management/RuntimeOperationsException.html" title="class in javax.management">RuntimeOperationsException</A></CODE> - Wraps a
 <CODE>java.lang.IllegalArgumentException</CODE>: The className
 passed in parameter is null, the <CODE>ObjectName</CODE> passed
 in parameter contains a pattern or no <CODE>ObjectName</CODE>
 is specified for the MBean.
<DD><CODE><A HREF="http://java.sun.com/j2se/1.4/docs/api/java/io/IOException.html" title="class or interface in java.io">IOException</A></CODE> - A communication problem occurred when
 talking to the MBean server.</DL>
</DD>
</DL>
<HR>

<A NAME="unregisterMBean(javax.management.ObjectName)"><!-- --></A><H3>
unregisterMBean</H3>
<PRE>
public void <B>unregisterMBean</B>(<A HREF="../../javax/management/ObjectName.html" title="class in javax.management">ObjectName</A>&nbsp;name)
                     throws <A HREF="../../javax/management/InstanceNotFoundException.html" title="class in javax.management">InstanceNotFoundException</A>,
                            <A HREF="../../javax/management/MBeanRegistrationException.html" title="class in javax.management">MBeanRegistrationException</A>,
                            <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/io/IOException.html" title="class or interface in java.io">IOException</A></PRE>
<DL>
<DD>Unregisters an MBean from the MBean server. The MBean is
 identified by its object name. Once the method has been
 invoked, the MBean may no longer be accessed by its object
 name.
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>name</CODE> - The object name of the MBean to be unregistered.
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../javax/management/InstanceNotFoundException.html" title="class in javax.management">InstanceNotFoundException</A></CODE> - The MBean specified is not
 registered in the MBean server.
<DD><CODE><A HREF="../../javax/management/MBeanRegistrationException.html" title="class in javax.management">MBeanRegistrationException</A></CODE> - The preDeregister
 ((<CODE>MBeanRegistration</CODE> interface) method of the MBean
 has thrown an exception.
<DD><CODE><A HREF="../../javax/management/RuntimeOperationsException.html" title="class in javax.management">RuntimeOperationsException</A></CODE> - Wraps a
 <CODE>java.lang.IllegalArgumentException</CODE>: The object
 name in parameter is null or the MBean you are when trying to
 unregister is the <A HREF="../../javax/management/MBeanServerDelegate.html" title="class in javax.management"><CODE>MBeanServerDelegate</CODE></A> MBean.
<DD><CODE><A HREF="http://java.sun.com/j2se/1.4/docs/api/java/io/IOException.html" title="class or interface in java.io">IOException</A></CODE> - A communication problem occurred when
 talking to the MBean server.</DL>
</DD>
</DL>
<HR>

<A NAME="getObjectInstance(javax.management.ObjectName)"><!-- --></A><H3>
getObjectInstance</H3>
<PRE>
public <A HREF="../../javax/management/ObjectInstance.html" title="class in javax.management">ObjectInstance</A> <B>getObjectInstance</B>(<A HREF="../../javax/management/ObjectName.html" title="class in javax.management">ObjectName</A>&nbsp;name)
                                 throws <A HREF="../../javax/management/InstanceNotFoundException.html" title="class in javax.management">InstanceNotFoundException</A>,
                                        <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/io/IOException.html" title="class or interface in java.io">IOException</A></PRE>
<DL>
<DD>Gets the <CODE>ObjectInstance</CODE> for a given MBean
 registered with the MBean server.
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>name</CODE> - The object name of the MBean.
<DT><B>Returns:</B><DD>The <CODE>ObjectInstance</CODE> associated with the MBean
 specified by <VAR>name</VAR>.  The contained <code>ObjectName</code>
 is <code>name</code> and the contained class name is
 <code><A HREF="../../javax/management/MBeanServerConnection.html#getMBeanInfo(javax.management.ObjectName)"><CODE>getMBeanInfo(name)</CODE></A>.getClassName()</code>.
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../javax/management/InstanceNotFoundException.html" title="class in javax.management">InstanceNotFoundException</A></CODE> - The MBean specified is not
 registered in the MBean server.
<DD><CODE><A HREF="http://java.sun.com/j2se/1.4/docs/api/java/io/IOException.html" title="class or interface in java.io">IOException</A></CODE> - A communication problem occurred when
 talking to the MBean server.</DL>
</DD>
</DL>
<HR>

<A NAME="queryMBeans(javax.management.ObjectName, javax.management.QueryExp)"><!-- --></A><H3>
queryMBeans</H3>
<PRE>
public <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/util/Set.html" title="class or interface in java.util">Set</A> <B>queryMBeans</B>(<A HREF="../../javax/management/ObjectName.html" title="class in javax.management">ObjectName</A>&nbsp;name,
                       <A HREF="../../javax/management/QueryExp.html" title="interface in javax.management">QueryExp</A>&nbsp;query)
                throws <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/io/IOException.html" title="class or interface in java.io">IOException</A></PRE>
<DL>
<DD>Gets MBeans controlled by the MBean server. This method allows
 any of the following to be obtained: All MBeans, a set of
 MBeans specified by pattern matching on the
 <CODE>ObjectName</CODE> and/or a Query expression, a specific
 MBean. When the object name is null or no domain and key
 properties are specified, all objects are to be selected (and
 filtered if a query is specified). It returns the set of
 <CODE>ObjectInstance</CODE> objects (containing the
 <CODE>ObjectName</CODE> and the Java Class name) for the
 selected MBeans.
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>name</CODE> - The object name pattern identifying the MBeans to
 be retrieved. If null or no domain and key properties are
 specified, all the MBeans registered will be retrieved.<DD><CODE>query</CODE> - The query expression to be applied for selecting
 MBeans. If null no query expression will be applied for
 selecting MBeans.
<DT><B>Returns:</B><DD>A set containing the <CODE>ObjectInstance</CODE>
 objects for the selected MBeans.  If no MBean satisfies the
 query an empty list is returned.
<DT><B>Throws:</B>
<DD><CODE><A HREF="http://java.sun.com/j2se/1.4/docs/api/java/io/IOException.html" title="class or interface in java.io">IOException</A></CODE> - A communication problem occurred when
 talking to the MBean server.</DL>
</DD>
</DL>
<HR>