compact3

javax.management

Interface MBeanServerConnection

All Known Subinterfaces:

MBeanServer， MBeanServerForwarder

public interface MBeanServerConnection

这个接口代表交谈的方式MBean服务器，无论是本地或远程。的 MBeanServer接口，代表本地MBean服务器，扩展接口。

从以下版本开始：

一点五

方法摘要

Modifier and Type	Method and Description
void	addNotificationListener(ObjectName name, NotificationListener listener, NotificationFilter filter, Object handback) 添加一个监听器注册MBean。
void	addNotificationListener(ObjectName name, ObjectName listener, NotificationFilter filter, Object handback) 添加一个监听器注册MBean。
ObjectInstance	createMBean(String className, ObjectName name) 实例化和注册在MBean服务器的MBean。
ObjectInstance	createMBean(String className, ObjectName name, Object[] params, String[] signature) 实例化和注册在MBean服务器的MBean。
ObjectInstance	createMBean(String className, ObjectName name, ObjectName loaderName) 实例化和注册在MBean服务器的MBean。
ObjectInstance	createMBean(String className, ObjectName name, ObjectName loaderName, Object[] params, String[] signature) 实例化和注册在MBean服务器的MBean。
Object	getAttribute(ObjectName name, String attribute) 获取一个名为MBean的特定属性的值。
AttributeList	getAttributes(ObjectName name, String[] attributes) 获取一个名为MBean的几个属性的值。
String	getDefaultDomain() 返回用于命名的MBean默认域。
String[]	getDomains() 返回内任何MBean目前注册名单。
Integer	getMBeanCount() 返回在MBean服务器注册MBean的数量。
MBeanInfo	getMBeanInfo(ObjectName name) 这种方法发现MBean公开管理的属性和操作。
ObjectInstance	getObjectInstance(ObjectName name) 获取一个给定的MBean的MBean服务器注册的 ObjectInstance。
Object	invoke(ObjectName name, String operationName, Object[] params, String[] signature) 调用MBean操作。
boolean	isInstanceOf(ObjectName name, String className) 如果指定的MBean是指定类的实例返回true，否则为false。
boolean	isRegistered(ObjectName name) 检查是否一个MBean，其对象的姓名，已经与MBean服务器注册。
Set<ObjectInstance>	queryMBeans(ObjectName name, QueryExp query) 通过MBean服务器控制的MBeans。
Set<ObjectName>	queryNames(ObjectName name, QueryExp query) 获取由MBean服务器控制的MBean的名字。
void	removeNotificationListener(ObjectName name, NotificationListener listener) 从注册MBean移除侦听器。
void	removeNotificationListener(ObjectName name, NotificationListener listener, NotificationFilter filter, Object handback) 从注册MBean移除侦听器。
void	removeNotificationListener(ObjectName name, ObjectName listener) 从注册MBean移除侦听器。
void	removeNotificationListener(ObjectName name, ObjectName listener, NotificationFilter filter, Object handback) 从注册MBean移除侦听器。
void	setAttribute(ObjectName name, Attribute attribute) 套一个名叫MBean的特定属性的值。
AttributeList	setAttributes(ObjectName name, AttributeList attributes) 套一名叫MBean的几个属性的值。
void	unregisterMBean(ObjectName name) 将从MBean服务器MBean。

方法详细信息

createMBean

ObjectInstance createMBean(String className,
                           ObjectName name)
                    throws ReflectionException,
                           InstanceAlreadyExistsException,
                           MBeanRegistrationException,
                           MBeanException,
                           NotCompliantMBeanException,
                           IOException

实例化和注册在MBean服务器的MBean。MBean服务器将使用其Default Loader Repository加载MBean类。对象名称与MBean相关。如果对象名是无效的，必须通过实施MBeanRegistration MBean接口和从preRegister方法返回的名称提供它自己的名字。

这种方法相当于createMBean(className, name, (Object[]) null, (String[]) null)。

参数

className要实例化MBean类名称。

name - MBean对象名称。可能是空的。

结果

一个 ObjectInstance，含有 ObjectName和新实例化MBean的java类的名称。如果有 ObjectName是 n，包含java类的名字是 getMBeanInfo(n).getClassName()。

