Module java.management.rmi

软件包 javax.management.remote.rmi

Class RMIConnectionImpl

java.lang.Object

javax.management.remote.rmi.RMIConnectionImpl

All Implemented Interfaces:

Closeable ， AutoCloseable ， Remote ， Unreferenced ， RMIConnection

public class RMIConnectionImpl
extends Object
implements RMIConnection, Unreferenced

实现RMIConnection接口。 用户代码通常不会引用此类。

从以下版本开始：

1.5

构造方法摘要

构造方法

Constructor	描述
RMIConnectionImpl(RMIServerImpl rmiServer, String connectionId, ClassLoader defaultClassLoader, Subject subject, Map<String,?> env)	构造新的RMIConnection 。

方法摘要

Modifier and Type	方法	描述
void	addNotificationListener(ObjectName name, ObjectName listener, MarshalledObject filter, MarshalledObject handback, Subject delegationSubject)	处理方法 MBeanServerConnection.addNotificationListener(ObjectName, ObjectName, NotificationFilter, Object) 。
Integer[]	addNotificationListeners(ObjectName[] names, MarshalledObject[] filters, Subject[] delegationSubjects)	处理方法 MBeanServerConnection.addNotificationListener(ObjectName, NotificationListener, NotificationFilter, Object) 。
void	close()	关闭此连接。
ObjectInstance	createMBean(String className, ObjectName name, MarshalledObject params, String[] signature, Subject delegationSubject)	处理方法 MBeanServerConnection.createMBean(String, ObjectName, Object[], String[]) 。
ObjectInstance	createMBean(String className, ObjectName name, ObjectName loaderName, MarshalledObject params, String[] signature, Subject delegationSubject)	处理方法 MBeanServerConnection.createMBean(String, ObjectName, ObjectName, Object[], String[]) 。
ObjectInstance	createMBean(String className, ObjectName name, ObjectName loaderName, Subject delegationSubject)	处理方法 MBeanServerConnection.createMBean(String, ObjectName, ObjectName) 。
ObjectInstance	createMBean(String className, ObjectName name, Subject delegationSubject)	处理方法 MBeanServerConnection.createMBean(String, ObjectName) 。
NotificationResult	fetchNotifications(long clientSequenceNumber, int maxNotifications, long timeout)	从连接器服务器检索通知。
Object	getAttribute(ObjectName name, String attribute, Subject delegationSubject)	处理方法 MBeanServerConnection.getAttribute(ObjectName, String) 。
AttributeList	getAttributes(ObjectName name, String[] attributes, Subject delegationSubject)	处理方法 MBeanServerConnection.getAttributes(ObjectName, String[]) 。
String	getConnectionId()	返回连接ID。
String	getDefaultDomain(Subject delegationSubject)	处理方法 MBeanServerConnection.getDefaultDomain() 。
String[]	getDomains(Subject delegationSubject)	处理方法 MBeanServerConnection.getDomains() 。
Integer	getMBeanCount(Subject delegationSubject)	处理方法 MBeanServerConnection.getMBeanCount() 。
MBeanInfo	getMBeanInfo(ObjectName name, Subject delegationSubject)	处理方法 MBeanServerConnection.getMBeanInfo(ObjectName) 。
ObjectInstance	getObjectInstance(ObjectName name, Subject delegationSubject)	处理方法 MBeanServerConnection.getObjectInstance(ObjectName) 。
Object	invoke(ObjectName name, String operationName, MarshalledObject params, String[] signature, Subject delegationSubject)	处理方法 MBeanServerConnection.invoke(ObjectName, String, Object[], String[]) 。
boolean	isInstanceOf(ObjectName name, String className, Subject delegationSubject)	处理方法 MBeanServerConnection.isInstanceOf(ObjectName, String) 。
boolean	isRegistered(ObjectName name, Subject delegationSubject)	处理方法 MBeanServerConnection.isRegistered(ObjectName) 。
Set<ObjectInstance>	queryMBeans(ObjectName name, MarshalledObject query, Subject delegationSubject)	处理方法 MBeanServerConnection.queryMBeans(ObjectName, QueryExp) 。
Set<ObjectName>	queryNames(ObjectName name, MarshalledObject query, Subject delegationSubject)	处理方法 MBeanServerConnection.queryNames(ObjectName, QueryExp) 。
void	removeNotificationListener(ObjectName name, ObjectName listener, MarshalledObject filter, MarshalledObject handback, Subject delegationSubject)	处理方法 MBeanServerConnection.removeNotificationListener(ObjectName, ObjectName, NotificationFilter, Object) 。
void	removeNotificationListener(ObjectName name, ObjectName listener, Subject delegationSubject)	处理方法 MBeanServerConnection.removeNotificationListener(ObjectName, ObjectName) 。
void	removeNotificationListeners(ObjectName name, Integer[] listenerIDs, Subject delegationSubject)	处理 removeNotificationListener(ObjectName, NotificationListener)和 removeNotificationListener(ObjectName, NotificationListener, NotificationFilter, Object)方法。
void	setAttribute(ObjectName name, MarshalledObject attribute, Subject delegationSubject)	处理方法 MBeanServerConnection.setAttribute(ObjectName, Attribute) 。
AttributeList	setAttributes(ObjectName name, MarshalledObject attributes, Subject delegationSubject)	处理方法 MBeanServerConnection.setAttributes(ObjectName, AttributeList) 。
String	toString()	返回此对象的字符串表示形式。
void	unreferenced()	运行时确定引用列表（引用远程对象的客户端列表）变为空时，由RMI运行时调用。
void	unregisterMBean(ObjectName name, Subject delegationSubject)	处理方法 MBeanServerConnection.unregisterMBean(ObjectName) 。

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

