JavaTM Platform
Standard Ed. 6

javax.management.remote.rmi
类 RMIConnectionImpl_Stub

java.lang.Object
  继承者 java.rmi.server.RemoteObject
      继承者 java.rmi.server.RemoteStub
          继承者 javax.management.remote.rmi.RMIConnectionImpl_Stub
所有已实现的接口:
Closeable, Serializable, Remote, RMIConnection

public final class RMIConnectionImpl_Stub
extends RemoteStub
implements RMIConnection

另请参见:
序列化表格

字段摘要
 
从类 java.rmi.server.RemoteObject 继承的字段
ref
 
构造方法摘要
RMIConnectionImpl_Stub(RemoteRef ref)
           
 
方法摘要
 void addNotificationListener(ObjectName $param_ObjectName_1, ObjectName $param_ObjectName_2, MarshalledObject $param_MarshalledObject_3, MarshalledObject $param_MarshalledObject_4, Subject $param_Subject_5)
          处理 MBeanServerConnection.addNotificationListener(ObjectName, ObjectName, NotificationFilter, Object) 方法。
 Integer[] addNotificationListeners(ObjectName[] $param_arrayOf_ObjectName_1, MarshalledObject[] $param_arrayOf_MarshalledObject_2, Subject[] $param_arrayOf_Subject_3)
          处理 MBeanServerConnection.addNotificationListener(ObjectName, NotificationListener, NotificationFilter, Object) 方法。
 void close()
          关闭此连接。
 ObjectInstance createMBean(String $param_String_1, ObjectName $param_ObjectName_2, MarshalledObject $param_MarshalledObject_3, String[] $param_arrayOf_String_4, Subject $param_Subject_5)
          处理 MBeanServerConnection.createMBean(String, ObjectName, Object[], String[]) 方法。
 ObjectInstance createMBean(String $param_String_1, ObjectName $param_ObjectName_2, ObjectName $param_ObjectName_3, MarshalledObject $param_MarshalledObject_4, String[] $param_arrayOf_String_5, Subject $param_Subject_6)
          处理 MBeanServerConnection.createMBean(String, ObjectName, ObjectName, Object[], String[]) 方法。
 ObjectInstance createMBean(String $param_String_1, ObjectName $param_ObjectName_2, ObjectName $param_ObjectName_3, Subject $param_Subject_4)
          处理 MBeanServerConnection.createMBean(String, ObjectName, ObjectName) 方法。
 ObjectInstance createMBean(String $param_String_1, ObjectName $param_ObjectName_2, Subject $param_Subject_3)
          处理 MBeanServerConnection.createMBean(String, ObjectName) 方法。
 NotificationResult fetchNotifications(long $param_long_1, int $param_int_2, long $param_long_3)
          检索来自连接器服务器的通知。
 Object getAttribute(ObjectName $param_ObjectName_1, String $param_String_2, Subject $param_Subject_3)
          处理 MBeanServerConnection.getAttribute(ObjectName, String) 方法。
 AttributeList getAttributes(ObjectName $param_ObjectName_1, String[] $param_arrayOf_String_2, Subject $param_Subject_3)
          处理 MBeanServerConnection.getAttributes(ObjectName, String[]) 方法。
 String getConnectionId()
          返回连接 ID。
 String getDefaultDomain(Subject $param_Subject_1)
          处理 MBeanServerConnection.getDefaultDomain() 方法。
 String[] getDomains(Subject $param_Subject_1)
          处理 MBeanServerConnection.getDomains() 方法。
 Integer getMBeanCount(Subject $param_Subject_1)
          处理 MBeanServerConnection.getMBeanCount() 方法。
 MBeanInfo getMBeanInfo(ObjectName $param_ObjectName_1, Subject $param_Subject_2)
          处理 MBeanServerConnection.getMBeanInfo(ObjectName) 方法。
 ObjectInstance getObjectInstance(ObjectName $param_ObjectName_1, Subject $param_Subject_2)
          处理 MBeanServerConnection.getObjectInstance(ObjectName) 方法。
 Object invoke(ObjectName $param_ObjectName_1, String $param_String_2, MarshalledObject $param_MarshalledObject_3, String[] $param_arrayOf_String_4, Subject $param_Subject_5)
          处理 MBeanServerConnection.invoke(ObjectName, String, Object[], String[]) 方法。
 boolean isInstanceOf(ObjectName $param_ObjectName_1, String $param_String_2, Subject $param_Subject_3)
          处理 MBeanServerConnection.isInstanceOf(ObjectName, String) 方法。
 boolean isRegistered(ObjectName $param_ObjectName_1, Subject $param_Subject_2)
          处理 MBeanServerConnection.isRegistered(ObjectName) 方法。
 Set queryMBeans(ObjectName $param_ObjectName_1, MarshalledObject $param_MarshalledObject_2, Subject $param_Subject_3)
          处理 MBeanServerConnection.queryMBeans(ObjectName, QueryExp) 方法。
 Set queryNames(ObjectName $param_ObjectName_1, MarshalledObject $param_MarshalledObject_2, Subject $param_Subject_3)
          处理 MBeanServerConnection.queryNames(ObjectName, QueryExp) 方法。
 void removeNotificationListener(ObjectName $param_ObjectName_1, ObjectName $param_ObjectName_2, MarshalledObject $param_MarshalledObject_3, MarshalledObject $param_MarshalledObject_4, Subject $param_Subject_5)
          处理 MBeanServerConnection.removeNotificationListener(ObjectName, ObjectName, NotificationFilter, Object) 方法。
 void removeNotificationListener(ObjectName $param_ObjectName_1, ObjectName $param_ObjectName_2, Subject $param_Subject_3)
          处理 MBeanServerConnection.removeNotificationListener(ObjectName, ObjectName) 方法。
 void removeNotificationListeners(ObjectName $param_ObjectName_1, Integer[] $param_arrayOf_Integer_2, Subject $param_Subject_3)
          处理 removeNotificationListener(ObjectName, NotificationListener)removeNotificationListener(ObjectName, NotificationListener, NotificationFilter, Object) 方法。
 void setAttribute(ObjectName $param_ObjectName_1, MarshalledObject $param_MarshalledObject_2, Subject $param_Subject_3)
          处理 MBeanServerConnection.setAttribute(ObjectName, Attribute) 方法。
 AttributeList setAttributes(ObjectName $param_ObjectName_1, MarshalledObject $param_MarshalledObject_2, Subject $param_Subject_3)
          处理 MBeanServerConnection.setAttributes(ObjectName, AttributeList) 方法。
 void unregisterMBean(ObjectName $param_ObjectName_1, Subject $param_Subject_2)
          处理 MBeanServerConnection.unregisterMBean(ObjectName) 方法。
 