异常

ReflectionException -包装 java.lang.ClassNotFoundException或 java.lang.Exception时试图调用MBean的构造函数。

InstanceAlreadyExistsException的MBean已经是MBean服务器的控制下。

MBeanRegistrationException - preRegister（ MBeanRegistration接口）的MBean方法抛出异常。MBean将不予注册。

RuntimeMBeanException如果MBean的构造函数或其 preRegister或 postRegister方法抛出一个 RuntimeException。如果 postRegister（ MBeanRegistration接口）的MBean方法抛出一个 RuntimeException，的 createMBean方法将抛出一个 RuntimeMBeanException，虽然MBean的创建和注册成功。在这种情况下，MBean将实际上注册即使 createMBean方法抛出一个异常。注意， RuntimeMBeanException也可以被 preRegister，在这种情况下，MBean将不予注册。

RuntimeErrorException -如果 postRegister（ MBeanRegistration接口）的MBean方法抛出的 Error， createMBean方法将抛出一个 RuntimeErrorException，虽然MBean的创建和注册成功。在这种情况下，MBean将实际上注册即使 createMBean方法抛出一个异常。注意， RuntimeErrorException也可以被 preRegister，在这种情况下，MBean将不予注册。

MBeanException - MBean构造函数抛出了一个异常

NotCompliantMBeanException这类不符合JMX MBean

RuntimeOperationsException -包装 java.lang.IllegalArgumentException：类名传入的参数为空， ObjectName传入的参数包含模式或没有 ObjectName是MBean指定。

IOException -沟通问题发生到MBean服务器交谈时。

另请参见：

MBeanRegistration

createMBean

ObjectInstance createMBean(String className,
                           ObjectName name,
                           ObjectName loaderName)
                    throws ReflectionException,
                           InstanceAlreadyExistsException,
                           MBeanRegistrationException,
                           MBeanException,
                           NotCompliantMBeanException,
                           InstanceNotFoundException,
                           IOException

实例化和注册在MBean服务器的MBean。要使用的类装载器是由它的对象名称标识的。对象名称与MBean相关。如果Loader对象名称是无效的，该类加载器加载的MBean服务器将使用。如果MBean的对象名是无效的，必须通过实施MBeanRegistration MBean接口和从preRegister方法返回的名称提供它自己的名字。

这种方法相当于createMBean(className, name, loaderName, (Object[]) null, (String[]) null)。

参数

className - MBean类名称被实例化。

name - MBean对象名称。可能是空的。

loaderName -类加载器对象的名字被使用。

结果

一个 ObjectInstance，含有 ObjectName和新实例化MBean的java类的名称。如果有 ObjectName是 n，包含java类的名字是 getMBeanInfo(n).getClassName()。

异常

ReflectionException -包装 java.lang.ClassNotFoundException或 java.lang.Exception时试图调用MBean的构造函数。

InstanceAlreadyExistsException的MBean已经是MBean服务器的控制下。

MBeanRegistrationException - preRegister（ MBeanRegistration接口）的MBean方法抛出异常。MBean将不予注册。

RuntimeMBeanException如果MBean的构造函数或其 preRegister或 postRegister方法抛出一个 RuntimeException。如果 postRegister（ MBeanRegistration接口）的MBean方法抛出一个 RuntimeException，的 createMBean方法将抛出一个 RuntimeMBeanException，虽然MBean的创建和注册成功。在这种情况下，MBean将实际上注册即使 createMBean方法抛出一个异常。注意， RuntimeMBeanException也可以被 preRegister，在这种情况下，MBean将不予注册。

RuntimeErrorException -如果 postRegister（ MBeanRegistration接口）的MBean方法抛出的 Error， createMBean方法将抛出一个 RuntimeErrorException，虽然MBean的创建和注册成功。在这种情况下，MBean将实际上注册即使 createMBean方法抛出一个异常。注意， RuntimeErrorException也可以被 preRegister，在这种情况下，MBean将不予注册。

MBeanException - MBean构造函数抛出了一个异常

NotCompliantMBeanException这类不符合JMX MBean