构造方法详细信息

RMIConnectionImpl

public RMIConnectionImpl(RMIServerImpl rmiServer,
                         String connectionId,
                         ClassLoader defaultClassLoader,
                         Subject subject,
                         Map<String,?> env)

构造新的RMIConnection 。 该连接可以与JRMP传输一起使用。 此对象不导出自身：调用者有责任适当地导出它（请参阅RMIJRMPServerImpl.makeClient(String,Subject) ）。

参数

rmiServer - 创建此连接的RMIServerImpl对象。 如果此参数为空，则该行为是未指定的。

connectionId - 此连接的ID。 如果此参数为空，则该行为是未指定的。

defaultClassLoader - 反序列化编组对象时使用的默认ClassLoader。 可以为null，表示引导类加载器。

subject - 认证主体用于授权。 可以为null，表示没有任何主题已被认证。

env - 包含新的属性的环境RMIServerImpl 。 可以为null，相当于空的地图。

方法详细信息

getConnectionId

public String getConnectionId()
                       throws IOException

说明从接口RMIConnection复制

返回连接ID。 每个与给定RMI连接器服务器的打开连接的字符串不同。

Specified by:

getConnectionId在接口 RMIConnection

结果

连接ID

异常

IOException - 如果发生通用通信异常。

另请参见：

RMIConnector.connect

close

public void close()
           throws IOException

说明从界面复制： RMIConnection

关闭此连接。 从此方法返回时，实现此接口的RMI对象将被取消导出，因此对其的远程调用将失败。

Specified by:

close在接口 AutoCloseable

Specified by:

close在接口 Closeable

Specified by:

close在接口 RMIConnection

异常

IOException - 如果无法关闭连接，或远程对象无法取消导出，或者发送远程关闭请求时发生通信故障。

unreferenced

public void unreferenced()

描述从接口Unreferenced复制

运行时确定引用列表（引用远程对象的客户端列表）变为空时，由RMI运行时调用。

Specified by:

unreferenced在接口 Unreferenced

createMBean

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

说明从接口RMIConnection复制

处理方法 MBeanServerConnection.createMBean(String, ObjectName) 。

Specified by:

createMBean在接口 RMIConnection

参数

className - 要实例化的MBean的类名。

name - MBean的对象名称。 可能为null。

delegationSubject -该 Subject包含委托principal或 null如果认证主要来代替。

结果

一个ObjectInstance ，包含新近实例化的MBean的ObjectName和Java类名。 如果包含的ObjectName是n ，则包含的Java类名称为getMBeanInfo(n).getClassName() 。

异常

ReflectionException - 包装一个 java.lang.ClassNotFoundException或 java.lang.Exception ，当尝试调用MBean的构造函数时。

InstanceAlreadyExistsException - MBean已经在MBean服务器的控制之下了。

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

MBeanException - MBean的构造函数已经抛出异常。

NotCompliantMBeanException - 此类不是符合JMX的MBean。

IOException - 如果发生一般通信异常。

createMBean

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

说明从界面复制： RMIConnection

处理方法 MBeanServerConnection.createMBean(String, ObjectName, ObjectName) 。

