RequiredModelMBean (Java Platform SE 7)

java.lang.Object
- javax.management.modelmbean.RequiredModelMBean

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

DynamicMBean, MBeanRegistration, ModelMBean, ModelMBeanNotificationBroadcaster, NotificationBroadcaster, NotificationEmitter, PersistentMBean
```
public class RequiredModelMBean
extends Object
implements ModelMBean, MBeanRegistration, NotificationEmitter
```
このクラスは、ModelMBean の実装です。すべての JMX エージェントに適切な ModelMBean の実装が付属している必要があります。また、クラス名は必ず RequiredModelMBean とします。
管理対象になる Java リソースは、MBeanServer の createMBean メソッドを使って、RequiredModelMBean をインスタンス化します。次に、RequiredModelMBean インスタンスの MBeanInfo および Descriptor を設定します。ModelMBean の ModelMBeanInfo で公開された属性とオペレーションには、MBean、コネクタ、アダプタからアクセスできます。Descriptor を使って、管理対象アプリケーション内の値とメソッドを定義し、ModelMBean の属性およびオペレーションにマップすることができます。このマッピングは、XML 形式のファイル内、または実行時にプログラムを使って動的に定義できます。
MBeanServer 内でインスタンス化される各 RequiredModelMBean が管理対象になります。
これらの属性およびオペレーションには、MBeanServer に接続されたコネクタまたはアダプタ経由でリモートアクセスできます。
JMX 準拠の MBean でない Java オブジェクトは、MBeanServer に登録できません。RequiredModelMBean をインスタンス化することで、リソースは MBean が有効であることを保証されます。すべての public メソッドで、MBeanException および RuntimeOperationsException がスローされる必要があります。これにより、分散型通信 (RMI、EJB など) からの例外のラップが可能になります。

導入されたバージョン:

1.5

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

コンストラクタ
コンストラクタと説明
`RequiredModelMBean()` 空の ModelMBeanInfo で `RequiredModelMBean` を構築します。
`RequiredModelMBean(ModelMBeanInfo mbi)` 渡された ModelMBeanInfo を使って RequiredModelMBean オブジェクトを構築します。

メソッドのサマリー

メソッド
修飾子と型	メソッドと説明
`void`	`addAttributeChangeNotificationListener(NotificationListener inlistener, String inAttributeName, Object inhandback)` NotificationListener インタフェースを実装するオブジェクトをリスナーとして登録します。
`void`	`addNotificationListener(NotificationListener listener, NotificationFilter filter, Object handback)` NotificationListener インタフェースを実装するオブジェクトをリスナーとして登録します。
`Object`	`getAttribute(String attrName)` この ModelMBean に定義された特定の属性の値を返します。
`AttributeList`	`getAttributes(String[] attrNames)` ModelMBean 内の複数の属性の値を返します。
`protected ClassLoaderRepository`	`getClassLoaderRepository()` クラスのロードに使用されたクラスローダーリポジトリを返します。
`MBeanInfo`	`getMBeanInfo()` この RequiredModelMBean が管理用に公開する属性、オペレーション、コンストラクタ、および通知を返します。
`MBeanNotificationInfo[]`	`getNotificationInfo()` 常に RequiredModelMBean によって生成される Notification の配列を返します。
`Object`	`invoke(String opName, Object[] opArgs, String[] sig)` RequiredModelMBean 上または経由でメソッドを呼び出し、その実行結果を返します。
`void`	`load()` この MBean インスタンスを、永続ストアで見つかる MBean 用のデータでインスタンス化します。
`void`	`postDeregister()` MBean サーバーから登録解除したあと、MBean が必要なオペレーションを実行できるようにします。
`void`	`postRegister(Boolean registrationDone)` MBean サーバーへの登録が成功または失敗したあと、MBean が必要なオペレーションを実行できるようにします。
`void`	`preDeregister()` MBean サーバーから登録解除する前に、MBean が必要なオペレーションを実行できるようにします。
`ObjectName`	`preRegister(MBeanServer server, ObjectName name)` MBean サーバーに登録する前に必要なオペレーションを MBean が実行することを許可します。
`void`	`removeAttributeChangeNotificationListener(NotificationListener inlistener, String inAttributeName)` RequiredModelMBean から attributeChangeNotification のリスナーを削除します。
`void`	`removeNotificationListener(NotificationListener listener)` RequiredModelMBean から Notification のリスナーを削除します。
`void`	`removeNotificationListener(NotificationListener listener, NotificationFilter filter, Object handback)` この MBean からリスナーを削除します。
`void`	`sendAttributeChangeNotification(Attribute inOldVal, Attribute inNewVal)` ModelMBean 上の登録済み AttributeChangeNotification リスナーに、属性の古い値と新しい値を含む attributeChangeNotification を送信します。
`void`	`sendAttributeChangeNotification(AttributeChangeNotification ntfyObj)` ModelMBean 上の登録済み attributeChangeNotification リスナーに渡される attributeChangeNotification を送信します。
`void`	`sendNotification(Notification ntfyObj)` ModelMBean 上の登録済み Notification リスナーに、jmx.modelmbean.generic 通知として渡される Notification を送信します。
`void`	`sendNotification(String ntfyText)` ModelMBean 上の登録済み Notification リスナーに渡されるテキスト文字列を含む Notification を送信します。
`void`	`setAttribute(Attribute attribute)` 指定された ModelMBean の特定の属性の値を設定します。
`AttributeList`	`setAttributes(AttributeList attributes)` この ModelMBean の属性の配列の値を設定します。
`void`	`setManagedResource(Object mr, String mr_type)` この ModelMBean 管理インタフェース (MBeanInfo と Descriptor) 内のすべてのメソッドの実行先オブジェクトのインスタンスハンドルを設定します。
`void`	`setModelMBeanInfo(ModelMBeanInfo mbi)` 渡された ModelMBeanInfo を使って ModelMBean オブジェクトを初期化します。
`void`	`store()` この MBean インスタンスの現在の状態を取り込み、永続ストアに書き出します。