InstanceNotFoundException -指定的类装载器是不是在MBean服务器注册。

RuntimeOperationsException -包装 java.lang.IllegalArgumentException：类名传入的参数为空， ObjectName传入的参数包含模式或没有 ObjectName是MBean指定。

IOException -沟通问题发生到MBean服务器交谈时。

另请参见：

MBeanRegistration

createMBean

ObjectInstance createMBean(String className,
                           ObjectName name,
                           Object[] params,
                           String[] signature)
                    throws ReflectionException,
                           InstanceAlreadyExistsException,
                           MBeanRegistrationException,
                           MBeanException,
                           NotCompliantMBeanException,
                           IOException

实例化和注册在MBean服务器的MBean。MBean服务器将使用其 Default Loader Repository加载MBean类。对象名称与MBean相关。如果对象名是无效的，必须通过实施 MBeanRegistration MBean接口和从 preRegister方法返回的名称提供它自己的名字。

参数

className - MBean类名称被实例化。

name - MBean对象名称。可能是空的。

params -数组包含要调用的构造函数的参数。

signature -数组包含要调用构造函数的签名。

结果

一个 ObjectInstance，含有 ObjectName和新实例化MBean的java类的名称。如果有 ObjectName是 n，包含java类的名字是 getMBeanInfo(n).getClassName()。

异常

ReflectionException -包装 java.lang.ClassNotFoundException或 java.lang.Exception时试图调用MBean的构造函数。

InstanceAlreadyExistsException的MBean已经是MBean服务器的控制下。

MBeanRegistrationException - preRegister（ MBeanRegistration接口）的MBean方法抛出异常。MBean将不予注册。

RuntimeMBeanException如果MBean的构造函数或其 preRegister或 postRegister方法抛出一个 RuntimeException。如果 postRegister（ MBeanRegistration接口）的MBean方法抛出一个 RuntimeException，的 createMBean方法将抛出一个 RuntimeMBeanException，虽然MBean的创建和注册成功。在这种情况下，MBean将实际上注册即使 createMBean方法抛出一个异常。注意， RuntimeMBeanException也可以被 preRegister，在这种情况下，MBean将不予注册。

RuntimeErrorException -如果 postRegister（ MBeanRegistration接口）的MBean方法抛出的 Error， createMBean方法将抛出一个 RuntimeErrorException，虽然MBean的创建和注册成功。在这种情况下，MBean将实际上注册即使 createMBean方法抛出一个异常。注意， RuntimeErrorException也可以被 preRegister，在这种情况下，MBean将不予注册。

MBeanException - MBean构造函数抛出了一个异常

NotCompliantMBeanException这类不符合JMX MBean

RuntimeOperationsException -包装 java.lang.IllegalArgumentException：类名传入的参数为空， ObjectName传入的参数包含模式或没有 ObjectName是MBean指定。

IOException -沟通问题发生到MBean服务器交谈时。

另请参见：

MBeanRegistration

createMBean

ObjectInstance createMBean(String className,
                           ObjectName name,
                           ObjectName loaderName,
                           Object[] params,
                           String[] signature)
                    throws ReflectionException,
                           InstanceAlreadyExistsException,
                           MBeanRegistrationException,
                           MBeanException,
                           NotCompliantMBeanException,
                           InstanceNotFoundException,
                           IOException

实例化和注册在MBean服务器的MBean。要使用的类装载器是由它的对象名称标识的。对象名称与MBean相关。如果未指定的加载对象的名称，该类加载器加载的MBean服务器将使用。如果MBean对象名是无效的，必须通过实施MBeanRegistration MBean接口和从preRegister方法返回的名称提供它自己的名字。

参数

className - MBean类名称被实例化。

name - MBean对象名称。可能是空的。

params -数组包含要调用的构造函数的参数。

signature -数组包含要调用构造函数的签名。

loaderName -类加载器对象的名字被使用。

结果

一个 ObjectInstance，含有 ObjectName和新实例化MBean的java类的名称。如果有 ObjectName是 n，包含java类的名字是 getMBeanInfo(n).getClassName()。

异常

ReflectionException -包装 java.lang.ClassNotFoundException或 java.lang.Exception时试图调用MBean的构造函数。