Specified by:

createMBean在接口 RMIConnection

参数

className - 要实例化的MBean的类名。

name - MBean的对象名称。 可能为null。

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

delegationSubject -该 Subject包含委托principal或 null如果认证主要来代替。

结果

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

异常

ReflectionException - 包装一个 java.lang.ClassNotFoundException或 java.lang.Exception ，当尝试调用MBean的构造函数时发生。

InstanceAlreadyExistsException - MBean已经在MBean服务器的控制之下了。

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

MBeanException - MBean的构造函数已经抛出异常。

NotCompliantMBeanException - 此类不是符合JMX的MBean。

InstanceNotFoundException - 指定的类加载器未在MBean服务器中注册。

IOException - 如果发生一般通信异常。

createMBean

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

说明从接口RMIConnection复制

处理方法MBeanServerConnection.createMBean(String, ObjectName, Object[], String[]) 。 Object[]参数包裹在一个MarshalledObject 。

Specified by:

createMBean在接口 RMIConnection

参数

className - 要实例化的MBean的类名。

name - MBean的对象名称。 可能为null。

params - 包含要调用的构造函数的参数的数组，封装在一个MarshalledObject 。 封装的数组可以为空，相当于一个空数组。

signature - 包含要调用的构造函数的签名的数组。 可以为null，相当于一个空数组。

delegationSubject -该 Subject包含委托principal或 null如果认证主要来代替。

结果

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

异常

ReflectionException - 包装一个 java.lang.ClassNotFoundException或 java.lang.Exception ，当尝试调用MBean的构造函数时发生。

InstanceAlreadyExistsException - MBean已经在MBean服务器的控制之下。

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

MBeanException - MBean的构造函数已经抛出异常。

NotCompliantMBeanException - 此类不是符合JMX的MBean。

IOException - 如果发生通用通信异常。

createMBean

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

说明从接口RMIConnection复制

处理方法MBeanServerConnection.createMBean(String, ObjectName, ObjectName, Object[], String[]) 。 Object[]参数包裹在一个MarshalledObject 。

Specified by:

createMBean在接口 RMIConnection

参数

className - 要实例化的MBean的类名。

name - MBean的对象名称。 可能为null。

loaderName - 要使用的类加载器的对象名称。

params - 包含要调用的构造函数的参数的数组，封装到一个MarshalledObject 。 封装的数组可以为空，相当于一个空数组。

signature - 包含要调用的构造函数的签名的数组。 可以为null，相当于一个空数组。

delegationSubject -该 Subject包含委托principal或 null如果认证主要来代替。

结果

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

异常

ReflectionException - 包装一个 java.lang.ClassNotFoundException或 java.lang.Exception ，当尝试调用MBean的构造函数时。

InstanceAlreadyExistsException - MBean已经在MBean服务器的控制之下了。

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

MBeanException - MBean的构造函数抛出异常。

NotCompliantMBeanException - 此类不是符合JMX的MBean。

InstanceNotFoundException - 指定的类加载器未在MBean服务器中注册。

IOException - 如果发生通用通信异常。

unregisterMBean

public void unregisterMBean(ObjectName name,
                            Subject delegationSubject)
                     throws InstanceNotFoundException,
                            MBeanRegistrationException,
                            IOException

说明从界面RMIConnection复制

处理方法 MBeanServerConnection.unregisterMBean(ObjectName) 。

Specified by:

unregisterMBean在接口 RMIConnection

参数

name - 要注销的MBean的对象名称。

delegationSubject -该 Subject包含委托principal或 null如果认证主要来代替。

异常

InstanceNotFoundException - 指定的MBean未在MBean服务器中注册。

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

IOException - 如果发生通用通信异常。

getObjectInstance

public ObjectInstance getObjectInstance(ObjectName name,
                                        Subject delegationSubject)
                                 throws InstanceNotFoundException,
                                        IOException

说明从接口RMIConnection复制

处理方法 MBeanServerConnection.getObjectInstance(ObjectName) 。

Specified by:

getObjectInstance在接口 RMIConnection

参数

name - MBean的对象名称。

delegationSubject -该 Subject包含委托principal或 null如果认证主要来代替。

结果

与名称指定的MBean相关联的ObjectInstance 。 包含的ObjectName是name ，包含的类名是getMBeanInfo(name).getClassName() 。

异常

InstanceNotFoundException - 指定的MBean未在MBean服务器中注册。