クラス java.lang.Object から継承されたメソッド
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- コンストラクタの詳細
  - RequiredModelMBean
```
public RequiredModelMBean()
                   throws MBeanException,
                          RuntimeOperationsException
```
    空の ModelMBeanInfo で RequiredModelMBean を構築します。
    RequiredModelMBean の MBeanInfo および Descriptor は、setModelMBeanInfo(javax.management.modelmbean.ModelMBeanInfo) メソッドでカスタマイズできます。RequiredModelMBean の MBeanInfo および Descriptor のカスタマイズ後、RequiredModelMBean を MBeanServer に登録することができます。
    
    例外:
    
    MBeanException - 分散通信 Exception をラップする。
    
    RuntimeOperationsException - オブジェクトの構築時に RuntimeException をラップする。
  - RequiredModelMBean
```
public RequiredModelMBean(ModelMBeanInfo mbi)
                   throws MBeanException,
                          RuntimeOperationsException
```
    渡された ModelMBeanInfo を使って RequiredModelMBean オブジェクトを構築します。RequiredModelMBean がまだ MBeanServer に登録されていない場合に限り、setModelMBeanInfo(javax.management.modelmbean.ModelMBeanInfo) メソッドを使って RequiredModelMBean の MBeanInfo および Descriptor をカスタマイズできます。RequiredModelMBean の MBeanInfo および Descriptor のカスタマイズ後、RequiredModelMBean を MBeanServer に登録することができます。
    
    パラメータ:
    mbi - RequiredModelMBean によって使用される ModelMBeanInfo オブジェクト。指定された ModelMBeanInfo が、setModelMBeanInfo(javax.management.modelmbean.ModelMBeanInfo) で指定されたように複製され、変更される
    
    例外:
    
    MBeanException - 分散通信 Exception をラップする。
    
    RuntimeOperationsException - {link java.lang.IllegalArgumentException} をラップする。パラメータに渡される MBeanInfo が null の場合。
- メソッドの詳細
  - setModelMBeanInfo
```
public void setModelMBeanInfo(ModelMBeanInfo mbi)
                       throws MBeanException,
                              RuntimeOperationsException
```
    ModelMBeanInfo を使って ModelMBean オブジェクトを初期化します。このメソッドを使用すると、ModelMBean 上に、MBeanServer に登録されていないカスタム ModelMBeanInfo を設定できます。
    ModelMBean の ModelMBeanInfo (Descriptor 付き) をカスタマイズし、ModelMBean に設定したあと、ModelMBean を MBeanServer に登録することができます。
    ModelMBean が現在登録されている場合、このメソッドは IllegalStateException をラップする RuntimeOperationsException をスローします。
    指定の inModelMBeanInfo に GENERIC または ATTRIBUTE_CHANGE 通知の ModelMBeanNotificationInfo が含まれない場合、RequiredModelMBean により、デフォルトの ModelMBeanNotificationInfo が提供されます。
    定義:
    
    setModelMBeanInfo、インタフェース: ModelMBean
    
    パラメータ:
    mbi - ModelMBean によって使用される ModelMBeanInfo オブジェクト。
    
    例外:
    
    MBeanException - 分散通信 Exception をラップする。
    RuntimeOperationsException -
    パラメータとして渡された MBeanInfo が null の場合、IllegalArgumentException をラップする。
    
    ModelMBean が現在 MBeanServer に登録されている場合、IllegalStateException をラップする。
  - setManagedResource
```
public void setManagedResource(Object mr,
                      String mr_type)
                        throws MBeanException,
                               RuntimeOperationsException,
                               InstanceNotFoundException,
                               InvalidTargetObjectTypeException
```
    この ModelMBean 管理インタフェース (MBeanInfo と Descriptor) 内のすべてのメソッドの実行先オブジェクトのインスタンスハンドルを設定します。
    
    定義:
    
    setManagedResource、インタフェース: ModelMBean
    
    パラメータ:
    mr - 管理対象のリソースになっているオブジェクト
    mr_type - 管理対象のリソースの参照の型
    次のうちのいずれか:ObjectReference、Handle、IOR、EJBHandle、または RMIReference
    この実装でサポートされるのは ObjectReference のみ。
    
    例外:
    
    MBeanException - オブジェクトのイニシャライザが例外をスローした場合。
    
    InstanceNotFoundException - 管理対象のリソースオブジェクトが見つからない場合
    
    InvalidTargetObjectTypeException - 管理対象のリソースの型は ObjectReference でなければならない。
    
    RuntimeOperationsException - リソースの設定時に RuntimeException をラップする。
  - load