InstanceAlreadyExistsException的MBean已经是MBean服务器的控制下。

MBeanRegistrationException - preRegister（ MBeanRegistration接口）的MBean方法抛出异常。MBean将不予注册。

RuntimeMBeanException的MBean的构造函数或其 preRegister或 postRegister方法抛出一个 RuntimeException。如果 postRegister（ MBeanRegistration接口）的MBean方法抛出一个 RuntimeException，的 createMBean方法将抛出一个 RuntimeMBeanException，虽然MBean的创建和注册成功。在这种情况下，MBean将实际上注册即使 createMBean方法抛出一个异常。注意， RuntimeMBeanException也可以被 preRegister，在这种情况下，MBean将不予注册。

RuntimeErrorException -如果 postRegister方法（ MBeanRegistration接口）的MBean方法抛出的 Error， createMBean方法将抛出一个 RuntimeErrorException，虽然MBean的创建和注册成功。在这种情况下，MBean将实际上注册即使 createMBean方法抛出一个异常。注意， RuntimeErrorException也可以被 preRegister，在这种情况下，MBean将不予注册。

MBeanException - MBean构造函数抛出了一个异常

NotCompliantMBeanException这类不符合JMX MBean

InstanceNotFoundException -指定的类装载器是不是在MBean服务器注册。

RuntimeOperationsException -包装 java.lang.IllegalArgumentException：类名传入的参数为空， ObjectName传入的参数包含模式或没有 ObjectName是MBean指定。

IOException -沟通问题发生到MBean服务器交谈时。

另请参见：

MBeanRegistration

unregisterMBean

void unregisterMBean(ObjectName name)
              throws InstanceNotFoundException,
                     MBeanRegistrationException,
                     IOException

将从MBean服务器MBean。MBean的对象名称标识。一旦方法被调用时，MBean可能不再是通过对象名访问。

参数

name - MBean对象名称未登记。

异常

InstanceNotFoundException的MBean指定不在MBean服务器注册。

MBeanRegistrationException - prederegister（（ MBeanRegistration接口）的MBean方法抛出异常。

RuntimeMBeanException -如果 postDeregister（ MBeanRegistration接口）的MBean方法抛出一个 RuntimeException，的 unregisterMBean方法将抛出一个 RuntimeMBeanException，虽然MBean注销成功。在这种情况下，MBean将实际上未注册即使 unregisterMBean方法抛出一个异常。注意， RuntimeMBeanException也可以被 preDeregister，在这种情况下，MBean将保持注册。

RuntimeErrorException -如果 postDeregister（ MBeanRegistration接口）的MBean方法抛出的 Error， unregisterMBean方法将抛出一个 RuntimeErrorException，虽然MBean注销成功。在这种情况下，MBean将实际上未注册即使 unregisterMBean方法抛出一个异常。注意， RuntimeMBeanException也可以被 preDeregister，在这种情况下，MBean将保持注册。

RuntimeOperationsException -包装 java.lang.IllegalArgumentException：参数对象名称为空或MBean当你试图注销是 MBeanServerDelegate MBean。

IOException -沟通问题发生到MBean服务器交谈时。

另请参见：

MBeanRegistration

getObjectInstance

ObjectInstance getObjectInstance(ObjectName name)
                          throws InstanceNotFoundException,
                                 IOException

获取一个给定的MBean的MBean服务器注册的 ObjectInstance。

参数

name - MBean对象名称。

结果

所指定的 名称 MBean相关的 ObjectInstance。所含的 ObjectName是 name和包含的类的名字是 getMBeanInfo(name).getClassName()。

异常

InstanceNotFoundException的MBean指定不在MBean服务器注册。

IOException -沟通问题发生到MBean服务器交谈时。

queryMBeans

Set<ObjectInstance> queryMBeans(ObjectName name,
                                QueryExp query)
                         throws IOException

通过MBean服务器控制的MBeans。这种方法允许下列获得：所有MBean，一套模式在 ObjectName和/或查询表达式匹配指定的MBean，特定的MBean。当对象名称为空或没有域和键属性被指定时，所有对象都将被选择（如果指定了查询）。它返回 ObjectInstance对象集（含 ObjectName和java类的名称）为选定的MBeans。

