モジュール java.management

パッケージ javax.management

インタフェースMBeanServer

すべてのスーパー・インタフェース:

MBeanServerConnection

既知のすべてのサブインタフェース:

MBeanServerForwarder

public interface MBeanServer extends MBeanServerConnection

エージェント側でMBeanを操作するためのインタフェースです。 登録済みのMBeanにアクセスするためのメソッドのほか、MBeanを作成、登録、削除するために必要なメソッドが含まれます。 これが、JMXインフラストラクチャの主要コンポーネントになります。

通常、ユーザー・コードはこのインタフェースを実装しません。 ただし、このインタフェースを実装するオブジェクトは、MBeanServerFactoryクラスのいずれかのメソッドで取得できます。

MBeanサーバーに追加されたMBeanはすべて管理対象となります。これらのMBeanの属性とオペレーションには、MBeanサーバーに接続されたコネクタまたはアダプタ経由でリモート・アクセスできます。 JMX準拠のMBeanでないJavaオブジェクトは、MBeanサーバーに登録できません。

MBeanサーバーでMBeanを登録または登録解除すると、MBeanServerNotification通知が発行されます。 オブジェクトをMBeanServerNotificationのリスナーとして登録するには、MBeanServerDelegateのObjectNameを指定して、MBeanサーバー・メソッドaddNotificationListenerをObjectNameと呼び出すようにしてください。 このObjectNameは、
JMImplementation: type=MBeanServerDelegateになります。

MBeanServerFactoryクラスのcreateMBeanServerまたはnewMBeanServerメソッドから取得されたオブジェクトでは、次のように、そのメソッドにセキュリティ・チェックが適用されます。

セキュリティ・マネージャが存在しない場合、すなわちSystem.getSecurityManager()がnullの場合、このインタフェースの実装はチェックを行わないこともあります。

セキュリティ・マネージャが存在する場合、または実装でチェックを行うことが選択されている場合、次のようなチェックが行われます。 特に指定されないかぎり、classNameは、MBeanInfo.getClassName()によってターゲットMBeanに返される文字列です。

セキュリティ・チェックに失敗した場合、メソッドはSecurityExceptionをスローします。

InstanceNotFoundExceptionをスローする可能性があるメソッドは、アクセス権の内容に関係なく、MBeanが存在しない場合にこの例外をスローします。 これは、MBeanが存在しなければ、classNameも存在しないからです。

• invokeメソッドの呼出し元は、アクセス権としてMBeanPermission(className, operationName, name, "invoke")を持っている必要がある。

• getAttributeメソッドの呼出し元は、アクセス権としてMBeanPermission(className, attribute, name, "getAttribute")を持っている必要がある。

• getAttributesメソッドの呼出し元は、アクセス権としてMBeanPermission(className, null, name, "getAttribute")を持っている必要がある。 呼出し元がアクセス権MBeanPermission(className, a, name, "getAttribute")を持っていない場合、MBeanサーバーは、AttributeList内の属性aがリスト内に存在しないとみなす。

• setAttributeメソッドの呼出し元は、アクセス権としてMBeanPermission(className, attrName, name, "setAttribute")を持っている必要がある(attrNameはattribute.getName())。

• setAttributesメソッドの呼出し元は、アクセス権としてMBeanPermission(className, null, name, "setAttribute")を持っている必要がある。 呼出し元がアクセス権MBeanPermission(className, a, name, "setAttribute")を持っていない場合、MBeanサーバーは、AttributeList内の属性aがリスト内に存在しないとみなす。

• addNotificationListenerメソッドの呼出し元は、アクセス権としてMBeanPermission(className, null, name, "addNotificationListener")を持っている必要がある。

• removeNotificationListenerメソッドの呼出し元は、アクセス権としてMBeanPermission(className, null, name, "removeNotificationListener")を持っている必要がある。

• getMBeanInfoメソッドの呼出し元は、アクセス権としてMBeanPermission(className, null, name, "getMBeanInfo")を持っている必要がある。

• getObjectInstanceメソッドの呼出し元は、アクセス権としてMBeanPermission(className, null, name, "getObjectInstance")を持っている必要がある。

• isInstanceOfメソッドの呼出し元は、アクセス権としてMBeanPermission(className, null, name, "isInstanceOf")を持っている必要がある。

• queryMBeansメソッドの呼出し元は、アクセス権としてMBeanPermission(null, null, null, "queryMBeans")を持っている必要がある。 呼出し元がアクセス権MBeanPermission(className, null, n, "queryMBeans")を持っていない場合、MBeanサーバーは、nameに一致するMBean nが存在しないとみなす。

  特定のクエリー要素は、MBeanサーバー上でオペレーションを実行する。 呼出し元が指定されたMBeanを使用するために必要なアクセス権を持っていない場合、このMBeanはクエリーの結果から除外される。 影響を受ける標準クエリー要素は、Query.attr(String)、Query.attr(String,String)、およびQuery.classattr()。

• queryNamesメソッドの場合、queryMBeansと同様のチェックが行われる。ただし、MBeanPermissionオブジェクトでは、"queryMBeans"のかわりに"queryNames"が使用される。 アクセス権"queryMBeans"には、対応するアクセス権"queryNames"が含まれる。

• getDomainsメソッドの呼出し元は、アクセス権としてMBeanPermission(null, null, null, "getDomains")を持っている必要がある。 呼出し元がアクセス権MBeanPermission(null, null, new ObjectName("d:x=x"), "getDomains")を持っていない場合、返される配列からドメインdが除外される。 x=xは、ObjectNameのコンストラクタ専用の任意のkey=valueペア。

• getClassLoaderメソッドの呼出し元は、アクセス権としてMBeanPermission(className, null, loaderName, "getClassLoader")を持っている必要がある。

• getClassLoaderForメソッドの呼出し元は、アクセス権としてMBeanPermission(className, null, mbeanName, "getClassLoaderFor")を持っている必要がある。

• getClassLoaderRepositoryメソッドの呼出し元は、アクセス権としてMBeanPermission(null, null, null, "getClassLoaderRepository")を持っている必要がある。

• 非推奨のdeserializeメソッドは、これらの代替となるメソッドと同じアクセス権を必要とする。

• instantiateメソッドの呼出し元は、アクセス権としてMBeanPermission(className, null, null, "instantiate")を持っている必要がある(classNameはインスタンス化されるクラスの名前)。

• registerMBeanメソッドの呼出し元は、アクセス権としてMBeanPermission(className, null, name, "registerMBean")を持っている必要がある。

  MBeanPermissionチェックに成功した場合、MBeanのクラスの妥当性検査が行われる。具体的には、ProtectionDomainにMBeanTrustPermission("register")が含まれるかどうかがチェックされる。

  name引数がnullの場合、MBeanRegistration.preRegisterによって返されるObjectNameにより、別のMBeanPermissionチェックが行われる。

