当前页面: 在线文档首页 > JavaTM 2 Platform Standard Edition 5.0 API 规范中文版
javax.management.remote.rmi
提交错误或意见
有关更多的 API 参考资料和开发人员文档，请参阅 Java 2 SDK SE 开发人员文档。该文档包含更详细的、面向开发人员的描述，以及总体概述、术语定义、使用技巧和工作代码示例。
RMIConnection (Java 2 Platform SE 5.0) - JavaTM 2 Platform Standard Edition 5.0 API 规范中文版
|
JavaTM 2 Platform Standard Ed. 5.0 |
|||||||||
| 上一个类 下一个类 | 框架 无框架 | |||||||||
| 摘要： 嵌套 | 字段 | 构造方法 | 方法 | 详细信息： 字段 | 构造方法 | 方法 | |||||||||
javax.management.remote.rmi
接口 RMIConnection
- 所有超级接口：
- Remote
- 所有已知实现类：
- RMIConnectionImpl, RMIConnectionImpl_Stub
public interface RMIConnection
- extends Remote
RMI 对象，用于将 MBeanServer 请求从客户端转发到其位于服务器端的 MBeanServer 实现。连接到 RMI 连接器的每个远程客户端都有一个实现此接口的 Remote 对象。
用户代码不经常引用此接口。它作为公用 API 的一部分指定，便于该 API 的不同实现之间实现互操作。
为确保用正确的类加载器将客户端参数在服务器端反序列化，客户端参数（例如，用于调用方法的参数）包装在 MarshalledObject 方法中。此接口的实现必须首先获得适用于操作及其目标的适当的类加载器，然后用该类加载器反序列化编组的参数。除非另外说明，MarshalledObject 或 MarshalledObject[] 类型的参数必定不为 null；如果参数为 null，则行为不明确。
有关类加载的内容在辅助文档 JMX Remote API 进行了详细的描述，它是对本文档的补充。本 Javadoc 规范所在的位置应包含它的 PDF 文档。
- 从以下版本开始：
- 1.5
| 方法详细信息 |
|---|
getConnectionId
String getConnectionId() throws IOException
返回连接 ID。对于每个到给定的 RMI 连接器服务器的开放连接，此字符串都不相同。
- 返回：
- 连接 ID
- 抛出：
IOException- 如果出现通用通信异常。- 另请参见：
RMIConnector.connect
close
void close()
throws IOException
关闭此连接。从此方法返回时，不导出实现此接口的 RMI 对象，因此对它的进一步远程调用将失败。
- 抛出：
IOException- 如果无法关闭连接，或 Remote 对象无法被导出，或者在传输远程关闭请求时出现通信故障。
createMBean
ObjectInstance createMBean(String className, ObjectName name, Subject delegationSubject) throws ReflectionException, InstanceAlreadyExistsException, MBeanRegistrationException, MBeanException, NotCompliantMBeanException, IOException
- 处理
MBeanServerConnection.createMBean(String, ObjectName)方法。- 参数：
className- 要实例化的 MBean 的类名称。name- MBean 的对象名。可以为 null。delegationSubject- 包含委托 principal 的Subject，如果使用了验证 principal，则为null。- 返回：
ObjectInstance，它包含新实例化的 MBean 的ObjectName和 Java 类名。如果所包含的ObjectName为n，则所包含的 Java 类名为getMBeanInfo(n).getClassName()- 抛出：
ReflectionException- 在尝试调用 MBean 的构造方法的过程中出现的、包装了java.lang.ClassNotFoundException或java.lang.Exception的异常。InstanceAlreadyExistsException- MBean 已处于 MBean 服务器的控制之下。MBeanRegistrationException- MBean 的preRegister（MBeanRegistration接口）方法已抛出异常。不对 MBean 进行注册。MBeanException- MBean 的构造方法已抛出异常。NotCompliantMBeanException- 该类不是一个遵守 JMX 的 MBean。RuntimeOperationsException- 包装了java.lang.IllegalArgumentException：className 传入的参数为 null，ObjectName传入的参数包含模式或未为 MBean 指定任何ObjectName。SecurityException- 如果客户端或委托的 Subject（如果有）没有执行此操作的权限。IOException- 如果出现通用通信异常。
createMBean
ObjectInstance createMBean(String className, ObjectName name, ObjectName loaderName, Subject delegationSubject) throws ReflectionException, InstanceAlreadyExistsException, MBeanRegistrationException, MBeanException, NotCompliantMBeanException, InstanceNotFoundException, IOException
- 处理
MBeanServerConnection.createMBean(String, ObjectName, ObjectName)方法。- 参数：
className- 要实例化的 MBean 的类名称。name- MBean 的对象名。可以为 null。loaderName- 要使用的类加载器的对象名。delegationSubject- 包含委托 principal 的Subject，如果使用了验证 principal，则为null。- 返回：
ObjectInstance，它包含新实例化的 MBean 的ObjectName和 Java 类名。如果所包含的ObjectName为n，则所包含的 Java 类名为getMBeanInfo(n).getClassName()- 抛出：
ReflectionException- 在尝试调用 MBean 的构造方法的过程中出现的、包装了java.lang.ClassNotFoundException或java.lang.Exception的异常。InstanceAlreadyExistsException- MBean 已处于 MBean 服务器的控制之下。MBeanRegistrationException- MBean 的preRegister（MBeanRegistration接口）方法已抛出异常。不对 MBean 进行注册。MBeanException- MBean 的构造方法已抛出异常。NotCompliantMBeanException- 该类不是一个遵守 JMX 的 MBean。InstanceNotFoundException- 指定的类加载器未在 MBean 服务器中注册。RuntimeOperationsException- 包装了java.lang.IllegalArgumentException：className 传入的参数为 null，ObjectName传入的参数包含模式或未为 MBean 指定任何ObjectName。SecurityException- 如果客户端或委托的 Subject（如果有）没有执行此操作的权限。IOException- 如果出现通用通信异常。
createMBean
ObjectInstance createMBean(String className, ObjectName name, MarshalledObject params, String[] signature, Subject delegationSubject) throws ReflectionException, InstanceAlreadyExistsException, MBeanRegistrationException, MBeanException, NotCompliantMBeanException, IOException
- 处理
MBeanServerConnection.createMBean(String, ObjectName, Object[], String[])方法。Object[]参数包装在MarshalledObject中。- 参数：
className- 要实例化的 MBean 的类名称。name- MBean 的对象名。可以为 null。params- 包含要调用的构造方法的参数的数组，数组封装在MarshalledObject中。封装的数组可以为 null，其等效于一个空数组。signature- 包含要调用的构造方法的签名的数组。可以为 null，等效于一个空数组。delegationSubject- 包含委托 principal 的Subject，如果使用了验证 principal，则为null。- 返回：
ObjectInstance，它包含新实例化的 MBean 的ObjectName和 Java 类名。如果所包含的ObjectName为n，则所包含的 Java 类名为getMBeanInfo(n).getClassName()- 抛出：
ReflectionException- 在尝试调用 MBean 的构造方法的过程中出现的、包装了java.lang.ClassNotFoundException或java.lang.Exception的异常。InstanceAlreadyExistsException- MBean 已处于 MBean 服务器的控制之下。MBeanRegistrationException- MBean 的preRegister（MBeanRegistration接口）方法已抛出异常。不对 MBean 进行注册。MBeanException- MBean 的构造方法已抛出异常。NotCompliantMBeanException- 该类不是一个遵守 JMX 的 MBean。RuntimeOperationsException- 包装了java.lang.IllegalArgumentException：className 传入的参数为 null，ObjectName传入的参数包含一个模式，或未为 MBean 指定任何ObjectName。SecurityException- 如果客户端或委托的 Subject（如果有）没有执行此操作的权限。IOException- 如果出现通用通信异常。
createMBean
ObjectInstance createMBean(String className, ObjectName name, ObjectName loaderName, MarshalledObject params, String[] signature, Subject delegationSubject) throws ReflectionException, InstanceAlreadyExistsException, MBeanRegistrationException, MBeanException, NotCompliantMBeanException, InstanceNotFoundException, IOException
- 处理
MBeanServerConnection.createMBean(String, ObjectName, ObjectName, Object[], String[])方法。Object[]参数包装在MarshalledObject中。- 参数：
className- 要实例化的 MBean 的类名称。name- MBean 的对象名。可以为 null。loaderName- 要使用的类加载器的对象名。params- 包含要调用的构造方法的参数的数组，数组封装在MarshalledObject中。封装的数组可以为 null，其等效于一个空数组。signature- 包含要调用的构造方法的签名的数组。可以为 null，等效于一个空数组。delegationSubject- 包含委托 principal 的Subject，如果使用了验证 principal，则为null。- 返回：
ObjectInstance，它包含新实例化的 MBean 的ObjectName和 Java 类名。如果所包含的ObjectName为n，则所包含的 Java 类名为getMBeanInfo(n).getClassName()- 抛出：
ReflectionException- 在尝试调用 MBean 的构造方法的过程中出现的、包装了java.lang.ClassNotFoundException或java.lang.Exception的异常。InstanceAlreadyExistsException- MBean 已处于 MBean 服务器的控制之下。MBeanRegistrationException- MBean 的preRegister（MBeanRegistration接口）方法已抛出异常。不对 MBean 进行注册。MBeanException- MBean 的构造方法已抛出异常。NotCompliantMBeanException- 该类不是一个遵守 JMX 的 MBean。InstanceNotFoundException- 指定的类加载器未在 MBean 服务器中注册。RuntimeOperationsException- 包装了java.lang.IllegalArgumentException：className 传入的参数为 null，ObjectName传入的参数包含一个模式，或未为 MBean 指定任何ObjectName。SecurityException- 如果客户端或委托的 Subject（如果有）没有执行此操作的权限。IOException- 如果出现通用通信异常。
unregisterMBean
void unregisterMBean(ObjectName name, Subject delegationSubject) throws InstanceNotFoundException, MBeanRegistrationException, IOException
- 处理
MBeanServerConnection.unregisterMBean(ObjectName)方法。- 参数：
name- 要注册的 MBean 的对象名。delegationSubject- 包含委托 principal 的Subject，如果使用了验证 principal，则为null。- 抛出：
InstanceNotFoundException- 指定的 MBean 未在 MBean 服务器中注册。MBeanRegistrationException- MBean 的 preDeregister （MBeanRegistration接口）方法已抛出异常。RuntimeOperationsException- 包装了java.lang.IllegalArgumentException：参数中的对象名为 null 或您尝试注销的 MBean 为MBeanServerDelegateMBean。SecurityException- 如果客户端或委托的 Subject（如果有）没有执行此操作的权限。IOException- 如果出现通用通信异常。
getObjectInstance
ObjectInstance getObjectInstance(ObjectName name, Subject delegationSubject) throws InstanceNotFoundException, IOException
- 处理
MBeanServerConnection.getObjectInstance(ObjectName)方法。- 参数：
name- MBean 的对象名。delegationSubject- 包含委托 principal 的Subject，如果使用了验证 principal，则为null。- 返回：
- 由 name 指定的与 MBean 关联的
ObjectInstance。所包含的ObjectName为name，所包含的类名称为getMBeanInfo(name).getClassName() - 抛出：
InstanceNotFoundException- 指定的 MBean 未在 MBean 服务器中注册。RuntimeOperationsException- 包装了java.lang.IllegalArgumentException：参数中的对象名为 null。SecurityException- 如果客户端或委托的 Subject（如果有）没有执行此操作的权限。IOException- 如果出现通用通信异常。
queryMBeans
Set<ObjectInstance> queryMBeans(ObjectName name, MarshalledObject query, Subject delegationSubject) throws IOException
- 处理
MBeanServerConnection.queryMBeans(ObjectName, QueryExp)方法。QueryExp包装在MarshalledObject中。- 参数：
name- 标识要检索的 MBean 的对象名模式。如果指定了 null 或未指定任何域或关键字属性，则将检索所有已注册的 MBean。query- 用于选择 MBean 的查询表达式，它封装在MarshalledObject中。如果MarshalledObject封装了一个 null 值，则选择 MBean 时不使用任何查询表达式。delegationSubject- 包含委托 principal 的Subject，如果使用了验证 principal，则为null。- 返回：
- 包含选定 MBean 的
ObjectInstance对象集。如果没有任何 MBean 满足此查询，则返回一个空列表。 - 抛出：
SecurityException- 如果客户端或委托的 Subject（如果有）没有执行此操作的权限。IOException- 如果出现通用通信异常。
queryNames
Set<ObjectName> queryNames(ObjectName name, MarshalledObject query, Subject delegationSubject) throws IOException
- 处理
MBeanServerConnection.queryNames(ObjectName, QueryExp)方法。QueryExp包装在MarshalledObject中。- 参数：
name- 标识要检索的 MBean 名称的对象名模式。如果指定了 null 或未指定任何域或关键字属性，则将检索所有已注册的 MBean 的名称。query- 用于选择 MBean 的查询表达式，它封装在MarshalledObject中。如果MarshalledObject封装了一个 null 值，则选择 MBean 时不使用任何查询表达式。delegationSubject- 包含委托 principal 的Subject，如果使用了验证 principal，则为null。- 返回：
- 包含选定的 MBean 的 ObjectName 集。如果没有任何 MBean 满足此查询，则返回一个空列表。
- 抛出：
SecurityException- 如果客户端或委托的 Subject（如果有）没有执行此操作的权限。IOException- 如果出现通用通信异常。
isRegistered
boolean isRegistered(ObjectName name, Subject delegationSubject) throws IOException
- 处理
MBeanServerConnection.isRegistered(ObjectName)方法。- 参数：
name- 要检查的 MBean 的对象名。delegationSubject- 包含委托 principal 的Subject，如果使用了验证 principal，则为null。- 返回：
- True 如果 MBean 已在 MBean 服务器上注册，否则返回 false。
- 抛出：
RuntimeOperationsException- 包装了java.lang.IllegalArgumentException：参数中的对象名为 null。SecurityException- 如果客户端或委托的 Subject（如果有）没有执行此操作的权限。IOException- 如果出现通用通信异常。
getMBeanCount
Integer getMBeanCount(Subject delegationSubject) throws IOException
- 处理
MBeanServerConnection.getMBeanCount()方法。- 参数：
delegationSubject- 包含委托 principal 的Subject，如果使用了验证 principal，则为null。- 返回：
- 已注册的 MBean 数。
- 抛出：
SecurityException- 如果客户端或委托的 Subject（如果有）没有执行此操作的权限。IOException- 如果出现通用通信异常。
getAttribute
Object getAttribute(ObjectName name, String attribute, Subject delegationSubject) throws MBeanException, AttributeNotFoundException, InstanceNotFoundException, ReflectionException, IOException
- 处理
MBeanServerConnection.getAttribute(ObjectName, String)方法。- 参数：
name- 将要从其检索属性的 MBean 的对象名。attribute- 指定要检索的属性名称的字符串。delegationSubject- 包含委托 principal 的Subject，如果使用了验证 principal，则为null。- 返回：
- 检索到的属性的值。
- 抛出：
AttributeNotFoundException- 指定的属性在 MBean 中无法访问。MBeanException- 包装了由 MBean 的 getter 方法抛出的异常。InstanceNotFoundException- 指定的 MBean 未在 MBean 服务器中注册。ReflectionException- 包装了尝试调用 getter 方法时抛出的java.lang.Exception。RuntimeOperationsException- 包装了java.lang.IllegalArgumentException：参数中的对象名为 null，或参数中的属性为 null。RuntimeMBeanException- 包装了由 MBean 的 getter 方法抛出的运行时异常。SecurityException- 如果客户端或委托的 Subject（如果有）没有执行此操作的权限。IOException- 如果出现通用通信异常。- 另请参见：
setAttribute(javax.management.ObjectName, java.rmi.MarshalledObject, javax.security.auth.Subject)
getAttributes
AttributeList getAttributes(ObjectName name, String[] attributes, Subject delegationSubject) throws InstanceNotFoundException, ReflectionException, IOException
- 处理
MBeanServerConnection.getAttributes(ObjectName, String[])方法。- 参数：
name- 从其检索属性的 MBean 的对象名。attributes- 要检索的属性的列表。delegationSubject- 包含委托 principal 的Subject，如果使用了验证 principal，则为null。- 返回：
- 所检索的属性的列表。
- 抛出：
InstanceNotFoundException- 指定的 MBean 未在 MBean 服务器中注册。ReflectionException- 尝试调用 Dynamic MBean 的 getAttributes 方法时出现的异常。RuntimeOperationsException- 包装了java.lang.IllegalArgumentException：参数中的对象名为 null，或参数中的属性为 null。SecurityException- 如果客户端或委托的 Subject（如果有）没有执行此操作的权限。IOException- 如果出现通用通信异常。- 另请参见：
setAttributes(javax.management.ObjectName, java.rmi.MarshalledObject, javax.security.auth.Subject)
setAttribute
void setAttribute(ObjectName name, MarshalledObject attribute, Subject delegationSubject) throws InstanceNotFoundException, AttributeNotFoundException, InvalidAttributeValueException, MBeanException, ReflectionException, IOException
- 处理
MBeanServerConnection.setAttribute(ObjectName, Attribute)方法。Attribute参数包装在MarshalledObject中。- 参数：
name- 在其中设置属性的 MBean 的名称。attribute- 要设置的属性的标识及要设置的值，封装在MarshalledObject中。delegationSubject- 包含委托 principal 的Subject，如果使用了验证 principal，则为null。- 抛出：
InstanceNotFoundException- 指定的 MBean 未在 MBean 服务器中注册。AttributeNotFoundException- 指定的属性在 MBean 中无法访问。InvalidAttributeValueException- 为属性指定的值无效。MBeanException- 包装了由 MBean 的设置方法抛出的异常。ReflectionException- 包装了尝试调用设置方法时抛出的java.lang.Exception。RuntimeOperationsException- 包装了java.lang.IllegalArgumentException：参数中的对象名为 null，或参数中的属性为 null。SecurityException- 如果客户端或委托的 Subject（如果有）没有执行此操作的权限。IOException- 如果出现通用通信异常。- 另请参见：
getAttribute(javax.management.ObjectName, java.lang.String, javax.security.auth.Subject)
setAttributes
AttributeList setAttributes(ObjectName name, MarshalledObject attributes, Subject delegationSubject) throws InstanceNotFoundException, ReflectionException, IOException
- 处理
MBeanServerConnection.setAttributes(ObjectName, AttributeList)方法。AttributeList参数包装在MarshalledObject中。- 参数：
name- 要在其中设置属性的 MBean 的对象名。attributes- 属性列表：要设置的属性的标识及要设置的值，封装在MarshalledObject中。delegationSubject- 包含委托 principal 的Subject，如果使用了验证 principal，则为null。- 返回：
- 原先设置过的带有新值的属性列表。
- 抛出：
InstanceNotFoundException- 指定的 MBean 未在 MBean 服务器中注册。ReflectionException- 尝试调用 Dynamic MBean 的 getAttributes 方法时出现的异常。RuntimeOperationsException- 包装了java.lang.IllegalArgumentException：参数中的对象名为 null，或参数中的属性为 null。SecurityException- 如果客户端或委托的 Subject（如果有）没有执行此操作的权限。IOException- 如果出现通用通信异常。- 另请参见：
getAttributes(javax.management.ObjectName, java.lang.String[], javax.security.auth.Subject)
invoke
Object invoke(ObjectName name, String operationName, MarshalledObject params, String[] signature, Subject delegationSubject) throws InstanceNotFoundException, MBeanException, ReflectionException, IOException
- 处理
MBeanServerConnection.invoke(ObjectName, String, Object[], String[])方法。Object[]参数包装在MarshalledObject中。- 参数：
name- 将在其上调用此方法的 MBean 的对象名。operationName- 要调用的操作的名称。params- 包含调用操作时将设置的参数的数组，它封装在MarshalledObject中。封装的数组可以为 null，其等效于一个空数组。signature- 包含操作的签名的数组。该类对象将使用与加载在其上调用了操作的 MBean 过程中所用的相同的类加载器加载。可以为 null，等效于一个空数组。delegationSubject- 包含委托 principal 的Subject，如果使用了验证 principal，则为null。- 返回：
- 操作返回的对象，它代表在指定的 MBean 上调用操作的结果。
- 抛出：
InstanceNotFoundException- 指定的 MBean 未在 MBean 服务器中注册。MBeanException- 包装了由 MBean 的调用的方法抛出的异常。ReflectionException- 包装了尝试调用此方法时抛出的java.lang.Exception。SecurityException- 如果客户端或委托的 Subject（如果有）没有执行此操作的权限。IOException- 如果出现通用通信异常。RuntimeOperationsException- 包装了name或operationName为 null 时抛出的IllegalArgumentException。
getDefaultDomain
String getDefaultDomain(Subject delegationSubject) throws IOException
- 处理
MBeanServerConnection.getDefaultDomain()方法。- 参数：
delegationSubject- 包含委托 principal 的Subject，如果使用了验证 principal，则为null。- 返回：
- 默认的域。
- 抛出：
SecurityException- 如果客户端或委托的 Subject（如果有）没有执行此操作的权限。IOException- 如果出现通用通信异常。
getDomains
String[] getDomains(Subject delegationSubject) throws IOException
- 处理
MBeanServerConnection.getDomains()方法。- 参数：
delegationSubject- 包含委托 principal 的Subject，如果使用了验证 principal，则为null。- 返回：
- 域列表。
- 抛出：
SecurityException- 如果客户端或委托的 Subject（如果有）没有执行此操作的权限。IOException- 如果出现通用通信异常。
getMBeanInfo
MBeanInfo getMBeanInfo(ObjectName name, Subject delegationSubject) throws InstanceNotFoundException, IntrospectionException, ReflectionException, IOException
- 处理
MBeanServerConnection.getMBeanInfo(ObjectName)方法。- 参数：
name- 要分析的 MBean 的名称delegationSubject- 包含委托 principal 的Subject，如果使用了验证委托 principal，则为null。- 返回：
- 允许检索该 MBean 的所有属性和操作的
MBeanInfo的实例。 - 抛出：
IntrospectionException- 自行推算过程中出现的异常。InstanceNotFoundException- 未找到指定的 MBean。ReflectionException- 尝试调用 Dynamic MBean 的 getMBeanInfo 方法时出现的异常。SecurityException- 如果客户端或委托的 Subject（如果有）没有执行此操作的权限。IOException- 如果出现通用通信异常。RuntimeOperationsException- 包装了java.lang.IllegalArgumentException：参数中的对象名为 null。
isInstanceOf
boolean isInstanceOf(ObjectName name, String className, Subject delegationSubject) throws InstanceNotFoundException, IOException
- 处理
MBeanServerConnection.isInstanceOf(ObjectName, String)方法。- 参数：
name- MBean 的ObjectName。className- 类的名称。delegationSubject- 包含委托 principal 的Subject，如果使用了验证 principal，则为null。- 返回：
- 按照上面的规则，如果指定的 MBean 为指定类的实例，则返回 true，否则返回 false。
- 抛出：
InstanceNotFoundException- 指定的 MBean 未在 MBean 服务器中注册。SecurityException- 如果客户端或委托的 Subject（如果有）没有执行此操作的权限。IOException- 如果出现通用通信异常。RuntimeOperationsException- 包装了java.lang.IllegalArgumentException：参数中的对象名为 null。
addNotificationListener
void addNotificationListener(ObjectName name, ObjectName listener, MarshalledObject filter, MarshalledObject handback, Subject delegationSubject) throws InstanceNotFoundException, IOException
- 处理
MBeanServerConnection.addNotificationListener(ObjectName, ObjectName, NotificationFilter, Object)方法。NotificationFilter参数包装在MarshalledObject中。Object(handback) 参数也包装在MarshalledObject中。- 参数：
name- 应在其上添加侦听器的 MBean 的名称。listener- 将处理由已注册的 MBean 发出通知的侦听器的对象名。filter- 过滤器对象，封装在MarshalledObject中。如果封装在MarshalledObject中的过滤器的值为 null，则在对通知处理之前不执行任何过滤。handback- 通知发出时发送到侦听器的上下文，封装在MarshalledObject中。delegationSubject- 包含委托 principal 的Subject，如果使用了验证 principal，则为null。- 抛出：
InstanceNotFoundException- 通知侦听器或通知广播器的 MBean 名称不与注册的任何 MBean 匹配。RuntimeOperationsException- 包装了IllegalArgumentException。存在由listener命名的 MBean，但它并不实现NotificationListener接口，或者name或listener为 null。SecurityException- 如果客户端或委托的 Subject（如果有）没有执行此操作的权限。IOException- 如果出现通用通信异常。- 另请参见：
removeNotificationListener(ObjectName, ObjectName, Subject),removeNotificationListener(ObjectName, ObjectName, MarshalledObject, MarshalledObject, Subject)
removeNotificationListener
void removeNotificationListener(ObjectName name, ObjectName listener, Subject delegationSubject) throws InstanceNotFoundException, ListenerNotFoundException, IOException
- 处理
MBeanServerConnection.removeNotificationListener(ObjectName, ObjectName)方法。- 参数：
name- 应在其上移除侦听器的 MBean 的名称。listener- 要移除的侦听器的对象名。delegationSubject- 包含委托 principal 的Subject，如果使用了验证 principal，则为null。- 抛出：
InstanceNotFoundException- 所提供的 MBean 名称不与任何已注册 MBean 匹配。ListenerNotFoundException- 侦听器未在 MBean 中注册。SecurityException- 如果客户端或委托的 Subject（如果有）没有执行此操作的权限。IOException- 如果出现通用通信异常。RuntimeOperationsException- 当name或listener为 null 时包装了IllegalArgumentException。- 另请参见：
addNotificationListener(javax.management.ObjectName, javax.management.ObjectName, java.rmi.MarshalledObject, java.rmi.MarshalledObject, javax.security.auth.Subject)
removeNotificationListener
void removeNotificationListener(ObjectName name, ObjectName listener, MarshalledObject filter, MarshalledObject handback, Subject delegationSubject) throws InstanceNotFoundException, ListenerNotFoundException, IOException
- 处理
MBeanServerConnection.removeNotificationListener(ObjectName, ObjectName, NotificationFilter, Object)方法。NotificationFilter参数包装在MarshalledObject中。Object参数也包装在MarshalledObject中。- 参数：
name- 应在其上移除侦听器的 MBean 的名称。listener- 原先添加到此 MBean 的侦听器。filter- 添加侦听器时指定的过滤器，它封装在MarshalledObject中。handback- 添加侦听器时指定的 handback，它封装在MarshalledObject中。delegationSubject- 包含委托 principal 的Subject，如果使用了验证 principal，则为null。- 抛出：
InstanceNotFoundException- 所提供的 MBean 名称不与任何已注册 MBean 匹配。ListenerNotFoundException- 侦听器未在 MBean 中注册，或者未用给定的过滤器和 handback 注册。SecurityException- 如果客户端或委托的 Subject（如果有）没有执行此操作的权限。IOException- 如果出现通用通信异常。RuntimeOperationsException- 当name或listener为 null 时包装了IllegalArgumentException。- 另请参见：
addNotificationListener(javax.management.ObjectName, javax.management.ObjectName, java.rmi.MarshalledObject, java.rmi.MarshalledObject, javax.security.auth.Subject)
addNotificationListeners
Integer[] addNotificationListeners(ObjectName[] names, MarshalledObject[] filters, Subject[] delegationSubjects) throws InstanceNotFoundException, IOException
-
供来自给定 MBean 的与给定的过滤器匹配的通知使用的记录。远程客户端以后可使用
fetchNotifications方法检索该通知。对于每个侦听器，原始的
NotificationListener和handback保留在客户端；为帮助客户端识别它们，服务器生成并返回一个惟一的listenerID。该listenerID与Notifications一起转发到远程客户端。如果给定 (name, filter) 对中有任何一对无法注册，则操作失败并抛出异常，不注册任何名称或过滤器。
- 参数：
names- 标识发出 Notification 的 MBean 的ObjectNames。filters-NotificationFilters的编组表示形式的数组。此数组的元素可以为 null。delegationSubjects- 侦听器代表其添加的Subjects。此数组的元素可以为 null。同样，delegationSubjects参数本身可以为 null，它表示具有 null 值的数组，数组大小与names和filters数组大小相同。- 返回：
- 标识本地侦听器的
listenerIDs数组。此数组具有与参数个数相同的元素数。 - 抛出：
IllegalArgumentException- 如果names或filters为 null，或者names包含 null 元素，或者三个数组的大小不相同。ClassCastException- 如果filters中有一个元素解组为不是NotificationFilter的非 null 对象。InstanceNotFoundException- 如果names中有一个不与任何已注册的 MBean 对应。SecurityException- 如果 MBean 之一、客户端或委托的 Subject（如果有）无权添加侦听器。IOException- 如果出现通用通信异常。
removeNotificationListeners
void removeNotificationListeners(ObjectName name, Integer[] listenerIDs, Subject delegationSubject) throws InstanceNotFoundException, ListenerNotFoundException, IOException
处理
removeNotificationListener(ObjectName, NotificationListener)和removeNotificationListener(ObjectName, NotificationListener, NotificationFilter, Object)方法。此方法从 MBean 服务器中的给定 MBean 中移除一个或多个
NotificationListener。NotificationListeners通过从addNotificationListeners(ObjectName[], MarshalledObject[], Subject[])方法返回的 ID 标识。- 参数：
name- 标识发出 Notification 的 MBean 的ObjectName。listenerIDs- 与要移除的侦听器对应的 ID。delegationSubject- 包含委托 principal 的Subject，如果使用了验证 principal，则为null。- 抛出：
InstanceNotFoundException- 如果给定的name不对应任何已注册的 MBean。ListenerNotFoundException- 如果有一个侦听器在服务器端无法找到。当 MBean 出于某种原因丢弃了一个侦听器，而未通过调用MBeanServer.removeNotificationListener丢弃时，出现该异常。SecurityException- 如果客户端或委托的 Subject（如果有）没有移除侦听器的权限。IOException- 如果出现通用通信异常。IllegalArgumentException- 如果ObjectName或listenerIds为 null，或者listenerIds包含一个 null 元素。
fetchNotifications
NotificationResult fetchNotifications(long clientSequenceNumber, int maxNotifications, long timeout) throws IOException
检索来自连接器服务器的通知。该方法可能阻塞，直到至少有一个通知，或者直到达到指定的超时时间。该方法还可在任何时间返回零通知。
如果通知的序列号不小于
clientSequenceNumber，并且此客户端已为 MBean 生成通知至少注册了一个侦听器（带一个接收通知的过滤器），则通知可包含在该结果中。对通知感兴趣的各侦听器由从addNotificationListeners(ObjectName[], MarshalledObject[], Subject[])返回的整数型 ID 标识。- 参数：
clientSequenceNumber- 客户端感兴趣的第一个序列号。如果为负，它表示下一个通知将具有的序列号。maxNotifications- 返回的不同通知的最大数。如果同一个通知出现了多次，则返回的NotificationResult中的TargetedNotification数组可能包含比此数更多的元素。如果该参数为负，则行为不明确。timeout- 等待通知到达的最长时间，以毫秒为单位。它可以是 0，指示在无通知时该方法不应等待，而应立即返回。它可以为Long.MAX_VALUE，指示无超时。如果该参数为负，则行为不明确。- 返回：
- 一个
NotificationResult。 - 抛出：
IOException- 如果出现通用通信异常。
|
JavaTM 2 Platform Standard Ed. 5.0 |
|||||||||
| 上一个类 下一个类 | 框架 无框架 | |||||||||
| 摘要： 嵌套 | 字段 | 构造方法 | 方法 | 详细信息： 字段 | 构造方法 | 方法 | |||||||||
提交错误或意见
有关更多的 API 参考资料和开发人员文档，请参阅 Java 2 SDK SE 开发人员文档。该文档包含更详细的、面向开发人员的描述，以及总体概述、术语定义、使用技巧和工作代码示例。
版权所有 2004 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策。