```
public void load()
          throws MBeanException,
                 RuntimeOperationsException,
                 InstanceNotFoundException
```
    この MBean インスタンスを、永続ストアで見つかる MBean 用のデータでインスタンス化します。データとして、属性とオペレーションの値をロードできます。
    
    このメソッドは、このインスタンスの構築または初期化時、MBean を MBeanServer に登録する前に呼び出します。
    
    このクラスの実装が永続性をサポートしない場合、ServiceNotFoundException をラップする MBeanException がスローされます。
    
    定義:
    
    load、インタフェース: PersistentMBean
    
    例外:
    
    MBeanException - その他の例外をラップする場合、または永続性がサポートされない場合
    
    RuntimeOperationsException - 永続メカニズムからの例外をラップする場合
    
    InstanceNotFoundException - この MBean が見つからない場合、または永続ストレージからロードできない場合
  - store
```
public void store()
           throws MBeanException,
                  RuntimeOperationsException,
                  InstanceNotFoundException
```
    この MBean インスタンスの現在の状態を取り込み、永続ストアに書き出します。属性やオペレーションの値が、状態として格納される場合もあります。
    
    このクラスの実装が永続性をサポートしない場合、ServiceNotFoundException をラップする MBeanException がスローされます。
    
    MBean の永続性ポリシーおよび属性記述子を使って、このメソッドの実行を制御します。persistPolicy フィールドが次の内容になっている場合、MBean は格納されます。
```
  != "never"
   = "always"
   = "onTimer" and now > 'lastPersistTime' + 'persistPeriod'
   = "NoMoreOftenThan" and now > 'lastPersistTime' + 'persistPeriod'
   = "onUnregister"
 
```
    persistPolicy フィールドが次の内容になっている場合、MBean は格納されません。
```
    = "never"
    = "onUpdate"
    = "onTimer" && now < 'lastPersistTime' + 'persistPeriod'
 
```
    定義:
    
    store、インタフェース: PersistentMBean
    
    例外:
    
    MBeanException - その他の例外をラップする場合、または永続性がサポートされない場合
    
    RuntimeOperationsException - 永続メカニズムからの例外をラップする場合
    
    InstanceNotFoundException - 永続ストアが見つからない場合、またはアクセスできない場合
  - getMBeanInfo
```
public MBeanInfo getMBeanInfo()
```
    この RequiredModelMBean が管理用に公開する属性、オペレーション、コンストラクタ、および通知を返します。
    
    定義:
    
    getMBeanInfo、インタフェース: DynamicMBean
    
    戻り値:
    ModelMBeanInfo のインスタンス。この MBean のすべての属性、オペレーション、および通知の取得を許可する。
  - invoke
```
public Object invoke(String opName,
            Object[] opArgs,
            String[] sig)
              throws MBeanException,
                     ReflectionException
```
    RequiredModelMBean 上または経由でメソッドを呼び出し、その実行結果を返します。
    呼び出されるメソッドとシグニチャーが RequiredModelMbean からアクセス可能なメソッドのいずれかに一致している場合、このメソッドが呼び出されます。それ以外の場合、管理対象のリソース上で、指定のメソッドの呼び出しが試行されます。
    オペレーションによって返される最後の値は、ModelMBeanOperationInfo の記述子内のオペレーション記述子にキャッシュされることがあります。有効な値が存在する場合、value フィールド内に存在します。値がキャッシュされるかどうかは、記述子内の currencyTimeLimit フィールドの値によって決まります。
    - <0 の場合、値は無効で、キャッシュされない。オペレーションメソッドが呼び出される。value フィールドと lastUpdatedTimeStamp フィールドはクリアされる。
    - =0 の場合、値は常に有効で、常にキャッシュされる。value フィールドが返される。value フィールドが存在しない場合、属性用としてオペレーションメソッドが呼び出される。lastUpdatedTimeStamp フィールドと value フィールドには、オペレーションの戻り値および現在のタイムスタンプが設定される。
    - >0 は、value フィールドの有効期間を表す秒数。lastUpdatedTimeStamp + currencyTimeLimit > Now の場合、value フィールドは無効になる。
      
      value が有効である場合、value が返される。
      
      value が無効になった場合、オペレーションメソッドが呼び出される。lastUpdatedTimeStamp フィールドおよび value フィールドが更新される。
    注:以前のバージョンの仕様との不整合があるため、currencyTimeLimit にはゼロ以下の値を使用しないようにしてください。キャッシュに入った値が有効でないことを示す場合は、currencyTimeLimit フィールドを省略します。この値が常に有効であることを示す場合は、このフィールドに非常に大きい値を指定します。
    定義:
    
    invoke、インタフェース: DynamicMBean
    
    パラメータ:
    opName - 呼び出されるメソッドの名前。クラス名を含む完全修飾メソッド名。オペレーション記述子の class フィールドにクラス名が定義されている場合はメソッド名のみ。
    opArgs - オペレーションの呼び出し時に設定されるパラメータを含む配列。
    sig - オペレーションのシグニチャーを含む配列。クラスオブジェクトのロードには、オペレーションを呼び出した MBean をロードするときと同じクラスローダーが使用される。
    
    戻り値:
    メソッドによって返されるオブジェクト。指定された管理対象のリソース上でメソッドを呼び出した結果を表す。
    
    例外:
    MBeanException - 次のいずれかの Exception をラップする:
    
    管理対象オブジェクトの呼び出しメソッドによってスローされた Exception。
    
    ServiceNotFoundException:ModelMBeanOperationInfo が存在しない場合、指定のオペレーションの記述子が定義されていない場合、または管理対象のリソースが null の場合。
    
    InvalidTargetObjectTypeException:targetType フィールドの値が objectReference でない場合。
    ReflectionException - メソッドの呼び出し時にスローされる Exception をラップする。
    
    RuntimeOperationsException - IllegalArgumentException をラップする。メソッド名が null の場合。
  - getAttribute
