Management (Jakarta EE 8 仕様 API)

すべてのスーパーインターフェース:
EJBObject, RemoteSE
```
public interface Management
extends EJBObject
```
管理インターフェースは、管理対象オブジェクトをナビゲートおよび操作するための API を提供します。Jakarta Management Enterprise Bean コンポーネント（MEJB）は、これをリモートインターフェースとして実装する必要があります。
作成者:
Hans Hrasna

メソッドのサマリー

すべてのメソッドインスタンスメソッド抽象メソッド
修飾子と型	メソッドと説明
`ObjectSE`	`getAttribute(ObjectNameSE name, StringSE attribute)` 名前付き管理対象オブジェクトの特定の属性の値を取得します。
`AttributeListSE`	`getAttributes(ObjectNameSE name, StringSE[] attributes)` 名前付き管理オブジェクトのいくつかの属性の値を有効にします。
`StringSE`	`getDefaultDomain()` この MEJB のデフォルトのドメイン名を返します。
`ListenerRegistration`	`getListenerRegistry()` この MEJB のリスナーレジストリ実装を返します。
`IntegerSE`	`getMBeanCount()` MEJB に登録されている管理対象オブジェクトの数を返します。
`MBeanInfoSE`	`getMBeanInfo(ObjectNameSE name)` このメソッドは、管理対象オブジェクトが管理のために公開する属性と操作を検出します。
`ObjectSE`	`invoke(ObjectNameSE name, StringSE operationName, ObjectSE[] params, StringSE[] signature)` 管理対象オブジェクトの操作を呼び出します。
`boolean`	`isRegistered(ObjectNameSE name)` オブジェクト名で識別される管理対象オブジェクトがすでに MEJB に登録されているかどうかを確認します。
`SetSE`	`queryNames(ObjectNameSE name, QueryExpSE query)` MEJB によって制御される管理対象オブジェクトの名前を取得します。
`void`	`setAttribute(ObjectNameSE name, AttributeSE attribute)` 名前付き管理対象オブジェクトの特定の属性の値を設定します。
`AttributeListSE`	`setAttributes(ObjectNameSE name, AttributeListSE attributes)` 名前付き管理オブジェクトのいくつかの属性の値を設定します。

インターフェース javax.ejb.EJBObject から継承されたメソッド
getEJBHome, getHandle, getPrimaryKey, isIdentical, remove

- メソッドの詳細
  - queryNames
```
SetSE queryNames(ObjectNameSE name,
               QueryExpSE query)
        throws RemoteExceptionSE
```
    MEJB によって制御される管理対象オブジェクトの名前を取得します。このメソッドを使用すると、次のいずれかを取得できます。すべての管理対象オブジェクトの名前、ObjectName でのパターンマッチングによって指定された一連の管理対象オブジェクトの名前、特定の管理対象オブジェクト名（管理対象オブジェクトが登録されているかどうかのテストと同等）。オブジェクト名が null の場合、またはドメインとキープロパティが指定されていない場合は、すべてのオブジェクトが選択されます。選択した管理対象オブジェクトの Jakarta EE ObjectNames のセットを返します。
    パラメーター:
    name - 取得する管理対象オブジェクトを識別するオブジェクト名パターン。null またはドメインとキーのプロパティが指定されていない場合、登録されているすべての管理オブジェクトが取得されます。
    戻り値:
    選択された管理対象オブジェクトの ObjectNames を含むセット。クエリを満たす管理オブジェクトがない場合、空のセットが返されます。
    例外:
    RemoteExceptionSE - リモートメソッド呼び出しの実行中に通信例外が発生しました
  - isRegistered
```
boolean isRegistered(ObjectNameSE name)
              throws RemoteExceptionSE
```
    オブジェクト名で識別される管理対象オブジェクトがすでに MEJB に登録されているかどうかを確認します。
    パラメーター:
    name - チェックする管理対象オブジェクトのオブジェクト名。
    戻り値:
    管理対象オブジェクトがすでに MEJB に登録されている場合は true、そうでない場合は false。
    例外:
    RemoteExceptionSE - リモートメソッド呼び出しの実行中に通信例外が発生しました
  - getMBeanCount
