既知のすべての実装クラス:

CounterMonitor, GaugeMonitor, JMXConnectorServer, MLet, Monitor, PrivateMLet, RelationService, RelationSupport, RequiredModelMBean, RMIConnectorServer, StandardEmitterMBean, StandardMBean, StringMonitor, Timer
```
public interface MBeanRegistration
```
MBeanサーバーへの登録またはMBeanサーバーからの登録解除の前後にさまざまなオペレーションを実行するため、MBeanにより実装されます。 MBeanサーバーまたはMBeanサーバー内の名前、あるいはその両方への参照を取得するために、MBeanもこのインタフェースを実装できます。

導入されたバージョン:

1.5

メソッドのサマリー

すべてのメソッドインスタンス・メソッド抽象メソッド
修飾子と型	メソッド	説明
`void`	`postDeregister()`	MBeanサーバーから登録解除したあと、MBeanが必要なオペレーションを実行できるようにします。
`void`	`postRegister(Boolean registrationDone)`	MBeanサーバーへの登録が成功または失敗したあと、MBeanが必要なオペレーションを実行できるようにします。
`void`	`preDeregister()`	MBeanサーバーから登録解除する前に、MBeanが必要なオペレーションを実行できるようにします。
`ObjectName`	`preRegister(MBeanServer server, ObjectName name)`	MBeanサーバーに登録する前に、MBeanが必要なオペレーションを実行できるようにします。

- メソッドの詳細
  - preRegister
```
ObjectName preRegister(MBeanServer server,
                       ObjectName name)
                throws Exception
```
    MBeanサーバーに登録する前に、MBeanが必要なオペレーションを実行できるようにします。 MBeanの名前を指定しないと、MBeanにより、登録用の名前が提供されます。例外がスローされた場合、MBeanはMBeanサーバーに登録されません。
    
    パラメータ:
    
    server - MBeanサーバー。MBeanはここに登録される。
    
    name - MBeanのオブジェクト名。 MBeanServerインタフェース内のcreateMBeanまたはregisterMBeanメソッドのnameパラメータがnullの場合、この名前もnullになる。この場合、このメソッドは、新しいMBean用にnull以外のObjectNameを必ず返す。
    
    戻り値:
    
    MBeanの登録名。 nullは指定できない。 nameパラメータがnull以外の場合、通常は値が返されるが、これは必須ではない。
    
    例外:
    
    Exception - この例外は、MBeanサーバーにキャッチされ、MBeanRegistrationExceptionとして再スローされる。
  - postRegister
```
void postRegister(Boolean registrationDone)
```
    MBeanサーバーへの登録が成功または失敗したあと、MBeanが必要なオペレーションを実行できるようにします。
    このメソッドの実装がRuntimeExceptionまたはErrorをスローする場合、MBeanサーバーはRuntimeMBeanExceptionまたはRuntimeErrorExceptionの内部でこれらをそれぞれ再スローします。ただし、postRegisterで例外をスローしてもMBeanの状態は変化しません。MBeanがすでに登録されている(registrationDoneがtrueである)場合、MBeanの登録は解除されません。
    
    createMBean()またはregisterMBean()を呼び出すコードでは、このような例外が発行されたときにMBeanの登録が失敗したとみなされることがあるため、これによって混乱が生じる可能性があります。したがって、回避できる場合はpostRegisterの実装で実行時例外またはエラーをスローしないことをお勧めします。
    
    パラメータ:
    
    registrationDone - MBeanがMBeanサーバーに正常に登録されたかどうかを示す。登録に失敗した場合の値はfalse。
  - preDeregister
```
void preDeregister()
            throws Exception
```
    MBeanサーバーから登録解除する前に、MBeanが必要なオペレーションを実行できるようにします。
    
    例外:
    
    Exception - この例外は、MBeanサーバーにキャッチされ、MBeanRegistrationExceptionとして再スローされる。
  - postDeregister
```
void postDeregister()
```
    MBeanサーバーから登録解除したあと、MBeanが必要なオペレーションを実行できるようにします。
    このメソッドの実装がRuntimeExceptionまたはErrorをスローする場合、MBeanサーバーはRuntimeMBeanExceptionまたはRuntimeErrorExceptionの内部でこれらをそれぞれ再スローします。ただし、postDeregisterで例外をスローしてもMBeanの状態は変化しません。MBeanはすでに正常に登録解除されており、その状態のままになります。
    
    unregisterMBean()を呼び出すコードでは、MBeanの登録解除が失敗したとみなされることがあるため、これによって混乱が生じる可能性があります。したがって、回避できる場合はpostDeregisterの実装で実行時例外またはエラーをスローしないことをお勧めします。

インタフェースMBeanRegistration

メソッドのサマリー

メソッドの詳細

preRegister

postRegister

preDeregister

postDeregister