```
public Object getAttribute(String attrName)
                    throws AttributeNotFoundException,
                           MBeanException,
                           ReflectionException
```
    この ModelMBean に定義された特定の属性の値を返します。属性によって返される最後の値は、属性の記述子内にキャッシュされることがあります。有効な値が存在する場合、value フィールド内に存在します。値がキャッシュされるかどうかは、記述子内の currencyTimeLimit フィールドの値によって決まります。
    - <0 の場合、値は無効で、キャッシュされない。属性に対して取得メソッドが呼び出される。value フィールドと lastUpdatedTimeStamp フィールドはクリアされる。
    - =0 の場合、値は常に有効で、常にキャッシュされる。value フィールドが返される。value フィールドが存在しない場合、属性用として取得メソッドが呼び出される。lastUpdatedTimeStamp フィールドと value フィールドには、属性値および現在のタイムスタンプが設定される。
    - >0 は、value フィールドの有効期間を表す秒数。lastUpdatedTimeStamp + currencyTimeLimit > Now の場合、value フィールドは無効になる。
      
      value が有効である場合、value が返される。
      
      value が無効になった場合、属性に対して取得メソッドが呼び出される。lastUpdatedTimeStamp フィールドおよび value フィールドが更新される。
    注:以前のバージョンの仕様との不整合があるため、currencyTimeLimit にはゼロ以下の値を使用しないようにしてください。キャッシュに入った値が有効でないことを示す場合は、currencyTimeLimit フィールドを省略します。この値が常に有効であることを示す場合は、このフィールドに非常に大きい値を指定します。
    
    getMethod フィールドに有効なオペレーション記述子の名前が含まれる場合、このオペレーション記述子によって記述されたメソッドが実行されます。メソッドは、応答として属性値を返します。オペレーションが失敗した場合、または戻り値の型が属性の宣言型と互換性がない場合、例外がスローされます。
    
    getMethod フィールドが定義されていない場合、属性のデフォルト値が返されます。戻り値の型が属性の宣言型と互換性がない場合、例外がスローされます。
    
    属性の宣言型は、MBeanAttributeInfo.getType() により返される String です。次のいずれかが当てはまる場合、値はこの型と互換性があります。
    - value が null である。
    - 宣言された名前がプリミティブ型の名前 (「int」など) であり、値が対応するラッパー型のインスタンス (java.lang.Integer など) である。
    - 値のクラスの名前が、宣言された名前と同一である。
    - 宣言された名前を値のクラスローダーを使ってロードできる。また、値を割り当て可能なクラスが生成される。
    この実装で、getMethod を呼び出す必要がある場合は、呼び出しが正常に行われるように、この getMethod に対してオペレーションを指定する必要があります。これは、メソッドが標準の呼び出しメソッドから呼び出され、operationInfo が必要になるからです。
    定義:
    
    getAttribute、インタフェース: DynamicMBean
    
    パラメータ:
    attrName - 取得される属性の名前を指定する String。ModelMBeanAttributeInfo の名前に一致している必要がある。
    
    戻り値:
    記述子の value フィールドから取得した属性の値。または、記述子の getMethod フィールド内のオペレーションの呼び出しによって取得した属性の値。
    
    例外:
    AttributeNotFoundException - 指定の属性が MBean にアクセスできない場合。次の場合、AttributeNotFoundException がスローされる可能性がある。
    
    ModelMBean の ModelMBeanInfo が見つからない場合。
    
    指定の属性名の ModelMBeanAttributeInfo が見つからない場合。
    
    ModelMBeanAttributeInfo の isReadable メソッドの戻り値が false の場合。
    MBeanException - 次のいずれかの Exception をラップする:
    
    InvalidAttributeValueException:属性の取得メソッドから受け取った値の型が不正な場合、または属性の記述子内に getMethod フィールドが定義されておらず、デフォルト値が存在しない場合。
    
    ServiceNotFoundException:属性の取得メソッドに対して ModelMBeanOperationInfo が定義されていない場合、ModelMBeanOperationInfo に記述子が関連付けられていない場合、または管理対象のリソースが null の場合。
    
    InvalidTargetObjectTypeException。targetType フィールドの値が objectReference でない場合。
    
    管理対象オブジェクトの取得メソッドによってスローされた Exception。
    ReflectionException - 取得メソッドの呼び出し時にスローされる Exception をラップする。
    
    RuntimeOperationsException - IllegalArgumentException をラップする場合:パラメータ内の属性名は null。
    関連項目:
    setAttribute(javax.management.Attribute)
  - getAttributes