参数

name -对象名称模式识别的MBean进行检索。如果为空或没有域和关键属性被指定，所有MBeans注册将被收回。

query -查询表达式适用于选择MBeans。如果没有查询表达式将用于选择MBeans。

结果

一套包含所选对象的 ObjectInstance MBeans。如果没有MBean满足查询，则返回一个空列表。

异常

IOException -沟通问题发生到MBean服务器交谈时。

queryNames

Set<ObjectName> queryNames(ObjectName name,
                           QueryExp query)
                    throws IOException

获取由MBean服务器控制的MBean的名字。此方法使下列获得：所有MBean的名字，一套模式在 ObjectName和/或查询表达式匹配指定的MBean的名字，一个特定的MBean名（相当于测试是否一个MBean注册）。当对象名称为空或没有域和键属性被指定时，所有对象都被选择（如果指定了查询）。它返回的MBeans选择objectnames集。

参数

name -对象名称模式识别的MBean名进行检索。如果为空或没有域和关键属性被指定，所有注册MBean的名字将被收回。

query -查询表达式适用于选择MBeans。如果没有查询表达式将用于选择MBeans。

结果

一套包含选定的objectnames MBeans。如果没有MBean满足查询，则返回一个空列表。

异常

IOException -沟通问题发生到MBean服务器交谈时。

isRegistered

boolean isRegistered(ObjectName name)
              throws IOException

检查是否一个MBean，其对象的姓名，已经与MBean服务器注册。

参数

name - MBean对象名称进行检查。

结果

如果mbean已经在MBean服务器注册真，否则为假。

异常

RuntimeOperationsException -包装 java.lang.IllegalArgumentException：参数对象名称为空。

IOException -沟通问题发生到MBean服务器交谈时。

getMBeanCount

Integer getMBeanCount()
               throws IOException

返回在MBean服务器注册MBean的数量。

结果

对MBeans注册数。

异常

IOException -沟通问题发生到MBean服务器交谈时。

getAttribute

Object getAttribute(ObjectName name,
                    String attribute)
             throws MBeanException,
                    AttributeNotFoundException,
                    InstanceNotFoundException,
                    ReflectionException,
                    IOException

获取一个名为MBean的特定属性的值。MBean的对象名称标识。

参数

name -对象名称的MBean的属性进行检索。

attribute -指定要检索的属性的名称。

结果

检索属性的值。

异常

AttributeNotFoundException -属性中指定的MBean无法访问。

MBeanException包例外MBean的吸气剂扔。

InstanceNotFoundException的MBean指定不在MBean服务器注册。

ReflectionException -包装 java.lang.Exception扔在试图调用setter。

RuntimeOperationsException -包装 java.lang.IllegalArgumentException：参数对象名称参数为空或属性为空。

IOException -沟通问题发生到MBean服务器交谈时。

另请参见：

setAttribute(javax.management.ObjectName, javax.management.Attribute)

getAttributes

AttributeList getAttributes(ObjectName name,
                            String[] attributes)
                     throws InstanceNotFoundException,
                            ReflectionException,
                            IOException

获取一个名为MBean的几个属性的值。MBean的对象名称标识。

如果一个或多个属性不能被检索，因为某些原因，他们将从返回的AttributeList略。来电者应该检查列表的大小为attributes阵列相同。发现什么问题，防止从一个给定的检索属性，该属性getAttribute电话。

这里是调用此方法的一个示例，并检查它成功地检索所有请求的属性：

字符串attrnames = []…；AttributeList列表= mbeanserverconnection getattributes（对象，attrnames）；如果（列表。size() = = attrnames。长度）系统的输入（“所有属性检索成功”）；别的{ List<String>失踪=新 ArrayList<String>（Arrays.asList（attrnames））；为（属性：列表。aslist()）删除（A. getname()）失踪；系统的输入（“没有检索：“+失踪）；}

参数

name -对象名称的MBean，检索的属性。

attributes -目录的属性进行检索。

结果

检索属性的列表。

异常

InstanceNotFoundException的MBean指定不在MBean服务器注册。