IOException - 如果发生一般通信异常。

queryMBeans

public Set<ObjectInstance> queryMBeans(ObjectName name,
                                       MarshalledObject query,
                                       Subject delegationSubject)
                                throws IOException

描述从接口RMIConnection复制

处理方法MBeanServerConnection.queryMBeans(ObjectName, QueryExp) 。 QueryExp包裹在一个MarshalledObject 。

Specified by:

queryMBeans在接口 RMIConnection

参数

name - 标识要检索的MBean的对象名称模式。 如果指定了null或没有域和密钥属性，则将检索注册的所有MBean。

query - 要应用于选择MBean的查询表达式，封装在MarshalledObject 。 如果MarshalledObject封装了一个空值，则不会使用查询表达式来选择MBean。

delegationSubject -该 Subject包含委托principal或 null如果认证主要来代替。

结果

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

异常

IOException - 如果发生通用通信异常。

queryNames

public Set<ObjectName> queryNames(ObjectName name,
                                  MarshalledObject query,
                                  Subject delegationSubject)
                           throws IOException

描述从接口RMIConnection复制

处理方法MBeanServerConnection.queryNames(ObjectName, QueryExp) 。 QueryExp包裹在一个MarshalledObject 。

Specified by:

queryNames在接口 RMIConnection

参数

name - 标识要检索的MBean名称的对象名称模式。 如果指定了null或没有域和键属性，将检索所有注册的MBean的名称。

query - 要应用于选择MBean的查询表达式，封装在MarshalledObject 。 如果MarshalledObject封装了空值，则不会使用查询表达式来选择MBean。

delegationSubject -该 Subject包含委托principal或 null如果认证主要来代替。

结果

包含所选MBean的ObjectName的集合。 如果没有MBean满足查询，则返回一个空列表。

异常

IOException - 如果发生一般通信异常。

isRegistered

public boolean isRegistered(ObjectName name,
                            Subject delegationSubject)
                     throws IOException

描述从界面RMIConnection复制

处理方法 MBeanServerConnection.isRegistered(ObjectName) 。

Specified by:

isRegistered在接口 RMIConnection

参数

name - 要检查的MBean的对象名称。

delegationSubject -该 Subject包含委托principal或 null如果认证主要来代替。

结果

如果MBean已经在MBean服务器中注册，则为true，否则为false。

异常

IOException - 如果发生一般通信异常。

getMBeanCount

public Integer getMBeanCount(Subject delegationSubject)
                      throws IOException

描述从接口RMIConnection复制

处理方法 MBeanServerConnection.getMBeanCount() 。

Specified by:

getMBeanCount在接口 RMIConnection

参数

delegationSubject -该 Subject包含委托principal或 null如果认证主要来代替。

结果

注册的MBean的数量。

异常

IOException - 如果发生一般通信异常。

getAttribute

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

描述从接口RMIConnection复制

处理方法 MBeanServerConnection.getAttribute(ObjectName, String) 。

Specified by:

getAttribute在接口 RMIConnection

参数

name - 要从中检索属性的MBean的对象名称。

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

delegationSubject -该 Subject包含委托principal或 null如果认证主要来代替。

结果

检索属性的值。

异常

MBeanException - 包装MBean的getter抛出的异常。

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

InstanceNotFoundException - 指定的MBean未在MBean服务器中注册。

ReflectionException - 包裹一个 java.lang.Exception在尝试调用吸气剂时抛出。

IOException - 如果发生一般通信异常。

另请参见：

RMIConnection.setAttribute(javax.management.ObjectName, java.rmi.MarshalledObject, javax.security.auth.Subject)

getAttributes

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

描述从接口RMIConnection复制

处理方法 MBeanServerConnection.getAttributes(ObjectName, String[]) 。

Specified by:

getAttributes在接口 RMIConnection

参数

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

attributes - 要检索的属性的列表。

delegationSubject -该 Subject包含委托principal或 null如果认证主要来代替。

结果

检索属性的列表。

异常

InstanceNotFoundException - 指定的MBean未在MBean服务器中注册。

ReflectionException - 尝试调用动态MBean的getAttributes方法时发生异常。

IOException - 如果发生一般通信异常。

另请参见：

RMIConnection.setAttributes(javax.management.ObjectName, java.rmi.MarshalledObject, javax.security.auth.Subject)

setAttribute