```
IntegerSE getMBeanCount()
               throws RemoteExceptionSE
```
    MEJB に登録されている管理対象オブジェクトの数を返します。
    例外:
    RemoteExceptionSE - リモートメソッド呼び出しの実行中に通信例外が発生しました
  - getMBeanInfo
```
MBeanInfoSE getMBeanInfo(ObjectNameSE name)
                throws IntrospectionExceptionSE,
                       InstanceNotFoundExceptionSE,
                       ReflectionExceptionSE,
                       RemoteExceptionSE
```
    このメソッドは、管理対象オブジェクトが管理のために公開する属性と操作を検出します。
    パラメーター:
    name - 分析する管理対象オブジェクトの名前
    戻り値:
    この管理対象オブジェクトのすべての属性と操作を取得できる MBeanInfo のインスタンス。
    例外:
    IntrospectionExceptionSE - イントロスペクション中に例外が発生します。
    InstanceNotFoundExceptionSE - 指定された管理対象オブジェクトが見つかりません。
    ReflectionExceptionSE - 管理対象オブジェクトでリフレクションを実行しようとしたときに例外が発生しました
    RemoteExceptionSE - リモートメソッド呼び出しの実行中に通信例外が発生しました
  - getAttribute
```
ObjectSE getAttribute(ObjectNameSE name,
                    StringSE attribute)
             throws MBeanExceptionSE,
                    AttributeNotFoundExceptionSE,
                    InstanceNotFoundExceptionSE,
                    ReflectionExceptionSE,
                    RemoteExceptionSE
```
    名前付き管理対象オブジェクトの特定の属性の値を取得します。管理対象オブジェクトは、そのオブジェクト名で識別されます。
    パラメーター:
    name - 属性の取得元となる管理対象オブジェクトのオブジェクト名。
    attribute - 取得する属性の名前を指定する文字列。
    戻り値:
    取得した属性の値。
    例外:
    AttributeNotFoundExceptionSE - 指定された属性は、管理対象オブジェクトではアクセスできません。
    MBeanExceptionSE - 管理対象オブジェクトの getter によってスローされた例外をラップします。
    InstanceNotFoundExceptionSE - 指定された管理対象オブジェクトは MEJB に登録されていません。
    ReflectionExceptionSE - 動的 MBean の getAttribute メソッドを呼び出そうとしたときに例外が発生しました
    RemoteExceptionSE - リモートメソッド呼び出しの実行中に通信例外が発生しました
  - getAttributes
```
AttributeListSE getAttributes(ObjectNameSE name,
                            StringSE[] attributes)
                     throws InstanceNotFoundExceptionSE,
                            ReflectionExceptionSE,
                            RemoteExceptionSE
```
    名前付き管理対象オブジェクトのいくつかの属性の値を有効にします。管理対象オブジェクトは、そのオブジェクト名で識別されます。
    パラメーター:
    name - 属性の取得元の管理対象オブジェクトのオブジェクト名。
    attributes - 取得する属性のリスト。
    戻り値:
    取得した属性のリスト。
    例外:
    InstanceNotFoundExceptionSE - 指定された管理対象オブジェクトは MEJB に登録されていません。
    ReflectionExceptionSE - 動的 MBean の getAttributes メソッドを呼び出そうとしたときに例外が発生しました。
    RemoteExceptionSE - リモートメソッド呼び出しの実行中に通信例外が発生しました
  - setAttribute