从类 java.rmi.server.RemoteStub 继承的方法
setRef
 
从类 java.rmi.server.RemoteObject 继承的方法
equals, getRef, hashCode, toString, toStub
 
从类 java.lang.Object 继承的方法
clone, finalize, getClass, notify, notifyAll, wait, wait, wait
 

构造方法详细信息

RMIConnectionImpl_Stub

public RMIConnectionImpl_Stub(RemoteRef ref)
方法详细信息

addNotificationListener

public void addNotificationListener(ObjectName $param_ObjectName_1,
                                    ObjectName $param_ObjectName_2,
                                    MarshalledObject $param_MarshalledObject_3,
                                    MarshalledObject $param_MarshalledObject_4,
                                    Subject $param_Subject_5)
                             throws IOException,
                                    InstanceNotFoundException
从接口 RMIConnection 复制的描述
处理 MBeanServerConnection.addNotificationListener(ObjectName, ObjectName, NotificationFilter, Object) 方法。NotificationFilter 参数包装在 MarshalledObject 中。Object (handback) 参数也包装在 MarshalledObject 中。

指定者:
接口 RMIConnection 中的 addNotificationListener
参数:
$param_ObjectName_1 - 应在其上添加侦听器的 MBean 的名称。
$param_ObjectName_2 - 将处理由已注册的 MBean 发出通知的侦听器的对象名。
$param_MarshalledObject_3 - 过滤器对象,封装在 MarshalledObject 中。如果封装在 MarshalledObject 中的过滤器的值为 null,则在对通知处理之前不执行任何过滤。
$param_MarshalledObject_4 - 通知发出时发送到侦听器的上下文,封装在 MarshalledObject 中。
$param_Subject_5 - 包含委托 principal 的 Subject,如果使用了验证 principal,则为 null
抛出:
IOException - 如果出现通用通信异常。
InstanceNotFoundException - 通知侦听器或通知广播器的 MBean 名称不与注册的任何 MBean 匹配。
另请参见:
RMIConnection.removeNotificationListener(ObjectName, ObjectName, Subject), RMIConnection.removeNotificationListener(ObjectName, ObjectName, MarshalledObject, MarshalledObject, Subject)

addNotificationListeners

public Integer[] addNotificationListeners(ObjectName[] $param_arrayOf_ObjectName_1,
                                          MarshalledObject[] $param_arrayOf_MarshalledObject_2,
                                          Subject[] $param_arrayOf_Subject_3)
                                   throws IOException,
                                          InstanceNotFoundException
从接口 RMIConnection 复制的描述

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

供来自给定 MBean 的与给定的过滤器匹配的通知使用的记录。远程客户端以后可使用 fetchNotifications 方法检索该通知。

对于每个侦听器,原始的 NotificationListenerhandback 保留在客户端;为帮助客户端识别它们,服务器生成并返回一个唯一的 listenerID。该 listenerIDNotifications 一起转发到远程客户端。

如果给定 (name, filter) 对中有任何一对无法注册,则操作失败并抛出异常,不注册任何名称或过滤器。