• createMBeanメソッドの呼出し元は、同等のinstantiateおよびregisterMBeanが必要とするアクセス権を持っている必要がある。

• unregisterMBeanメソッドの呼出し元は、アクセス権としてMBeanPermission(className, null, name, "unregisterMBean")を持っている必要がある。

導入されたバージョン:

1.5

メソッドのサマリー

修飾子と型	メソッド	説明
void	addNotificationListener(ObjectName name, NotificationListener listener, NotificationFilter filter, Object handback)	登録済みMBeanにリスナーを追加します。
void	addNotificationListener(ObjectName name, ObjectName listener, NotificationFilter filter, Object handback)	登録済みMBeanにリスナーを追加します。
ObjectInstance	createMBean(String className, ObjectName name)	MBeanをインスタンス化し、MBeanサーバーに登録します。
ObjectInstance	createMBean(String className, ObjectName name, Object[] params, String[] signature)	MBeanをインスタンス化し、MBeanサーバーに登録します。
ObjectInstance	createMBean(String className, ObjectName name, ObjectName loaderName)	MBeanをインスタンス化し、MBeanサーバーに登録します。
ObjectInstance	createMBean(String className, ObjectName name, ObjectName loaderName, Object[] params, String[] signature)	MBeanをインスタンス化し、MBeanサーバーに登録します。
default ObjectInputStream	deserialize(String className, byte[] data)	非推奨。 getClassLoaderRepository()を使ってクラス・ローダー・リポジトリを取得し、それを使って直列化復元を行います。
default ObjectInputStream	deserialize(String className, ObjectName loaderName, byte[] data)	非推奨。 getClassLoaderを使って直列化復元用のクラス・ローダーを取得します。
default ObjectInputStream	deserialize(ObjectName name, byte[] data)	非推奨。 getClassLoaderForを使って、直列化復元に使用する適切なクラス・ローダーを取得します。
Object	getAttribute(ObjectName name, String attribute)	指定されたMBeanの特定の属性の値を取得します。
AttributeList	getAttributes(ObjectName name, String[] attributes)	指定されたMBeanの複数の属性の値を取り出します。
ClassLoader	getClassLoader(ObjectName loaderName)	指定されたClassLoaderを返します。
ClassLoader	getClassLoaderFor(ObjectName mbeanName)	指定されたMBeanのクラスのロードに使用されたClassLoaderを返します。
ClassLoaderRepository	getClassLoaderRepository()	このMBeanServerのClassLoaderRepositoryを返します。
String	getDefaultDomain()	MBeanの指定に使用するデフォルトのドメインを返します。
String[]	getDomains()	MBeanが現在登録されているドメインのリストを返します。
Integer	getMBeanCount()	MBeanサーバーに登録されているMBeanの数を返します。
MBeanInfo	getMBeanInfo(ObjectName name)	このメソッドは、MBeanが管理用として公開している属性とオペレーションを検出します。
ObjectInstance	getObjectInstance(ObjectName name)	MBeanに登録された、指定されたMBeanのObjectInstanceを取得します。
Object	instantiate(String className)	MBeanサーバーのClass Loader Repository内に登録されたすべてのクラス・ローダーのリストを使って、オブジェクトをインスタンス化します。
Object	instantiate(String className, Object[] params, String[] signature)	MBeanサーバーのClass Loader Repository内に登録されたすべてのクラス・ローダーのリストを使って、オブジェクトをインスタンス化します。
Object	instantiate(String className, ObjectName loaderName)	ObjectNameで指定されたクラス・ローダーを使って、オブジェクトをインスタンス化します。
Object	instantiate(String className, ObjectName loaderName, Object[] params, String[] signature)	オブジェクトをインスタンス化します。
Object	invoke(ObjectName name, String operationName, Object[] params, String[] signature)	MBean上でオペレーションを呼び出します。
boolean	isInstanceOf(ObjectName name, String className)	指定されたMBeanが指定されたクラスのインスタンスである場合はtrue、そうでない場合はfalseを返します。
boolean	isRegistered(ObjectName name)	このオブジェクト名で識別されるMBeanが、すでにMBeanサーバーに登録されているかどうかをチェックします。
Set<ObjectInstance>	queryMBeans(ObjectName name, QueryExp query)	MBeanサーバーによって制御されるMBeanを取得します。
Set<ObjectName>	queryNames(ObjectName name, QueryExp query)	MBeanサーバーによって制御されるMBeanの名前を取得します。
ObjectInstance	registerMBean(Object object, ObjectName name)	既存のオブジェクトをMBeanとしてMBeanサーバーに登録します。
void	removeNotificationListener(ObjectName name, NotificationListener listener)	登録済みMBeanからリスナーを削除します。
void	removeNotificationListener(ObjectName name, NotificationListener listener, NotificationFilter filter, Object handback)	登録済みMBeanからリスナーを削除します。
void	removeNotificationListener(ObjectName name, ObjectName listener)	登録済みMBeanからリスナーを削除します。
void	removeNotificationListener(ObjectName name, ObjectName listener, NotificationFilter filter, Object handback)	登録済みMBeanからリスナーを削除します。
void	setAttribute(ObjectName name, Attribute attribute)	指定されたMBeanの特定の属性の値を設定します。
AttributeList	setAttributes(ObjectName name, AttributeList attributes)	指定されたMBeanの複数の属性の値を設定します。
void	unregisterMBean(ObjectName name)	MBeanサーバーからMBeanの登録を解除します。

メソッドの詳細

createMBean

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

MBeanをインスタンス化し、MBeanサーバーに登録します。 MBeanサーバーは、Default Loader Repositoryを使って、このMBeanのクラスをロードします。 MBeanにはオブジェクト名が関連付けられます。 このオブジェクト名がnullの場合、MBeanは、MBeanRegistrationインタフェースを実装し、preRegisterメソッドから返される独自の名前を使用する必要があります。

このメソッドは、createMBean(className, name,(Object[]) null,(String[]) null)と同等です。

このメソッドがMBeanの作成に成功すると、前述の通知が送信されます。

定義:

createMBean、インタフェースMBeanServerConnection

パラメータ:

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

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

戻り値:

新しくインスタンス化されたMBeanのObjectNameとJavaクラス名を含むObjectInstance。 含まれるObjectNameがnの場合、含まれるJavaクラス名はgetMBeanInfo(n).getClassName()。

例外:

RuntimeOperationsException - java.lang.IllegalArgumentExceptionをラップする場合。すなわち、パラメータに渡されるclassNameがnullであるか、パラメータに渡されるObjectNameがパターンであるか、MBeanにObjectNameが指定されていない場合。