```
void setAttribute(ObjectNameSE name,
                  AttributeSE attribute)
           throws InstanceNotFoundExceptionSE,
                  AttributeNotFoundExceptionSE,
                  InvalidAttributeValueExceptionSE,
                  MBeanExceptionSE,
                  ReflectionExceptionSE,
                  RemoteExceptionSE
```
    名前付き管理対象オブジェクトの特定の属性の値を設定します。管理対象オブジェクトは、そのオブジェクト名で識別されます。
    パラメーター:
    name - 属性が設定される管理対象オブジェクトの名前。
    attribute - 設定する属性の ID と設定する値。
    例外:
    InstanceNotFoundExceptionSE - 指定された管理対象オブジェクトは MEJB に登録されていません。
    AttributeNotFoundExceptionSE - 指定された属性は、管理対象オブジェクトではアクセスできません。
    InvalidAttributeValueExceptionSE - 属性に指定された値が無効です。
    MBeanExceptionSE - 管理対象オブジェクトの setter によってスローされた例外をラップします。
    ReflectionExceptionSE - 動的 MBean の setAttribute メソッドを呼び出そうとしたときに例外が発生しました。
    RemoteExceptionSE - リモートメソッド呼び出しの実行中に通信例外が発生しました
  - setAttributes
```
AttributeListSE setAttributes(ObjectNameSE name,
                            AttributeListSE attributes)
                     throws InstanceNotFoundExceptionSE,
                            ReflectionExceptionSE,
                            RemoteExceptionSE
```
    名前付き管理対象オブジェクトのいくつかの属性の値を設定します。管理対象オブジェクトは、そのオブジェクト名で識別されます。
    パラメーター:
    name - 属性が設定される管理対象オブジェクトのオブジェクト名。
    attributes - 属性のリスト: 設定する属性の ID とそれらに設定する値。
    戻り値:
    設定された属性とその新しい値のリスト。
    例外:
    InstanceNotFoundExceptionSE - 指定された管理対象オブジェクトは MEJB に登録されていません。
    ReflectionExceptionSE - 動的 MBean の setAttributes メソッドを呼び出そうとしたときに例外が発生しました。
    RemoteExceptionSE - リモートメソッド呼び出しの実行中に通信例外が発生しました
  - invoke
```
ObjectSE invoke(ObjectNameSE name,
              StringSE operationName,
              ObjectSE[] params,
              StringSE[] signature)
       throws InstanceNotFoundExceptionSE,
              MBeanExceptionSE,
              ReflectionExceptionSE,
              RemoteExceptionSE
```
    管理対象オブジェクトの操作を呼び出します。
    パラメーター:
    name - メソッドが呼び出される管理対象オブジェクトのオブジェクト名。
    operationName - 呼び出される操作の名前。
    params - 操作が呼び出されたときに設定されるパラメーターを含む配列
    signature - 操作のシグネチャーを含む配列。クラスオブジェクトは、操作が呼び出された管理対象オブジェクトのロードに使用されたものと同じクラスローダーを使用してロードされます。
    戻り値:
    指定された管理対象オブジェクトに対して操作を呼び出した結果を表す、操作によって返されるオブジェクト。
    例外:
    InstanceNotFoundExceptionSE - 指定された管理対象オブジェクトは MEJB に登録されていません。
    MBeanExceptionSE - 管理対象オブジェクトの呼び出されたメソッドによってスローされた例外をラップします。
    ReflectionExceptionSE - メソッドを呼び出そうとしたときにスローされた java.lang.Exception をラップします。
    RemoteExceptionSE - リモートメソッド呼び出しの実行中に通信例外が発生しました
  - getDefaultDomain
```
StringSE getDefaultDomain()
                 throws RemoteExceptionSE
```
    この MEJB のデフォルトのドメイン名を返します。
    例外:
    RemoteExceptionSE - リモートメソッド呼び出しの実行中に通信例外が発生しました
  - getListenerRegistry
```
ListenerRegistration getListenerRegistry()
                                  throws RemoteExceptionSE
```
    この MEJB のリスナーレジストリ実装を返します。リスナーレジストリは、クリントがイベント通知リスナーの管理対象オブジェクトを追加および削除できるようにするメソッドを実装します
    戻り値:
    javax.management.j2ee.ListenerRegistration の実装
    例外:
    RemoteExceptionSE - リモートメソッド呼び出しの実行中に通信例外が発生しました

インターフェース Management

メソッドのサマリー

インターフェース javax.ejb.EJBObject から継承されたメソッド

メソッドの詳細

queryNames

isRegistered

getMBeanCount

getMBeanInfo

getAttribute

getAttributes

setAttribute

setAttributes

invoke

getDefaultDomain

getListenerRegistry