指定者:
接口 RMIConnection 中的 addNotificationListeners
参数:
$param_arrayOf_ObjectName_1 - 标识发出 Notification 的 MBean 的 ObjectNames
$param_arrayOf_MarshalledObject_2 - NotificationFilters 的编组表示形式的数组。此数组的元素可以为 null。
$param_arrayOf_Subject_3 - 侦听器代表其添加的 Subjects。此数组的元素可以为 null。同样,delegationSubjects 参数本身可以为 null,它表示具有 null 值的数组,数组大小与 namesfilters 数组大小相同。
返回:
标识本地侦听器的 listenerIDs 数组。此数组具有与参数个数相同的元素数。
抛出:
IOException - 如果出现通用通信异常。
InstanceNotFoundException - 如果 names 中有一个不与任何已注册的 MBean 对应。

close

public void close()
           throws IOException
从接口 RMIConnection 复制的描述

关闭此连接。从此方法返回时,不导出实现此接口的 RMI 对象,因此对它的进一步远程调用将失败。

指定者:
接口 Closeable 中的 close
指定者:
接口 RMIConnection 中的 close
抛出:
IOException - 如果无法关闭连接,或 Remote 对象无法被导出,或者在传输远程关闭请求时出现通信故障。

createMBean

public ObjectInstance createMBean(String $param_String_1,
                                  ObjectName $param_ObjectName_2,
                                  MarshalledObject $param_MarshalledObject_3,
                                  String[] $param_arrayOf_String_4,
                                  Subject $param_Subject_5)
                           throws IOException,
                                  InstanceAlreadyExistsException,
                                  MBeanException,
                                  MBeanRegistrationException,
                                  NotCompliantMBeanException,
                                  ReflectionException
从接口 RMIConnection 复制的描述
处理 MBeanServerConnection.createMBean(String, ObjectName, Object[], String[]) 方法。Object[] 参数包装在 MarshalledObject 中。

指定者:
接口 RMIConnection 中的 createMBean
参数:
$param_String_1 - 要实例化的 MBean 的类名称。
$param_ObjectName_2 - MBean 的对象名。可以为 null。
$param_MarshalledObject_3 - 包含要调用的构造方法的参数的数组,数组封装在 MarshalledObject 中。封装的数组可以为 null,其等效于一个空数组。
$param_arrayOf_String_4 - 包含要调用的构造方法的签名的数组。可以为 null,等效于一个空数组。
$param_Subject_5 - 包含委托 principal 的 Subject,如果使用了验证 principal,则为 null
返回:
ObjectInstance,它包含新实例化的 MBean 的 ObjectName 和 Java 类名。如果所包含的 ObjectNamen,则所包含的 Java 类名为 getMBeanInfo(n).getClassName()
抛出:
IOException - 如果出现通用通信异常。
InstanceAlreadyExistsException - MBean 已处于 MBean 服务器的控制之下。
MBeanRegistrationException - MBean 的 preRegisterMBeanRegistration 接口)方法已抛出异常。不对 MBean 进行注册。
MBeanException - MBean 的构造方法已抛出异常。
NotCompliantMBeanException - 该类不是一个遵守 JMX 的 MBean。
ReflectionException - 在尝试调用 MBean 的构造方法的过程中出现的、包装了 java.lang.ClassNotFoundExceptionjava.lang.Exception 的异常。

createMBean

public ObjectInstance createMBean(String $param_String_1,
                                  ObjectName $param_ObjectName_2,
                                  ObjectName $param_ObjectName_3,
                                  MarshalledObject $param_MarshalledObject_4,
                                  String[] $param_arrayOf_String_5,
                                  Subject $param_Subject_6)
                           throws IOException,
                                  InstanceAlreadyExistsException,
                                  InstanceNotFoundException,
                                  MBeanException,
                                  MBeanRegistrationException,
                                  NotCompliantMBeanException,
                                  ReflectionException
从接口 RMIConnection 复制的描述
处理 MBeanServerConnection.createMBean(String, ObjectName, ObjectName, Object[], String[]) 方法。Object[] 参数包装在 MarshalledObject 中。

指定者:
接口 RMIConnection 中的 createMBean
参数:
$param_String_1 - 要实例化的 MBean 的类名称。
$param_ObjectName_2 - MBean 的对象名。可以为 null。
$param_ObjectName_3 - 要使用的类加载器的对象名。
$param_MarshalledObject_4 - 包含要调用的构造方法的参数的数组,数组封装在 MarshalledObject 中。封装的数组可以为 null,其等效于一个空数组。
$param_arrayOf_String_5 - 包含要调用的构造方法的签名的数组。可以为 null,等效于一个空数组。
$param_Subject_6 - 包含委托 principal 的 Subject,如果使用了验证 principal,则为 null
返回:
ObjectInstance,它包含新实例化的 MBean 的 ObjectName 和 Java 类名。如果所包含的 ObjectNamen,则所包含的 Java 类名为 getMBeanInfo(n).getClassName()
抛出:
IOException - 如果出现通用通信异常。
InstanceAlreadyExistsException - MBean 已处于 MBean 服务器的控制之下。
InstanceNotFoundException - 指定的类加载器未在 MBean 服务器中注册。
MBeanRegistrationException - MBean 的 preRegisterMBeanRegistration 接口)方法已抛出异常。不对 MBean 进行注册。
MBeanException - MBean 的构造方法已抛出异常。
NotCompliantMBeanException - 该类不是一个遵守 JMX 的 MBean。
ReflectionException - 在尝试调用 MBean 的构造方法的过程中出现的、包装了 java.lang.ClassNotFoundExceptionjava.lang.Exception 的异常。