ReflectionException -例外发生在试图调用一个动态MBean的getattributes方法。

RuntimeOperationsException包装一 java.lang.IllegalArgumentException：参数对象名称参数为空或属性为空。

IOException -沟通问题发生到MBean服务器交谈时。

另请参见：

setAttributes(javax.management.ObjectName, javax.management.AttributeList)

setAttribute

void setAttribute(ObjectName name,
                  Attribute attribute)
           throws InstanceNotFoundException,
                  AttributeNotFoundException,
                  InvalidAttributeValueException,
                  MBeanException,
                  ReflectionException,
                  IOException

套一个名叫MBean的特定属性的值。MBean的对象名称标识。

参数

name - MBean的属性可以设置名称。

attribute -属性要设置的识别和可设置的值。

异常

InstanceNotFoundException的MBean指定不在MBean服务器注册。

AttributeNotFoundException -属性中指定的MBean无法访问。

InvalidAttributeValueException为属性指定的值无效。

MBeanException包例外MBean的setter抛出。

ReflectionException -包装 java.lang.Exception扔在试图调用setter。

RuntimeOperationsException -包装 java.lang.IllegalArgumentException：参数对象名称参数为空或属性为空。

IOException -沟通问题发生到MBean服务器交谈时。

另请参见：

getAttribute(javax.management.ObjectName, java.lang.String)

setAttributes

AttributeList setAttributes(ObjectName name,
                            AttributeList attributes)
                     throws InstanceNotFoundException,
                            ReflectionException,
                            IOException

套一名叫MBean的几个属性的值。MBean的对象名称标识。

如果一个或多个属性不能被设置，因为某些原因，他们将从返回的AttributeList略。调用者应该检查输入AttributeList大小作为输出相同。发现什么问题，防止从一个给定的检索属性，通常可以称为属性setAttribute，虽然这是没有保证的工作。（例如，两个属性的值可能被拒绝，因为它们是彼此不一致的。设置其中一个可能是允许的。

这里是调用此方法的一个示例，并检查它成功地设置了所有请求的属性：

AttributeList inputattrs =…；outputattrs AttributeList mbeanserverconnection setattributes（=。对象，inputattrs）；如果（inputattrs。size() = = outputattrs。size()）系统的输入（“所有属性设置成功”）；别的{ List<String>失踪=新z-d158e3b2-b994-4021-8771- c42e651afdbc()；为（属性：inputattrs。aslist()）添加（A getname()）失踪；为（属性：outputattrs。aslist()）删除（A. getname()）失踪；系统的输入（“没有设置：“+失踪）；}

参数

name -对象名称的MBean的属性来设置。

attributes -目录属性：属性的识别是集和它们的值被设置为。

结果

被设置的属性列表，用他们的新值。

异常

InstanceNotFoundException的MBean指定不在MBean服务器注册。

ReflectionException -例外发生在试图调用一个动态MBean的getattributes方法。

RuntimeOperationsException -包装 java.lang.IllegalArgumentException：参数对象名称参数为空或属性为空。

IOException -沟通问题发生到MBean服务器交谈时。

另请参见：

getAttributes(javax.management.ObjectName, java.lang.String[])

invoke

Object invoke(ObjectName name,
              String operationName,
              Object[] params,
              String[] signature)
       throws InstanceNotFoundException,
              MBeanException,
              ReflectionException,
              IOException

调用MBean操作。

因为一个signature分化可能超载操作的需要，这是很简单的调用操作尽可能通过MBean proxy。例如，假设你有一个标准的MBean接口这样：

FooMBean的公共接口{public int countmatches（字符串[ ]模式，布尔忽略大小写）；}

的countMatches操作可以调用如下：

字符串mypatterns = []…；int数=（整数）mbeanserverconnection调用（。对象，“countmatches”，新的对象[ ] { mypatterns，真}，新的字符串的字符串[ ] [ ] {。类。getname()，布尔。类getname() }）；

或者，它可以通过一个代理调用如下：

字符串mypatterns = []…；foombean fooproxy = JMX。newmbeanproxy（mbeanserverconnection、对象、FooMBean类）；int数= fooproxy countmatches（mypatterns，真的）；