RuntimeMBeanException - MBeanのコンストラクタ、あるいはそのpreRegisterまたはpostRegisterメソッドがRuntimeExceptionをスローした場合。 MBeanのpostRegister (MBeanRegistrationインタフェース)メソッドがRuntimeExceptionをスローすると、MBeanの作成と登録は成功しますが、createMBeanメソッドはRuntimeMBeanExceptionをスローします。 このような場合、createMBeanメソッドが例外をスローしたとしても、MBeanは実際に登録されます。 RuntimeMBeanExceptionはpreRegisterでもスローされますが、その場合はMBeanは登録されません。

RuntimeErrorException - MBeanのpostRegister (MBeanRegistrationインタフェース)メソッドがErrorをスローすると、MBeanの作成と登録は成功しますが、createMBeanメソッドはRuntimeErrorExceptionをスローします。 このような場合、createMBeanメソッドが例外をスローしたとしても、MBeanは実際に登録されます。 RuntimeErrorExceptionはpreRegisterでもスローされますが、その場合はMBeanは登録されません。

ReflectionException - MBeanのコンストラクタの呼出し時に発行されるjava.lang.ClassNotFoundExceptionまたはjava.lang.Exceptionをラップする場合。

InstanceAlreadyExistsException - MBeanがすでにMBeanサーバーによって制御されている場合。

MBeanRegistrationException - MBeanのpreRegister (MBeanRegistrationインタフェース)メソッドが例外をスローした場合。 MBeanは登録されない。

MBeanException - MBeanのコンストラクタが例外をスローした場合

NotCompliantMBeanException - このクラスがJMX準拠のMBeanでない場合

関連項目:

• MBeanRegistration

createMBean

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

MBeanをインスタンス化し、MBeanサーバーに登録します。 使用するクラス・ローダーは、オブジェクト名で識別されます。 MBeanにはオブジェクト名が関連付けられます。 ローダーのオブジェクト名がnullの場合、MBeanサーバーのロードに使用したClassLoaderが使用されます。 MBeanのオブジェクト名がnullの場合、MBeanは、MBeanRegistrationインタフェースを実装し、preRegisterメソッドから返される独自の名前を使用する必要があります。

このメソッドは、createMBean(className, name, loaderName,(Object[]) null,(String[]) null)と同等です。

このメソッドがMBeanの作成に成功すると、前述の通知が送信されます。

定義:

createMBean、インタフェースMBeanServerConnection

パラメータ:

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

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

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

戻り値:

新しくインスタンス化されたMBeanのObjectNameとJavaクラス名を含むObjectInstance。 含まれるObjectNameがnの場合、含まれるJavaクラス名はgetMBeanInfo(n).getClassName()。

例外:

RuntimeOperationsException - java.lang.IllegalArgumentExceptionをラップする場合。すなわち、パラメータに渡されるclassNameがnullであるか、パラメータに渡されるObjectNameがパターンであるか、MBeanにObjectNameが指定されていない場合。

RuntimeMBeanException - MBeanのコンストラクタ、あるいはそのpreRegisterまたはpostRegisterメソッドがRuntimeExceptionをスローした場合。 MBeanのpostRegister (MBeanRegistrationインタフェース)メソッドがRuntimeExceptionをスローすると、MBeanの作成と登録は成功しますが、createMBeanメソッドはRuntimeMBeanExceptionをスローします。 このような場合、createMBeanメソッドが例外をスローしたとしても、MBeanは実際に登録されます。 RuntimeMBeanExceptionはpreRegisterでもスローされますが、その場合はMBeanは登録されません。

RuntimeErrorException - MBeanのpostRegister (MBeanRegistrationインタフェース)メソッドがErrorをスローすると、MBeanの作成と登録は成功しますが、createMBeanメソッドはRuntimeErrorExceptionをスローします。 このような場合、createMBeanメソッドが例外をスローしたとしても、MBeanは実際に登録されます。 RuntimeErrorExceptionはpreRegisterでもスローされますが、その場合はMBeanは登録されません。

ReflectionException - MBeanのコンストラクタの呼出し時に発行されるjava.lang.ClassNotFoundExceptionまたはjava.lang.Exceptionをラップする場合。

InstanceAlreadyExistsException - MBeanがすでにMBeanサーバーによって制御されている場合。

MBeanRegistrationException - MBeanのpreRegister (MBeanRegistrationインタフェース)メソッドが例外をスローした場合。 MBeanは登録されない。

MBeanException - MBeanのコンストラクタが例外をスローした場合

NotCompliantMBeanException - このクラスがJMX準拠のMBeanでない場合

InstanceNotFoundException - 指定されたクラス・ローダーがMBeanサーバーに登録されていない場合。

関連項目:

• MBeanRegistration

createMBean

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

MBeanをインスタンス化し、MBeanサーバーに登録します。 MBeanサーバーは、Default Loader Repositoryを使って、このMBeanのクラスをロードします。 MBeanにはオブジェクト名が関連付けられます。 このオブジェクト名がnullの場合、MBeanは、MBeanRegistrationインタフェースを実装し、preRegisterメソッドから返される独自の名前を使用する必要があります。

このメソッドがMBeanの作成に成功すると、前述の通知が送信されます。

定義:

createMBean、インタフェースMBeanServerConnection

パラメータ:

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

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

params - 呼び出されるコンストラクタのパラメータを含む配列。

signature - 呼び出されるコンストラクタのシグニチャを含む配列。

戻り値:

新しくインスタンス化されたMBeanのObjectNameとJavaクラス名を含むObjectInstance。 含まれるObjectNameがnの場合、含まれるJavaクラス名はgetMBeanInfo(n).getClassName()。

例外:

RuntimeOperationsException - java.lang.IllegalArgumentExceptionをラップする場合。すなわち、パラメータに渡されるclassNameがnullであるか、パラメータに渡されるObjectNameがパターンであるか、MBeanにObjectNameが指定されていない場合。

RuntimeMBeanException - MBeanのコンストラクタ、あるいはそのpreRegisterまたはpostRegisterメソッドがRuntimeExceptionをスローした場合。 MBeanのpostRegister (MBeanRegistrationインタフェース)メソッドがRuntimeExceptionをスローすると、MBeanの作成と登録は成功しますが、createMBeanメソッドはRuntimeMBeanExceptionをスローします。 このような場合、createMBeanメソッドが例外をスローしたとしても、MBeanは実際に登録されます。 RuntimeMBeanExceptionはpreRegisterでもスローされますが、その場合はMBeanは登録されません。

RuntimeErrorException - MBeanのpostRegister (MBeanRegistrationインタフェース)メソッドがErrorをスローすると、MBeanの作成と登録は成功しますが、createMBeanメソッドはRuntimeErrorExceptionをスローします。 このような場合、createMBeanメソッドが例外をスローしたとしても、MBeanは実際に登録されます。 RuntimeErrorExceptionはpreRegisterでもスローされますが、その場合はMBeanは登録されません。