```
public AttributeList getAttributes(String[] attrNames)
```
    ModelMBean 内の複数の属性の値を返します。渡される attrNames 配列内の属性名ごとに getAttribute を実行します。
    
    定義:
    
    getAttributes、インタフェース: DynamicMBean
    
    パラメータ:
    attrNames - 取得される属性の名前から成る String 配列。
    
    戻り値:
    取得される String 配列。
    
    例外:
    
    RuntimeOperationsException - IllegalArgumentException をラップする場合:すなわち、パラメータ内のオブジェクト名が null であるか、パラメータ内の属性が null である場合。
    関連項目:
    setAttributes(javax.management.AttributeList)
  - setAttribute
```
public void setAttribute(Attribute attribute)
                  throws AttributeNotFoundException,
                         InvalidAttributeValueException,
                         MBeanException,
                         ReflectionException
```
    指定された ModelMBean の特定の属性の値を設定します。属性の記述子の setMethod フィールドに有効なオペレーション記述子の名前が含まれる場合、このオペレーション記述子によって記述されたメソッドが実行されます。この実装では、setMethod を正常に動作させるため、オペレーション記述子を正しく指定し、modelMBeanInfo に割り当てる必要があります。メソッドからの応答内容は、記述子内の属性の値として設定されます。
    currencyTimeLimit が > 0 の場合、属性の新しい値が属性記述子の value フィールドにキャッシュされ、lastUpdatedTimeStamp フィールドに現在のタイムスタンプが設定されます。
    属性の記述子の永続フィールドが null 以外の場合、永続ストア内に属性を格納するため、属性記述子の Persistance ポリシーが使用されます。
    persistPolicy フィールドが次の内容になっている場合、MBean が格納されます。
    - != "never"
    - = "always"
    - = "onUpdate"
    - = "onTimer" および now > 'lastPersistTime' + 'persistPeriod'
    - = "NoMoreOftenThan" および now > 'lastPersistTime' + 'persistPeriod'
    persistPolicy フィールドが次の内容になっている場合、MBean は格納されません。
    - != "never"
    - = "onTimer" && now < 'lastPersistTime' + 'persistPeriod'
    - = "onUnregister"
    - = "NoMoreOftenThan" および now < 'lastPersistTime' + 'persistPeriod'
    Model MBean の ModelMBeanInfo はファイルに格納されます。
    定義:
    
    setAttribute、インタフェース: DynamicMBean
    
    パラメータ:
    attribute - 設定される属性の名前と設定値を含む Attribute インスタンス。
    
    例外:
    AttributeNotFoundException - 指定の属性が MBean にアクセスできない場合。
    次の場合、AttributeNotFoundException がスローされる可能性がある。
    
    指定の属性の ModelMBeanAttributeInfo が見つからない場合。
    
    ModelMBeanAttributeInfo の isWritable メソッドの戻り値が false の場合。
    InvalidAttributeValueException - 指定の属性に記述子が定義されていない場合。
    MBeanException - 次のいずれかの Exception をラップする:
    
    管理対象オブジェクトの設定メソッドによってスローされた Exception。
    
    ServiceNotFoundException。属性の記述子に setMethod フィールドが定義されておらず、管理対象のリソースが null の場合。または setMethod フィールドが定義されておらず、属性でキャッシュが有効になっていない場合。getMethod フィールドも存在しない場合は、キャッシュが自動的に有効になる。
    
    InvalidTargetObjectTypeException。targetType フィールドの値が objectReference でない場合。
    
    管理対象オブジェクトの取得メソッドによってスローされた Exception。
    ReflectionException - 設定メソッドの呼び出し時にスローされる Exception をラップする。
    
    RuntimeOperationsException - IllegalArgumentException をラップする場合:パラメータ内の属性名が null の場合
    関連項目:
    getAttribute(java.lang.String)
  - setAttributes