createMBean

public ObjectInstance createMBean(String $param_String_1,
                                  ObjectName $param_ObjectName_2,
                                  ObjectName $param_ObjectName_3,
                                  Subject $param_Subject_4)
                           throws IOException,
                                  InstanceAlreadyExistsException,
                                  InstanceNotFoundException,
                                  MBeanException,
                                  MBeanRegistrationException,
                                  NotCompliantMBeanException,
                                  ReflectionException
从接口 RMIConnection 复制的描述
处理 MBeanServerConnection.createMBean(String, ObjectName, ObjectName) 方法。

指定者:
接口 RMIConnection 中的 createMBean
参数:
$param_String_1 - 要实例化的 MBean 的类名称。
$param_ObjectName_2 - MBean 的对象名。可以为 null。
$param_ObjectName_3 - 要使用的类加载器的对象名。
$param_Subject_4 - 包含委托 principal 的 Subject,如果使用了验证 principal,则为 null
返回:
ObjectInstance,它包含新实例化的 MBean 的 ObjectName 和 Java 类名。如果所包含的 ObjectNamen,则所包含的 Java 类名为 getMBeanInfo(n).getClassName()
抛出:
IOException - 如果出现通用通信异常。
InstanceAlreadyExistsException - MBean 已处于 MBean 服务器的控制之下。
InstanceNotFoundException - 指定的类加载器未在 MBean 服务器中注册。
MBeanRegistrationException - MBean 的 preRegisterMBeanRegistration 接口)方法已抛出异常。不对 MBean 进行注册。
MBeanException - MBean 的构造方法已抛出异常。
NotCompliantMBeanException - 该类不是一个遵守 JMX 的 MBean。
ReflectionException - 在尝试调用 MBean 的构造方法的过程中出现的、包装了 java.lang.ClassNotFoundExceptionjava.lang.Exception 的异常。

createMBean

public ObjectInstance createMBean(String $param_String_1,
                                  ObjectName $param_ObjectName_2,
                                  Subject $param_Subject_3)
                           throws IOException,
                                  InstanceAlreadyExistsException,
                                  MBeanException,
                                  MBeanRegistrationException,
                                  NotCompliantMBeanException,
                                  ReflectionException
从接口 RMIConnection 复制的描述
处理 MBeanServerConnection.createMBean(String, ObjectName) 方法。

指定者:
接口 RMIConnection 中的 createMBean
参数:
$param_String_1 - 要实例化的 MBean 的类名称。
$param_ObjectName_2 - MBean 的对象名。可以为 null。
$param_Subject_3 - 包含委托 principal 的 Subject,如果使用了验证 principal,则为 null
返回:
ObjectInstance,它包含新实例化的 MBean 的 ObjectName 和 Java 类名。如果所包含的 ObjectNamen,则所包含的 Java 类名为 getMBeanInfo(n).getClassName()
抛出:
IOException - 如果出现通用通信异常。
InstanceAlreadyExistsException - MBean 已处于 MBean 服务器的控制之下。
MBeanRegistrationException - MBean 的 preRegisterMBeanRegistration 接口)方法已抛出异常。不对 MBean 进行注册。
MBeanException - MBean 的构造方法已抛出异常。
NotCompliantMBeanException - 该类不是一个遵守 JMX 的 MBean。
ReflectionException - 在尝试调用 MBean 的构造方法的过程中出现的、包装了 java.lang.ClassNotFoundExceptionjava.lang.Exception 的异常。

fetchNotifications

public NotificationResult fetchNotifications(long $param_long_1,
                                             int $param_int_2,
                                             long $param_long_3)
                                      throws IOException
从接口 RMIConnection 复制的描述

检索来自连接器服务器的通知。该方法可能阻塞,直到至少有一个通知,或者直到达到指定的超时时间。该方法还可在任何时间返回零通知。

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

指定者:
接口 RMIConnection 中的 fetchNotifications
参数:
$param_long_1 - 客户端感兴趣的第一个序列号。如果为负,它表示下一个通知将具有的序列号。
$param_int_2 - 返回的不同通知的最大数。如果同一个通知出现了多次,则返回的 NotificationResult 中的 TargetedNotification 数组可能包含比此数更多的元素。如果该参数为负,则行为不明确。
$param_long_3 - 等待通知到达的最长时间,以毫秒为单位。它可以是 0,指示在无通知时该方法不应等待,而应立即返回。它可以为 Long.MAX_VALUE,指示无超时。如果该参数为负,则行为不明确。
返回:
一个 NotificationResult
抛出:
IOException - 如果出现通用通信异常。