参数

name -对象名称的MBean的方法被调用。

operationName -操作的名称被调用。

params -一个数组包含的参数设置操作时调用

signature -一个数组包含操作的签名，通过 Class.getName()返回格式中的类名称的数组。该类的对象将使用相同的类装载器是用于装载MBean操作的调用加载。

结果

通过操作返回的对象，它代表调用操作对MBean指定的结果。

异常

InstanceNotFoundException的MBean指定不在MBean服务器注册。

MBeanException包例外MBean的方法被调用。

ReflectionException -包装 java.lang.Exception扔在试图调用的方法。

IOException -沟通问题发生到MBean服务器交谈时。

getDefaultDomain

String getDefaultDomain()
                 throws IOException

返回用于命名的MBean默认域。默认的域名作为域名的一部分在MBeans的对象如果没有域是由用户指定。

结果

默认域。

异常

IOException -沟通问题发生到MBean服务器交谈时。

getDomains

String[] getDomains()
             throws IOException

返回内任何MBean目前注册名单。一个字符串中返回的数组的当且仅当至少有一个MBean的对象的getDomain()等于字符串注册。返回数组中的字符串的顺序没有定义。

结果

域列表。

异常

IOException -沟通问题发生到MBean服务器交谈时。

addNotificationListener

void addNotificationListener(ObjectName name,
                             NotificationListener listener,
                             NotificationFilter filter,
                             Object handback)
                      throws InstanceNotFoundException,
                             IOException

添加一个监听器注册MBean。通过MBean发出的通知将被转发给听众。

参数

name -名称的MBean的听众应该增加。

listener -监听器对象将处理由注册MBean发出的通知。

filter -滤波对象。如果过滤器为空，则在处理通知之前没有进行过滤。

handback -上下文被发送到听者的通知时发出的。

异常

InstanceNotFoundException的MBean提供的名称不符合任何注册MBean。

IOException -沟通问题发生到MBean服务器交谈时。

另请参见：

removeNotificationListener(ObjectName, NotificationListener)， removeNotificationListener(ObjectName, NotificationListener, NotificationFilter, Object)

addNotificationListener

void addNotificationListener(ObjectName name,
                             ObjectName listener,
                             NotificationFilter filter,
                             Object handback)
                      throws InstanceNotFoundException,
                             IOException

添加一个监听器注册MBean。

一个由MBean发出的通知将被转发给听者的MBeanServer。如果源的通知是一个MBean对象MBean服务器将取代了MBean的对象。否则源是不变的。

接收通知的侦听器对象是在该方法被调用时注册的一个给定名称的一个。即使它随后未注册，它将继续接收通知。

参数

name -名称的MBean的听众应该增加。

listener -监听器将处理由注册MBean发出的通知对象的名称。

filter -滤波对象。如果过滤器为空，则在处理通知之前没有进行过滤。

handback -上下文被发送到听者的通知时发出的。

异常

InstanceNotFoundException -通知监听器MBean名或通知广播员不符合任何注册MBean。

RuntimeOperationsException -包装 IllegalArgumentException。MBean的命名 listener存在但没有实施 NotificationListener接口。

IOException -沟通问题发生到MBean服务器交谈时。

另请参见：

removeNotificationListener(ObjectName, ObjectName)， removeNotificationListener(ObjectName, ObjectName, NotificationFilter, Object)

removeNotificationListener

void removeNotificationListener(ObjectName name,
                                ObjectName listener)
                         throws InstanceNotFoundException,
                                ListenerNotFoundException,
                                IOException

从注册MBean移除侦听器。

如果监听器注册超过一次，也许不同的过滤器或回调，这一方法将删除所有的注册。

参数

name -名称的MBean的听众应该被删除。

listener -监听器对象名称被删除。

异常

InstanceNotFoundException -提供MBean名不匹配任何已注册的MBean。

ListenerNotFoundException -听者不在MBean注册。

IOException -沟通问题发生到MBean服务器交谈时。

另请参见：

addNotificationListener(ObjectName, ObjectName, NotificationFilter, Object)

removeNotificationListener