```
public AttributeList setAttributes(AttributeList attributes)
```
    この ModelMBean の属性の配列の値を設定します。リスト内の各属性に対して setAttribute() メソッドを実行します。
    
    定義:
    
    setAttributes、インタフェース: DynamicMBean
    
    パラメータ:
    attributes - 属性のリスト。属性のリスト (設定される属性の ID と設定される値)。
    
    戻り値:
    Attribute インスタンス内の新しい値で設定された属性の配列。
    
    例外:
    
    RuntimeOperationsException - IllegalArgumentException をラップする場合:すなわち、パラメータ内のオブジェクト名が null であるか、パラメータ内の属性が null である場合。
    関連項目:
    getAttributes(java.lang.String[])
  - addNotificationListener
```
public void addNotificationListener(NotificationListener listener,
                           NotificationFilter filter,
                           Object handback)
                             throws IllegalArgumentException
```
    NotificationListener インタフェースを実装するオブジェクトをリスナーとして登録します。ModelMBean によって任意の通知が発行されると、このオブジェクトの handleNotification() メソッドが呼び出されます。attributeChangeNotification は含みません。これらは個別に登録する必要があります。
    
    定義:
    
    addNotificationListener、インタフェース: NotificationBroadcaster
    
    パラメータ:
    listener - 登録済み MBean が発行した通知を処理するリスナーオブジェクト。
    filter - フィルタオブジェクト。null の場合、通知処理の前にフィルタは適用されない。
    handback - 通知が発行されたとき通知とともにリスナーに送信されるコンテキスト。
    
    例外:
    
    IllegalArgumentException - リスナーは null にできない。
    関連項目:
    removeNotificationListener(javax.management.NotificationListener)
  - removeNotificationListener
```
public void removeNotificationListener(NotificationListener listener)
                                throws ListenerNotFoundException
```
    RequiredModelMBean から Notification のリスナーを削除します。
    
    定義:
    
    removeNotificationListener、インタフェース: NotificationBroadcaster
    
    パラメータ:
    listener - 登録済み MBean が発行した通知を処理していたリスナーの名前。このメソッドはこのリスナーに関するすべての情報を削除する。
    
    例外:
    
    ListenerNotFoundException - リスナーが MBean に登録されていないか、null の場合。
    関連項目:
    addNotificationListener(javax.management.NotificationListener, javax.management.NotificationFilter, java.lang.Object)
  - removeNotificationListener
```
public void removeNotificationListener(NotificationListener listener,
                              NotificationFilter filter,
                              Object handback)
                                throws ListenerNotFoundException
```
    インタフェースからコピーされた説明: NotificationEmitter
    
    この MBean からリスナーを削除します。MBean は、指定された listener、filter、および handback パラメータと正確に一致するリスナーを持っている必要があります。該当するリスナーが複数存在する場合、そのうちの 1 つだけが削除されます。
    
    削除されるリスナー内で null が指定されている場合、filter および handback パラメータは null になります。
    
    定義:
    
    removeNotificationListener、インタフェース: NotificationEmitter
    
    パラメータ:
    listener - 以前にこの MBean に追加されたリスナー。
    filter - リスナーの追加時に指定されたフィルタ。
    handback - リスナーの追加時に指定されたハンドバック。
    
    例外:
    
    ListenerNotFoundException - リスナーが MBean に登録されていない場合、または指定されたフィルタおよびハンドバックで登録されていない場合。
  - sendNotification
```
public void sendNotification(Notification ntfyObj)
                      throws MBeanException,
                             RuntimeOperationsException
```
    インタフェースからコピーされた説明: ModelMBeanNotificationBroadcaster
    
    ModelMBean 上の登録済み Notification リスナーに、jmx.modelmbean.generic 通知として渡される Notification を送信します。
    
    定義:
    
    sendNotification、インタフェース: ModelMBeanNotificationBroadcaster
    
    パラメータ:
    ntfyObj - リスナーオブジェクトの handleNotification メソッドに渡される通知。
    
    例外:
    
    MBeanException - 分散通信 Exception をラップする。
    
    RuntimeOperationsException - IllegalArgumentException をラップする場合:パラメータとして渡された Notification オブジェクトが null の場合。
  - sendNotification
```
public void sendNotification(String ntfyText)
                      throws MBeanException,
                             RuntimeOperationsException
```
    インタフェースからコピーされた説明: ModelMBeanNotificationBroadcaster
    
    ModelMBean 上の登録済み Notification リスナーに渡されるテキスト文字列を含む Notification を送信します。
    
    定義:
    
    sendNotification、インタフェース: ModelMBeanNotificationBroadcaster
    
    パラメータ:
    ntfyText - Notification に指定され、リスナーオブジェクトの handleNotification メソッドに渡されるテキスト。構築される Notification を次に示す。type: "jmx.modelmbean.generic"、source: この ModelMBean インスタンス、sequence : 1
    
    例外:
    
    MBeanException - 分散通信 Exception をラップする。
    
    RuntimeOperationsException - IllegalArgumentException をラップする場合:パラメータとして渡された Notification テキスト文字列が null の場合。
  - getNotificationInfo