getAttribute

public Object getAttribute(ObjectName $param_ObjectName_1,
                           String $param_String_2,
                           Subject $param_Subject_3)
                    throws IOException,
                           AttributeNotFoundException,
                           InstanceNotFoundException,
                           MBeanException,
                           ReflectionException
从接口 RMIConnection 复制的描述
处理 MBeanServerConnection.getAttribute(ObjectName, String) 方法。

指定者:
接口 RMIConnection 中的 getAttribute
参数:
$param_ObjectName_1 - 将要从其检索属性的 MBean 的对象名。
$param_String_2 - 指定要检索的属性名称的字符串。
$param_Subject_3 - 包含委托 principal 的 Subject,如果使用了验证 principal,则为 null
返回:
检索到的属性的值。
抛出:
IOException - 如果出现通用通信异常。
AttributeNotFoundException - 指定的属性在 MBean 中无法访问。
InstanceNotFoundException - 指定的 MBean 未在 MBean 服务器中注册。
MBeanException - 包装了由 MBean 的获取方法抛出的异常。
ReflectionException - 包装了尝试调用获取方法时抛出的 java.lang.Exception
另请参见:
RMIConnection.setAttribute(javax.management.ObjectName, java.rmi.MarshalledObject, javax.security.auth.Subject)

getAttributes

public AttributeList getAttributes(ObjectName $param_ObjectName_1,
                                   String[] $param_arrayOf_String_2,
                                   Subject $param_Subject_3)
                            throws IOException,
                                   InstanceNotFoundException,
                                   ReflectionException
从接口 RMIConnection 复制的描述
处理 MBeanServerConnection.getAttributes(ObjectName, String[]) 方法。

指定者:
接口 RMIConnection 中的 getAttributes
参数:
$param_ObjectName_1 - 从其检索属性的 MBean 的对象名。
$param_arrayOf_String_2 - 要检索的属性的列表。
$param_Subject_3 - 包含委托 principal 的 Subject,如果使用了验证 principal,则为 null
返回:
所检索的属性的列表。
抛出:
IOException - 如果出现通用通信异常。
InstanceNotFoundException - 指定的 MBean 未在 MBean 服务器中注册。
ReflectionException - 尝试调用 Dynamic MBean 的 getAttributes 方法时出现的异常。
另请参见:
RMIConnection.setAttributes(javax.management.ObjectName, java.rmi.MarshalledObject, javax.security.auth.Subject)

getConnectionId

public String getConnectionId()
                       throws IOException
从接口 RMIConnection 复制的描述

返回连接 ID。对于每个到给定的 RMI 连接器服务器的开放连接,此字符串都不相同。

指定者:
接口 RMIConnection 中的 getConnectionId
返回:
连接 ID
抛出:
IOException - 如果出现通用通信异常。
另请参见:
RMIConnector.connect

getDefaultDomain

public String getDefaultDomain(Subject $param_Subject_1)
                        throws IOException
从接口 RMIConnection 复制的描述
处理 MBeanServerConnection.getDefaultDomain() 方法。

指定者:
接口 RMIConnection 中的 getDefaultDomain
参数:
$param_Subject_1 - 包含委托 principal 的 Subject,如果使用了验证 principal,则为 null
返回:
默认的域。
抛出:
IOException - 如果出现通用通信异常。

getDomains

public String[] getDomains(Subject $param_Subject_1)
                    throws IOException
从接口 RMIConnection 复制的描述
处理 MBeanServerConnection.getDomains() 方法。

指定者:
接口 RMIConnection 中的 getDomains
参数:
$param_Subject_1 - 包含委托 principal 的 Subject,如果使用了验证 principal,则为 null
返回:
域列表。
抛出:
IOException - 如果出现通用通信异常。

getMBeanCount

public Integer getMBeanCount(Subject $param_Subject_1)
                      throws IOException
从接口 RMIConnection 复制的描述
处理 MBeanServerConnection.getMBeanCount() 方法。

指定者:
接口 RMIConnection 中的 getMBeanCount
参数:
$param_Subject_1 - 包含委托 principal 的 Subject,如果使用了验证 principal,则为 null
返回:
已注册的 MBean 数。
抛出:
IOException - 如果出现通用通信异常。

getMBeanInfo

public MBeanInfo getMBeanInfo(ObjectName $param_ObjectName_1,
                              Subject $param_Subject_2)
                       throws IOException,
                              InstanceNotFoundException,
                              IntrospectionException,
                              ReflectionException
从接口 RMIConnection 复制的描述
处理 MBeanServerConnection.getMBeanInfo(ObjectName) 方法。

