モジュール java.management.rmi

パッケージ javax.management.remote.rmi

クラスRMIConnectionImpl

java.lang.Object

javax.management.remote.rmi.RMIConnectionImpl

すべての実装されたインタフェース:

Closeable, AutoCloseable, Remote, Unreferenced, RMIConnection

public class RMIConnectionImpl
extends Object
implements RMIConnection, Unreferenced

RMIConnectionインタフェースの実装です。 通常、ユーザー・コードはこのクラスを参照しません。

導入されたバージョン:

1.5

コンストラクタのサマリー

コンストラクタ

コンストラクタ	説明
RMIConnectionImpl(RMIServerImpl rmiServer, String connectionId, ClassLoader defaultClassLoader, Subject subject, Map<String,?> env)	新しいRMIConnectionを構築します。

メソッドのサマリー

修飾子と型	メソッド	説明
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)メソッドを処理します。

クラス 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オブジェクト。 このパラメータがnullの場合の動作は不定。

connectionId - この接続のID。 このパラメータがnullの場合の動作は不定。

defaultClassLoader - 整列化オブジェクトの直列化復元時に使用されるデフォルトのClassLoader。 ブートストラップ・クラス・ローダーを指定する場合はnullも可。

subject - 承認に使用する認証済みの被認証者。 認証済みの被認証者が存在しないことを指定する場合はnullも可。

env - 新しいRMIServerImplの属性を含む環境。 nullの場合、空マップと同等。

メソッドの詳細

getConnectionId

public String getConnectionId()
                       throws IOException

次のインタフェースからコピーされた説明: RMIConnection

接続IDを返します。 この文字列は、指定のRMIコネクタ・サーバーへの開かれた接続ごとに異なります。

定義:

getConnectionId、インタフェース: RMIConnection

戻り値:

接続ID

例外:

IOException - 一般的な通信例外が発生した場合。

関連項目:

RMIConnector.connect

close

public void close()
           throws IOException

次のインタフェースからコピーされた説明: RMIConnection

この接続を終了します。 このメソッドの終了時には、これ以上リモート呼出しの失敗が起こらないように、このインタフェースを実装するRMIオブジェクトがアンエクスポートされます。

定義:

close、インタフェース: AutoCloseable

定義:

close、インタフェース: Closeable

定義:

close、インタフェース: RMIConnection

例外:

IOException - 接続を終了できなかった場合、Remoteオブジェクトをアンエクスポートできなかった場合、またはリモート終了要求の転送時に通信障害が発生した場合。

unreferenced

public void unreferenced()

次のインタフェースからコピーされた説明: Unreferenced

RMIランタイムによって、参照リスト(リモート・オブジェクトを参照するクライアントのリスト)が空になったと判断されたしばらくあとに呼び出されます。

定義:

unreferenced、インタフェース: Unreferenced

createMBean

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

次のインタフェースからコピーされた説明: RMIConnection

MBeanServerConnection.createMBean(String, ObjectName)メソッドを処理します。

定義:

createMBean、インタフェース: RMIConnection

パラメータ:

className - インスタンス化するMBeanのクラス名。

name - MBeanのオブジェクト名。 nullも可。

delegationSubject - 委譲プリンシパルを含むSubject。認証プリンシパルが代わりに使用されている場合はnull。

戻り値:

新しくインスタンス化されたMBeanのObjectNameとJavaクラス名を含むObjectInstance。 含まれる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でない場合。

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)メソッドを処理します。

定義:

createMBean、インタフェース: RMIConnection

パラメータ:

className - インスタンス化するMBeanのクラス名。

name - MBeanのオブジェクト名。 nullも可。

loaderName - 使用するクラス・ローダーのオブジェクト名。

delegationSubject - 委譲プリンシパルを含むSubject。認証プリンシパルが代わりに使用されている場合はnull。

戻り値:

新しくインスタンス化されたMBeanのObjectNameとJavaクラス名を含むObjectInstance。 含まれる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サーバーに登録されていない場合。

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にラップされています。

定義:

createMBean、インタフェース: RMIConnection

パラメータ:

className - インスタンス化するMBeanのクラス名。

name - MBeanのオブジェクト名。 nullも可。

params - 呼び出されるコンストラクタのパラメータを含む配列。この配列は、MarshalledObjectにカプセル化されている。 カプセル化された配列がnullの場合、空配列と同じ意味になる。

signature - 呼び出されるコンストラクタのシグニチャを含む配列。 nullの場合、空配列と同じ意味になる。

delegationSubject - 委譲プリンシパルを含むSubject。認証プリンシパルが代わりに使用されている場合はnull。

戻り値:

新しくインスタンス化されたMBeanのObjectNameとJavaクラス名を含むObjectInstance。 含まれる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でない場合。

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にラップされています。

定義:

createMBean、インタフェース: RMIConnection

パラメータ:

className - インスタンス化するMBeanのクラス名。

name - MBeanのオブジェクト名。 nullも可。

loaderName - 使用するクラス・ローダーのオブジェクト名。

params - 呼び出されるコンストラクタのパラメータを含む配列。この配列は、MarshalledObjectにカプセル化されている。 カプセル化された配列がnullの場合、空配列と同じ意味になる。

signature - 呼び出されるコンストラクタのシグニチャを含む配列。 nullの場合、空配列と同じ意味になる。

delegationSubject - 委譲プリンシパルを含むSubject。認証プリンシパルが代わりに使用されている場合はnull。

戻り値:

新しくインスタンス化されたMBeanのObjectNameとJavaクラス名を含むObjectInstance。 含まれる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サーバーに登録されていない場合。

IOException - 一般的な通信例外が発生した場合。

unregisterMBean

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

次のインタフェースからコピーされた説明: RMIConnection

MBeanServerConnection.unregisterMBean(ObjectName)メソッドを処理します。

定義:

unregisterMBean、インタフェース: RMIConnection

パラメータ:

name - 登録解除するMBeanのオブジェクト名。

delegationSubject - 委譲プリンシパルを含むSubject。認証プリンシパルが代わりに使用されている場合はnull。

例外:

InstanceNotFoundException - 指定されたMBeanがMBeanサーバーに登録されていない場合。

MBeanRegistrationException - MBeanのpreDeregister (MBeanRegistrationインタフェース)メソッドが例外をスローした場合。

IOException - 一般的な通信例外が発生した場合。

getObjectInstance

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

次のインタフェースからコピーされた説明: RMIConnection

MBeanServerConnection.getObjectInstance(ObjectName)メソッドを処理します。

定義:

getObjectInstance、インタフェース: RMIConnection

パラメータ:

name - MBeanのオブジェクト名。

delegationSubject - 委譲プリンシパルを含むSubject。認証プリンシパルが代わりに使用されている場合はnull。

戻り値:

nameで指定された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にラップされています。

定義:

queryMBeans、インタフェース: RMIConnection

パラメータ:

name - 取得するMBeanを識別するオブジェクト名パターン。 nullの場合、またはドメインやキーのプロパティが指定されていない場合は、登録されているすべてのMBeanが取得される。

query - MBeanの選択に適用されるクエリー式。MarshalledObjectにカプセル化されている。 MarshalledObjectにnull値がカプセル化されている場合、MBeanの選択にクエリー式は適用されない。

delegationSubject - 委譲プリンシパルを含むSubject。認証プリンシパルが代わりに使用されている場合は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にラップされています。

定義:

queryNames、インタフェース: RMIConnection

パラメータ:

name - 取得するMBean名を識別するオブジェクト名パターン。 nullの場合、またはドメインやキーのプロパティが指定されていない場合は、登録されているすべてのMBeanの名前が取得される。

query - MBeanの選択に適用されるクエリー式。MarshalledObjectにカプセル化されている。 MarshalledObjectにnull値がカプセル化されている場合、MBeanの選択にクエリー式は適用されない。