ReflectionException - MBeanのコンストラクタの呼出し時に発行されるjava.lang.ClassNotFoundExceptionまたはjava.lang.Exceptionをラップする場合。

InstanceAlreadyExistsException - MBeanがすでにMBeanサーバーによって制御されている場合。

MBeanRegistrationException - MBeanのpreRegister (MBeanRegistrationインタフェース)メソッドが例外をスローした場合。 MBeanは登録されない。

MBeanException - MBeanのコンストラクタが例外をスローした場合

NotCompliantMBeanException - このクラスがJMX準拠のMBeanでない場合

関連項目:

• MBeanRegistration

createMBean

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

MBeanをインスタンス化し、MBeanサーバーに登録します。 使用するクラス・ローダーは、オブジェクト名で識別されます。 MBeanにはオブジェクト名が関連付けられます。 ローダーのオブジェクト名が指定されていない場合、MBeanサーバーのロードに使用したClassLoaderが使用されます。 MBeanのオブジェクト名がnullの場合、MBeanは、MBeanRegistrationインタフェースを実装し、preRegisterメソッドから返される独自の名前を使用する必要があります。

このメソッドがMBeanの作成に成功すると、前述の通知が送信されます。

定義:

createMBean、インタフェースMBeanServerConnection

パラメータ:

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

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

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

params - 呼び出されるコンストラクタのパラメータを含む配列。

signature - 呼び出されるコンストラクタのシグニチャを含む配列。

戻り値:

新しくインスタンス化されたMBeanのObjectNameとJavaクラス名を含むObjectInstance。 含まれるObjectNameがnの場合、含まれるJavaクラス名はgetMBeanInfo(n).getClassName()。

例外:

RuntimeOperationsException - java.lang.IllegalArgumentExceptionをラップする場合。すなわち、パラメータに渡されるclassNameがnullであるか、パラメータに渡されるObjectNameがパターンであるか、MBeanにObjectNameが指定されていない場合。

RuntimeMBeanException - MBeanのコンストラクタ、あるいはそのpreRegisterまたはpostRegisterメソッドがRuntimeExceptionをスローした場合。 MBeanのpostRegister (MBeanRegistrationインタフェース)メソッドがRuntimeExceptionをスローすると、MBeanの作成と登録は成功しますが、createMBeanメソッドはRuntimeMBeanExceptionをスローします。 このような場合、createMBeanメソッドが例外をスローしたとしても、MBeanは実際に登録されます。 RuntimeMBeanExceptionはpreRegisterでもスローされますが、その場合はMBeanは登録されません。

RuntimeErrorException - MBeanのpostRegisterメソッド(MBeanRegistrationインタフェース)メソッドがErrorをスローすると、MBeanの作成と登録は成功しますが、createMBeanメソッドはRuntimeErrorExceptionをスローします。 このような場合、createMBeanメソッドが例外をスローしたとしても、MBeanは実際に登録されます。 RuntimeErrorExceptionはpreRegisterでもスローされますが、その場合はMBeanは登録されません。

ReflectionException - MBeanのコンストラクタの呼出し時に発行されるjava.lang.ClassNotFoundExceptionまたはjava.lang.Exceptionをラップする場合。

InstanceAlreadyExistsException - MBeanがすでにMBeanサーバーによって制御されている場合。

MBeanRegistrationException - MBeanのpreRegister (MBeanRegistrationインタフェース)メソッドが例外をスローした場合。 MBeanは登録されない。

MBeanException - MBeanのコンストラクタが例外をスローした場合

NotCompliantMBeanException - このクラスがJMX準拠のMBeanでない場合

InstanceNotFoundException - 指定されたクラス・ローダーがMBeanサーバーに登録されていない場合。

関連項目:

• MBeanRegistration

registerMBean

ObjectInstance registerMBean(Object object, ObjectName name) throws InstanceAlreadyExistsException, MBeanRegistrationException, NotCompliantMBeanException

既存のオブジェクトをMBeanとしてMBeanサーバーに登録します。 このオブジェクト名がnullの場合、MBeanは、MBeanRegistrationインタフェースを実装し、preRegisterメソッドから返される独自の名前を使用する必要があります。

このメソッドがMBeanの登録に成功すると、前述の通知が送信されます。

パラメータ:

object - MBeanとして登録されるMBean。

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

戻り値:

新しく登録されたMBeanのObjectNameとJavaクラス名を含むObjectInstance。 含まれるObjectNameがnの場合、含まれるJavaクラス名はgetMBeanInfo(n).getClassName()。

例外:

InstanceAlreadyExistsException - MBeanがすでにMBeanサーバーによって制御されている場合。

MBeanRegistrationException - MBeanのpreRegister (MBeanRegistrationインタフェース)メソッドが例外をスローした場合。 MBeanは登録されない。

RuntimeMBeanException - MBeanのpostRegister (MBeanRegistrationインタフェース)メソッドがRuntimeExceptionをスローすると、MBeanの登録は成功しますが、registerMBeanメソッドはRuntimeMBeanExceptionをスローします。 このような場合、registerMBeanメソッドが例外をスローしたとしても、MBeanは実際に登録されます。 RuntimeMBeanExceptionはpreRegisterでもスローされますが、その場合はMBeanは登録されません。

RuntimeErrorException - MBeanのpostRegister (MBeanRegistrationインタフェース)メソッドがErrorをスローすると、MBeanの登録は成功しますが、registerMBeanメソッドはRuntimeErrorExceptionをスローします。 このような場合、registerMBeanメソッドが例外をスローしたとしても、MBeanは実際に登録されます。 RuntimeErrorExceptionはpreRegisterでもスローされますが、その場合はMBeanは登録されません。

NotCompliantMBeanException - このオブジェクトがJMX準拠のMBeanでない場合

RuntimeOperationsException - java.lang.IllegalArgumentExceptionをラップする場合。すなわち、パラメータに渡されるオブジェクトがnullであるか、オブジェクト名が指定されていない場合。

関連項目:

• MBeanRegistration

unregisterMBean

void unregisterMBean(ObjectName name) throws InstanceNotFoundException, MBeanRegistrationException

MBeanサーバーからMBeanの登録を解除します。 MBeanはオブジェクト名で識別されます。 メソッドを呼び出したあと、オブジェクト名を指定してこのMBeanにアクセスすることはできません。

このメソッドがMBeanの登録解除に成功すると、前述の通知が送信されます。

定義:

unregisterMBean、インタフェースMBeanServerConnection

パラメータ:

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

例外:

RuntimeOperationsException - java.lang.IllegalArgumentExceptionをラップする場合。すなわち、パラメータ内のオブジェクト名がnullであるか、登録解除しようとしているMBeanがMBeanServerDelegateである場合。