指定者:
接口 RMIConnection 中的 getMBeanInfo
参数:
$param_ObjectName_1 - 要分析的 MBean 的名称
$param_Subject_2 - 包含委托 principal 的 Subject,如果使用了验证委托 principal,则为 null
返回:
允许检索该 MBean 的所有属性和操作的 MBeanInfo 的实例。
抛出:
IOException - 如果出现通用通信异常。
InstanceNotFoundException - 未找到指定的 MBean。
IntrospectionException - 自行推算过程中出现的异常。
ReflectionException - 尝试调用 Dynamic MBean 的 getMBeanInfo 方法时出现的异常。

getObjectInstance

public ObjectInstance getObjectInstance(ObjectName $param_ObjectName_1,
                                        Subject $param_Subject_2)
                                 throws IOException,
                                        InstanceNotFoundException
从接口 RMIConnection 复制的描述
处理 MBeanServerConnection.getObjectInstance(ObjectName) 方法。

指定者:
接口 RMIConnection 中的 getObjectInstance
参数:
$param_ObjectName_1 - MBean 的对象名。
$param_Subject_2 - 包含委托 principal 的 Subject,如果使用了验证 principal,则为 null
返回:
name 指定的与 MBean 关联的 ObjectInstance。所包含的 ObjectNamename,所包含的类名称为 getMBeanInfo(name).getClassName()
抛出:
IOException - 如果出现通用通信异常。
InstanceNotFoundException - 指定的 MBean 未在 MBean 服务器中注册。

invoke

public Object invoke(ObjectName $param_ObjectName_1,
                     String $param_String_2,
                     MarshalledObject $param_MarshalledObject_3,
                     String[] $param_arrayOf_String_4,
                     Subject $param_Subject_5)
              throws IOException,
                     InstanceNotFoundException,
                     MBeanException,
                     ReflectionException
从接口 RMIConnection 复制的描述
处理 MBeanServerConnection.invoke(ObjectName, String, Object[], String[]) 方法。Object[] 参数包装在 MarshalledObject 中。

指定者:
接口 RMIConnection 中的 invoke
参数:
$param_ObjectName_1 - 将在其上调用此方法的 MBean 的对象名。
$param_String_2 - 要调用的操作的名称。
$param_MarshalledObject_3 - 包含调用操作时将设置的参数的数组,它封装在 MarshalledObject 中。封装的数组可以为 null,其等效于一个空数组。
$param_arrayOf_String_4 - 包含操作的签名的数组。该类对象将使用与加载在其上调用了操作的 MBean 过程中所用的相同的类加载器加载。可以为 null,等效于一个空数组。
$param_Subject_5 - 包含委托 principal 的 Subject,如果使用了验证 principal,则为 null
返回:
操作返回的对象,它代表在指定的 MBean 上调用操作的结果。
抛出:
IOException - 如果出现通用通信异常。
InstanceNotFoundException - 指定的 MBean 未在 MBean 服务器中注册。
MBeanException - 包装了由 MBean 的调用的方法抛出的异常。
ReflectionException - 包装了尝试调用此方法时抛出的 java.lang.Exception

isInstanceOf

public boolean isInstanceOf(ObjectName $param_ObjectName_1,
                            String $param_String_2,
                            Subject $param_Subject_3)
                     throws IOException,
                            InstanceNotFoundException
从接口 RMIConnection 复制的描述
处理 MBeanServerConnection.isInstanceOf(ObjectName, String) 方法。

指定者:
接口 RMIConnection 中的 isInstanceOf
参数:
$param_ObjectName_1 - MBean 的 ObjectName
$param_String_2 - 类的名称。
$param_Subject_3 - 包含委托 principal 的 Subject,如果使用了验证 principal,则为 null
返回:
按照上面的规则,如果指定的 MBean 为指定类的实例,则返回 true,否则返回 false。
抛出:
IOException - 如果出现通用通信异常。
InstanceNotFoundException - 指定的 MBean 未在 MBean 服务器中注册。

isRegistered

public boolean isRegistered(ObjectName $param_ObjectName_1,
                            Subject $param_Subject_2)
                     throws IOException
从接口 RMIConnection 复制的描述
处理 MBeanServerConnection.isRegistered(ObjectName) 方法。

指定者:
接口 RMIConnection 中的 isRegistered
参数:
$param_ObjectName_1 - 要检查的 MBean 的对象名。
$param_Subject_2 - 包含委托 principal 的 Subject,如果使用了验证 principal,则为 null
返回:
True 如果 MBean 已在 MBean 服务器上注册,否则返回 false。
抛出:
IOException - 如果出现通用通信异常。

queryMBeans

public Set queryMBeans(ObjectName $param_ObjectName_1,
                       MarshalledObject $param_MarshalledObject_2,
                       Subject $param_Subject_3)
                throws IOException
从接口 RMIConnection 复制的描述
处理 MBeanServerConnection.queryMBeans(ObjectName, QueryExp) 方法。QueryExp 包装在 MarshalledObject 中。