delegationSubject - 委譲プリンシパルを含むSubject。認証プリンシパルが代わりに使用されている場合はnull。

戻り値:

選択されたMBeanのObjectNameを含むセット。 クエリーの条件を満たすMBeanが存在しない場合、空のリストが返される。

例外:

IOException - 一般的な通信例外が発生した場合。

isRegistered

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

次のインタフェースからコピーされた説明: RMIConnection

MBeanServerConnection.isRegistered(ObjectName)メソッドを処理します。

定義:

isRegistered、インタフェース: RMIConnection

パラメータ:

name - チェック対象のMBeanのオブジェクト名。

delegationSubject - 委譲プリンシパルを含むSubject。認証プリンシパルが代わりに使用されている場合はnull。

戻り値:

MBeanがすでにMBeanサーバーに登録されている場合はtrue、そうでない場合はfalse。

例外:

IOException - 一般的な通信例外が発生した場合。

getMBeanCount

public Integer getMBeanCount(Subject delegationSubject)
                      throws IOException

次のインタフェースからコピーされた説明: RMIConnection

MBeanServerConnection.getMBeanCount()メソッドを処理します。

定義:

getMBeanCount、インタフェース: RMIConnection

パラメータ:

delegationSubject - 委譲プリンシパルを含むSubject。認証プリンシパルが代わりに使用されている場合はnull。

戻り値:

登録済みのMBeanの数。

例外:

IOException - 一般的な通信例外が発生した場合。

getAttribute

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

次のインタフェースからコピーされた説明: RMIConnection

MBeanServerConnection.getAttribute(ObjectName, String)メソッドを処理します。

定義:

getAttribute、インタフェース: RMIConnection

パラメータ:

name - MBeanのオブジェクト名。このMBeanの属性が取得される。

attribute - 取得される属性の名前を指定するString。

delegationSubject - 委譲プリンシパルを含むSubject。認証プリンシパルが代わりに使用されている場合は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[])メソッドを処理します。

定義:

getAttributes、インタフェース: RMIConnection

パラメータ:

name - MBeanのオブジェクト名。このMBeanの属性が取得される。

attributes - 取得される属性のリスト。

delegationSubject - 委譲プリンシパルを含むSubject。認証プリンシパルが代わりに使用されている場合はnull。

戻り値:

取得される属性のリスト。

例外:

InstanceNotFoundException - 指定されたMBeanがMBeanサーバーに登録されていない場合。

ReflectionException - Dynamic 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にラップされています。

定義:

setAttribute、インタフェース: RMIConnection

パラメータ:

name - MBean名。このMBeanの属性が設定される。

attribute - 設定される属性と、設定後MarshalledObjectにカプセル化される値のID。

delegationSubject - 委譲プリンシパルを含むSubject。認証プリンシパルが代わりに使用されている場合は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にラップされています。

定義:

setAttributes、インタフェース: RMIConnection

パラメータ:

name - MBeanのオブジェクト名。このMBeanの属性が設定される。

attributes - 属性のリスト。設定される属性と、設定後MarshalledObjectにカプセル化される値のID。

delegationSubject - 委譲プリンシパルを含むSubject。認証プリンシパルが代わりに使用されている場合はnull。

戻り値:

設定された属性と新しい値のリスト。

例外:

InstanceNotFoundException - 指定されたMBeanがMBeanサーバーに登録されていない場合。

ReflectionException - Dynamic 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にラップされています。

定義:

invoke、インタフェース: RMIConnection

パラメータ:

name - メソッドの呼出しが行われるMBeanのオブジェクト名。

operationName - 呼び出されるオペレーションの名前。

params - オペレーションが呼び出され、MarshalledObjectにカプセル化されたとき設定されるパラメータを含む配列。 カプセル化された配列がnullの場合、空配列と同じ意味になる。