public void setAttribute(ObjectName name,
                         MarshalledObject attribute,
                         Subject delegationSubject)
                  throws InstanceNotFoundException,
                         AttributeNotFoundException,
                         InvalidAttributeValueException,
                         MBeanException,
                         ReflectionException,
                         IOException

说明从接口RMIConnection复制

处理方法MBeanServerConnection.setAttribute(ObjectName, Attribute) 。 Attribute参数包裹在一个MarshalledObject 。

Specified by:

setAttribute在接口 RMIConnection

参数

name - 要在其中设置属性的MBean的名称。

attribute - 要设置的属性的标识和要设置的值，封装在 MarshalledObject 。

delegationSubject -该 Subject包含委托principal或 null如果认证主要来代替。

异常

InstanceNotFoundException - 指定的MBean未在MBean服务器中注册。

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

InvalidAttributeValueException - 为属性指定的值无效。

MBeanException - 包装由MBean的setter抛出的异常。

ReflectionException - 在尝试调用setter时，抛出一个 java.lang.Exception 。

IOException - 如果发生一般通信异常。

另请参见：

RMIConnection.getAttribute(javax.management.ObjectName, java.lang.String, javax.security.auth.Subject)

setAttributes

public AttributeList setAttributes(ObjectName name,
                                   MarshalledObject attributes,
                                   Subject delegationSubject)
                            throws InstanceNotFoundException,
                                   ReflectionException,
                                   IOException

说明从界面RMIConnection复制

处理方法MBeanServerConnection.setAttributes(ObjectName, AttributeList) 。 AttributeList参数包裹在一个MarshalledObject 。

Specified by:

setAttributes在接口 RMIConnection

参数

name - 要在其中设置属性的MBean的对象名称。

attributes - 属性列表：要设置的属性的标识以及要设置为的值，封装在 MarshalledObject 。

delegationSubject -该 Subject包含委托principal或 null如果认证主要来代替。

结果

已设置的属性列表及其新值。

异常

InstanceNotFoundException - 指定的MBean未在MBean服务器中注册。

ReflectionException - 尝试调用动态MBean的getAttributes方法时发生异常。

IOException - 如果发生通用通信异常。

另请参见：

RMIConnection.getAttributes(javax.management.ObjectName, java.lang.String[], javax.security.auth.Subject)

invoke

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

描述从接口RMIConnection复制

处理方法MBeanServerConnection.invoke(ObjectName, String, Object[], String[]) 。 Object[]参数包裹在一个MarshalledObject 。

Specified by:

invoke在接口 RMIConnection

参数

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

operationName - 要调用的操作的名称。

params - 包含在调用操作时要设置的参数的数组，封装在一个MarshalledObject 。 封装的数组可以为空，相当于一个空数组。

signature - 包含操作签名的数组。 将使用与用于加载调用操作的MBean相同的类加载器来加载类对象。 可以为null，相当于一个空数组。

delegationSubject -该 Subject包含委托principal或 null如果认证主要来代替。

结果

由操作返回的对象，表示在指定的MBean上调用操作的结果。

异常

InstanceNotFoundException - 指定的MBean未在MBean服务器中注册。

MBeanException - 包装MBean调用方法抛出的异常。

ReflectionException - 在尝试调用该方法时抛出一个 java.lang.Exception 。

IOException - 如果发生通用通信异常。

getDefaultDomain

public String getDefaultDomain(Subject delegationSubject)
                        throws IOException

说明从接口RMIConnection复制

处理方法 MBeanServerConnection.getDefaultDomain() 。

Specified by:

getDefaultDomain在接口 RMIConnection

参数

delegationSubject -该 Subject包含委托principal或 null如果认证主要来代替。

结果

默认域。

异常

IOException - 如果发生通用通信异常。

getDomains

public String[] getDomains(Subject delegationSubject)
                    throws IOException

说明从界面RMIConnection复制

处理方法 MBeanServerConnection.getDomains() 。

Specified by:

getDomains在接口 RMIConnection

参数

delegationSubject -该 Subject包含委托principal或 null如果认证主要来代替。

结果

域列表。

异常

IOException - 如果发生一般通信异常。

getMBeanInfo

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

说明从接口RMIConnection复制

处理方法 MBeanServerConnection.getMBeanInfo(ObjectName) 。

Specified by:

getMBeanInfo接口 RMIConnection

参数

name - 要分析的MBean的名称

delegationSubject -该 Subject包含委托principal或 null如果认证主要来代替。

