GizzlerandCursor
58b7826162
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>
1847 lines
116 KiB
HTML
1847 lines
116 KiB
HTML
<!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:08 EDT 2011 -->
|
|
<TITLE>
|
|
MBeanServer (Management Application API)
|
|
</TITLE>
|
|
|
|
<META NAME="keywords" CONTENT="javax.management.MBeanServer interface">
|
|
|
|
<LINK REL ="stylesheet" TYPE="text/css" HREF="../../stylesheet.css" TITLE="Style">
|
|
|
|
<SCRIPT type="text/javascript">
|
|
function windowTitle()
|
|
{
|
|
parent.document.title="MBeanServer (Management Application API)";
|
|
}
|
|
</SCRIPT>
|
|
<NOSCRIPT>
|
|
</NOSCRIPT>
|
|
|
|
</HEAD>
|
|
|
|
<BODY BGCOLOR="white" onload="windowTitle();">
|
|
|
|
|
|
<!-- ========= START OF TOP NAVBAR ======= -->
|
|
<A NAME="navbar_top"><!-- --></A>
|
|
<A HREF="MBeanServer.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="MBeanRegistrationException.html" title="class in javax.management"><B>PREV CLASS</B></A>
|
|
<A HREF="MBeanServerBuilder.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%252FMBeanServer.html" target="_top"><B>FRAMES</B></A>
|
|
<A HREF="MBeanServer.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="MBeanServer.html#method_summary">METHOD</A></FONT></TD>
|
|
<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
|
|
DETAIL: FIELD | CONSTR | <A HREF="MBeanServer.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>
|
|
Interface MBeanServer</H2>
|
|
<DL>
|
|
<DT><B>All Superinterfaces:</B> <DD><A HREF="MBeanServerConnection.html" title="interface in javax.management">MBeanServerConnection</A></DD>
|
|
</DL>
|
|
<HR>
|
|
<DL>
|
|
<DT><PRE>public interface <B>MBeanServer</B><DT>extends <A HREF="MBeanServerConnection.html" title="interface in javax.management">MBeanServerConnection</A></DL>
|
|
</PRE>
|
|
|
|
<P>
|
|
<p>This is the interface for MBean manipulation on the agent
|
|
side. It contains the methods necessary for the creation,
|
|
registration, and deletion of MBeans as well as the access methods
|
|
for registered MBeans. This is the core component of the JMX
|
|
infrastructure.</p>
|
|
|
|
<p>User code does not usually implement this interface. Instead,
|
|
an object that implements this interface is obtained with one of
|
|
the methods in the <A HREF="MBeanServerFactory.html" title="class in javax.management"><CODE>MBeanServerFactory</CODE></A> class.</p>
|
|
|
|
<p>Every MBean which is added to the MBean server becomes
|
|
manageable: its attributes and operations become remotely
|
|
accessible through the connectors/adaptors connected to that MBean
|
|
server. A Java object cannot be registered in the MBean server
|
|
unless it is a JMX compliant MBean.</p>
|
|
|
|
<p>When an MBean is registered or unregistered in the MBean server
|
|
a <A HREF="MBeanServerNotification.html" title="class in javax.management"><CODE>MBeanServerNotification</CODE></A> Notification is emitted. To register an
|
|
object as listener to MBeanServerNotifications you should call the
|
|
MBean server method <A HREF="MBeanServer.html#addNotificationListener(javax.management.ObjectName, javax.management.NotificationListener, javax.management.NotificationFilter, java.lang.Object)"><CODE>addNotificationListener</CODE></A> with <CODE>ObjectName</CODE> the
|
|
<CODE>ObjectName</CODE> of the <A HREF="MBeanServerDelegate.html" title="class in javax.management"><CODE>MBeanServerDelegate</CODE></A>. This
|
|
<CODE>ObjectName</CODE> is: <BR>
|
|
<CODE>JMImplementation:type=MBeanServerDelegate</CODE>.</p>
|
|
|
|
<p>An object obtained from the <A HREF="MBeanServerFactory.html#createMBeanServer(java.lang.String)"><CODE>createMBeanServer</CODE></A> or
|
|
<A HREF="MBeanServerFactory.html#newMBeanServer(java.lang.String)"><CODE>newMBeanServer</CODE></A>
|
|
methods of the <A HREF="MBeanServerFactory.html" title="class in javax.management"><CODE>MBeanServerFactory</CODE></A> class applies security
|
|
checks to its methods, as follows.</p>
|
|
|
|
<p>First, if there is no security manager (<CODE>System.getSecurityManager()</CODE> is null), then no checks are made.</p>
|
|
|
|
<p>Assuming there is a security manager, the checks are made as
|
|
detailed below. In what follows, <code>className</code> is the
|
|
string returned by <A HREF="MBeanInfo.html#getClassName()"><CODE>MBeanInfo.getClassName()</CODE></A> for the target
|
|
MBean.</p>
|
|
|
|
<p>If a security check fails, the method throws <CODE>SecurityException</CODE>.</p>
|
|
|
|
<p>For methods that can throw <A HREF="InstanceNotFoundException.html" title="class in javax.management"><CODE>InstanceNotFoundException</CODE></A>,
|
|
this exception is thrown for a non-existent MBean, regardless of
|
|
permissions. This is because a non-existent MBean has no
|
|
<code>className</code>.</p>
|
|
|
|
<ul>
|
|
|
|
<li><p>For the <A HREF="MBeanServer.html#invoke(javax.management.ObjectName, java.lang.String, java.lang.Object[], java.lang.String[])"><CODE>invoke</CODE></A> method, the caller's
|
|
permissions must imply <A HREF="MBeanPermission.html#MBeanPermission(java.lang.String, java.lang.String, javax.management.ObjectName, java.lang.String)"><CODE>MBeanPermission(className, operationName, name, "invoke")</CODE></A>.</p>
|
|
|
|
<li><p>For the <A HREF="MBeanServer.html#getAttribute(javax.management.ObjectName, java.lang.String)"><CODE>getAttribute</CODE></A> method, the
|
|
caller's permissions must imply <A HREF="MBeanPermission.html#MBeanPermission(java.lang.String, java.lang.String, javax.management.ObjectName, java.lang.String)"><CODE>MBeanPermission(className, attribute, name, "getAttribute")</CODE></A>.</p>
|
|
|
|
<li><p>For the <A HREF="MBeanServer.html#getAttributes(javax.management.ObjectName, java.lang.String[])"><CODE>getAttributes</CODE></A> method, the
|
|
caller's permissions must imply <A HREF="MBeanPermission.html#MBeanPermission(java.lang.String, java.lang.String, javax.management.ObjectName, java.lang.String)"><CODE>MBeanPermission(className, null, name, "getAttribute")</CODE></A>.
|
|
Additionally, for each attribute <em>a</em> in the <A HREF="AttributeList.html" title="class in javax.management"><CODE>AttributeList</CODE></A>, if the caller's permissions do not imply <A HREF="MBeanPermission.html#MBeanPermission(java.lang.String, java.lang.String, javax.management.ObjectName, java.lang.String)"><CODE>MBeanPermission(className, <em>a</em>, name, "getAttribute")</CODE></A>, the
|
|
MBean server will behave as if that attribute had not been in the
|
|
supplied list.</p>
|
|
|
|
<li><p>For the <A HREF="MBeanServer.html#setAttribute(javax.management.ObjectName, javax.management.Attribute)"><CODE>setAttribute</CODE></A> method, the
|
|
caller's permissions must imply <A HREF="MBeanPermission.html#MBeanPermission(java.lang.String, java.lang.String, javax.management.ObjectName, java.lang.String)"><CODE>MBeanPermission(className, attrName, name, "getAttribute")</CODE></A>, where
|
|
<code>attrName</code> is <A HREF="Attribute.html#getName()"><CODE>attribute.getName()</CODE></A>.</p>
|
|
|
|
<li><p>For the <A HREF="MBeanServer.html#setAttributes(javax.management.ObjectName, javax.management.AttributeList)"><CODE>setAttributes</CODE></A> method, the
|
|
caller's permissions must imply <A HREF="MBeanPermission.html#MBeanPermission(java.lang.String, java.lang.String, javax.management.ObjectName, java.lang.String)"><CODE>MBeanPermission(className, null, name, "setAttribute")</CODE></A>.
|
|
Additionally, for each attribute <em>a</em> in the <A HREF="AttributeList.html" title="class in javax.management"><CODE>AttributeList</CODE></A>, if the caller's permissions do not imply <A HREF="MBeanPermission.html#MBeanPermission(java.lang.String, java.lang.String, javax.management.ObjectName, java.lang.String)"><CODE>MBeanPermission(className, <em>a</em>, name, "setAttribute")</CODE></A>, the
|
|
MBean server will behave as if that attribute had not been in the
|
|
supplied list.</p>
|
|
|
|
<li><p>For the <code>addNotificationListener</code> methods,
|
|
the caller's permissions must imply <A HREF="MBeanPermission.html#MBeanPermission(java.lang.String, java.lang.String, javax.management.ObjectName, java.lang.String)"><CODE>MBeanPermission(className, null, name,
|
|
"addNotificationListener")</CODE></A>.</p>
|
|
|
|
<li><p>For the <code>removeNotificationListener</code> methods,
|
|
the caller's permissions must imply <A HREF="MBeanPermission.html#MBeanPermission(java.lang.String, java.lang.String, javax.management.ObjectName, java.lang.String)"><CODE>MBeanPermission(className, null, name,
|
|
"removeNotificationListener")</CODE></A>.</p>
|
|
|
|
<li><p>For the <A HREF="MBeanServer.html#getMBeanInfo(javax.management.ObjectName)"><CODE>getMBeanInfo</CODE></A> method, the
|
|
caller's permissions must imply <A HREF="MBeanPermission.html#MBeanPermission(java.lang.String, java.lang.String, javax.management.ObjectName, java.lang.String)"><CODE>MBeanPermission(className, null, name, "getMBeanInfo")</CODE></A>.</p>
|
|
|
|
<li><p>For the <A HREF="MBeanServer.html#getObjectInstance(javax.management.ObjectName)"><CODE>getObjectInstance</CODE></A> method,
|
|
the caller's permissions must imply <A HREF="MBeanPermission.html#MBeanPermission(java.lang.String, java.lang.String, javax.management.ObjectName, java.lang.String)"><CODE>MBeanPermission(className, null, name, "getObjectInstance")</CODE></A>.</p>
|
|
|
|
<li><p>For the <A HREF="MBeanServer.html#isInstanceOf(javax.management.ObjectName, java.lang.String)"><CODE>isInstanceOf</CODE></A> method, the
|
|
caller's permissions must imply <A HREF="MBeanPermission.html#MBeanPermission(java.lang.String, java.lang.String, javax.management.ObjectName, java.lang.String)"><CODE>MBeanPermission(className, null, name, "isInstanceOf")</CODE></A>.</p>
|
|
|
|
<li><p>For the <A HREF="MBeanServer.html#queryMBeans(javax.management.ObjectName, javax.management.QueryExp)"><CODE>queryMBeans</CODE></A> method, the
|
|
caller's permissions must imply <A HREF="MBeanPermission.html#MBeanPermission(java.lang.String, java.lang.String, javax.management.ObjectName, java.lang.String)"><CODE>MBeanPermission(null, null, name, "queryMBeans")</CODE></A>.
|
|
Additionally, for each MBean that matches <code>name</code>,
|
|
if the caller's permissions do not imply <A HREF="MBeanPermission.html#MBeanPermission(java.lang.String, java.lang.String, javax.management.ObjectName, java.lang.String)"><CODE>MBeanPermission(className, null, name, "queryMBeans")</CODE></A>, the
|
|
MBean server will behave as if that MBean did not exist.</p>
|
|
|
|
<p>Certain query elements perform operations on the MBean server.
|
|
If the caller does not have the required permissions for a given
|
|
MBean, that MBean will not be included in the result of the query.
|
|
The standard query elements that are affected are <A HREF="Query.html#attr(java.lang.String)"><CODE>Query.attr(String)</CODE></A>, <A HREF="Query.html#attr(java.lang.String, java.lang.String)"><CODE>Query.attr(String,String)</CODE></A>, and <A HREF="Query.html#classattr()"><CODE>Query.classattr()</CODE></A>.</p>
|
|
|
|
<li><p>For the <A HREF="MBeanServer.html#queryNames(javax.management.ObjectName, javax.management.QueryExp)"><CODE>queryNames</CODE></A> method, the checks
|
|
are the same as for <code>queryMBeans</code> except that
|
|
<code>"queryNames"</code> is used instead of
|
|
<code>"queryMBeans"</code> in the <code>MBeanPermission</code>
|
|
objects. Note that a <code>"queryMBeans"</code> permission implies
|
|
the corresponding <code>"queryNames"</code> permission.</p>
|
|
|
|
<li><p>For the <A HREF="MBeanServer.html#getDomains()"><CODE>getDomains</CODE></A> method, the caller's
|
|
permissions must imply <A HREF="MBeanPermission.html#MBeanPermission(java.lang.String, java.lang.String, javax.management.ObjectName, java.lang.String)"><CODE>MBeanPermission(null, null, name, "getDomains")</CODE></A>. Additionally,
|
|
for each domain <var>d</var> in the returned array, if the caller's
|
|
permissions do not imply <A HREF="MBeanPermission.html#MBeanPermission(java.lang.String, java.lang.String, javax.management.ObjectName, java.lang.String)"><CODE>MBeanPermission(null, null, new ObjectName("<var>d</var>:x=x"),
|
|
"getDomains")</CODE></A>, the domain is eliminated from the array. Here,
|
|
<code>x=x</code> is any <var>key=value</var> pair, needed to
|
|
satisfy ObjectName's constructor but not otherwise relevant.</p>
|
|
|
|
<li><p>For the <A HREF="MBeanServer.html#getClassLoader(javax.management.ObjectName)"><CODE>getClassLoader</CODE></A> method, the
|
|
caller's permissions must imply <A HREF="MBeanPermission.html#MBeanPermission(java.lang.String, java.lang.String, javax.management.ObjectName, java.lang.String)"><CODE>MBeanPermission(className, null, loaderName,
|
|
"getClassLoader")</CODE></A>.</p>
|
|
|
|
<li><p>For the <A HREF="MBeanServer.html#getClassLoaderFor(javax.management.ObjectName)"><CODE>getClassLoaderFor</CODE></A> method,
|
|
the caller's permissions must imply <A HREF="MBeanPermission.html#MBeanPermission(java.lang.String, java.lang.String, javax.management.ObjectName, java.lang.String)"><CODE>MBeanPermission(className, null, mbeanName,
|
|
"getClassLoaderFor")</CODE></A>.</p>
|
|
|
|
<li><p>For the <A HREF="MBeanServer.html#getClassLoaderRepository()"><CODE>getClassLoaderRepository</CODE></A> method, the caller's permissions must
|
|
imply <A HREF="MBeanPermission.html#MBeanPermission(java.lang.String, java.lang.String, javax.management.ObjectName, java.lang.String)"><CODE>MBeanPermission(null, null, null, "getClassLoaderRepository")</CODE></A>.</p>
|
|
|
|
<li><p>For the deprecated <code>deserialize</code> methods, the
|
|
required permissions are the same as for the methods that replace
|
|
them.</p>
|
|
|
|
<li><p>For the <code>instantiate</code> methods, the caller's
|
|
permissions must imply <A HREF="MBeanPermission.html#MBeanPermission(java.lang.String, java.lang.String, javax.management.ObjectName, java.lang.String)"><CODE>MBeanPermission(className, null, null, "instantiate")</CODE></A>.</p>
|
|
|
|
<li><p>For the <A HREF="MBeanServer.html#registerMBean(java.lang.Object, javax.management.ObjectName)"><CODE>registerMBean</CODE></A> method, the
|
|
caller's permissions must imply <A HREF="MBeanPermission.html#MBeanPermission(java.lang.String, java.lang.String, javax.management.ObjectName, java.lang.String)"><CODE>MBeanPermission(className, null, name, "registerMBean")</CODE></A>. Here
|
|
<code>className</code> is the string returned by <A HREF="MBeanInfo.html#getClassName()"><CODE>MBeanInfo.getClassName()</CODE></A> for an object of this class.
|
|
|
|
<p>If the <code>MBeanPermission</code> check succeeds, the MBean's
|
|
class is validated by checking that its <CODE>ProtectionDomain</CODE> implies <A HREF="MBeanTrustPermission.html#MBeanTrustPermission(java.lang.String)"><CODE>MBeanTrustPermission("register")</CODE></A>.</p>
|
|
|
|
<p>Finally, if the <code>name</code> argument is null, another
|
|
<code>MBeanPermission</code> check is made using the
|
|
<code>ObjectName</code> returned by <A HREF="MBeanRegistration.html#preRegister(javax.management.MBeanServer, javax.management.ObjectName)"><CODE>MBeanRegistration.preRegister</CODE></A>.</p>
|
|
|
|
<li><p>For the <code>createMBean</code> methods, the caller's
|
|
permissions must imply the permissions needed by the equivalent
|
|
<code>instantiate</code> followed by
|
|
<code>registerMBean</code>.</p>
|
|
|
|
<li><p>For the <A HREF="MBeanServer.html#unregisterMBean(javax.management.ObjectName)"><CODE>unregisterMBean</CODE></A> method,
|
|
the caller's permissions must imply <A HREF="MBeanPermission.html#MBeanPermission(java.lang.String, java.lang.String, javax.management.ObjectName, java.lang.String)"><CODE>MBeanPermission(className, null, name, "unregisterMBean")</CODE></A>.</p>
|
|
|
|
</ul>
|
|
<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> void</CODE></FONT></TD>
|
|
<TD><CODE><B><A HREF="MBeanServer.html#addNotificationListener(javax.management.ObjectName, javax.management.NotificationListener, javax.management.NotificationFilter, java.lang.Object)">addNotificationListener</A></B>(<A HREF="ObjectName.html" title="class in javax.management">ObjectName</A> name,
|
|
<A HREF="NotificationListener.html" title="interface in javax.management">NotificationListener</A> listener,
|
|
<A HREF="NotificationFilter.html" title="interface in javax.management">NotificationFilter</A> filter,
|
|
java.lang.Object handback)</CODE>
|
|
|
|
<BR>
|
|
Adds a listener to a registered MBean.</TD>
|
|
</TR>
|
|
<TR BGCOLOR="white" CLASS="TableRowColor">
|
|
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
|
|
<CODE> void</CODE></FONT></TD>
|
|
<TD><CODE><B><A HREF="MBeanServer.html#addNotificationListener(javax.management.ObjectName, javax.management.ObjectName, javax.management.NotificationFilter, java.lang.Object)">addNotificationListener</A></B>(<A HREF="ObjectName.html" title="class in javax.management">ObjectName</A> name,
|
|
<A HREF="ObjectName.html" title="class in javax.management">ObjectName</A> listener,
|
|
<A HREF="NotificationFilter.html" title="interface in javax.management">NotificationFilter</A> filter,
|
|
java.lang.Object handback)</CODE>
|
|
|
|
<BR>
|
|
Adds a listener to a registered MBean.</TD>
|
|
</TR>
|
|
<TR BGCOLOR="white" CLASS="TableRowColor">
|
|
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
|
|
<CODE> <A HREF="ObjectInstance.html" title="class in javax.management">ObjectInstance</A></CODE></FONT></TD>
|
|
<TD><CODE><B><A HREF="MBeanServer.html#createMBean(java.lang.String, javax.management.ObjectName)">createMBean</A></B>(java.lang.String className,
|
|
<A HREF="ObjectName.html" title="class in javax.management">ObjectName</A> name)</CODE>
|
|
|
|
<BR>
|
|
Instantiates and registers an MBean in the MBean server.</TD>
|
|
</TR>
|
|
<TR BGCOLOR="white" CLASS="TableRowColor">
|
|
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
|
|
<CODE> <A HREF="ObjectInstance.html" title="class in javax.management">ObjectInstance</A></CODE></FONT></TD>
|
|
<TD><CODE><B><A HREF="MBeanServer.html#createMBean(java.lang.String, javax.management.ObjectName, java.lang.Object[], java.lang.String[])">createMBean</A></B>(java.lang.String className,
|
|
<A HREF="ObjectName.html" title="class in javax.management">ObjectName</A> name,
|
|
java.lang.Object[] params,
|
|
java.lang.String[] signature)</CODE>
|
|
|
|
<BR>
|
|
Instantiates and registers an MBean in the MBean server.</TD>
|
|
</TR>
|
|
<TR BGCOLOR="white" CLASS="TableRowColor">
|
|
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
|
|
<CODE> <A HREF="ObjectInstance.html" title="class in javax.management">ObjectInstance</A></CODE></FONT></TD>
|
|
<TD><CODE><B><A HREF="MBeanServer.html#createMBean(java.lang.String, javax.management.ObjectName, javax.management.ObjectName)">createMBean</A></B>(java.lang.String className,
|
|
<A HREF="ObjectName.html" title="class in javax.management">ObjectName</A> name,
|
|
<A HREF="ObjectName.html" title="class in javax.management">ObjectName</A> loaderName)</CODE>
|
|
|
|
<BR>
|
|
Instantiates and registers an MBean in the MBean server.</TD>
|
|
</TR>
|
|
<TR BGCOLOR="white" CLASS="TableRowColor">
|
|
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
|
|
<CODE> <A HREF="ObjectInstance.html" title="class in javax.management">ObjectInstance</A></CODE></FONT></TD>
|
|
<TD><CODE><B><A HREF="MBeanServer.html#createMBean(java.lang.String, javax.management.ObjectName, javax.management.ObjectName, java.lang.Object[], java.lang.String[])">createMBean</A></B>(java.lang.String className,
|
|
<A HREF="ObjectName.html" title="class in javax.management">ObjectName</A> name,
|
|
<A HREF="ObjectName.html" title="class in javax.management">ObjectName</A> loaderName,
|
|
java.lang.Object[] params,
|
|
java.lang.String[] signature)</CODE>
|
|
|
|
<BR>
|
|
Instantiates and registers an MBean in the MBean server.</TD>
|
|
</TR>
|
|
<TR BGCOLOR="white" CLASS="TableRowColor">
|
|
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
|
|
<CODE> java.lang.Object</CODE></FONT></TD>
|
|
<TD><CODE><B><A HREF="MBeanServer.html#getAttribute(javax.management.ObjectName, java.lang.String)">getAttribute</A></B>(<A HREF="ObjectName.html" title="class in javax.management">ObjectName</A> name,
|
|
java.lang.String attribute)</CODE>
|
|
|
|
<BR>
|
|
Gets the value of a specific attribute of a named MBean.</TD>
|
|
</TR>
|
|
<TR BGCOLOR="white" CLASS="TableRowColor">
|
|
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
|
|
<CODE> <A HREF="AttributeList.html" title="class in javax.management">AttributeList</A></CODE></FONT></TD>
|
|
<TD><CODE><B><A HREF="MBeanServer.html#getAttributes(javax.management.ObjectName, java.lang.String[])">getAttributes</A></B>(<A HREF="ObjectName.html" title="class in javax.management">ObjectName</A> name,
|
|
java.lang.String[] attributes)</CODE>
|
|
|
|
<BR>
|
|
Gets the values of several attributes of a named MBean.</TD>
|
|
</TR>
|
|
<TR BGCOLOR="white" CLASS="TableRowColor">
|
|
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
|
|
<CODE> java.lang.ClassLoader</CODE></FONT></TD>
|
|
<TD><CODE><B><A HREF="MBeanServer.html#getClassLoader(javax.management.ObjectName)">getClassLoader</A></B>(<A HREF="ObjectName.html" title="class in javax.management">ObjectName</A> loaderName)</CODE>
|
|
|
|
<BR>
|
|
Return the named <CODE>ClassLoader</CODE>.</TD>
|
|
</TR>
|
|
<TR BGCOLOR="white" CLASS="TableRowColor">
|
|
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
|
|
<CODE> java.lang.ClassLoader</CODE></FONT></TD>
|
|
<TD><CODE><B><A HREF="MBeanServer.html#getClassLoaderFor(javax.management.ObjectName)">getClassLoaderFor</A></B>(<A HREF="ObjectName.html" title="class in javax.management">ObjectName</A> mbeanName)</CODE>
|
|
|
|
<BR>
|
|
Return the <CODE>ClassLoader</CODE> that was used for
|
|
loading the class of the named MBean.</TD>
|
|
</TR>
|
|
<TR BGCOLOR="white" CLASS="TableRowColor">
|
|
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
|
|
<CODE> <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="MBeanServer.html#getClassLoaderRepository()">getClassLoaderRepository</A></B>()</CODE>
|
|
|
|
<BR>
|
|
Return the ClassLoaderRepository for this MBeanServer.</TD>
|
|
</TR>
|
|
<TR BGCOLOR="white" CLASS="TableRowColor">
|
|
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
|
|
<CODE> java.lang.String</CODE></FONT></TD>
|
|
<TD><CODE><B><A HREF="MBeanServer.html#getDefaultDomain()">getDefaultDomain</A></B>()</CODE>
|
|
|
|
<BR>
|
|
Returns the default domain used for naming the MBean.</TD>
|
|
</TR>
|
|
<TR BGCOLOR="white" CLASS="TableRowColor">
|
|
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
|
|
<CODE> java.lang.String[]</CODE></FONT></TD>
|
|
<TD><CODE><B><A HREF="MBeanServer.html#getDomains()">getDomains</A></B>()</CODE>
|
|
|
|
<BR>
|
|
Returns the list of domains in which any MBean is currently
|
|
registered.</TD>
|
|
</TR>
|
|
<TR BGCOLOR="white" CLASS="TableRowColor">
|
|
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
|
|
<CODE> java.lang.Integer</CODE></FONT></TD>
|
|
<TD><CODE><B><A HREF="MBeanServer.html#getMBeanCount()">getMBeanCount</A></B>()</CODE>
|
|
|
|
<BR>
|
|
Returns the number of MBeans registered in the MBean server.</TD>
|
|
</TR>
|
|
<TR BGCOLOR="white" CLASS="TableRowColor">
|
|
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
|
|
<CODE> <A HREF="MBeanInfo.html" title="class in javax.management">MBeanInfo</A></CODE></FONT></TD>
|
|
<TD><CODE><B><A HREF="MBeanServer.html#getMBeanInfo(javax.management.ObjectName)">getMBeanInfo</A></B>(<A HREF="ObjectName.html" title="class in javax.management">ObjectName</A> name)</CODE>
|
|
|
|
<BR>
|
|
This method discovers the attributes and operations that an
|
|
MBean exposes for management.</TD>
|
|
</TR>
|
|
<TR BGCOLOR="white" CLASS="TableRowColor">
|
|
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
|
|
<CODE> <A HREF="ObjectInstance.html" title="class in javax.management">ObjectInstance</A></CODE></FONT></TD>
|
|
<TD><CODE><B><A HREF="MBeanServer.html#getObjectInstance(javax.management.ObjectName)">getObjectInstance</A></B>(<A HREF="ObjectName.html" title="class in javax.management">ObjectName</A> name)</CODE>
|
|
|
|
<BR>
|
|
Gets the <CODE>ObjectInstance</CODE> for a given MBean
|
|
registered with the MBean server.</TD>
|
|
</TR>
|
|
<TR BGCOLOR="white" CLASS="TableRowColor">
|
|
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
|
|
<CODE> java.lang.Object</CODE></FONT></TD>
|
|
<TD><CODE><B><A HREF="MBeanServer.html#instantiate(java.lang.String)">instantiate</A></B>(java.lang.String className)</CODE>
|
|
|
|
<BR>
|
|
Instantiates an object using the list of all class loaders
|
|
registered in the MBean server's <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"><CODE>Class Loader
|
|
Repository</CODE></A>.</TD>
|
|
</TR>
|
|
<TR BGCOLOR="white" CLASS="TableRowColor">
|
|
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
|
|
<CODE> java.lang.Object</CODE></FONT></TD>
|
|
<TD><CODE><B><A HREF="MBeanServer.html#instantiate(java.lang.String, java.lang.Object[], java.lang.String[])">instantiate</A></B>(java.lang.String className,
|
|
java.lang.Object[] params,
|
|
java.lang.String[] signature)</CODE>
|
|
|
|
<BR>
|
|
Instantiates an object using the list of all class loaders
|
|
registered in the MBean server <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"><CODE>Class Loader
|
|
Repository</CODE></A>.</TD>
|
|
</TR>
|
|
<TR BGCOLOR="white" CLASS="TableRowColor">
|
|
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
|
|
<CODE> java.lang.Object</CODE></FONT></TD>
|
|
<TD><CODE><B><A HREF="MBeanServer.html#instantiate(java.lang.String, javax.management.ObjectName)">instantiate</A></B>(java.lang.String className,
|
|
<A HREF="ObjectName.html" title="class in javax.management">ObjectName</A> loaderName)</CODE>
|
|
|
|
<BR>
|
|
Instantiates an object using the class Loader specified by its
|
|
<CODE>ObjectName</CODE>.</TD>
|
|
</TR>
|
|
<TR BGCOLOR="white" CLASS="TableRowColor">
|
|
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
|
|
<CODE> java.lang.Object</CODE></FONT></TD>
|
|
<TD><CODE><B><A HREF="MBeanServer.html#instantiate(java.lang.String, javax.management.ObjectName, java.lang.Object[], java.lang.String[])">instantiate</A></B>(java.lang.String className,
|
|
<A HREF="ObjectName.html" title="class in javax.management">ObjectName</A> loaderName,
|
|
java.lang.Object[] params,
|
|
java.lang.String[] signature)</CODE>
|
|
|
|
<BR>
|
|
Instantiates an object.</TD>
|
|
</TR>
|
|
<TR BGCOLOR="white" CLASS="TableRowColor">
|
|
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
|
|
<CODE> java.lang.Object</CODE></FONT></TD>
|
|
<TD><CODE><B><A HREF="MBeanServer.html#invoke(javax.management.ObjectName, java.lang.String, java.lang.Object[], java.lang.String[])">invoke</A></B>(<A HREF="ObjectName.html" title="class in javax.management">ObjectName</A> name,
|
|
java.lang.String operationName,
|
|
java.lang.Object[] params,
|
|
java.lang.String[] signature)</CODE>
|
|
|
|
<BR>
|
|
Invokes an operation on an MBean.</TD>
|
|
</TR>
|
|
<TR BGCOLOR="white" CLASS="TableRowColor">
|
|
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
|
|
<CODE> boolean</CODE></FONT></TD>
|
|
<TD><CODE><B><A HREF="MBeanServer.html#isInstanceOf(javax.management.ObjectName, java.lang.String)">isInstanceOf</A></B>(<A HREF="ObjectName.html" title="class in javax.management">ObjectName</A> name,
|
|
java.lang.String className)</CODE>
|
|
|
|
<BR>
|
|
Returns true if the MBean specified is an instance of the
|
|
specified class, false otherwise.</TD>
|
|
</TR>
|
|
<TR BGCOLOR="white" CLASS="TableRowColor">
|
|
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
|
|
<CODE> boolean</CODE></FONT></TD>
|
|
<TD><CODE><B><A HREF="MBeanServer.html#isRegistered(javax.management.ObjectName)">isRegistered</A></B>(<A HREF="ObjectName.html" title="class in javax.management">ObjectName</A> name)</CODE>
|
|
|
|
<BR>
|
|
Checks whether an MBean, identified by its object name, is
|
|
already registered with the MBean server.</TD>
|
|
</TR>
|
|
<TR BGCOLOR="white" CLASS="TableRowColor">
|
|
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
|
|
<CODE> java.util.Set</CODE></FONT></TD>
|
|
<TD><CODE><B><A HREF="MBeanServer.html#queryMBeans(javax.management.ObjectName, javax.management.QueryExp)">queryMBeans</A></B>(<A HREF="ObjectName.html" title="class in javax.management">ObjectName</A> name,
|
|
<A HREF="QueryExp.html" title="interface in javax.management">QueryExp</A> query)</CODE>
|
|
|
|
<BR>
|
|
Gets MBeans controlled by the MBean server.</TD>
|
|
</TR>
|
|
<TR BGCOLOR="white" CLASS="TableRowColor">
|
|
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
|
|
<CODE> java.util.Set</CODE></FONT></TD>
|
|
<TD><CODE><B><A HREF="MBeanServer.html#queryNames(javax.management.ObjectName, javax.management.QueryExp)">queryNames</A></B>(<A HREF="ObjectName.html" title="class in javax.management">ObjectName</A> name,
|
|
<A HREF="QueryExp.html" title="interface in javax.management">QueryExp</A> query)</CODE>
|
|
|
|
<BR>
|
|
Gets the names of MBeans controlled by the MBean server.</TD>
|
|
</TR>
|
|
<TR BGCOLOR="white" CLASS="TableRowColor">
|
|
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
|
|
<CODE> <A HREF="ObjectInstance.html" title="class in javax.management">ObjectInstance</A></CODE></FONT></TD>
|
|
<TD><CODE><B><A HREF="MBeanServer.html#registerMBean(java.lang.Object, javax.management.ObjectName)">registerMBean</A></B>(java.lang.Object object,
|
|
<A HREF="ObjectName.html" title="class in javax.management">ObjectName</A> name)</CODE>
|
|
|
|
<BR>
|
|
Registers a pre-existing object as an MBean with the MBean
|
|
server.</TD>
|
|
</TR>
|
|
<TR BGCOLOR="white" CLASS="TableRowColor">
|
|
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
|
|
<CODE> void</CODE></FONT></TD>
|
|
<TD><CODE><B><A HREF="MBeanServer.html#removeNotificationListener(javax.management.ObjectName, javax.management.NotificationListener)">removeNotificationListener</A></B>(<A HREF="ObjectName.html" title="class in javax.management">ObjectName</A> name,
|
|
<A HREF="NotificationListener.html" title="interface in javax.management">NotificationListener</A> listener)</CODE>
|
|
|
|
<BR>
|
|
Removes a listener from a registered MBean.</TD>
|
|
</TR>
|
|
<TR BGCOLOR="white" CLASS="TableRowColor">
|
|
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
|
|
<CODE> void</CODE></FONT></TD>
|
|
<TD><CODE><B><A HREF="MBeanServer.html#removeNotificationListener(javax.management.ObjectName, javax.management.NotificationListener, javax.management.NotificationFilter, java.lang.Object)">removeNotificationListener</A></B>(<A HREF="ObjectName.html" title="class in javax.management">ObjectName</A> name,
|
|
<A HREF="NotificationListener.html" title="interface in javax.management">NotificationListener</A> listener,
|
|
<A HREF="NotificationFilter.html" title="interface in javax.management">NotificationFilter</A> filter,
|
|
java.lang.Object handback)</CODE>
|
|
|
|
<BR>
|
|
Removes a listener from a registered MBean.</TD>
|
|
</TR>
|
|
<TR BGCOLOR="white" CLASS="TableRowColor">
|
|
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
|
|
<CODE> void</CODE></FONT></TD>
|
|
<TD><CODE><B><A HREF="MBeanServer.html#removeNotificationListener(javax.management.ObjectName, javax.management.ObjectName)">removeNotificationListener</A></B>(<A HREF="ObjectName.html" title="class in javax.management">ObjectName</A> name,
|
|
<A HREF="ObjectName.html" title="class in javax.management">ObjectName</A> listener)</CODE>
|
|
|
|
<BR>
|
|
Removes a listener from a registered MBean.</TD>
|
|
</TR>
|
|
<TR BGCOLOR="white" CLASS="TableRowColor">
|
|
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
|
|
<CODE> void</CODE></FONT></TD>
|
|
<TD><CODE><B><A HREF="MBeanServer.html#removeNotificationListener(javax.management.ObjectName, javax.management.ObjectName, javax.management.NotificationFilter, java.lang.Object)">removeNotificationListener</A></B>(<A HREF="ObjectName.html" title="class in javax.management">ObjectName</A> name,
|
|
<A HREF="ObjectName.html" title="class in javax.management">ObjectName</A> listener,
|
|
<A HREF="NotificationFilter.html" title="interface in javax.management">NotificationFilter</A> filter,
|
|
java.lang.Object handback)</CODE>
|
|
|
|
<BR>
|
|
Removes a listener from a registered MBean.</TD>
|
|
</TR>
|
|
<TR BGCOLOR="white" CLASS="TableRowColor">
|
|
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
|
|
<CODE> void</CODE></FONT></TD>
|
|
<TD><CODE><B><A HREF="MBeanServer.html#setAttribute(javax.management.ObjectName, javax.management.Attribute)">setAttribute</A></B>(<A HREF="ObjectName.html" title="class in javax.management">ObjectName</A> name,
|
|
<A HREF="Attribute.html" title="class in javax.management">Attribute</A> attribute)</CODE>
|
|
|
|
<BR>
|
|
Sets the value of a specific attribute of a named MBean.</TD>
|
|
</TR>
|
|
<TR BGCOLOR="white" CLASS="TableRowColor">
|
|
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
|
|
<CODE> <A HREF="AttributeList.html" title="class in javax.management">AttributeList</A></CODE></FONT></TD>
|
|
<TD><CODE><B><A HREF="MBeanServer.html#setAttributes(javax.management.ObjectName, javax.management.AttributeList)">setAttributes</A></B>(<A HREF="ObjectName.html" title="class in javax.management">ObjectName</A> name,
|
|
<A HREF="AttributeList.html" title="class in javax.management">AttributeList</A> attributes)</CODE>
|
|
|
|
<BR>
|
|
Sets the values of several attributes of a named MBean.</TD>
|
|
</TR>
|
|
<TR BGCOLOR="white" CLASS="TableRowColor">
|
|
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
|
|
<CODE> void</CODE></FONT></TD>
|
|
<TD><CODE><B><A HREF="MBeanServer.html#unregisterMBean(javax.management.ObjectName)">unregisterMBean</A></B>(<A HREF="ObjectName.html" title="class in javax.management">ObjectName</A> name)</CODE>
|
|
|
|
<BR>
|
|
Unregisters an MBean from the MBean server.</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="addNotificationListener(javax.management.ObjectName, javax.management.NotificationListener, javax.management.NotificationFilter, java.lang.Object)"><!-- --></A><H3>
|
|
addNotificationListener</H3>
|
|
<PRE>
|
|
void <B>addNotificationListener</B>(<A HREF="ObjectName.html" title="class in javax.management">ObjectName</A> name,
|
|
<A HREF="NotificationListener.html" title="interface in javax.management">NotificationListener</A> listener,
|
|
<A HREF="NotificationFilter.html" title="interface in javax.management">NotificationFilter</A> filter,
|
|
java.lang.Object handback)
|
|
throws <A HREF="InstanceNotFoundException.html" title="class in javax.management">InstanceNotFoundException</A></PRE>
|
|
<DL>
|
|
<DD><p>Adds a listener to a registered MBean.</p>
|
|
|
|
<P> A notification emitted by the MBean will be forwarded by the
|
|
MBeanServer to the listener. If the source of the notification
|
|
is a reference to the MBean object, the MBean server will replace it
|
|
by the MBean's ObjectName. Otherwise the source is unchanged.
|
|
<P>
|
|
<DD><DL>
|
|
<DT><B>Specified by:</B><DD><CODE><A HREF="MBeanServerConnection.html#addNotificationListener(javax.management.ObjectName, javax.management.NotificationListener, javax.management.NotificationFilter, java.lang.Object)">addNotificationListener</A></CODE> in interface <CODE><A HREF="MBeanServerConnection.html" title="interface in javax.management">MBeanServerConnection</A></CODE></DL>
|
|
</DD>
|
|
<DD><DL>
|
|
<DT><B>Parameters:</B><DD><CODE>name</CODE> - The name of the MBean on which the listener should
|
|
be added.<DD><CODE>listener</CODE> - The listener object which will handle the
|
|
notifications emitted by the registered MBean.<DD><CODE>filter</CODE> - The filter object. If filter is null, no
|
|
filtering will be performed before handling notifications.<DD><CODE>handback</CODE> - The context to be sent to the listener when a
|
|
notification is emitted.
|
|
<DT><B>Throws:</B>
|
|
<DD><CODE><A HREF="InstanceNotFoundException.html" title="class in javax.management">InstanceNotFoundException</A></CODE> - The MBean name provided
|
|
does not match any of the registered MBeans.<DT><B>See Also:</B><DD><A HREF="MBeanServer.html#removeNotificationListener(javax.management.ObjectName, javax.management.NotificationListener)"><CODE>removeNotificationListener(ObjectName, NotificationListener)</CODE></A>,
|
|
<A HREF="MBeanServer.html#removeNotificationListener(javax.management.ObjectName, javax.management.NotificationListener, javax.management.NotificationFilter, java.lang.Object)"><CODE>removeNotificationListener(ObjectName, NotificationListener,
|
|
NotificationFilter, Object)</CODE></A></DL>
|
|
</DD>
|
|
</DL>
|
|
<HR>
|
|
|
|
<A NAME="addNotificationListener(javax.management.ObjectName, javax.management.ObjectName, javax.management.NotificationFilter, java.lang.Object)"><!-- --></A><H3>
|
|
addNotificationListener</H3>
|
|
<PRE>
|
|
void <B>addNotificationListener</B>(<A HREF="ObjectName.html" title="class in javax.management">ObjectName</A> name,
|
|
<A HREF="ObjectName.html" title="class in javax.management">ObjectName</A> listener,
|
|
<A HREF="NotificationFilter.html" title="interface in javax.management">NotificationFilter</A> filter,
|
|
java.lang.Object handback)
|
|
throws <A HREF="InstanceNotFoundException.html" title="class in javax.management">InstanceNotFoundException</A></PRE>
|
|
<DL>
|
|
<DD><p>Adds a listener to a registered MBean.</p>
|
|
|
|
<P> A notification emitted by the MBean will be forwarded by the
|
|
MBeanServer to the listener. If the source of the notification
|
|
is a reference to the MBean object, the MBean server will replace it
|
|
by the MBean's ObjectName. Otherwise the source is unchanged.
|
|
|
|
<p>The listener object that receives notifications is the one
|
|
that is registered with the given name at the time this method
|
|
is called. Even if it is subsequently unregistered, it will
|
|
continue to receive notifications.</p>
|
|
<P>
|
|
<DD><DL>
|
|
<DT><B>Specified by:</B><DD><CODE><A HREF="MBeanServerConnection.html#addNotificationListener(javax.management.ObjectName, javax.management.ObjectName, javax.management.NotificationFilter, java.lang.Object)">addNotificationListener</A></CODE> in interface <CODE><A HREF="MBeanServerConnection.html" title="interface in javax.management">MBeanServerConnection</A></CODE></DL>
|
|
</DD>
|
|
<DD><DL>
|
|
<DT><B>Parameters:</B><DD><CODE>name</CODE> - The name of the MBean on which the listener should
|
|
be added.<DD><CODE>listener</CODE> - The object name of the listener which will
|
|
handle the notifications emitted by the registered MBean.<DD><CODE>filter</CODE> - The filter object. If filter is null, no
|
|
filtering will be performed before handling notifications.<DD><CODE>handback</CODE> - The context to be sent to the listener when a
|
|
notification is emitted.
|
|
<DT><B>Throws:</B>
|
|
<DD><CODE><A HREF="InstanceNotFoundException.html" title="class in javax.management">InstanceNotFoundException</A></CODE> - The MBean name of the
|
|
notification listener or of the notification broadcaster does
|
|
not match any of the registered MBeans.
|
|
<DD><CODE><A HREF="RuntimeOperationsException.html" title="class in javax.management">RuntimeOperationsException</A></CODE> - Wraps an <CODE>IllegalArgumentException</CODE>. The MBean named by
|
|
<code>listener</code> exists but does not implement the <A HREF="NotificationListener.html" title="interface in javax.management"><CODE>NotificationListener</CODE></A> interface.<DT><B>See Also:</B><DD><A HREF="MBeanServer.html#removeNotificationListener(javax.management.ObjectName, javax.management.ObjectName)"><CODE>removeNotificationListener(ObjectName, ObjectName)</CODE></A>,
|
|
<A HREF="MBeanServer.html#removeNotificationListener(javax.management.ObjectName, javax.management.ObjectName, javax.management.NotificationFilter, java.lang.Object)"><CODE>removeNotificationListener(ObjectName, ObjectName,
|
|
NotificationFilter, Object)</CODE></A></DL>
|
|
</DD>
|
|
</DL>
|
|
<HR>
|
|
|
|
<A NAME="createMBean(java.lang.String, javax.management.ObjectName)"><!-- --></A><H3>
|
|
createMBean</H3>
|
|
<PRE>
|
|
<A HREF="ObjectInstance.html" title="class in javax.management">ObjectInstance</A> <B>createMBean</B>(java.lang.String className,
|
|
<A HREF="ObjectName.html" title="class in javax.management">ObjectName</A> name)
|
|
throws <A HREF="ReflectionException.html" title="class in javax.management">ReflectionException</A>,
|
|
<A HREF="InstanceAlreadyExistsException.html" title="class in javax.management">InstanceAlreadyExistsException</A>,
|
|
<A HREF="MBeanRegistrationException.html" title="class in javax.management">MBeanRegistrationException</A>,
|
|
<A HREF="MBeanException.html" title="class in javax.management">MBeanException</A>,
|
|
<A HREF="NotCompliantMBeanException.html" title="class in javax.management">NotCompliantMBeanException</A></PRE>
|
|
<DL>
|
|
<DD><p>Instantiates and registers an MBean in the MBean server. The
|
|
MBean server will use its <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"><CODE>Default Loader
|
|
Repository</CODE></A> to load the class of the MBean. An object name is
|
|
associated to the MBean. If the object name given is null, the
|
|
MBean must provide its own name by implementing the <A HREF="MBeanRegistration.html" title="interface in javax.management"><CODE>MBeanRegistration</CODE></A> interface
|
|
and returning the name from the <A HREF="MBeanRegistration.html#preRegister(javax.management.MBeanServer, javax.management.ObjectName)"><CODE>preRegister</CODE></A> method.</p>
|
|
|
|
<p>This method is equivalent to <A HREF="MBeanServer.html#createMBean(java.lang.String, javax.management.ObjectName, java.lang.Object[], java.lang.String[])"><CODE>createMBean(className, name, (Object[]) null, (String[])
|
|
null)</CODE></A>.</p>
|
|
<P>
|
|
<DD><DL>
|
|
<DT><B>Specified by:</B><DD><CODE><A HREF="MBeanServerConnection.html#createMBean(java.lang.String, javax.management.ObjectName)">createMBean</A></CODE> in interface <CODE><A HREF="MBeanServerConnection.html" title="interface in javax.management">MBeanServerConnection</A></CODE></DL>
|
|
</DD>
|
|
<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.
|
|
<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="MBeanServer.html#getMBeanInfo(javax.management.ObjectName)"><CODE>getMBeanInfo(n)</CODE></A>.getClassName()</code>.
|
|
<DT><B>Throws:</B>
|
|
<DD><CODE><A HREF="ReflectionException.html" title="class in javax.management">ReflectionException</A></CODE> - Wraps a
|
|
<CODE>java.lang.ClassNotFoundException</CODE> or a
|
|
<CODE><CODE>java.lang.Exception</CODE></CODE> that occurred
|
|
when trying to invoke the MBean's constructor.
|
|
<DD><CODE><A HREF="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="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="MBeanException.html" title="class in javax.management">MBeanException</A></CODE> - The constructor of the MBean has
|
|
thrown an exception
|
|
<DD><CODE><A HREF="NotCompliantMBeanException.html" title="class in javax.management">NotCompliantMBeanException</A></CODE> - This class is not a JMX
|
|
compliant MBean
|
|
<DD><CODE><A HREF="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.</DL>
|
|
</DD>
|
|
</DL>
|
|
<HR>
|
|
|
|
<A NAME="createMBean(java.lang.String, javax.management.ObjectName, java.lang.Object[], java.lang.String[])"><!-- --></A><H3>
|
|
createMBean</H3>
|
|
<PRE>
|
|
<A HREF="ObjectInstance.html" title="class in javax.management">ObjectInstance</A> <B>createMBean</B>(java.lang.String className,
|
|
<A HREF="ObjectName.html" title="class in javax.management">ObjectName</A> name,
|
|
java.lang.Object[] params,
|
|
java.lang.String[] signature)
|
|
throws <A HREF="ReflectionException.html" title="class in javax.management">ReflectionException</A>,
|
|
<A HREF="InstanceAlreadyExistsException.html" title="class in javax.management">InstanceAlreadyExistsException</A>,
|
|
<A HREF="MBeanRegistrationException.html" title="class in javax.management">MBeanRegistrationException</A>,
|
|
<A HREF="MBeanException.html" title="class in javax.management">MBeanException</A>,
|
|
<A HREF="NotCompliantMBeanException.html" title="class in javax.management">NotCompliantMBeanException</A></PRE>
|
|
<DL>
|
|
<DD>Instantiates and registers an MBean in the MBean server. The
|
|
MBean server will use its <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"><CODE>Default Loader
|
|
Repository</CODE></A> to load the class of the MBean. An object name is
|
|
associated to the MBean. If the object name given is null, the
|
|
MBean must provide its own name by implementing the <A HREF="MBeanRegistration.html" title="interface in javax.management"><CODE>MBeanRegistration</CODE></A> interface
|
|
and returning the name from the <A HREF="MBeanRegistration.html#preRegister(javax.management.MBeanServer, javax.management.ObjectName)"><CODE>preRegister</CODE></A> method.
|
|
<P>
|
|
<DD><DL>
|
|
<DT><B>Specified by:</B><DD><CODE><A HREF="MBeanServerConnection.html#createMBean(java.lang.String, javax.management.ObjectName, java.lang.Object[], java.lang.String[])">createMBean</A></CODE> in interface <CODE><A HREF="MBeanServerConnection.html" title="interface in javax.management">MBeanServerConnection</A></CODE></DL>
|
|
</DD>
|
|
<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.
|
|
<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="MBeanServer.html#getMBeanInfo(javax.management.ObjectName)"><CODE>getMBeanInfo(n)</CODE></A>.getClassName()</code>.
|
|
<DT><B>Throws:</B>
|
|
<DD><CODE><A HREF="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="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="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="MBeanException.html" title="class in javax.management">MBeanException</A></CODE> - The constructor of the MBean has
|
|
thrown an exception
|
|
<DD><CODE><A HREF="NotCompliantMBeanException.html" title="class in javax.management">NotCompliantMBeanException</A></CODE> - This class is not a JMX
|
|
compliant MBean
|
|
<DD><CODE><A HREF="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.</DL>
|
|
</DD>
|
|
</DL>
|
|
<HR>
|
|
|
|
<A NAME="createMBean(java.lang.String, javax.management.ObjectName, javax.management.ObjectName)"><!-- --></A><H3>
|
|
createMBean</H3>
|
|
<PRE>
|
|
<A HREF="ObjectInstance.html" title="class in javax.management">ObjectInstance</A> <B>createMBean</B>(java.lang.String className,
|
|
<A HREF="ObjectName.html" title="class in javax.management">ObjectName</A> name,
|
|
<A HREF="ObjectName.html" title="class in javax.management">ObjectName</A> loaderName)
|
|
throws <A HREF="ReflectionException.html" title="class in javax.management">ReflectionException</A>,
|
|
<A HREF="InstanceAlreadyExistsException.html" title="class in javax.management">InstanceAlreadyExistsException</A>,
|
|
<A HREF="MBeanRegistrationException.html" title="class in javax.management">MBeanRegistrationException</A>,
|
|
<A HREF="MBeanException.html" title="class in javax.management">MBeanException</A>,
|
|
<A HREF="NotCompliantMBeanException.html" title="class in javax.management">NotCompliantMBeanException</A>,
|
|
<A HREF="InstanceNotFoundException.html" title="class in javax.management">InstanceNotFoundException</A></PRE>
|
|
<DL>
|
|
<DD><p>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 null, the ClassLoader that loaded the MBean
|
|
server will be used. If the MBean's object name given is null,
|
|
the MBean must provide its own name by implementing the <A HREF="MBeanRegistration.html" title="interface in javax.management"><CODE>MBeanRegistration</CODE></A> interface
|
|
and returning the name from the <A HREF="MBeanRegistration.html#preRegister(javax.management.MBeanServer, javax.management.ObjectName)"><CODE>preRegister</CODE></A> method.</p>
|
|
|
|
<p>This method is equivalent to <A HREF="MBeanServer.html#createMBean(java.lang.String, javax.management.ObjectName, javax.management.ObjectName, java.lang.Object[], java.lang.String[])"><CODE>createMBean(className, name, loaderName, (Object[]) null,
|
|
(String[]) null)</CODE></A>.</p>
|
|
<P>
|
|
<DD><DL>
|
|
<DT><B>Specified by:</B><DD><CODE><A HREF="MBeanServerConnection.html#createMBean(java.lang.String, javax.management.ObjectName, javax.management.ObjectName)">createMBean</A></CODE> in interface <CODE><A HREF="MBeanServerConnection.html" title="interface in javax.management">MBeanServerConnection</A></CODE></DL>
|
|
</DD>
|
|
<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>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="MBeanServer.html#getMBeanInfo(javax.management.ObjectName)"><CODE>getMBeanInfo(n)</CODE></A>.getClassName()</code>.
|
|
<DT><B>Throws:</B>
|
|
<DD><CODE><A HREF="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="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="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="MBeanException.html" title="class in javax.management">MBeanException</A></CODE> - The constructor of the MBean has
|
|
thrown an exception
|
|
<DD><CODE><A HREF="NotCompliantMBeanException.html" title="class in javax.management">NotCompliantMBeanException</A></CODE> - This class is not a JMX
|
|
compliant MBean
|
|
<DD><CODE><A HREF="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="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.</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>
|
|
<A HREF="ObjectInstance.html" title="class in javax.management">ObjectInstance</A> <B>createMBean</B>(java.lang.String className,
|
|
<A HREF="ObjectName.html" title="class in javax.management">ObjectName</A> name,
|
|
<A HREF="ObjectName.html" title="class in javax.management">ObjectName</A> loaderName,
|
|
java.lang.Object[] params,
|
|
java.lang.String[] signature)
|
|
throws <A HREF="ReflectionException.html" title="class in javax.management">ReflectionException</A>,
|
|
<A HREF="InstanceAlreadyExistsException.html" title="class in javax.management">InstanceAlreadyExistsException</A>,
|
|
<A HREF="MBeanRegistrationException.html" title="class in javax.management">MBeanRegistrationException</A>,
|
|
<A HREF="MBeanException.html" title="class in javax.management">MBeanException</A>,
|
|
<A HREF="NotCompliantMBeanException.html" title="class in javax.management">NotCompliantMBeanException</A>,
|
|
<A HREF="InstanceNotFoundException.html" title="class in javax.management">InstanceNotFoundException</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="MBeanRegistration.html" title="interface in javax.management"><CODE>MBeanRegistration</CODE></A>
|
|
interface and returning the name from the <A HREF="MBeanRegistration.html#preRegister(javax.management.MBeanServer, javax.management.ObjectName)"><CODE>preRegister</CODE></A> method.
|
|
<P>
|
|
<DD><DL>
|
|
<DT><B>Specified by:</B><DD><CODE><A HREF="MBeanServerConnection.html#createMBean(java.lang.String, javax.management.ObjectName, javax.management.ObjectName, java.lang.Object[], java.lang.String[])">createMBean</A></CODE> in interface <CODE><A HREF="MBeanServerConnection.html" title="interface in javax.management">MBeanServerConnection</A></CODE></DL>
|
|
</DD>
|
|
<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="MBeanServer.html#getMBeanInfo(javax.management.ObjectName)"><CODE>getMBeanInfo(n)</CODE></A>.getClassName()</code>.
|
|
<DT><B>Throws:</B>
|
|
<DD><CODE><A HREF="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="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="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="MBeanException.html" title="class in javax.management">MBeanException</A></CODE> - The constructor of the MBean has
|
|
thrown an exception
|
|
<DD><CODE><A HREF="NotCompliantMBeanException.html" title="class in javax.management">NotCompliantMBeanException</A></CODE> - This class is not a JMX
|
|
compliant MBean
|
|
<DD><CODE><A HREF="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="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.</DL>
|
|
</DD>
|
|
</DL>
|
|
<HR>
|
|
|
|
<A NAME="getAttribute(javax.management.ObjectName, java.lang.String)"><!-- --></A><H3>
|
|
getAttribute</H3>
|
|
<PRE>
|
|
java.lang.Object <B>getAttribute</B>(<A HREF="ObjectName.html" title="class in javax.management">ObjectName</A> name,
|
|
java.lang.String attribute)
|
|
throws <A HREF="MBeanException.html" title="class in javax.management">MBeanException</A>,
|
|
<A HREF="AttributeNotFoundException.html" title="class in javax.management">AttributeNotFoundException</A>,
|
|
<A HREF="InstanceNotFoundException.html" title="class in javax.management">InstanceNotFoundException</A>,
|
|
<A HREF="ReflectionException.html" title="class in javax.management">ReflectionException</A></PRE>
|
|
<DL>
|
|
<DD>Gets the value of a specific attribute of a named MBean. The MBean
|
|
is identified by its object name.
|
|
<P>
|
|
<DD><DL>
|
|
<DT><B>Specified by:</B><DD><CODE><A HREF="MBeanServerConnection.html#getAttribute(javax.management.ObjectName, java.lang.String)">getAttribute</A></CODE> in interface <CODE><A HREF="MBeanServerConnection.html" title="interface in javax.management">MBeanServerConnection</A></CODE></DL>
|
|
</DD>
|
|
<DD><DL>
|
|
<DT><B>Parameters:</B><DD><CODE>name</CODE> - The object name of the MBean from which the
|
|
attribute is to be retrieved.<DD><CODE>attribute</CODE> - A String specifying the name of the attribute
|
|
to be retrieved.
|
|
<DT><B>Returns:</B><DD>The value of the retrieved attribute.
|
|
<DT><B>Throws:</B>
|
|
<DD><CODE><A HREF="AttributeNotFoundException.html" title="class in javax.management">AttributeNotFoundException</A></CODE> - The attribute specified
|
|
is not accessible in the MBean.
|
|
<DD><CODE><A HREF="MBeanException.html" title="class in javax.management">MBeanException</A></CODE> - Wraps an exception thrown by the
|
|
MBean's getter.
|
|
<DD><CODE><A HREF="InstanceNotFoundException.html" title="class in javax.management">InstanceNotFoundException</A></CODE> - The MBean specified is not
|
|
registered in the MBean server.
|
|
<DD><CODE><A HREF="ReflectionException.html" title="class in javax.management">ReflectionException</A></CODE> - Wraps a
|
|
<CODE>java.lang.Exception</CODE> thrown when trying to invoke
|
|
the setter.
|
|
<DD><CODE><A HREF="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 attribute in parameter is
|
|
null.<DT><B>See Also:</B><DD><A HREF="MBeanServer.html#setAttribute(javax.management.ObjectName, javax.management.Attribute)"><CODE>setAttribute(javax.management.ObjectName, javax.management.Attribute)</CODE></A></DL>
|
|
</DD>
|
|
</DL>
|
|
<HR>
|
|
|
|
<A NAME="getAttributes(javax.management.ObjectName, java.lang.String[])"><!-- --></A><H3>
|
|
getAttributes</H3>
|
|
<PRE>
|
|
<A HREF="AttributeList.html" title="class in javax.management">AttributeList</A> <B>getAttributes</B>(<A HREF="ObjectName.html" title="class in javax.management">ObjectName</A> name,
|
|
java.lang.String[] attributes)
|
|
throws <A HREF="InstanceNotFoundException.html" title="class in javax.management">InstanceNotFoundException</A>,
|
|
<A HREF="ReflectionException.html" title="class in javax.management">ReflectionException</A></PRE>
|
|
<DL>
|
|
<DD>Gets the values of several attributes of a named MBean. The MBean
|
|
is identified by its object name.
|
|
<P>
|
|
<DD><DL>
|
|
<DT><B>Specified by:</B><DD><CODE><A HREF="MBeanServerConnection.html#getAttributes(javax.management.ObjectName, java.lang.String[])">getAttributes</A></CODE> in interface <CODE><A HREF="MBeanServerConnection.html" title="interface in javax.management">MBeanServerConnection</A></CODE></DL>
|
|
</DD>
|
|
<DD><DL>
|
|
<DT><B>Parameters:</B><DD><CODE>name</CODE> - The object name of the MBean from which the
|
|
attributes are retrieved.<DD><CODE>attributes</CODE> - A list of the attributes to be retrieved.
|
|
<DT><B>Returns:</B><DD>The list of the retrieved attributes.
|
|
<DT><B>Throws:</B>
|
|
<DD><CODE><A HREF="InstanceNotFoundException.html" title="class in javax.management">InstanceNotFoundException</A></CODE> - The MBean specified is not
|
|
registered in the MBean server.
|
|
<DD><CODE><A HREF="ReflectionException.html" title="class in javax.management">ReflectionException</A></CODE> - An exception occurred when
|
|
trying to invoke the getAttributes method of a Dynamic MBean.
|
|
<DD><CODE><A HREF="RuntimeOperationsException.html" title="class in javax.management">RuntimeOperationsException</A></CODE> - Wrap a
|
|
<CODE>java.lang.IllegalArgumentException</CODE>: The object
|
|
name in parameter is null or attributes in parameter is null.<DT><B>See Also:</B><DD><A HREF="MBeanServer.html#setAttributes(javax.management.ObjectName, javax.management.AttributeList)"><CODE>setAttributes(javax.management.ObjectName, javax.management.AttributeList)</CODE></A></DL>
|
|
</DD>
|
|
</DL>
|
|
<HR>
|
|
|
|
<A NAME="getClassLoader(javax.management.ObjectName)"><!-- --></A><H3>
|
|
getClassLoader</H3>
|
|
<PRE>
|
|
java.lang.ClassLoader <B>getClassLoader</B>(<A HREF="ObjectName.html" title="class in javax.management">ObjectName</A> loaderName)
|
|
throws <A HREF="InstanceNotFoundException.html" title="class in javax.management">InstanceNotFoundException</A></PRE>
|
|
<DL>
|
|
<DD><p>Return the named <CODE>ClassLoader</CODE>.</p>
|
|
<P>
|
|
<DD><DL>
|
|
</DL>
|
|
</DD>
|
|
<DD><DL>
|
|
<DT><B>Parameters:</B><DD><CODE>loaderName</CODE> - The ObjectName of the ClassLoader. May be
|
|
null, in which case the MBean server's own ClassLoader is
|
|
returned.
|
|
<DT><B>Returns:</B><DD>The named ClassLoader. If <var>l</var> is the actual
|
|
ClassLoader with that name, and <var>r</var> is the returned
|
|
value, then either:
|
|
|
|
<ul>
|
|
<li><var>r</var> is identical to <var>l</var>; or
|
|
<li>the result of <var>r</var><CODE>.loadClass(<var>s</var>)</CODE> is the
|
|
same as <var>l</var><CODE>.loadClass(<var>s</var>)</CODE> for any string <var>s</var>.
|
|
</ul>
|
|
|
|
What this means is that the ClassLoader may be wrapped in
|
|
another ClassLoader for security or other reasons.
|
|
<DT><B>Throws:</B>
|
|
<DD><CODE><A HREF="InstanceNotFoundException.html" title="class in javax.management">InstanceNotFoundException</A></CODE> - if the named ClassLoader is
|
|
not found.<DT><B>Since:</B></DT>
|
|
<DD>JMX 1.2</DD>
|
|
</DL>
|
|
</DD>
|
|
</DL>
|
|
<HR>
|
|
|
|
<A NAME="getClassLoaderFor(javax.management.ObjectName)"><!-- --></A><H3>
|
|
getClassLoaderFor</H3>
|
|
<PRE>
|
|
java.lang.ClassLoader <B>getClassLoaderFor</B>(<A HREF="ObjectName.html" title="class in javax.management">ObjectName</A> mbeanName)
|
|
throws <A HREF="InstanceNotFoundException.html" title="class in javax.management">InstanceNotFoundException</A></PRE>
|
|
<DL>
|
|
<DD><p>Return the <CODE>ClassLoader</CODE> that was used for
|
|
loading the class of the named MBean.</p>
|
|
<P>
|
|
<DD><DL>
|
|
</DL>
|
|
</DD>
|
|
<DD><DL>
|
|
<DT><B>Parameters:</B><DD><CODE>mbeanName</CODE> - The ObjectName of the MBean.
|
|
<DT><B>Returns:</B><DD>The ClassLoader used for that MBean. If <var>l</var>
|
|
is the MBean's actual ClassLoader, and <var>r</var> is the
|
|
returned value, then either:
|
|
|
|
<ul>
|
|
<li><var>r</var> is identical to <var>l</var>; or
|
|
<li>the result of <var>r</var><CODE>.loadClass(<var>s</var>)</CODE> is the
|
|
same as <var>l</var><CODE>.loadClass(<var>s</var>)</CODE> for any string <var>s</var>.
|
|
</ul>
|
|
|
|
What this means is that the ClassLoader may be wrapped in
|
|
another ClassLoader for security or other reasons.
|
|
<DT><B>Throws:</B>
|
|
<DD><CODE><A HREF="InstanceNotFoundException.html" title="class in javax.management">InstanceNotFoundException</A></CODE> - if the named MBean is not found.<DT><B>Since:</B></DT>
|
|
<DD>JMX 1.2</DD>
|
|
</DL>
|
|
</DD>
|
|
</DL>
|
|
<HR>
|
|
|
|
<A NAME="getClassLoaderRepository()"><!-- --></A><H3>
|
|
getClassLoaderRepository</H3>
|
|
<PRE>
|
|
<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>()</PRE>
|
|
<DL>
|
|
<DD><p>Return the ClassLoaderRepository for this MBeanServer.
|
|
<P>
|
|
<DD><DL>
|
|
</DL>
|
|
</DD>
|
|
<DD><DL>
|
|
|
|
<DT><B>Returns:</B><DD>The ClassLoaderRepository for this MBeanServer.<DT><B>Since:</B></DT>
|
|
<DD>JMX 1.2</DD>
|
|
</DL>
|
|
</DD>
|
|
</DL>
|
|
<HR>
|
|
|
|
<A NAME="getDefaultDomain()"><!-- --></A><H3>
|
|
getDefaultDomain</H3>
|
|
<PRE>
|
|
java.lang.String <B>getDefaultDomain</B>()</PRE>
|
|
<DL>
|
|
<DD>Returns the default domain used for naming the MBean.
|
|
The default domain name is used as the domain part in the ObjectName
|
|
of MBeans if no domain is specified by the user.
|
|
<P>
|
|
<DD><DL>
|
|
<DT><B>Specified by:</B><DD><CODE><A HREF="MBeanServerConnection.html#getDefaultDomain()">getDefaultDomain</A></CODE> in interface <CODE><A HREF="MBeanServerConnection.html" title="interface in javax.management">MBeanServerConnection</A></CODE></DL>
|
|
</DD>
|
|
<DD><DL>
|
|
|
|
<DT><B>Returns:</B><DD>the default domain.</DL>
|
|
</DD>
|
|
</DL>
|
|
<HR>
|
|
|
|
<A NAME="getDomains()"><!-- --></A><H3>
|
|
getDomains</H3>
|
|
<PRE>
|
|
java.lang.String[] <B>getDomains</B>()</PRE>
|
|
<DL>
|
|
<DD><p>Returns the list of domains in which any MBean is currently
|
|
registered. A string is in the returned array if and only if
|
|
there is at least one MBean registered with an ObjectName whose
|
|
<A HREF="ObjectName.html#getDomain()"><CODE>getDomain()</CODE></A> is equal to that
|
|
string. The order of strings within the returned array is
|
|
not defined.</p>
|
|
<P>
|
|
<DD><DL>
|
|
<DT><B>Specified by:</B><DD><CODE><A HREF="MBeanServerConnection.html#getDomains()">getDomains</A></CODE> in interface <CODE><A HREF="MBeanServerConnection.html" title="interface in javax.management">MBeanServerConnection</A></CODE></DL>
|
|
</DD>
|
|
<DD><DL>
|
|
|
|
<DT><B>Returns:</B><DD>the list of domains.<DT><B>Since:</B></DT>
|
|
<DD>JMX 1.2</DD>
|
|
</DL>
|
|
</DD>
|
|
</DL>
|
|
<HR>
|
|
|
|
<A NAME="getMBeanCount()"><!-- --></A><H3>
|
|
getMBeanCount</H3>
|
|
<PRE>
|
|
java.lang.Integer <B>getMBeanCount</B>()</PRE>
|
|
<DL>
|
|
<DD>Returns the number of MBeans registered in the MBean server.
|
|
<P>
|
|
<DD><DL>
|
|
<DT><B>Specified by:</B><DD><CODE><A HREF="MBeanServerConnection.html#getMBeanCount()">getMBeanCount</A></CODE> in interface <CODE><A HREF="MBeanServerConnection.html" title="interface in javax.management">MBeanServerConnection</A></CODE></DL>
|
|
</DD>
|
|
<DD><DL>
|
|
|
|
<DT><B>Returns:</B><DD>the number of registered MBeans, wrapped in an Integer.
|
|
If the caller's permissions are restricted, this number may
|
|
be greater than the number of MBeans the caller can access.</DL>
|
|
</DD>
|
|
</DL>
|
|
<HR>
|
|
|
|
<A NAME="getMBeanInfo(javax.management.ObjectName)"><!-- --></A><H3>
|
|
getMBeanInfo</H3>
|
|
<PRE>
|
|
<A HREF="MBeanInfo.html" title="class in javax.management">MBeanInfo</A> <B>getMBeanInfo</B>(<A HREF="ObjectName.html" title="class in javax.management">ObjectName</A> name)
|
|
throws <A HREF="InstanceNotFoundException.html" title="class in javax.management">InstanceNotFoundException</A>,
|
|
<A HREF="IntrospectionException.html" title="class in javax.management">IntrospectionException</A>,
|
|
<A HREF="ReflectionException.html" title="class in javax.management">ReflectionException</A></PRE>
|
|
<DL>
|
|
<DD>This method discovers the attributes and operations that an
|
|
MBean exposes for management.
|
|
<P>
|
|
<DD><DL>
|
|
<DT><B>Specified by:</B><DD><CODE><A HREF="MBeanServerConnection.html#getMBeanInfo(javax.management.ObjectName)">getMBeanInfo</A></CODE> in interface <CODE><A HREF="MBeanServerConnection.html" title="interface in javax.management">MBeanServerConnection</A></CODE></DL>
|
|
</DD>
|
|
<DD><DL>
|
|
<DT><B>Parameters:</B><DD><CODE>name</CODE> - The name of the MBean to analyze
|
|
<DT><B>Returns:</B><DD>An instance of <CODE>MBeanInfo</CODE> allowing the
|
|
retrieval of all attributes and operations of this MBean.
|
|
<DT><B>Throws:</B>
|
|
<DD><CODE><A HREF="IntrospectionException.html" title="class in javax.management">IntrospectionException</A></CODE> - An exception occured during
|
|
introspection.
|
|
<DD><CODE><A HREF="InstanceNotFoundException.html" title="class in javax.management">InstanceNotFoundException</A></CODE> - The MBean specified was
|
|
not found.
|
|
<DD><CODE><A HREF="ReflectionException.html" title="class in javax.management">ReflectionException</A></CODE> - An exception occurred when
|
|
trying to invoke the getMBeanInfo of a Dynamic MBean.</DL>
|
|
</DD>
|
|
</DL>
|
|
<HR>
|
|
|
|
<A NAME="getObjectInstance(javax.management.ObjectName)"><!-- --></A><H3>
|
|
getObjectInstance</H3>
|
|
<PRE>
|
|
<A HREF="ObjectInstance.html" title="class in javax.management">ObjectInstance</A> <B>getObjectInstance</B>(<A HREF="ObjectName.html" title="class in javax.management">ObjectName</A> name)
|
|
throws <A HREF="InstanceNotFoundException.html" title="class in javax.management">InstanceNotFoundException</A></PRE>
|
|
<DL>
|
|
<DD>Gets the <CODE>ObjectInstance</CODE> for a given MBean
|
|
registered with the MBean server.
|
|
<P>
|
|
<DD><DL>
|
|
<DT><B>Specified by:</B><DD><CODE><A HREF="MBeanServerConnection.html#getObjectInstance(javax.management.ObjectName)">getObjectInstance</A></CODE> in interface <CODE><A HREF="MBeanServerConnection.html" title="interface in javax.management">MBeanServerConnection</A></CODE></DL>
|
|
</DD>
|
|
<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="MBeanServer.html#getMBeanInfo(javax.management.ObjectName)"><CODE>getMBeanInfo(name)</CODE></A>.getClassName()</code>.
|
|
<DT><B>Throws:</B>
|
|
<DD><CODE><A HREF="InstanceNotFoundException.html" title="class in javax.management">InstanceNotFoundException</A></CODE> - The MBean specified is not
|
|
registered in the MBean server.</DL>
|
|
</DD>
|
|
</DL>
|
|
<HR>
|
|
|
|
<A NAME="instantiate(java.lang.String)"><!-- --></A><H3>
|
|
instantiate</H3>
|
|
<PRE>
|
|
java.lang.Object <B>instantiate</B>(java.lang.String className)
|
|
throws <A HREF="ReflectionException.html" title="class in javax.management">ReflectionException</A>,
|
|
<A HREF="MBeanException.html" title="class in javax.management">MBeanException</A></PRE>
|
|
<DL>
|
|
<DD><p>Instantiates an object using the list of all class loaders
|
|
registered in the MBean server's <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"><CODE>Class Loader
|
|
Repository</CODE></A>. The object's class should have a public
|
|
constructor. This method returns a reference to the newly
|
|
created object. The newly created object is not registered in
|
|
the MBean server.</p>
|
|
|
|
<p>This method is equivalent to <A HREF="MBeanServer.html#instantiate(java.lang.String, java.lang.Object[], java.lang.String[])"><CODE>instantiate(className, (Object[]) null, (String[]) null)</CODE></A>.</p>
|
|
<P>
|
|
<DD><DL>
|
|
</DL>
|
|
</DD>
|
|
<DD><DL>
|
|
<DT><B>Parameters:</B><DD><CODE>className</CODE> - The class name of the object to be instantiated.
|
|
<DT><B>Returns:</B><DD>The newly instantiated object.
|
|
<DT><B>Throws:</B>
|
|
<DD><CODE><A HREF="ReflectionException.html" title="class in javax.management">ReflectionException</A></CODE> - Wraps a
|
|
<CODE>java.lang.ClassNotFoundException</CODE> or the
|
|
<CODE>java.lang.Exception</CODE> that occurred when trying to
|
|
invoke the object's constructor.
|
|
<DD><CODE><A HREF="MBeanException.html" title="class in javax.management">MBeanException</A></CODE> - The constructor of the object has
|
|
thrown an exception
|
|
<DD><CODE><A HREF="RuntimeOperationsException.html" title="class in javax.management">RuntimeOperationsException</A></CODE> - Wraps a
|
|
<CODE>java.lang.IllegalArgumentException</CODE>: The className
|
|
passed in parameter is null.</DL>
|
|
</DD>
|
|
</DL>
|
|
<HR>
|
|
|
|
<A NAME="instantiate(java.lang.String, java.lang.Object[], java.lang.String[])"><!-- --></A><H3>
|
|
instantiate</H3>
|
|
<PRE>
|
|
java.lang.Object <B>instantiate</B>(java.lang.String className,
|
|
java.lang.Object[] params,
|
|
java.lang.String[] signature)
|
|
throws <A HREF="ReflectionException.html" title="class in javax.management">ReflectionException</A>,
|
|
<A HREF="MBeanException.html" title="class in javax.management">MBeanException</A></PRE>
|
|
<DL>
|
|
<DD><p>Instantiates an object using the list of all class loaders
|
|
registered in the MBean server <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"><CODE>Class Loader
|
|
Repository</CODE></A>. The object's class should have a public
|
|
constructor. The call returns a reference to the newly created
|
|
object. The newly created object is not registered in the
|
|
MBean server.</p>
|
|
<P>
|
|
<DD><DL>
|
|
</DL>
|
|
</DD>
|
|
<DD><DL>
|
|
<DT><B>Parameters:</B><DD><CODE>className</CODE> - The class name of the object to be instantiated.<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.
|
|
<DT><B>Returns:</B><DD>The newly instantiated object.
|
|
<DT><B>Throws:</B>
|
|
<DD><CODE><A HREF="ReflectionException.html" title="class in javax.management">ReflectionException</A></CODE> - Wraps a
|
|
<CODE>java.lang.ClassNotFoundException</CODE> or the
|
|
<CODE>java.lang.Exception</CODE> that occurred when trying to
|
|
invoke the object's constructor.
|
|
<DD><CODE><A HREF="MBeanException.html" title="class in javax.management">MBeanException</A></CODE> - The constructor of the object has
|
|
thrown an exception
|
|
<DD><CODE><A HREF="RuntimeOperationsException.html" title="class in javax.management">RuntimeOperationsException</A></CODE> - Wraps a
|
|
<CODE>java.lang.IllegalArgumentException</CODE>: The className
|
|
passed in parameter is null.</DL>
|
|
</DD>
|
|
</DL>
|
|
<HR>
|
|
|
|
<A NAME="instantiate(java.lang.String, javax.management.ObjectName)"><!-- --></A><H3>
|
|
instantiate</H3>
|
|
<PRE>
|
|
java.lang.Object <B>instantiate</B>(java.lang.String className,
|
|
<A HREF="ObjectName.html" title="class in javax.management">ObjectName</A> loaderName)
|
|
throws <A HREF="ReflectionException.html" title="class in javax.management">ReflectionException</A>,
|
|
<A HREF="MBeanException.html" title="class in javax.management">MBeanException</A>,
|
|
<A HREF="InstanceNotFoundException.html" title="class in javax.management">InstanceNotFoundException</A></PRE>
|
|
<DL>
|
|
<DD><p>Instantiates an object using the class Loader specified by its
|
|
<CODE>ObjectName</CODE>. If the loader name is null, the
|
|
ClassLoader that loaded the MBean Server will be used. The
|
|
object's class should have a public constructor. This method
|
|
returns a reference to the newly created object. The newly
|
|
created object is not registered in the MBean server.</p>
|
|
|
|
<p>This method is equivalent to <A HREF="MBeanServer.html#instantiate(java.lang.String, javax.management.ObjectName, java.lang.Object[], java.lang.String[])"><CODE>instantiate(className, loaderName, (Object[]) null, (String[])
|
|
null)</CODE></A>.</p>
|
|
<P>
|
|
<DD><DL>
|
|
</DL>
|
|
</DD>
|
|
<DD><DL>
|
|
<DT><B>Parameters:</B><DD><CODE>className</CODE> - The class name of the MBean to be instantiated.<DD><CODE>loaderName</CODE> - The object name of the class loader to be used.
|
|
<DT><B>Returns:</B><DD>The newly instantiated object.
|
|
<DT><B>Throws:</B>
|
|
<DD><CODE><A HREF="ReflectionException.html" title="class in javax.management">ReflectionException</A></CODE> - Wraps a
|
|
<CODE>java.lang.ClassNotFoundException</CODE> or the
|
|
<CODE>java.lang.Exception</CODE> that occurred when trying to
|
|
invoke the object's constructor.
|
|
<DD><CODE><A HREF="MBeanException.html" title="class in javax.management">MBeanException</A></CODE> - The constructor of the object has
|
|
thrown an exception.
|
|
<DD><CODE><A HREF="InstanceNotFoundException.html" title="class in javax.management">InstanceNotFoundException</A></CODE> - The specified class loader
|
|
is not registered in the MBeanServer.
|
|
<DD><CODE><A HREF="RuntimeOperationsException.html" title="class in javax.management">RuntimeOperationsException</A></CODE> - Wraps a
|
|
<CODE>java.lang.IllegalArgumentException</CODE>: The className
|
|
passed in parameter is null.</DL>
|
|
</DD>
|
|
</DL>
|
|
<HR>
|
|
|
|
<A NAME="instantiate(java.lang.String, javax.management.ObjectName, java.lang.Object[], java.lang.String[])"><!-- --></A><H3>
|
|
instantiate</H3>
|
|
<PRE>
|
|
java.lang.Object <B>instantiate</B>(java.lang.String className,
|
|
<A HREF="ObjectName.html" title="class in javax.management">ObjectName</A> loaderName,
|
|
java.lang.Object[] params,
|
|
java.lang.String[] signature)
|
|
throws <A HREF="ReflectionException.html" title="class in javax.management">ReflectionException</A>,
|
|
<A HREF="MBeanException.html" title="class in javax.management">MBeanException</A>,
|
|
<A HREF="InstanceNotFoundException.html" title="class in javax.management">InstanceNotFoundException</A></PRE>
|
|
<DL>
|
|
<DD><p>Instantiates an object. The class loader to be used is
|
|
identified by its object name. If the object name of the loader
|
|
is null, the ClassLoader that loaded the MBean server will be
|
|
used. The object's class should have a public constructor.
|
|
The call returns a reference to the newly created object. The
|
|
newly created object is not registered in the MBean server.</p>
|
|
<P>
|
|
<DD><DL>
|
|
</DL>
|
|
</DD>
|
|
<DD><DL>
|
|
<DT><B>Parameters:</B><DD><CODE>className</CODE> - The class name of the object to be instantiated.<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>The newly instantiated object.
|
|
<DT><B>Throws:</B>
|
|
<DD><CODE><A HREF="ReflectionException.html" title="class in javax.management">ReflectionException</A></CODE> - Wraps a <CODE>java.lang.ClassNotFoundException</CODE> or the <CODE>java.lang.Exception</CODE> that
|
|
occurred when trying to invoke the object's constructor.
|
|
<DD><CODE><A HREF="MBeanException.html" title="class in javax.management">MBeanException</A></CODE> - The constructor of the object has
|
|
thrown an exception
|
|
<DD><CODE><A HREF="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="RuntimeOperationsException.html" title="class in javax.management">RuntimeOperationsException</A></CODE> - Wraps a
|
|
<CODE>java.lang.IllegalArgumentException</CODE>: The className
|
|
passed in parameter is null.</DL>
|
|
</DD>
|
|
</DL>
|
|
<HR>
|
|
|
|
<A NAME="invoke(javax.management.ObjectName, java.lang.String, java.lang.Object[], java.lang.String[])"><!-- --></A><H3>
|
|
invoke</H3>
|
|
<PRE>
|
|
java.lang.Object <B>invoke</B>(<A HREF="ObjectName.html" title="class in javax.management">ObjectName</A> name,
|
|
java.lang.String operationName,
|
|
java.lang.Object[] params,
|
|
java.lang.String[] signature)
|
|
throws <A HREF="InstanceNotFoundException.html" title="class in javax.management">InstanceNotFoundException</A>,
|
|
<A HREF="MBeanException.html" title="class in javax.management">MBeanException</A>,
|
|
<A HREF="ReflectionException.html" title="class in javax.management">ReflectionException</A></PRE>
|
|
<DL>
|
|
<DD>Invokes an operation on an MBean.
|
|
<P>
|
|
<DD><DL>
|
|
<DT><B>Specified by:</B><DD><CODE><A HREF="MBeanServerConnection.html#invoke(javax.management.ObjectName, java.lang.String, java.lang.Object[], java.lang.String[])">invoke</A></CODE> in interface <CODE><A HREF="MBeanServerConnection.html" title="interface in javax.management">MBeanServerConnection</A></CODE></DL>
|
|
</DD>
|
|
<DD><DL>
|
|
<DT><B>Parameters:</B><DD><CODE>name</CODE> - The object name of the MBean on which the method is
|
|
to be invoked.<DD><CODE>operationName</CODE> - The name of the operation to be invoked.<DD><CODE>params</CODE> - An array containing the parameters to be set when
|
|
the operation is invoked<DD><CODE>signature</CODE> - An array containing the signature of the
|
|
operation. The class objects will be loaded using the same
|
|
class loader as the one used for loading the MBean on which the
|
|
operation was invoked.
|
|
<DT><B>Returns:</B><DD>The object returned by the operation, which represents
|
|
the result ofinvoking the operation on the MBean specified.
|
|
<DT><B>Throws:</B>
|
|
<DD><CODE><A HREF="InstanceNotFoundException.html" title="class in javax.management">InstanceNotFoundException</A></CODE> - The MBean specified is not
|
|
registered in the MBean server.
|
|
<DD><CODE><A HREF="MBeanException.html" title="class in javax.management">MBeanException</A></CODE> - Wraps an exception thrown by the
|
|
MBean's invoked method.
|
|
<DD><CODE><A HREF="ReflectionException.html" title="class in javax.management">ReflectionException</A></CODE> - Wraps a
|
|
<CODE>java.lang.Exception</CODE> thrown while trying to invoke
|
|
the method.</DL>
|
|
</DD>
|
|
</DL>
|
|
<HR>
|
|
|
|
<A NAME="isInstanceOf(javax.management.ObjectName, java.lang.String)"><!-- --></A><H3>
|
|
isInstanceOf</H3>
|
|
<PRE>
|
|
boolean <B>isInstanceOf</B>(<A HREF="ObjectName.html" title="class in javax.management">ObjectName</A> name,
|
|
java.lang.String className)
|
|
throws <A HREF="InstanceNotFoundException.html" title="class in javax.management">InstanceNotFoundException</A></PRE>
|
|
<DL>
|
|
<DD><p>Returns true if the MBean specified is an instance of the
|
|
specified class, false otherwise.</p>
|
|
|
|
<p>If <code>name</code> does not name an MBean, this method
|
|
throws <A HREF="InstanceNotFoundException.html" title="class in javax.management"><CODE>InstanceNotFoundException</CODE></A>.</p>
|
|
|
|
<p>Otherwise, let<br>
|
|
X be the MBean named by <code>name</code>,<br>
|
|
L be the ClassLoader of X,<br>
|
|
N be the class name in X's <A HREF="MBeanInfo.html" title="class in javax.management"><CODE>MBeanInfo</CODE></A>.</p>
|
|
|
|
<p>If N equals <code>className</code>, the result is true.</p>
|
|
|
|
<p>Otherwise, if L successfully loads both N and
|
|
<code>className</code>, and the second class is assignable from
|
|
the first, the result is true.</p>
|
|
|
|
<p>Otherwise, the result is false.</p>
|
|
<P>
|
|
<DD><DL>
|
|
<DT><B>Specified by:</B><DD><CODE><A HREF="MBeanServerConnection.html#isInstanceOf(javax.management.ObjectName, java.lang.String)">isInstanceOf</A></CODE> in interface <CODE><A HREF="MBeanServerConnection.html" title="interface in javax.management">MBeanServerConnection</A></CODE></DL>
|
|
</DD>
|
|
<DD><DL>
|
|
<DT><B>Parameters:</B><DD><CODE>name</CODE> - The <CODE>ObjectName</CODE> of the MBean.<DD><CODE>className</CODE> - The name of the class.
|
|
<DT><B>Returns:</B><DD>true if the MBean specified is an instance of the
|
|
specified class according to the rules above, false otherwise.
|
|
<DT><B>Throws:</B>
|
|
<DD><CODE><A HREF="InstanceNotFoundException.html" title="class in javax.management">InstanceNotFoundException</A></CODE> - The MBean specified is not
|
|
registered in the MBean server.<DT><B>See Also:</B><DD><CODE>Class.isAssignableFrom(Class)</CODE></DL>
|
|
</DD>
|
|
</DL>
|
|
<HR>
|
|
|
|
<A NAME="isRegistered(javax.management.ObjectName)"><!-- --></A><H3>
|
|
isRegistered</H3>
|
|
<PRE>
|
|
boolean <B>isRegistered</B>(<A HREF="ObjectName.html" title="class in javax.management">ObjectName</A> name)</PRE>
|
|
<DL>
|
|
<DD>Checks whether an MBean, identified by its object name, is
|
|
already registered with the MBean server.
|
|
<P>
|
|
<DD><DL>
|
|
<DT><B>Specified by:</B><DD><CODE><A HREF="MBeanServerConnection.html#isRegistered(javax.management.ObjectName)">isRegistered</A></CODE> in interface <CODE><A HREF="MBeanServerConnection.html" title="interface in javax.management">MBeanServerConnection</A></CODE></DL>
|
|
</DD>
|
|
<DD><DL>
|
|
<DT><B>Parameters:</B><DD><CODE>name</CODE> - The object name of the MBean to be checked.
|
|
<DT><B>Returns:</B><DD>True if the MBean is already registered in the MBean
|
|
server, false otherwise.
|
|
<DT><B>Throws:</B>
|
|
<DD><CODE><A HREF="RuntimeOperationsException.html" title="class in javax.management">RuntimeOperationsException</A></CODE> - Wraps a
|
|
<CODE>java.lang.IllegalArgumentException</CODE>: The object
|
|
name in parameter is null.</DL>
|
|
</DD>
|
|
</DL>
|
|
<HR>
|
|
|
|
<A NAME="queryMBeans(javax.management.ObjectName, javax.management.QueryExp)"><!-- --></A><H3>
|
|
queryMBeans</H3>
|
|
<PRE>
|
|
java.util.Set <B>queryMBeans</B>(<A HREF="ObjectName.html" title="class in javax.management">ObjectName</A> name,
|
|
<A HREF="QueryExp.html" title="interface in javax.management">QueryExp</A> query)</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>Specified by:</B><DD><CODE><A HREF="MBeanServerConnection.html#queryMBeans(javax.management.ObjectName, javax.management.QueryExp)">queryMBeans</A></CODE> in interface <CODE><A HREF="MBeanServerConnection.html" title="interface in javax.management">MBeanServerConnection</A></CODE></DL>
|
|
</DD>
|
|
<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 set is returned.</DL>
|
|
</DD>
|
|
</DL>
|
|
<HR>
|
|
|
|
<A NAME="queryNames(javax.management.ObjectName, javax.management.QueryExp)"><!-- --></A><H3>
|
|
queryNames</H3>
|
|
<PRE>
|
|
java.util.Set <B>queryNames</B>(<A HREF="ObjectName.html" title="class in javax.management">ObjectName</A> name,
|
|
<A HREF="QueryExp.html" title="interface in javax.management">QueryExp</A> query)</PRE>
|
|
<DL>
|
|
<DD>Gets the names of MBeans controlled by the MBean server. This
|
|
method enables any of the following to be obtained: The names
|
|
of all MBeans, the names of a set of MBeans specified by
|
|
pattern matching on the <CODE>ObjectName</CODE> and/or a Query
|
|
expression, a specific MBean name (equivalent to testing
|
|
whether an MBean is registered). When the object name is null
|
|
or no domain and key properties are specified, all objects are
|
|
selected (and filtered if a query is specified). It returns the
|
|
set of ObjectNames for the MBeans selected.
|
|
<P>
|
|
<DD><DL>
|
|
<DT><B>Specified by:</B><DD><CODE><A HREF="MBeanServerConnection.html#queryNames(javax.management.ObjectName, javax.management.QueryExp)">queryNames</A></CODE> in interface <CODE><A HREF="MBeanServerConnection.html" title="interface in javax.management">MBeanServerConnection</A></CODE></DL>
|
|
</DD>
|
|
<DD><DL>
|
|
<DT><B>Parameters:</B><DD><CODE>name</CODE> - The object name pattern identifying the MBean names
|
|
to be retrieved. If null oror no domain and key properties are
|
|
specified, the name of all registered MBeans 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 ObjectNames for the MBeans
|
|
selected. If no MBean satisfies the query, an empty set is
|
|
returned.</DL>
|
|
</DD>
|
|
</DL>
|
|
<HR>
|
|
|
|
<A NAME="registerMBean(java.lang.Object, javax.management.ObjectName)"><!-- --></A><H3>
|
|
registerMBean</H3>
|
|
<PRE>
|
|
<A HREF="ObjectInstance.html" title="class in javax.management">ObjectInstance</A> <B>registerMBean</B>(java.lang.Object object,
|
|
<A HREF="ObjectName.html" title="class in javax.management">ObjectName</A> name)
|
|
throws <A HREF="InstanceAlreadyExistsException.html" title="class in javax.management">InstanceAlreadyExistsException</A>,
|
|
<A HREF="MBeanRegistrationException.html" title="class in javax.management">MBeanRegistrationException</A>,
|
|
<A HREF="NotCompliantMBeanException.html" title="class in javax.management">NotCompliantMBeanException</A></PRE>
|
|
<DL>
|
|
<DD>Registers a pre-existing object as an MBean with the MBean
|
|
server. If the object name given is null, the MBean must
|
|
provide its own name by implementing the <A HREF="MBeanRegistration.html" title="interface in javax.management"><CODE>MBeanRegistration</CODE></A> interface
|
|
and returning the name from the <A HREF="MBeanRegistration.html#preRegister(javax.management.MBeanServer, javax.management.ObjectName)"><CODE>preRegister</CODE></A> method.
|
|
<P>
|
|
<DD><DL>
|
|
</DL>
|
|
</DD>
|
|
<DD><DL>
|
|
<DT><B>Parameters:</B><DD><CODE>object</CODE> - The MBean to be registered as an MBean.<DD><CODE>name</CODE> - The object name of the MBean. May be null.
|
|
<DT><B>Returns:</B><DD>An <CODE>ObjectInstance</CODE>, containing the
|
|
<CODE>ObjectName</CODE> and the Java class name of the newly
|
|
registered MBean. If the contained <code>ObjectName</code>
|
|
is <code>n</code>, the contained Java class name is
|
|
<code><A HREF="MBeanServer.html#getMBeanInfo(javax.management.ObjectName)"><CODE>getMBeanInfo(n)</CODE></A>.getClassName()</code>.
|
|
<DT><B>Throws:</B>
|
|
<DD><CODE><A HREF="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="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="NotCompliantMBeanException.html" title="class in javax.management">NotCompliantMBeanException</A></CODE> - This object is not a JMX
|
|
compliant MBean
|
|
<DD><CODE><A HREF="RuntimeOperationsException.html" title="class in javax.management">RuntimeOperationsException</A></CODE> - Wraps a
|
|
<CODE>java.lang.IllegalArgumentException</CODE>: The object
|
|
passed in parameter is null or no object name is specified.</DL>
|
|
</DD>
|
|
</DL>
|
|
<HR>
|
|
|
|
<A NAME="removeNotificationListener(javax.management.ObjectName, javax.management.NotificationListener)"><!-- --></A><H3>
|
|
removeNotificationListener</H3>
|
|
<PRE>
|
|
void <B>removeNotificationListener</B>(<A HREF="ObjectName.html" title="class in javax.management">ObjectName</A> name,
|
|
<A HREF="NotificationListener.html" title="interface in javax.management">NotificationListener</A> listener)
|
|
throws <A HREF="InstanceNotFoundException.html" title="class in javax.management">InstanceNotFoundException</A>,
|
|
<A HREF="ListenerNotFoundException.html" title="class in javax.management">ListenerNotFoundException</A></PRE>
|
|
<DL>
|
|
<DD><p>Removes a listener from a registered MBean.</p>
|
|
|
|
<P> If the listener is registered more than once, perhaps with
|
|
different filters or callbacks, this method will remove all
|
|
those registrations.
|
|
<P>
|
|
<DD><DL>
|
|
<DT><B>Specified by:</B><DD><CODE><A HREF="MBeanServerConnection.html#removeNotificationListener(javax.management.ObjectName, javax.management.NotificationListener)">removeNotificationListener</A></CODE> in interface <CODE><A HREF="MBeanServerConnection.html" title="interface in javax.management">MBeanServerConnection</A></CODE></DL>
|
|
</DD>
|
|
<DD><DL>
|
|
<DT><B>Parameters:</B><DD><CODE>name</CODE> - The name of the MBean on which the listener should
|
|
be removed.<DD><CODE>listener</CODE> - The object name of the listener to be removed.
|
|
<DT><B>Throws:</B>
|
|
<DD><CODE><A HREF="InstanceNotFoundException.html" title="class in javax.management">InstanceNotFoundException</A></CODE> - The MBean name provided
|
|
does not match any of the registered MBeans.
|
|
<DD><CODE><A HREF="ListenerNotFoundException.html" title="class in javax.management">ListenerNotFoundException</A></CODE> - The listener is not
|
|
registered in the MBean.<DT><B>See Also:</B><DD><A HREF="MBeanServer.html#addNotificationListener(javax.management.ObjectName, javax.management.NotificationListener, javax.management.NotificationFilter, java.lang.Object)"><CODE>addNotificationListener(ObjectName, NotificationListener,
|
|
NotificationFilter, Object)</CODE></A></DL>
|
|
</DD>
|
|
</DL>
|
|
<HR>
|
|
|
|
<A NAME="removeNotificationListener(javax.management.ObjectName, javax.management.NotificationListener, javax.management.NotificationFilter, java.lang.Object)"><!-- --></A><H3>
|
|
removeNotificationListener</H3>
|
|
<PRE>
|
|
void <B>removeNotificationListener</B>(<A HREF="ObjectName.html" title="class in javax.management">ObjectName</A> name,
|
|
<A HREF="NotificationListener.html" title="interface in javax.management">NotificationListener</A> listener,
|
|
<A HREF="NotificationFilter.html" title="interface in javax.management">NotificationFilter</A> filter,
|
|
java.lang.Object handback)
|
|
throws <A HREF="InstanceNotFoundException.html" title="class in javax.management">InstanceNotFoundException</A>,
|
|
<A HREF="ListenerNotFoundException.html" title="class in javax.management">ListenerNotFoundException</A></PRE>
|
|
<DL>
|
|
<DD><p>Removes a listener from a registered MBean.</p>
|
|
|
|
<p>The MBean must have a listener that exactly matches the
|
|
given <code>listener</code>, <code>filter</code>, and
|
|
<code>handback</code> parameters. If there is more than one
|
|
such listener, only one is removed.</p>
|
|
|
|
<p>The <code>filter</code> and <code>handback</code> parameters
|
|
may be null if and only if they are null in a listener to be
|
|
removed.</p>
|
|
<P>
|
|
<DD><DL>
|
|
<DT><B>Specified by:</B><DD><CODE><A HREF="MBeanServerConnection.html#removeNotificationListener(javax.management.ObjectName, javax.management.NotificationListener, javax.management.NotificationFilter, java.lang.Object)">removeNotificationListener</A></CODE> in interface <CODE><A HREF="MBeanServerConnection.html" title="interface in javax.management">MBeanServerConnection</A></CODE></DL>
|
|
</DD>
|
|
<DD><DL>
|
|
<DT><B>Parameters:</B><DD><CODE>name</CODE> - The name of the MBean on which the listener should
|
|
be removed.<DD><CODE>listener</CODE> - A listener that was previously added to this
|
|
MBean.<DD><CODE>filter</CODE> - The filter that was specified when the listener
|
|
was added.<DD><CODE>handback</CODE> - The handback that was specified when the
|
|
listener was added.
|
|
<DT><B>Throws:</B>
|
|
<DD><CODE><A HREF="InstanceNotFoundException.html" title="class in javax.management">InstanceNotFoundException</A></CODE> - The MBean name provided
|
|
does not match any of the registered MBeans.
|
|
<DD><CODE><A HREF="ListenerNotFoundException.html" title="class in javax.management">ListenerNotFoundException</A></CODE> - The listener is not
|
|
registered in the MBean, or it is not registered with the given
|
|
filter and handback.<DT><B>Since:</B></DT>
|
|
<DD>JMX 1.2</DD>
|
|
<DT><B>See Also:</B><DD><A HREF="MBeanServer.html#addNotificationListener(javax.management.ObjectName, javax.management.NotificationListener, javax.management.NotificationFilter, java.lang.Object)"><CODE>addNotificationListener(ObjectName, NotificationListener,
|
|
NotificationFilter, Object)</CODE></A></DL>
|
|
</DD>
|
|
</DL>
|
|
<HR>
|
|
|
|
<A NAME="removeNotificationListener(javax.management.ObjectName, javax.management.ObjectName)"><!-- --></A><H3>
|
|
removeNotificationListener</H3>
|
|
<PRE>
|
|
void <B>removeNotificationListener</B>(<A HREF="ObjectName.html" title="class in javax.management">ObjectName</A> name,
|
|
<A HREF="ObjectName.html" title="class in javax.management">ObjectName</A> listener)
|
|
throws <A HREF="InstanceNotFoundException.html" title="class in javax.management">InstanceNotFoundException</A>,
|
|
<A HREF="ListenerNotFoundException.html" title="class in javax.management">ListenerNotFoundException</A></PRE>
|
|
<DL>
|
|
<DD>Removes a listener from a registered MBean.
|
|
|
|
<P> If the listener is registered more than once, perhaps with
|
|
different filters or callbacks, this method will remove all
|
|
those registrations.
|
|
<P>
|
|
<DD><DL>
|
|
<DT><B>Specified by:</B><DD><CODE><A HREF="MBeanServerConnection.html#removeNotificationListener(javax.management.ObjectName, javax.management.ObjectName)">removeNotificationListener</A></CODE> in interface <CODE><A HREF="MBeanServerConnection.html" title="interface in javax.management">MBeanServerConnection</A></CODE></DL>
|
|
</DD>
|
|
<DD><DL>
|
|
<DT><B>Parameters:</B><DD><CODE>name</CODE> - The name of the MBean on which the listener should
|
|
be removed.<DD><CODE>listener</CODE> - The object name of the listener to be removed.
|
|
<DT><B>Throws:</B>
|
|
<DD><CODE><A HREF="InstanceNotFoundException.html" title="class in javax.management">InstanceNotFoundException</A></CODE> - The MBean name provided
|
|
does not match any of the registered MBeans.
|
|
<DD><CODE><A HREF="ListenerNotFoundException.html" title="class in javax.management">ListenerNotFoundException</A></CODE> - The listener is not
|
|
registered in the MBean.<DT><B>See Also:</B><DD><A HREF="MBeanServer.html#addNotificationListener(javax.management.ObjectName, javax.management.ObjectName, javax.management.NotificationFilter, java.lang.Object)"><CODE>addNotificationListener(ObjectName, ObjectName,
|
|
NotificationFilter, Object)</CODE></A></DL>
|
|
</DD>
|
|
</DL>
|
|
<HR>
|
|
|
|
<A NAME="removeNotificationListener(javax.management.ObjectName, javax.management.ObjectName, javax.management.NotificationFilter, java.lang.Object)"><!-- --></A><H3>
|
|
removeNotificationListener</H3>
|
|
<PRE>
|
|
void <B>removeNotificationListener</B>(<A HREF="ObjectName.html" title="class in javax.management">ObjectName</A> name,
|
|
<A HREF="ObjectName.html" title="class in javax.management">ObjectName</A> listener,
|
|
<A HREF="NotificationFilter.html" title="interface in javax.management">NotificationFilter</A> filter,
|
|
java.lang.Object handback)
|
|
throws <A HREF="InstanceNotFoundException.html" title="class in javax.management">InstanceNotFoundException</A>,
|
|
<A HREF="ListenerNotFoundException.html" title="class in javax.management">ListenerNotFoundException</A></PRE>
|
|
<DL>
|
|
<DD><p>Removes a listener from a registered MBean.</p>
|
|
|
|
<p>The MBean must have a listener that exactly matches the
|
|
given <code>listener</code>, <code>filter</code>, and
|
|
<code>handback</code> parameters. If there is more than one
|
|
such listener, only one is removed.</p>
|
|
|
|
<p>The <code>filter</code> and <code>handback</code> parameters
|
|
may be null if and only if they are null in a listener to be
|
|
removed.</p>
|
|
<P>
|
|
<DD><DL>
|
|
<DT><B>Specified by:</B><DD><CODE><A HREF="MBeanServerConnection.html#removeNotificationListener(javax.management.ObjectName, javax.management.ObjectName, javax.management.NotificationFilter, java.lang.Object)">removeNotificationListener</A></CODE> in interface <CODE><A HREF="MBeanServerConnection.html" title="interface in javax.management">MBeanServerConnection</A></CODE></DL>
|
|
</DD>
|
|
<DD><DL>
|
|
<DT><B>Parameters:</B><DD><CODE>name</CODE> - The name of the MBean on which the listener should
|
|
be removed.<DD><CODE>listener</CODE> - A listener that was previously added to this
|
|
MBean.<DD><CODE>filter</CODE> - The filter that was specified when the listener
|
|
was added.<DD><CODE>handback</CODE> - The handback that was specified when the
|
|
listener was added.
|
|
<DT><B>Throws:</B>
|
|
<DD><CODE><A HREF="InstanceNotFoundException.html" title="class in javax.management">InstanceNotFoundException</A></CODE> - The MBean name provided
|
|
does not match any of the registered MBeans.
|
|
<DD><CODE><A HREF="ListenerNotFoundException.html" title="class in javax.management">ListenerNotFoundException</A></CODE> - The listener is not
|
|
registered in the MBean, or it is not registered with the given
|
|
filter and handback.<DT><B>Since:</B></DT>
|
|
<DD>JMX 1.2</DD>
|
|
<DT><B>See Also:</B><DD><A HREF="MBeanServer.html#addNotificationListener(javax.management.ObjectName, javax.management.ObjectName, javax.management.NotificationFilter, java.lang.Object)"><CODE>addNotificationListener(ObjectName, ObjectName,
|
|
NotificationFilter, Object)</CODE></A></DL>
|
|
</DD>
|
|
</DL>
|
|
<HR>
|
|
|
|
<A NAME="setAttribute(javax.management.ObjectName, javax.management.Attribute)"><!-- --></A><H3>
|
|
setAttribute</H3>
|
|
<PRE>
|
|
void <B>setAttribute</B>(<A HREF="ObjectName.html" title="class in javax.management">ObjectName</A> name,
|
|
<A HREF="Attribute.html" title="class in javax.management">Attribute</A> attribute)
|
|
throws <A HREF="InstanceNotFoundException.html" title="class in javax.management">InstanceNotFoundException</A>,
|
|
<A HREF="AttributeNotFoundException.html" title="class in javax.management">AttributeNotFoundException</A>,
|
|
<A HREF="InvalidAttributeValueException.html" title="class in javax.management">InvalidAttributeValueException</A>,
|
|
<A HREF="MBeanException.html" title="class in javax.management">MBeanException</A>,
|
|
<A HREF="ReflectionException.html" title="class in javax.management">ReflectionException</A></PRE>
|
|
<DL>
|
|
<DD>Sets the value of a specific attribute of a named MBean. The MBean
|
|
is identified by its object name.
|
|
<P>
|
|
<DD><DL>
|
|
<DT><B>Specified by:</B><DD><CODE><A HREF="MBeanServerConnection.html#setAttribute(javax.management.ObjectName, javax.management.Attribute)">setAttribute</A></CODE> in interface <CODE><A HREF="MBeanServerConnection.html" title="interface in javax.management">MBeanServerConnection</A></CODE></DL>
|
|
</DD>
|
|
<DD><DL>
|
|
<DT><B>Parameters:</B><DD><CODE>name</CODE> - The name of the MBean within which the attribute is
|
|
to be set.<DD><CODE>attribute</CODE> - The identification of the attribute to be set
|
|
and the value it is to be set to.
|
|
<DT><B>Throws:</B>
|
|
<DD><CODE><A HREF="InstanceNotFoundException.html" title="class in javax.management">InstanceNotFoundException</A></CODE> - The MBean specified is not
|
|
registered in the MBean server.
|
|
<DD><CODE><A HREF="AttributeNotFoundException.html" title="class in javax.management">AttributeNotFoundException</A></CODE> - The attribute specified
|
|
is not accessible in the MBean.
|
|
<DD><CODE><A HREF="InvalidAttributeValueException.html" title="class in javax.management">InvalidAttributeValueException</A></CODE> - The value specified
|
|
for the attribute is not valid.
|
|
<DD><CODE><A HREF="MBeanException.html" title="class in javax.management">MBeanException</A></CODE> - Wraps an exception thrown by the
|
|
MBean's setter.
|
|
<DD><CODE><A HREF="ReflectionException.html" title="class in javax.management">ReflectionException</A></CODE> - Wraps a
|
|
<CODE>java.lang.Exception</CODE> thrown when trying to invoke
|
|
the setter.
|
|
<DD><CODE><A HREF="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 attribute in parameter is
|
|
null.<DT><B>See Also:</B><DD><A HREF="MBeanServer.html#getAttribute(javax.management.ObjectName, java.lang.String)"><CODE>getAttribute(javax.management.ObjectName, java.lang.String)</CODE></A></DL>
|
|
</DD>
|
|
</DL>
|
|
<HR>
|
|
|
|
<A NAME="setAttributes(javax.management.ObjectName, javax.management.AttributeList)"><!-- --></A><H3>
|
|
setAttributes</H3>
|
|
<PRE>
|
|
<A HREF="AttributeList.html" title="class in javax.management">AttributeList</A> <B>setAttributes</B>(<A HREF="ObjectName.html" title="class in javax.management">ObjectName</A> name,
|
|
<A HREF="AttributeList.html" title="class in javax.management">AttributeList</A> attributes)
|
|
throws <A HREF="InstanceNotFoundException.html" title="class in javax.management">InstanceNotFoundException</A>,
|
|
<A HREF="ReflectionException.html" title="class in javax.management">ReflectionException</A></PRE>
|
|
<DL>
|
|
<DD>Sets the values of several attributes of a named MBean. The MBean is
|
|
identified by its object name.
|
|
<P>
|
|
<DD><DL>
|
|
<DT><B>Specified by:</B><DD><CODE><A HREF="MBeanServerConnection.html#setAttributes(javax.management.ObjectName, javax.management.AttributeList)">setAttributes</A></CODE> in interface <CODE><A HREF="MBeanServerConnection.html" title="interface in javax.management">MBeanServerConnection</A></CODE></DL>
|
|
</DD>
|
|
<DD><DL>
|
|
<DT><B>Parameters:</B><DD><CODE>name</CODE> - The object name of the MBean within which the
|
|
attributes are to be set.<DD><CODE>attributes</CODE> - A list of attributes: The identification of
|
|
the attributes to be set and the values they are to be set to.
|
|
<DT><B>Returns:</B><DD>The list of attributes that were set, with their new
|
|
values.
|
|
<DT><B>Throws:</B>
|
|
<DD><CODE><A HREF="InstanceNotFoundException.html" title="class in javax.management">InstanceNotFoundException</A></CODE> - The MBean specified is not
|
|
registered in the MBean server.
|
|
<DD><CODE><A HREF="ReflectionException.html" title="class in javax.management">ReflectionException</A></CODE> - An exception occurred when
|
|
trying to invoke the getAttributes method of a Dynamic MBean.
|
|
<DD><CODE><A HREF="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 attributes in parameter is null.<DT><B>See Also:</B><DD><A HREF="MBeanServer.html#getAttributes(javax.management.ObjectName, java.lang.String[])"><CODE>getAttributes(javax.management.ObjectName, java.lang.String[])</CODE></A></DL>
|
|
</DD>
|
|
</DL>
|
|
<HR>
|
|
|
|
<A NAME="unregisterMBean(javax.management.ObjectName)"><!-- --></A><H3>
|
|
unregisterMBean</H3>
|
|
<PRE>
|
|
void <B>unregisterMBean</B>(<A HREF="ObjectName.html" title="class in javax.management">ObjectName</A> name)
|
|
throws <A HREF="InstanceNotFoundException.html" title="class in javax.management">InstanceNotFoundException</A>,
|
|
<A HREF="MBeanRegistrationException.html" title="class in javax.management">MBeanRegistrationException</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>Specified by:</B><DD><CODE><A HREF="MBeanServerConnection.html#unregisterMBean(javax.management.ObjectName)">unregisterMBean</A></CODE> in interface <CODE><A HREF="MBeanServerConnection.html" title="interface in javax.management">MBeanServerConnection</A></CODE></DL>
|
|
</DD>
|
|
<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="InstanceNotFoundException.html" title="class in javax.management">InstanceNotFoundException</A></CODE> - The MBean specified is not
|
|
registered in the MBean server.
|
|
<DD><CODE><A HREF="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="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="MBeanServerDelegate.html" title="class in javax.management"><CODE>MBeanServerDelegate</CODE></A> MBean.</DL>
|
|
</DD>
|
|
</DL>
|
|
<!-- ========= END OF CLASS DATA ========= -->
|
|
<HR>
|
|
|
|
|
|
<!-- ======= START OF BOTTOM NAVBAR ====== -->
|
|
<A NAME="navbar_bottom"><!-- --></A>
|
|
<A HREF="MBeanServer.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="MBeanRegistrationException.html" title="class in javax.management"><B>PREV CLASS</B></A>
|
|
<A HREF="MBeanServerBuilder.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%252FMBeanServer.html" target="_top"><B>FRAMES</B></A>
|
|
<A HREF="MBeanServer.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="MBeanServer.html#method_summary">METHOD</A></FONT></TD>
|
|
<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
|
|
DETAIL: FIELD | CONSTR | <A HREF="MBeanServer.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>
|