void removeNotificationListener(ObjectName name,
                                ObjectName listener,
                                NotificationFilter filter,
                                Object handback)
                         throws InstanceNotFoundException,
                                ListenerNotFoundException,
                                IOException

从注册MBean移除侦听器。

MBean必须完全匹配listener听众了，filter，和handback参数。如果有多于一个这样的侦听器，只有一个被删除。

的filter和handback参数可以为null，如果他们在听众被删除是空的。

参数

name -名称的MBean的听众应该被删除。

listener -监听器对象名称被删除。

filter -过滤器，当你添加指定的。

handback -盖印，指定当听众加入。

异常

InstanceNotFoundException的MBean提供的名称不符合任何注册MBean。

ListenerNotFoundException -听者不在MBean注册，或不与给定的滤波器和盖印注册。

IOException -沟通问题发生到MBean服务器交谈时。

另请参见：

addNotificationListener(ObjectName, ObjectName, NotificationFilter, Object)

removeNotificationListener

void removeNotificationListener(ObjectName name,
                                NotificationListener listener)
                         throws InstanceNotFoundException,
                                ListenerNotFoundException,
                                IOException

从注册MBean移除侦听器。

如果监听器注册超过一次，也许不同的过滤器或回调，这一方法将删除所有的注册。

参数

name -名称的MBean的听众应该被删除。

listener -听者被删除。

异常

InstanceNotFoundException的MBean提供的名称不符合任何注册MBean。

ListenerNotFoundException -听者不在MBean注册。

IOException -沟通问题发生到MBean服务器交谈时。

另请参见：

addNotificationListener(ObjectName, NotificationListener, NotificationFilter, Object)

removeNotificationListener

void removeNotificationListener(ObjectName name,
                                NotificationListener listener,
                                NotificationFilter filter,
                                Object handback)
                         throws InstanceNotFoundException,
                                ListenerNotFoundException,
                                IOException

从注册MBean移除侦听器。

MBean必须完全匹配listener听众了，filter，和handback参数。如果有多于一个这样的侦听器，只有一个被删除。

的filter和handback参数可以为null，如果他们在听众被删除是空的。

参数

name -名称的MBean的听众应该被删除。

listener -听者被删除。

filter -过滤器，当你添加指定的。

handback -盖印，指定当听众加入。

异常

InstanceNotFoundException的MBean提供的名称不符合任何注册MBean。

ListenerNotFoundException -听者不在MBean注册，或不与给定的滤波器和盖印注册。

IOException -沟通问题发生到MBean服务器交谈时。

另请参见：

addNotificationListener(ObjectName, NotificationListener, NotificationFilter, Object)

getMBeanInfo

MBeanInfo getMBeanInfo(ObjectName name)
                throws InstanceNotFoundException,
                       IntrospectionException,
                       ReflectionException,
                       IOException

这种方法发现MBean公开管理的属性和操作。

参数

name - MBean名分析

结果

对 MBeanInfo允许这个MBean的所有属性和操作的检索实例。

异常

IntrospectionException -例外发生在反思。

InstanceNotFoundException -没有发现指定的MBean。

ReflectionException -例外发生在试图调用一个动态MBean的getmbeaninfo。

IOException -沟通问题发生到MBean服务器交谈时。

isInstanceOf

boolean isInstanceOf(ObjectName name,
                     String className)
              throws InstanceNotFoundException,
                     IOException

如果指定的MBean是指定类的实例返回true，否则为false。

如果name并不叫MBean，这个方法会InstanceNotFoundException。

否则，let
X是MBean的命名name，
L是X的类装载器，
N是X的MBeanInfo类名。

如果n等于className，结果是真的。

否则，如果我成功加载className X是这个类的一个实例，结果是真的。

否则，如果我成功加载N和className，第二类是分配从第一，结果是真的。

否则，结果是假的。

参数

name - MBean的 ObjectName。

className -类的名字。

结果

如果指定的MBean是指定类的一个实例根据上述规则，真的，否则为假。

异常

InstanceNotFoundException的MBean指定不在MBean服务器注册。

IOException -沟通问题发生到MBean服务器交谈时。

另请参见：

Class.isInstance(java.lang.Object)