结果

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

异常

InstanceNotFoundException - 未找到指定的MBean。

IntrospectionException - 内省时发生异常。

ReflectionException - 尝试调用动态MBean的getMBeanInfo时发生异常。

IOException - 如果发生通用通信异常。

isInstanceOf

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

说明从接口RMIConnection复制

处理方法 MBeanServerConnection.isInstanceOf(ObjectName, String) 。

Specified by:

isInstanceOf在接口 RMIConnection

参数

name - MBean的 ObjectName 。

className - 类的名称。

delegationSubject -该 Subject包含委托principal或 null如果认证主要来代替。

结果

如果指定的MBean是根据上述规则的指定类的实例，则为true，否则为false。

异常

InstanceNotFoundException - 指定的MBean未在MBean服务器中注册。

IOException - 如果发生一般通信异常。

addNotificationListeners

public Integer[] addNotificationListeners(ObjectName[] names,
                                          MarshalledObject[] filters,
                                          Subject[] delegationSubjects)
                                   throws InstanceNotFoundException,
                                          IOException

描述从接口RMIConnection复制

处理方法MBeanServerConnection.addNotificationListener(ObjectName, NotificationListener, NotificationFilter, Object) 。

注册与给定过滤器匹配的给定MBean的通知。 远程客户端随后可以使用fetchNotifications方法检索通知。

对于每个听众，原始的NotificationListener和handback保留在客户端; 为了使客户端能够识别它们，服务器生成并返回唯一的listenerID 。 该listenerID与Notifications一起转发给远程客户端。

如果给定（名称，过滤器）对中的任何一个无法注册，则操作将失败并发生异常，并且不会注册名称或过滤器。

Specified by:

addNotificationListeners在接口 RMIConnection

参数

names - ObjectNames标识发布通知的MBean。

filters -所述的编组表示的阵列NotificationFilters 。 此数组的元素可以为空。

delegationSubjects - 代表正在添加的收听者的Subjects 。 此数组的元素可以为空。 此外， delegationSubjects参数本身可以为空，这相当于与names和filters数组大小相同的空值数组。

结果

一个listenerIDs的数组， listenerIDs标识本地侦听器。 该数组与参数的元素数量相同。

异常

InstanceNotFoundException - 如果 names中的一个与任何注册的MBean不对应。

IOException - 如果发生通用通信异常。

addNotificationListener

public void addNotificationListener(ObjectName name,
                                    ObjectName listener,
                                    MarshalledObject filter,
                                    MarshalledObject handback,
                                    Subject delegationSubject)
                             throws InstanceNotFoundException,
                                    IOException

描述从接口RMIConnection复制

处理方法MBeanServerConnection.addNotificationListener(ObjectName, ObjectName, NotificationFilter, Object) 。 NotificationFilter参数包裹在一个MarshalledObject 。 Object （handback）参数也包裹在一个MarshalledObject 。

Specified by:

addNotificationListener在接口 RMIConnection

参数

name - 应该添加侦听器的MBean的名称。

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

filter - 过滤器对象，封装成MarshalledObject 。 如果封装在MarshalledObject中的过滤MarshalledObject值，则在处理通知之前不会执行过滤。

handback - 发送通知时发送到侦听器的上下文，封装在 MarshalledObject 。

delegationSubject -该 Subject包含委托principal或 null如果认证主要来代替。

异常

InstanceNotFoundException - 通知侦听器或通知广播者的MBean名称与任何已注册的MBean不匹配。

IOException - 如果发生一般通信异常。

另请参见：

RMIConnection.removeNotificationListener(ObjectName, ObjectName, Subject) ， RMIConnection.removeNotificationListener(ObjectName, ObjectName, MarshalledObject, MarshalledObject, Subject)

removeNotificationListeners

public void removeNotificationListeners(ObjectName name,
                                        Integer[] listenerIDs,
                                        Subject delegationSubject)
                                 throws InstanceNotFoundException,
                                        ListenerNotFoundException,
                                        IOException

描述从接口RMIConnection复制

处理removeNotificationListener(ObjectName, NotificationListener)和removeNotificationListener(ObjectName, NotificationListener, NotificationFilter, Object)方法。

此方法从MBean服务器中的给定MBean中删除一个或多个NotificationListener 。

NotificationListeners由RMIConnection.addNotificationListeners(ObjectName[], MarshalledObject[], Subject[])方法返回的ID标识。

Specified by:

removeNotificationListeners在接口 RMIConnection

参数

name - ObjectName标识发布通知的MBean。

listenerIDs - 与要删除的侦听器相对应的ID的列表。

delegationSubject -该 Subject包含委托principal或 null如果认证主要来代替。

异常

InstanceNotFoundException - 如果给定的 name不对应于任何注册的MBean。

ListenerNotFoundException - 如果在服务器端没有找到其中一个侦听器。 如果MBean因为MBeanServer.removeNotificationListener的调用以外的某些原因丢弃了一个监听器，则可能会发生此异常。

IOException - 如果发生一般通信异常。

removeNotificationListener

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

说明从接口RMIConnection复制

处理方法 MBeanServerConnection.removeNotificationListener(ObjectName, ObjectName) 。

Specified by:

removeNotificationListener在接口 RMIConnection

参数

name - 应删除侦听器的MBean的名称。

listener - 要删除的侦听器的对象名称。

delegationSubject -该 Subject包含委托principal或 null如果认证主要来代替。

异常

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

ListenerNotFoundException - 监听器未在MBean中注册。

IOException - 如果发生通用通信异常。

另请参见：

RMIConnection.addNotificationListener(javax.management.ObjectName, javax.management.ObjectName, java.rmi.MarshalledObject, java.rmi.MarshalledObject, javax.security.auth.Subject)

removeNotificationListener

public void removeNotificationListener(ObjectName name,
                                       ObjectName listener,
                                       MarshalledObject filter,
                                       MarshalledObject handback,
                                       Subject delegationSubject)
                                throws InstanceNotFoundException,
                                       ListenerNotFoundException,
                                       IOException

描述从接口RMIConnection复制

处理方法MBeanServerConnection.removeNotificationListener(ObjectName, ObjectName, NotificationFilter, Object) 。 NotificationFilter参数包裹在一个MarshalledObject 。 Object参数也包裹在一个MarshalledObject 。

Specified by:

removeNotificationListener在接口 RMIConnection

参数

name - 应删除侦听器的MBean的名称。

listener - 以前添加到此MBean的侦听器。

filter - 添加侦听器时指定的过滤器，封装在 MarshalledObject 。

handback - 添加侦听器时指定的 MarshalledObject ，封装在 MarshalledObject 。

delegationSubject -该 Subject包含委托principal或 null如果认证主要来代替。

异常

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

ListenerNotFoundException - 侦听器未在MBean中注册，或者未注册给定的过滤器和回传。

IOException - 如果发生一般通信异常。

另请参见：

RMIConnection.addNotificationListener(javax.management.ObjectName, javax.management.ObjectName, java.rmi.MarshalledObject, java.rmi.MarshalledObject, javax.security.auth.Subject)

fetchNotifications

public NotificationResult fetchNotifications(long clientSequenceNumber,
                                             int maxNotifications,
                                             long timeout)
                                      throws IOException

描述从接口RMIConnection复制

从连接器服务器检索通知。 此方法可以阻止，直到有至少一个通知或直到达到指定的超时。 该方法也可以随时返回零通知。

如果序列号不小于clientSequenceNumber并且该客户端已经为生成通知的MBean注册了至少一个监听器，则该结果可以包含在结果中，并且接收该通知的过滤器。 对通知感兴趣的每个监听器由RMIConnection.addNotificationListeners(ObjectName[], MarshalledObject[], Subject[])返回的整数ID标识。

Specified by:

fetchNotifications在接口 RMIConnection

参数

clientSequenceNumber - 客户端感兴趣的第一个序列号。如果为负，则将其解释为下一个通知将具有的序列号。

maxNotifications - 返回的不同通知的最大数量。 返回的NotificationResult的TargetedNotification阵列可以具有比此更多的元素，如果同一通知出现多次。 如果此参数为负，则该行为是未指定的。

timeout - 等待通知到达的最长时间（以毫秒为单位）。 这可以是0表示方法不应该等待，如果没有通知，但应该立即返回。 可以是Long.MAX_VALUE表示没有超时。 如果此参数为负，则该行为是未指定的。

结果

A NotificationResult 。

异常

IOException - 如果发生一般通信异常。

toString

public String toString()

返回此对象的字符串表示形式。 一般来说， toString方法返回一个“ toString代表”这个对象的字符串。 结果应该是一个简明扼要的表达，容易让人阅读。

重写：

toString在 Object

结果

a String representation of this object.