signature - オペレーションのシグニチャを含む配列。 クラス・オブジェクトのロードには、オペレーションを呼び出したMBeanをロードするときと同じクラス・ローダーが使用される。 nullの場合、空配列と同じ意味になる。

delegationSubject - 委譲プリンシパルを含むSubject。認証プリンシパルが代わりに使用されている場合はnull。

戻り値:

オペレーションによって返されるオブジェクト。指定されたMBean上でオペレーションを呼び出した結果を表す。

例外:

InstanceNotFoundException - 指定されたMBeanがMBeanサーバーに登録されていない場合。

MBeanException - MBeanの呼出しメソッドによってスローされる例外をラップする場合。

ReflectionException - メソッドの呼出し時にスローされるjava.lang.Exceptionをラップする場合。

IOException - 一般的な通信例外が発生した場合。

getDefaultDomain

public String getDefaultDomain(Subject delegationSubject)
                        throws IOException

次のインタフェースからコピーされた説明: RMIConnection

MBeanServerConnection.getDefaultDomain()メソッドを処理します。

定義:

getDefaultDomain、インタフェース: RMIConnection

パラメータ:

delegationSubject - 委譲プリンシパルを含むSubject。認証プリンシパルが代わりに使用されている場合はnull。

戻り値:

デフォルトのドメイン。

例外:

IOException - 一般的な通信例外が発生した場合。

getDomains

public String[] getDomains(Subject delegationSubject)
                    throws IOException

次のインタフェースからコピーされた説明: RMIConnection

MBeanServerConnection.getDomains()メソッドを処理します。

定義:

getDomains、インタフェース: RMIConnection

パラメータ:

delegationSubject - 委譲プリンシパルを含むSubject。認証プリンシパルが代わりに使用されている場合はnull。

戻り値:

ドメインのリスト。

例外:

IOException - 一般的な通信例外が発生した場合。

getMBeanInfo

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

次のインタフェースからコピーされた説明: RMIConnection

MBeanServerConnection.getMBeanInfo(ObjectName)メソッドを処理します。

定義:

getMBeanInfo、インタフェース: RMIConnection

パラメータ:

name - 分析対象のMBeanの名前

delegationSubject - 委譲プリンシパルを含むSubject。認証プリンシパルが代わりに使用されている場合はnull。

戻り値:

MBeanInfoのインスタンス。このMBeanのすべての属性とオペレーションの取得を許可する。

例外:

InstanceNotFoundException - 指定されたMBeanが見つからなかった場合。

IntrospectionException - イントロスペクション中に例外が発生した場合。

ReflectionException - Dynamic MBeanのgetMBeanInfoメソッドの呼出し時に例外が発生した場合。

IOException - 一般的な通信例外が発生した場合。

isInstanceOf

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

次のインタフェースからコピーされた説明: RMIConnection

MBeanServerConnection.isInstanceOf(ObjectName, String)メソッドを処理します。

定義:

isInstanceOf、インタフェース: RMIConnection

パラメータ:

name - MBeanのObjectName。

className - クラスの名前。

delegationSubject - 委譲プリンシパルを含むSubject。認証プリンシパルが代わりに使用されている場合は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とともにリモート・クライアントに転送されます。

指定されたペア(名前、フィルタ)のいずれかを登録できない場合、オペレーションは例外を発行して終了します。この場合、名前もフィルタも登録されません。

定義:

addNotificationListeners、インタフェース: RMIConnection

パラメータ:

names - Notificationの発行元MBeanを識別するObjectNames。

filters - NotificationFiltersの整列化された表現から成る配列。 この配列の要素はnullでもよい。

delegationSubjects - Subjects。このSubject (複数可)の代わりにリスナーが追加される。 この配列の要素はnullでもよい。 また、delegationSubjectsパラメータ自体がnullであってもよい。その場合、この配列は、names配列やfilters配列と同じサイズのnull値から成る配列と同等になる。

戻り値:

ローカル・リスナーを識別する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 (ハンドバック)パラメータも、MarshalledObjectにラップされています。

定義:

addNotificationListener、インタフェース: RMIConnection

パラメータ:

name - リスナーが追加されるMBeanの名前。

listener - 登録済みMBeanが発行した通知を処理するリスナーのオブジェクト名。

filter - MarshalledObjectにカプセル化されたフィルタ・オブジェクト。 MarshalledObjectにカプセル化されたフィルタがnull値を持つ場合、通知の処理前にフィルタリングは行われない。

handback - 通知が発行されたときリスナーに送信されるコンテキスト。MarshalledObjectにカプセル化されている。

delegationSubject - 委譲プリンシパルを含むSubject。認証プリンシパルが代わりに使用されている場合は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から、1つ以上のNotificationListenerを削除します。

NotificationListenersは、RMIConnection.addNotificationListeners(ObjectName[], MarshalledObject[], Subject[])メソッドから返されたIDによって識別されます。

定義:

removeNotificationListeners、インタフェース: RMIConnection

パラメータ:

name - Notificationの発行元MBeanを識別するObjectName。

listenerIDs - 削除するリスナーに対応するIDのリスト。

delegationSubject - 委譲プリンシパルを含むSubject。認証プリンシパルが代わりに使用されている場合は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)メソッドを処理します。

定義:

removeNotificationListener、インタフェース: RMIConnection

パラメータ:

name - リスナーが削除されるMBeanの名前。

listener - 削除されるリスナーのオブジェクト名。

delegationSubject - 委譲プリンシパルを含むSubject。認証プリンシパルが代わりに使用されている場合は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にラップされています。

定義:

removeNotificationListener、インタフェース: RMIConnection

パラメータ:

name - リスナーが削除されるMBeanの名前。

listener - 以前にこのMBeanに追加されたリスナー。

filter - リスナーの追加時に指定されたフィルタ。MarshalledObjectにカプセル化されている。

handback - リスナーの追加時に指定されたハンドバック。MarshalledObjectにカプセル化されている。

delegationSubject - 委譲プリンシパルを含むSubject。認証プリンシパルが代わりに使用されている場合は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

コネクタ・サーバーから通知を受信します。 このメソッドは、1つ以上通知が発行されるか、指定されたタイム・アウトに達するまでブロックできます。 また、通知が0であればいつでも終了できます。

シーケンス番号がclientSequenceNumber以上で、このクライアントが通知を受け付けるフィルタを使って通知の発行元MBeanのリスナーを1つ以上登録している場合、この通知を結果に含めることができます。 この通知を待機する各リスナーは、RMIConnection.addNotificationListeners(ObjectName[], MarshalledObject[], Subject[])によって返された整数値のIDによって識別されます。

定義:

fetchNotifications、インタフェース: RMIConnection

パラメータ:

clientSequenceNumber - クライアントが待機する最初のシーケンス番号。 負の値の場合、次の通知のシーケンス番号と解釈される。

maxNotifications - 返される異なった通知の最大数。 同じ通知が繰返し発行される場合、返されるNotificationResultに含まれるTargetedNotification配列は、この値より多くの要素を持つことができる。 このパラメータの値が負の場合の動作は不定。

timeout - 通知の着信を待つ最大時間(ミリ秒単位)。 0の場合、通知がないとメソッドは待機せず、ただちに終了する。 Long.MAX_VALUEの場合、タイム・アウトは設定されない。 このパラメータの値が負の場合の動作は不定。

戻り値:

NotificationResult。

例外:

IOException - 一般的な通信例外が発生した場合。

toString

public String toString()

このオブジェクトの文字列表現を返します。 一般に、toStringメソッドは、このオブジェクトを「テキストで表す」文字列を返します。 この結果は、人間が読める簡潔で有益な情報であるべきです。

オーバーライド:

toString、クラス: Object

戻り値:

このオブジェクトのString表現。