指定者:
接口 RMIConnection 中的 queryMBeans
参数:
$param_ObjectName_1 - 标识要检索的 MBean 的对象名模式。如果指定了 null 或未指定任何域或关键字属性,则将检索所有已注册的 MBean。
$param_MarshalledObject_2 - 用于选择 MBean 的查询表达式,它封装在 MarshalledObject 中。如果 MarshalledObject 封装了一个 null 值,则选择 MBean 时不使用任何查询表达式。
$param_Subject_3 - 包含委托 principal 的 Subject,如果使用了验证 principal,则为 null
返回:
包含选定 MBean 的 ObjectInstance 对象集。如果没有任何 MBean 满足此查询,则返回一个空列表。
抛出:
IOException - 如果出现通用通信异常。

queryNames

public Set queryNames(ObjectName $param_ObjectName_1,
                      MarshalledObject $param_MarshalledObject_2,
                      Subject $param_Subject_3)
               throws IOException
从接口 RMIConnection 复制的描述
处理 MBeanServerConnection.queryNames(ObjectName, QueryExp) 方法。QueryExp 包装在 MarshalledObject 中。

指定者:
接口 RMIConnection 中的 queryNames
参数:
$param_ObjectName_1 - 标识要检索的 MBean 名称的对象名模式。如果指定了 null 或未指定任何域或关键字属性,则将检索所有已注册的 MBean 的名称。
$param_MarshalledObject_2 - 用于选择 MBean 的查询表达式,它封装在 MarshalledObject 中。如果 MarshalledObject 封装了一个 null 值,则选择 MBean 时不使用任何查询表达式。
$param_Subject_3 - 包含委托 principal 的 Subject,如果使用了验证 principal,则为 null
返回:
包含选定的 MBean 的 ObjectName 集。如果没有任何 MBean 满足此查询,则返回一个空列表。
抛出:
IOException - 如果出现通用通信异常。

removeNotificationListener

public void removeNotificationListener(ObjectName $param_ObjectName_1,
                                       ObjectName $param_ObjectName_2,
                                       MarshalledObject $param_MarshalledObject_3,
                                       MarshalledObject $param_MarshalledObject_4,
                                       Subject $param_Subject_5)
                                throws IOException,
                                       InstanceNotFoundException,
                                       ListenerNotFoundException
从接口 RMIConnection 复制的描述
处理 MBeanServerConnection.removeNotificationListener(ObjectName, ObjectName, NotificationFilter, Object) 方法。NotificationFilter 参数包装在 MarshalledObject 中。Object 参数也包装在 MarshalledObject 中。

指定者:
接口 RMIConnection 中的 removeNotificationListener
参数:
$param_ObjectName_1 - 应在其上移除侦听器的 MBean 的名称。
$param_ObjectName_2 - 原先添加到此 MBean 的侦听器。
$param_MarshalledObject_3 - 添加侦听器时指定的过滤器,它封装在 MarshalledObject 中。
$param_MarshalledObject_4 - 添加侦听器时指定的 handback,它封装在 MarshalledObject 中。
$param_Subject_5 - 包含委托 principal 的 Subject,如果使用了验证 principal,则为 null
抛出:
IOException - 如果出现通用通信异常。
InstanceNotFoundException - 所提供的 MBean 名称不与任何已注册 MBean 匹配。
ListenerNotFoundException - 侦听器未在 MBean 中注册,或者未用给定的过滤器和 handback 注册。
另请参见:
RMIConnection.addNotificationListener(javax.management.ObjectName, javax.management.ObjectName, java.rmi.MarshalledObject, java.rmi.MarshalledObject, javax.security.auth.Subject)

removeNotificationListener

public void removeNotificationListener(ObjectName $param_ObjectName_1,
                                       ObjectName $param_ObjectName_2,
                                       Subject $param_Subject_3)
                                throws IOException,
                                       InstanceNotFoundException,
                                       ListenerNotFoundException
从接口 RMIConnection 复制的描述
处理 MBeanServerConnection.removeNotificationListener(ObjectName, ObjectName) 方法。

指定者:
接口 RMIConnection 中的 removeNotificationListener
参数:
$param_ObjectName_1 - 应在其上移除侦听器的 MBean 的名称。
$param_ObjectName_2 - 要移除的侦听器的对象名。
$param_Subject_3 - 包含委托 principal 的 Subject,如果使用了验证 principal,则为 null
抛出:
IOException - 如果出现通用通信异常。
InstanceNotFoundException - 所提供的 MBean 名称不与任何已注册 MBean 匹配。
ListenerNotFoundException - 侦听器未在 MBean 中注册。
另请参见:
RMIConnection.addNotificationListener(javax.management.ObjectName, javax.management.ObjectName, java.rmi.MarshalledObject, java.rmi.MarshalledObject, javax.security.auth.Subject)

removeNotificationListeners