```
public MBeanNotificationInfo[] getNotificationInfo()
```
    常に RequiredModelMBean によって生成される Notification の配列を返します。
    RequiredModelMBean は、2 つの追加通知を送信する場合があります。
    - 1 つは記述 "name=GENERIC,descriptorType=notification,log=T,severity=6,displayName=jmx.modelmbean.generic" を持つ通知
    - もう 1 つは記述子 "name=ATTRIBUTE_CHANGE,descriptorType=notification,log=T,severity=6,displayName=jmx.attribute.change" を持つ標準属性変更通知
    これらの 2 つの通知は、アプリケーションによって指定された通知に常に追加されます。
    定義:
    
    getNotificationInfo、インタフェース: NotificationBroadcaster
    
    戻り値:
    MBeanNotificationInfo[]
  - addAttributeChangeNotificationListener
```
public void addAttributeChangeNotificationListener(NotificationListener inlistener,
                                          String inAttributeName,
                                          Object inhandback)
                                            throws MBeanException,
                                                   RuntimeOperationsException,
                                                   IllegalArgumentException
```
    インタフェースからコピーされた説明: ModelMBeanNotificationBroadcaster
    
    NotificationListener インタフェースを実装するオブジェクトをリスナーとして登録します。ModelMBean によって任意の attributeChangeNotification が発行されると、このオブジェクトの handleNotification() メソッドが呼び出されます。その他の Notification は含みません。これらは個別に登録する必要があります。この attributeName 用の AttributeChangeNotification が生成されます。
    
    定義:
    
    addAttributeChangeNotificationListener、インタフェース: ModelMBeanNotificationBroadcaster
    
    パラメータ:
    inlistener - 登録済み MBean が発行した通知を処理するリスナーオブジェクト。
    inAttributeName - ModelMBean 属性の名前。この属性の変更通知を受信する。null の場合、どの属性が変更されたときも attributeChangeNotification が発行される。
    inhandback - 通知が発行されたとき通知とともにリスナーに送信されるコンテキスト。
    
    例外:
    
    MBeanException - 分散通信 Exception をラップする。
    
    RuntimeOperationsException - IllegalArgumentException をラップする。パラメータとして渡される属性名が存在しない場合。
    
    IllegalArgumentException - リスナーは null にできない。
    関連項目:
    ModelMBeanNotificationBroadcaster.removeAttributeChangeNotificationListener(javax.management.NotificationListener, java.lang.String)
  - removeAttributeChangeNotificationListener
```
public void removeAttributeChangeNotificationListener(NotificationListener inlistener,
                                             String inAttributeName)
                                               throws MBeanException,
                                                      RuntimeOperationsException,
                                                      ListenerNotFoundException
```
    インタフェースからコピーされた説明: ModelMBeanNotificationBroadcaster
    
    RequiredModelMBean から attributeChangeNotification のリスナーを削除します。
    
    定義:
    
    removeAttributeChangeNotificationListener、インタフェース: ModelMBeanNotificationBroadcaster
    
    パラメータ:
    inlistener - 登録済み MBean が発行した通知を処理していたリスナーの名前。このメソッドはこのリスナーに関するすべての情報を削除する。
    inAttributeName - 属性。リスナーは、この属性の attributeChangeNotification を受信する必要がなくなった。null の場合、すべての attributeChangeNotification のリスナーが削除される。
    
    例外:
    
    MBeanException - 分散通信 Exception をラップする。
    
    RuntimeOperationsException - inAttributeName パラメータが属性名に一致しない場合、IllegalArgumentException をラップする。
    
    ListenerNotFoundException - リスナーが MBean に登録されていないか、null の場合。
    関連項目:
    ModelMBeanNotificationBroadcaster.addAttributeChangeNotificationListener(javax.management.NotificationListener, java.lang.String, java.lang.Object)
  - sendAttributeChangeNotification
```
public void sendAttributeChangeNotification(AttributeChangeNotification ntfyObj)
                                     throws MBeanException,
                                            RuntimeOperationsException
```
    インタフェースからコピーされた説明: ModelMBeanNotificationBroadcaster
    
    ModelMBean 上の登録済み attributeChangeNotification リスナーに渡される attributeChangeNotification を送信します。
    
    定義:
    
    sendAttributeChangeNotification、インタフェース: ModelMBeanNotificationBroadcaster
    
    パラメータ:
    ntfyObj - リスナーオブジェクトの handleNotification メソッドに渡される通知。
    
    例外:
    
    MBeanException - 分散通信 Exception をラップする。
    
    RuntimeOperationsException - IllegalArgumentException をラップする場合:パラメータとして渡された AttributeChangeNotification オブジェクトが null の場合。
  - sendAttributeChangeNotification