RuntimeMBeanException - MBeanのpostDeregister (MBeanRegistrationインタフェース)メソッドがRuntimeExceptionをスローすると、MBeanの登録解除は成功しますが、unregisterMBeanメソッドはRuntimeMBeanExceptionをスローします。 このような場合、unregisterMBeanメソッドが例外をスローしたとしても、MBeanは実際に登録解除されます。 RuntimeMBeanExceptionはpreDeregisterでもスローされますが、その場合はMBeanの登録は解除されません。

RuntimeErrorException - MBeanのpostDeregister (MBeanRegistrationインタフェース)メソッドがErrorをスローすると、MBeanの登録解除は成功しますが、unregisterMBeanメソッドはRuntimeErrorExceptionをスローします。 このような場合、unregisterMBeanメソッドが例外をスローしたとしても、MBeanは実際に登録解除されます。 RuntimeMBeanExceptionはpreDeregisterでもスローされますが、その場合はMBeanの登録は解除されません。

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

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

関連項目:

• MBeanRegistration

getObjectInstance

ObjectInstance getObjectInstance(ObjectName name) throws InstanceNotFoundException

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

MBeanに登録された、指定されたMBeanのObjectInstanceを取得します。

定義:

getObjectInstance、インタフェースMBeanServerConnection

パラメータ:

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

戻り値:

nameで指定されたMBeanに関連付けられたObjectInstance。 含まれるObjectNameはnameで、含まれるクラス名はgetMBeanInfo(name).getClassName()。

例外:

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

queryMBeans

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

MBeanサーバーによって制御されるMBeanを取得します。 このメソッドは、すべてのMBean、ObjectNameやクエリー式のパターン・マッチングによって指定されたMBeanのセット、特定のMBeanのいずれかを返します。 オブジェクト名がnullである場合、またはドメインやキーのプロパティが指定されていない場合、すべてのオブジェクトが選択されます。クエリーが指定されている場合は、さらにフィルタリングが適用されます。 このメソッドは、選択されたMBeanに対して、ObjectInstanceオブジェクトのセット(ObjectNameとJavaクラス名を含む)を返します。

定義:

queryMBeans、インタフェースMBeanServerConnection

パラメータ:

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

query - MBeanの選択に適用されるクエリー式。 nullの場合、MBeanの選択にクエリー式は適用されない。

戻り値:

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

queryNames

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

MBeanサーバーによって制御されるMBeanの名前を取得します。 このメソッドは、すべてのMBeanの名前、ObjectNameやQuery式のパターン・マッチングによって指定されたMBeanのセットの名前、特定のMBeanの名前のいずれかを返します。これにより、MBeanが登録されているかどうかを判別できます。 オブジェクト名がnullである場合、またはドメインやキーのプロパティが指定されていない場合、すべてのオブジェクトが選択されます。クエリーが指定されている場合は、さらにフィルタリングが適用されます。 このメソッドは、選択されたMBeanに対して、ObjectNameのセットを返します。

定義:

queryNames、インタフェースMBeanServerConnection

パラメータ:

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

query - MBeanの選択に適用されるクエリー式。 nullの場合、MBeanの選択にクエリー式は適用されない。

戻り値:

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

isRegistered

boolean isRegistered(ObjectName name)

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

このオブジェクト名で識別されるMBeanが、すでにMBeanサーバーに登録されているかどうかをチェックします。

定義:

isRegistered、インタフェースMBeanServerConnection

パラメータ:

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

戻り値:

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

例外:

RuntimeOperationsException - java.lang.IllegalArgumentExceptionをラップする場合。すなわち、パラメータ内のオブジェクト名がnullの場合。

getMBeanCount

Integer getMBeanCount()

MBeanサーバーに登録されているMBeanの数を返します。

定義:

getMBeanCount、インタフェースMBeanServerConnection

戻り値:

登録済MBeanの数。Integerにラップされる。 呼出し元のアクセス権が制限されている場合、この数は呼出し元からアクセスできるMBeanの数より大きくなる可能性がある。

getAttribute

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

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

指定されたMBeanの特定の属性の値を取得します。 MBeanはオブジェクト名で識別されます。

定義:

getAttribute、インタフェースMBeanServerConnection

パラメータ:

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

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

戻り値:

取得される属性の値。

例外:

RuntimeOperationsException - java.lang.IllegalArgumentExceptionをラップする場合。すなわち、パラメータ内のオブジェクト名がnullであるか、パラメータ内の属性がnullである場合。

MBeanException - MBeanのgetterによってスローされる例外をラップする場合。

AttributeNotFoundException - MBeanの指定された属性がアクセス不能である場合。

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

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

関連項目:

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

getAttributes

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

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

指定されたMBeanの複数の属性の値を取り出します。 MBeanはオブジェクト名で識別されます。

何らかの理由で1つ以上の属性を取得できない場合、それらは返されるAttributeListから省略されます。 呼出し側はリストがattributes配列と同じサイズであることを確認する必要があります。 属性の取得を妨げた問題を見つけるには、その属性のgetAttributeを呼び出します。

このメソッドを呼び出して、要求されたすべての属性を正常に取得できたことを確認する例を次に示します。

 String[] attrNames = ...;
 AttributeList list = mbeanServerConnection.getAttributes(objectName, attrNames);
 if (list.size() == attrNames.length)
     System.out.println("All attributes were retrieved successfully");
 else {
     List<String> missing = new ArrayList<String>(Arrays.asList(attrNames));
     for (Attribute a : list.asList())
         missing.remove(a.getName());
     System.out.println("Did not retrieve: " + missing);
 }
 

定義:

getAttributes、インタフェースMBeanServerConnection

パラメータ:

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

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

戻り値:

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

例外:

RuntimeOperationsException - java.lang.IllegalArgumentExceptionをラップする場合。すなわち、パラメータ内のオブジェクト名がnullであるか、パラメータ内の属性がnullである場合。

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

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

関連項目:

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

setAttribute

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

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

指定されたMBeanの特定の属性の値を設定します。 MBeanはオブジェクト名で識別されます。

定義:

setAttribute、インタフェースMBeanServerConnection

パラメータ:

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

attribute - 設定される属性のIDと設定される値。

例外:

RuntimeOperationsException - java.lang.IllegalArgumentExceptionをラップする場合。すなわち、パラメータ内のオブジェクト名がnullであるか、パラメータ内の属性がnullである場合。

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

AttributeNotFoundException - MBeanの指定された属性がアクセス不能である場合。

InvalidAttributeValueException - 指定された値が、属性に対する有効な値でない場合。

MBeanException - MBeanのsetterによってスローされる例外をラップする場合。

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

関連項目:

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

setAttributes

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

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

指定されたMBeanの複数の属性の値を設定します。 MBeanはオブジェクト名で識別されます。