public void removeNotificationListeners(ObjectName $param_ObjectName_1,
                                        Integer[] $param_arrayOf_Integer_2,
                                        Subject $param_Subject_3)
                                 throws IOException,
                                        InstanceNotFoundException,
                                        ListenerNotFoundException
从接口 RMIConnection 复制的描述

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

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

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

指定者:
接口 RMIConnection 中的 removeNotificationListeners
参数:
$param_ObjectName_1 - 标识发出 Notification 的 MBean 的 ObjectName
$param_arrayOf_Integer_2 - 与要移除的侦听器对应的 ID。
$param_Subject_3 - 包含委托 principal 的 Subject,如果使用了验证 principal,则为 null
抛出:
IOException - 如果出现通用通信异常。
InstanceNotFoundException - 如果给定的 name 不对应任何已注册的 MBean。
ListenerNotFoundException - 如果有一个侦听器在服务器端无法找到。当 MBean 出于某种原因丢弃了一个侦听器,而未通过调用 MBeanServer.removeNotificationListener 丢弃时,出现该异常。

setAttribute

public void setAttribute(ObjectName $param_ObjectName_1,
                         MarshalledObject $param_MarshalledObject_2,
                         Subject $param_Subject_3)
                  throws IOException,
                         AttributeNotFoundException,
                         InstanceNotFoundException,
                         InvalidAttributeValueException,
                         MBeanException,
                         ReflectionException
从接口 RMIConnection 复制的描述
处理 MBeanServerConnection.setAttribute(ObjectName, Attribute) 方法。Attribute 参数包装在 MarshalledObject 中。

指定者:
接口 RMIConnection 中的 setAttribute
参数:
$param_ObjectName_1 - 在其中设置属性的 MBean 的名称。
$param_MarshalledObject_2 - 要设置的属性的标识及要设置的值,封装在 MarshalledObject 中。
$param_Subject_3 - 包含委托 principal 的 Subject,如果使用了验证 principal,则为 null
抛出:
IOException - 如果出现通用通信异常。
AttributeNotFoundException - 指定的属性在 MBean 中无法访问。
InstanceNotFoundException - 指定的 MBean 未在 MBean 服务器中注册。
InvalidAttributeValueException - 为属性指定的值无效。
MBeanException - 包装了由 MBean 的设置方法抛出的异常。
ReflectionException - 包装了尝试调用设置方法时抛出的 java.lang.Exception
另请参见:
RMIConnection.getAttribute(javax.management.ObjectName, java.lang.String, javax.security.auth.Subject)

setAttributes

public AttributeList setAttributes(ObjectName $param_ObjectName_1,
                                   MarshalledObject $param_MarshalledObject_2,
                                   Subject $param_Subject_3)
                            throws IOException,
                                   InstanceNotFoundException,
                                   ReflectionException
从接口 RMIConnection 复制的描述
处理 MBeanServerConnection.setAttributes(ObjectName, AttributeList) 方法。AttributeList 参数包装在 MarshalledObject 中。

指定者:
接口 RMIConnection 中的 setAttributes
参数:
$param_ObjectName_1 - 要在其中设置属性的 MBean 的对象名。
$param_MarshalledObject_2 - 属性列表:要设置的属性的标识及要设置的值,封装在 MarshalledObject 中。
$param_Subject_3 - 包含委托 principal 的 Subject,如果使用了验证 principal,则为 null
返回:
原先设置过的带有新值的属性列表。
抛出:
IOException - 如果出现通用通信异常。
InstanceNotFoundException - 指定的 MBean 未在 MBean 服务器中注册。
ReflectionException - 尝试调用 Dynamic MBean 的 getAttributes 方法时出现的异常。
另请参见:
RMIConnection.getAttributes(javax.management.ObjectName, java.lang.String[], javax.security.auth.Subject)

unregisterMBean

public void unregisterMBean(ObjectName $param_ObjectName_1,
                            Subject $param_Subject_2)
                     throws IOException,
                            InstanceNotFoundException,
                            MBeanRegistrationException
从接口 RMIConnection 复制的描述
处理 MBeanServerConnection.unregisterMBean(ObjectName) 方法。

指定者:
接口 RMIConnection 中的 unregisterMBean
参数:
$param_ObjectName_1 - 要注册的 MBean 的对象名。
$param_Subject_2 - 包含委托 principal 的 Subject,如果使用了验证 principal,则为 null
抛出:
IOException - 如果出现通用通信异常。
InstanceNotFoundException - 指定的 MBean 未在 MBean 服务器中注册。
MBeanRegistrationException - MBean 的 preDeregister (MBeanRegistration 接口)方法已抛出异常。

JavaTM Platform
Standard Ed. 6

提交错误或意见
有关更多的 API 参考资料和开发人员文档,请参阅 Java SE 开发人员文档。该文档包含更详细的、面向开发人员的描述,以及总体概述、术语定义、使用技巧和工作代码示例。

版权所有 2007 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策