```
public void sendAttributeChangeNotification(Attribute inOldVal,
                                   Attribute inNewVal)
                                     throws MBeanException,
                                            RuntimeOperationsException
```
    インタフェースからコピーされた説明: ModelMBeanNotificationBroadcaster
    
    ModelMBean 上の登録済み AttributeChangeNotification リスナーに、属性の古い値と新しい値を含む attributeChangeNotification を送信します。
    定義:
    
    sendAttributeChangeNotification、インタフェース: ModelMBeanNotificationBroadcaster
    
    パラメータ:
    inOldVal - Attribute の初期値
    inNewVal - Attribute の現在の値
    
    The constructed attributeChangeNotification will be: type "jmx.attribute.change" source this ModelMBean instance sequence 1 attributeName oldValue.getName() attributeType oldValue's class attributeOldValue oldValue.getValue() attributeNewValue newValue.getValue()
    例外:
    
    MBeanException - 分散通信 Exception をラップする。
    
    RuntimeOperationsException - IllegalArgumentException をラップする場合:パラメータとして渡される Attribute オブジェクトが null である場合、またはパラメータに同じ名前の Attribute オブジェクトが複数指定された場合。
  - getClassLoaderRepository
```
protected ClassLoaderRepository getClassLoaderRepository()
```
    クラスのロードに使用されたクラスローダーリポジトリを返します。サブクラスは、このオブジェクト内で使用する適切な ClassLoaderRepository を返すため、このメソッドを再定義することができます。
    
    戻り値:
    クラスローダーリポジトリ
  - preRegister
```
public ObjectName preRegister(MBeanServer server,
                     ObjectName name)
                       throws Exception
```
    MBean サーバーに登録する前に必要なオペレーションを MBean が実行することを許可します。MBean の名前を指定しないと、MBean により、登録用の名前が提供されます。例外がスローされた場合、MBean は MBean サーバーに登録されません。
    RequireModelMBean が実行時に適切に機能するように、このメソッドをオーバーロードまたはオーバーライドする RequiredModelMBean のサブクラスは、固有の preRegister 実装内の super.preRegister(server, name) を呼び出す必要があります。
    
    定義:
    
    preRegister、インタフェース: MBeanRegistration
    
    パラメータ:
    server - MBean サーバー。MBean はここに登録される。
    name - MBean のオブジェクト名。MBeanServer インタフェース内の createMBean または registerMBean メソッドの name パラメータが null の場合、この名前も null になる。この場合、このメソッドは、新しい MBean 用に null 以外の ObjectName を必ず返す。
    
    戻り値:
    MBean の登録名。null は指定できない。name パラメータが null 以外の場合、通常は値が返されるが、これは必須ではない。
    
    例外:
    
    Exception - この例外は、MBean サーバーにキャッチされ、MBeanRegistrationException として再スローされる。
  - postRegister
```
public void postRegister(Boolean registrationDone)
```
    MBean サーバーへの登録が成功または失敗したあと、MBean が必要なオペレーションを実行できるようにします。
    RequireModelMBean が実行時に適切に機能するように、このメソッドをオーバーロードまたはオーバーライドする RequiredModelMBean のサブクラスは、固有の postRegister 実装内の super.postRegister(registrationDone) を呼び出す必要があります。
    
    定義:
    
    postRegister、インタフェース: MBeanRegistration
    
    パラメータ:
    registrationDone - MBean が MBean サーバーに正常に登録されたかどうかを示す。登録に失敗した場合の値は false。
  - preDeregister
```
public void preDeregister()
                   throws Exception
```
    MBean サーバーから登録解除する前に、MBean が必要なオペレーションを実行できるようにします。
    RequireModelMBean が実行時に適切に機能するように、このメソッドをオーバーロードまたはオーバーライドする RequiredModelMBean のサブクラスは、固有の preDeregister 実装内の super.preDeregister() を呼び出す必要があります。
    
    定義:
    
    preDeregister、インタフェース: MBeanRegistration
    
    例外:
    
    Exception - この例外は、MBean サーバーにキャッチされ、MBeanRegistrationException として再スローされる。
  - postDeregister
```
public void postDeregister()
```
    MBean サーバーから登録解除したあと、MBean が必要なオペレーションを実行できるようにします。
    RequireModelMBean が実行時に適切に機能するように、このメソッドをオーバーロードまたはオーバーライドする RequiredModelMBean のサブクラスは、固有の postDeregister 実装内の super.postDeregister() を呼び出す必要があります。
    
    定義:
    
    postDeregister、インタフェース: MBeanRegistration

バグまたは機能を送信
詳細な API リファレンスおよび開発者ドキュメントについては、Java SE のドキュメントを参照してください。そのドキュメントには、概念的な概要、用語の定義、回避方法、有効なコード例などの、開発者を対象にしたより詳細な説明が含まれています。
Copyright © 1993, 2013, Oracle and/or its affiliates. All rights reserved.

クラス RequiredModelMBean

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

メソッドのサマリー

クラス java.lang.Object から継承されたメソッド

コンストラクタの詳細

RequiredModelMBean

RequiredModelMBean

メソッドの詳細

setModelMBeanInfo

setManagedResource

load

store

getMBeanInfo

invoke

getAttribute

getAttributes

setAttribute

setAttributes

addNotificationListener

removeNotificationListener

removeNotificationListener

sendNotification

sendNotification

getNotificationInfo

addAttributeChangeNotificationListener

removeAttributeChangeNotificationListener

sendAttributeChangeNotification

sendAttributeChangeNotification

getClassLoaderRepository

preRegister

postRegister

preDeregister

postDeregister