何らかの理由で1つ以上の属性を設定できない場合、それらは返されるAttributeListから省略されます。 呼出し側は入力のAttributeListが出力のそれと同じサイズであることを確認する必要があります。 属性の取得を妨げた問題の発見は、通常、その属性のsetAttributeを呼び出すことで可能ですが、必ずしも成功する保証はありません。 たとえば、2つの属性の値が互いに矛盾するために拒否された可能性があります。 どちらか1つであれば、設定できる可能性があります。

このメソッドを呼び出して、要求されたすべての属性を正常に設定できたことを確認する例を次に示します。

 AttributeList inputAttrs = ...;
 AttributeList outputAttrs = mbeanServerConnection.setAttributes(objectName, inputAttrs);
 if (inputAttrs.size() == outputAttrs.size())
     System.out.println("All attributes were set successfully");
 else {
     List<String> missing = new ArrayList<String>();
     for (Attribute a : inputAttrs.asList())
         missing.add(a.getName());
     for (Attribute a : outputAttrs.asList())
         missing.remove(a.getName());
     System.out.println("Did not set: " + missing);
 }
 

定義:

setAttributes、インタフェースMBeanServerConnection

パラメータ:

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

attributes - 属性のリスト。属性のリスト(設定される属性のIDと設定される値)。

戻り値:

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

例外:

RuntimeOperationsException - java.lang.IllegalArgumentExceptionをラップする場合。すなわち、パラメータ内のオブジェクト名がnullであるか、パラメータ内の属性がnullである場合。

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

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

関連項目:

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

invoke

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

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

MBean上でオペレーションを呼び出します。

オーバーロードされる可能性があるオペレーションを区別するためにsignatureが必要であるため、可能な場合は、MBeanプロキシを介してさらに簡単にオペレーションを呼び出すことができます。 たとえば、次のようなStandard MBeanインタフェースが存在する場合を考えましょう。

 public interface FooMBean {
     public int countMatches(String[] patterns, boolean ignoreCase);
 }
 

countMatchesオペレーションは次のようにして呼び出すことができます。

 String[] myPatterns = ...;
 int count = (Integer) mbeanServerConnection.invoke(
         objectName,
         "countMatches",
         new Object[] {myPatterns, true},
         new String[] {String[].class.getName(), boolean.class.getName()});
 

または、次のようにプロキシを介して呼び出すこともできます。

 String[] myPatterns = ...;
 FooMBean fooProxy = JMX.newMBeanProxy(
         mbeanServerConnection, objectName, FooMBean.class);
 int count = fooProxy.countMatches(myPatterns, true);
 

定義:

invoke、インタフェースMBeanServerConnection

パラメータ:

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

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

params - オペレーションの呼出し時に設定されるパラメータを含む配列。

signature - オペレーションのシグニチャを含む配列(Class.getName()から返される形式のクラス名の配列)。 クラス・オブジェクトのロードには、オペレーションを呼び出したMBeanをロードするときと同じクラス・ローダーが使用される。

戻り値:

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

例外:

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

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

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

getDefaultDomain

String getDefaultDomain()

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

MBeanの指定に使用するデフォルトのドメインを返します。 ユーザーがドメイン名を指定しなかった場合、MBeanのObjectNameのドメイン部分には、デフォルトのドメイン名が入ります。

定義:

getDefaultDomain、インタフェースMBeanServerConnection

戻り値:

デフォルトのドメイン。

getDomains

String[] getDomains()

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

MBeanが現在登録されているドメインのリストを返します。 返される配列内に文字列が含まれるのは、その文字列と等しいgetDomain()を持つObjectNameに1個以上のMBeanが登録されている場合だけです。 返される配列内の文字列の順序は未定義です。

定義:

getDomains、インタフェースMBeanServerConnection

戻り値:

ドメインのリスト。

addNotificationListener

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

登録済みMBeanにリスナーを追加します。 MBeanが発行した通知は、リスナーに転送されます。

通知のソースがMBeanオブジェクトの参照になっている場合、MBeanサーバーは、これをMBeanのObjectNameで置き換えます。 それ以外の場合、ソースが変更されることはありません。

定義:

addNotificationListener、インタフェースMBeanServerConnection

パラメータ:

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

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

filter - フィルタ・オブジェクト。 フィルタがnullの場合、通知処理の前にフィルタは適用されない。

handback - 通知が発行されたときリスナーに送信されるコンテキスト。

例外:

InstanceNotFoundException - 登録済みMBeanの中に、指定されたMBean名がない場合。

関連項目:

• MBeanServerConnection.removeNotificationListener(ObjectName, NotificationListener)
• MBeanServerConnection.removeNotificationListener(ObjectName, NotificationListener, NotificationFilter, Object)

addNotificationListener

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

登録済みMBeanにリスナーを追加します。

MBeanが発行した通知は、MBeanServerによってリスナーに転送されます。 通知のソースがMBeanオブジェクトの参照になっている場合、MBeanサーバーは、これをMBeanのObjectNameで置き換えます。 それ以外の場合、ソースが変更されることはありません。

通知を受け取るリスナー・オブジェクトは、このメソッドの呼出し時に指定された名前で登録されたリスナー・オブジェクトです。 その後は登録しなくても引き続き通知を受け取ります。

定義:

addNotificationListener、インタフェースMBeanServerConnection

パラメータ:

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

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

filter - フィルタ・オブジェクト。 フィルタがnullの場合、通知処理の前にフィルタは適用されない。

handback - 通知が発行されたときリスナーに送信されるコンテキスト。

例外:

RuntimeOperationsException - IllegalArgumentExceptionをラップする場合。 listenerによって指定されたMBeanが存在していても、NotificationListenerインタフェースを実装していない場合。

InstanceNotFoundException - 登録済みMBeanの中に、通知リスナーまたは通知ブロードキャスタのMBean名がない場合。

関連項目:

• MBeanServerConnection.removeNotificationListener(ObjectName, ObjectName)
• MBeanServerConnection.removeNotificationListener(ObjectName, ObjectName, NotificationFilter, Object)

removeNotificationListener

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

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

登録済みMBeanからリスナーを削除します。

リスナーが、別のフィルタまたはコールバックにより複数回登録された場合、このメソッドは、これらすべての登録を削除します。

定義:

removeNotificationListener、インタフェースMBeanServerConnection

パラメータ:

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

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

例外:

InstanceNotFoundException - 登録済みMBeanの中に、指定されたMBean名がない場合。

ListenerNotFoundException - リスナーがMBeanに登録されていない場合。

関連項目:

• MBeanServerConnection.addNotificationListener(ObjectName, ObjectName, NotificationFilter, Object)

removeNotificationListener

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

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

登録済みMBeanからリスナーを削除します。

MBeanは、指定されたlistener、filter、およびhandbackパラメータと正確に一致するリスナーを持っている必要があります。 該当するリスナーが複数存在する場合、そのうちの1つだけが削除されます。

削除されるリスナー内でnullが指定されている場合にのみ、filterおよびhandbackパラメータはnullになります。

定義:

removeNotificationListener、インタフェースMBeanServerConnection

パラメータ:

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

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

filter - リスナーの追加時に指定されたフィルタ。

handback - リスナーの追加時に指定されたハンドバック。

例外:

InstanceNotFoundException - 登録済みMBeanの中に、指定されたMBean名がない場合。

ListenerNotFoundException - リスナーがMBeanに登録されていない場合、または指定されたフィルタおよびハンドバックで登録されていない場合。

関連項目:

• MBeanServerConnection.addNotificationListener(ObjectName, ObjectName, NotificationFilter, Object)

removeNotificationListener

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

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

登録済みMBeanからリスナーを削除します。

リスナーが、別のフィルタまたはコールバックにより複数回登録された場合、このメソッドは、これらすべての登録を削除します。

定義:

removeNotificationListener、インタフェースMBeanServerConnection

パラメータ:

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

listener - 削除されるリスナー。

例外:

InstanceNotFoundException - 登録済みMBeanの中に、指定されたMBean名がない場合。

ListenerNotFoundException - リスナーがMBeanに登録されていない場合。

関連項目:

• MBeanServerConnection.addNotificationListener(ObjectName, NotificationListener, NotificationFilter, Object)

removeNotificationListener

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

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

登録済みMBeanからリスナーを削除します。

MBeanは、指定されたlistener、filter、およびhandbackパラメータと正確に一致するリスナーを持っている必要があります。 該当するリスナーが複数存在する場合、そのうちの1つだけが削除されます。

削除されるリスナー内でnullが指定されている場合にのみ、filterおよびhandbackパラメータはnullになります。

定義:

removeNotificationListener、インタフェースMBeanServerConnection

パラメータ:

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

listener - 削除されるリスナー。

filter - リスナーの追加時に指定されたフィルタ。

handback - リスナーの追加時に指定されたハンドバック。

例外:

InstanceNotFoundException - 登録済みMBeanの中に、指定されたMBean名がない場合。

ListenerNotFoundException - リスナーがMBeanに登録されていない場合、または指定されたフィルタおよびハンドバックで登録されていない場合。

関連項目:

• MBeanServerConnection.addNotificationListener(ObjectName, NotificationListener, NotificationFilter, Object)

getMBeanInfo

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

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

このメソッドは、MBeanが管理用として公開している属性とオペレーションを検出します。

定義:

getMBeanInfo、インタフェースMBeanServerConnection

パラメータ:

name - 分析対象のMBeanの名前

戻り値:

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

例外:

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

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

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

isInstanceOf

boolean isInstanceOf(ObjectName name, String className) throws InstanceNotFoundException

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

指定されたMBeanが指定されたクラスのインスタンスである場合はtrue、そうでない場合はfalseを返します。

nameがMBeanを指定していない場合、このメソッドはInstanceNotFoundExceptionをスローします。

それ以外の場合、
Xはnameで指定されたMBean、
LはXのClassLoader、
NはXのMBeanInfo内のクラス名になります。

NがclassNameと等しい場合、結果はtrueです。

それ以外の場合、LがclassNameを正常にロードし、Xがこのクラスのインスタンスである場合、結果はtrueです。

それ以外の場合、LがNとclassNameの両方を正常にロードし、最初のクラスから2番目のクラスを割り当てることができる場合、結果はtrueです。

それ以外の場合、結果はfalseです。

定義:

isInstanceOf、インタフェースMBeanServerConnection

パラメータ:

name - MBeanのObjectName。

className - クラスの名前。

戻り値:

上記の規則に従って、指定されたMBeanが指定されたクラスのインスタンスである場合はtrue、そうでない場合はfalse。

例外:

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

関連項目:

• Class.isInstance(java.lang.Object)

instantiate

Object instantiate(String className) throws ReflectionException, MBeanException

MBeanサーバーのClass Loader Repository内に登録されたすべてのクラス・ローダーのリストを使って、オブジェクトをインスタンス化します。 オブジェクトのクラスは、publicコンストラクタを持っていなければいけません。 このメソッドは、新しく生成されたオブジェクトの参照を返します。 新しく生成されたオブジェクトは、MBeanサーバーに登録されていません。

このメソッドは、instantiate(className,(Object[]) null,(String[]) null)と同等です。

パラメータ:

className - インスタンス化するオブジェクトのクラス名。

戻り値:

新しくインスタンス化されたオブジェクト。

例外:

ReflectionException - オブジェクトのコンストラクタの呼出し時に発行されるjava.lang.ClassNotFoundExceptionまたはjava.lang.Exceptionをラップする場合。

MBeanException - オブジェクトのコンストラクタが例外をスローした場合。

RuntimeOperationsException - java.lang.IllegalArgumentExceptionをラップする場合。すなわち、パラメータに渡されるclassNameがnullの場合。

instantiate

Object instantiate(String className, ObjectName loaderName) throws ReflectionException, MBeanException, InstanceNotFoundException

ObjectNameで指定されたクラス・ローダーを使って、オブジェクトをインスタンス化します。 ローダー名がnullの場合、MBeanサーバーのロードに使用されたClassLoaderが使用されます。 オブジェクトのクラスは、publicコンストラクタを持っていなければいけません。 このメソッドは、新しく生成されたオブジェクトの参照を返します。 新しく生成されたオブジェクトは、MBeanサーバーに登録されていません。

このメソッドは、instantiate(className, loaderName,(Object[]) null,(String[]) null)と同等です。

パラメータ:

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

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

戻り値:

新しくインスタンス化されたオブジェクト。

例外:

ReflectionException - オブジェクトのコンストラクタの呼出し時に発行されるjava.lang.ClassNotFoundExceptionまたはjava.lang.Exceptionをラップする場合。

MBeanException - オブジェクトのコンストラクタが例外をスローした場合。

InstanceNotFoundException - 指定されたクラス・ローダーがMBeanServerに登録されていない場合。

RuntimeOperationsException - java.lang.IllegalArgumentExceptionをラップする場合。すなわち、パラメータに渡されるclassNameがnullの場合。

instantiate

Object instantiate(String className, Object[] params, String[] signature) throws ReflectionException, MBeanException

MBeanサーバーのClass Loader Repository内に登録されたすべてのクラス・ローダーのリストを使って、オブジェクトをインスタンス化します。 オブジェクトのクラスは、publicコンストラクタを持っていなければいけません。 この呼出しは、新しく生成されたオブジェクトの参照を返します。 新しく生成されたオブジェクトは、MBeanサーバーに登録されていません。

パラメータ:

className - インスタンス化するオブジェクトのクラス名。

params - 呼び出されるコンストラクタのパラメータを含む配列。

signature - 呼び出されるコンストラクタのシグニチャを含む配列。

戻り値:

新しくインスタンス化されたオブジェクト。

例外:

ReflectionException - オブジェクトのコンストラクタの呼出し時に発行されるjava.lang.ClassNotFoundExceptionまたはjava.lang.Exceptionをラップする場合。

MBeanException - オブジェクトのコンストラクタが例外をスローした場合。

RuntimeOperationsException - java.lang.IllegalArgumentExceptionをラップする場合。すなわち、パラメータに渡されるclassNameがnullの場合。

instantiate

Object instantiate(String className, ObjectName loaderName, Object[] params, String[] signature) throws ReflectionException, MBeanException, InstanceNotFoundException

オブジェクトをインスタンス化します。 使用するクラス・ローダーは、オブジェクト名で識別されます。 ローダーのオブジェクト名がnullの場合、MBeanサーバーのロードに使用したClassLoaderが使用されます。 オブジェクトのクラスは、publicコンストラクタを持っていなければいけません。 この呼出しは、新しく生成されたオブジェクトの参照を返します。 新しく生成されたオブジェクトは、MBeanサーバーに登録されていません。

パラメータ:

className - インスタンス化するオブジェクトのクラス名。

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

params - 呼び出されるコンストラクタのパラメータを含む配列。

signature - 呼び出されるコンストラクタのシグニチャを含む配列。

戻り値:

新しくインスタンス化されたオブジェクト。

例外:

ReflectionException - オブジェクトのコンストラクタの呼出し時に発行されるjava.lang.ClassNotFoundExceptionまたはjava.lang.Exceptionをラップする場合。

MBeanException - オブジェクトのコンストラクタが例外をスローした場合。

InstanceNotFoundException - 指定されたクラス・ローダーがMBeanサーバーに登録されていない場合。

RuntimeOperationsException - java.lang.IllegalArgumentExceptionをラップする場合。すなわち、パラメータに渡されるclassNameがnullの場合。

deserialize

@Deprecated(since="1.5") default ObjectInputStream deserialize(ObjectName name, byte[] data) throws InstanceNotFoundException, OperationsException

非推奨。

getClassLoaderForを使って、直列化復元に使用する適切なクラス・ローダーを取得します。

MBeanのクラス・ローダーのコンテキストで、バイト配列を直列化復元します。

実装要件:

このメソッドは、デフォルトでUnsupportedOperationExceptionをスローします。

パラメータ:

name - MBeanの名前。このMBeanのクラス・ローダーを使って、直列化復元が行われる。

data - 直列化復元の対象となるバイト配列。

戻り値:

直列化復元されたオブジェクト・ストリーム。

例外:

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

OperationsException - 通常の入出力関連の例外が発生した場合。

deserialize

@Deprecated(since="1.5") default ObjectInputStream deserialize(String className, byte[] data) throws OperationsException, ReflectionException

非推奨。

getClassLoaderRepository()を使ってクラス・ローダー・リポジトリを取得し、それを使って直列化復元を行います。

指定されたMBeanクラス・ローダーのコンテキストで、バイト配列の直列化復元を行います。 クラス・ローダーを検索するには、Class Loader Repositoryを使ってclassNameクラスをロードします。 このクラスのクラス・ローダーが使用されます。

実装要件:

このメソッドは、デフォルトでUnsupportedOperationExceptionをスローします。

パラメータ:

className - クラスの名前。このクラスのクラス・ローダーを使って、直列化復元が行われる。

data - 直列化復元の対象となるバイト配列。

戻り値:

直列化復元されたオブジェクト・ストリーム。

例外:

OperationsException - 通常の入出力関連の例外が発生した場合。

ReflectionException - 指定されたクラスがクラス・ローダー・リポジトリにロードされない場合。

deserialize

@Deprecated(since="1.5") default ObjectInputStream deserialize(String className, ObjectName loaderName, byte[] data) throws InstanceNotFoundException, OperationsException, ReflectionException

非推奨。

getClassLoaderを使って直列化復元用のクラス・ローダーを取得します。

指定されたMBeanクラス・ローダーのコンテキストで、バイト配列の直列化復元を行います。 このクラス・ローダーは、classNameという名前でクラスをロードしたクラス・ローダーです。 指定されたクラスのロードに使用されたクラス・ローダーの名前が使用されます。 nullの場合、MBeanサーバーのクラス・ローダーが使用される。

実装要件:

このメソッドは、デフォルトでUnsupportedOperationExceptionをスローします。

パラメータ:

className - クラスの名前。このクラスのクラス・ローダーを使って、直列化復元が行われる。

loaderName - 指定されたクラスのロードに使用されるクラス・ローダーの名前。 nullの場合、MBeanサーバーのクラス・ローダーが使用される。

data - 直列化復元の対象となるバイト配列。

戻り値:

直列化復元されたオブジェクト・ストリーム。

例外:

InstanceNotFoundException - 指定されたクラス・ローダーMBeanが見つからない場合。

OperationsException - 通常の入出力関連の例外が発生した場合。

ReflectionException - 指定されたクラスが指定されたクラス・ローダーによってロードされない場合。

getClassLoaderFor

ClassLoader getClassLoaderFor(ObjectName mbeanName) throws InstanceNotFoundException

指定されたMBeanのクラスのロードに使用されたClassLoaderを返します。

パラメータ:

mbeanName - MBeanのObjectName。

戻り値:

このMBean用のClassLoader。 MBeanの実際のClassLoaderがlで、戻り値がrの場合、次のいずれかの条件が成立する。

• rがlと同一、または
• r.loadClass(s)の結果が任意の文字列sのl.loadClass(s)に一致。

つまり、ClassLoaderは、セキュリティまたはその他の理由でほかのClassLoaderにラップされる可能性があるということです。

例外:

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

getClassLoader

ClassLoader getClassLoader(ObjectName loaderName) throws InstanceNotFoundException

指定されたClassLoaderを返します。

パラメータ:

loaderName - ClassLoaderのObjectName。 nullの場合、MBeanサーバー固有のClassLoaderが返される。

戻り値:

指定のClassLoader。 その名前の実際のClassLoaderがlで、戻り値がrの場合、次のいずれかの条件が成立する。

• rがlと同一、または
• r.loadClass(s)の結果が任意の文字列sのl.loadClass(s)に一致。

つまり、ClassLoaderは、セキュリティまたはその他の理由でほかのClassLoaderにラップされる可能性があるということです。

例外:

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

getClassLoaderRepository

ClassLoaderRepository getClassLoaderRepository()

このMBeanServerのClassLoaderRepositoryを返します。

戻り値:

このMBeanServerのClassLoaderRepository。