RelationService (Java Platform SE 8)

java.lang.Object
- javax.management.NotificationBroadcasterSupport
- - javax.management.relation.RelationService

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

EventListener, MBeanRegistration, NotificationBroadcaster, NotificationEmitter, NotificationListener, RelationServiceMBean
```
public class RelationService
extends NotificationBroadcasterSupport
implements RelationServiceMBean, MBeanRegistration, NotificationListener
```
関係サービスは、関係タイプと関係を作成および削除し、整合性を処理し、およびクエリー・メカニズムを提供します。
関係サービスは、関係の削除時に通知を送信するため、NotificationBroadcasterSupportを拡張することによってNotificationBroadcasterを実装します。
また、関係ロール内の参照対象のMBeanおよび関係MBeanの登録解除に関する通知を受信できるようにするため、NotificationListenerインタフェースを実装します。
さらに、ObjectNameとMBean Serverを取得できるように、MBeanRegistrationインタフェースを実装します。

導入されたバージョン:

1.5

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

コンストラクタ
コンストラクタ説明

RelationService(boolean immediatePurgeFlag)
コンストラクタです。

コンストラクタ
コンストラクタ	説明
`RelationService(boolean immediatePurgeFlag)`	コンストラクタです。

メソッドのサマリー

すべてのメソッドインスタンス・メソッド具象メソッド
修飾子と型	メソッド	説明
`void`	`addRelation(ObjectName relationObjectName)`	ユーザーによって作成されてMBean Serverに登録されるMBeanを、関係として関係サービスに追加します。
`void`	`addRelationType(RelationType relationTypeObj)`	指定されたオブジェクトを関係タイプとして追加します。
`Integer`	`checkRoleReading(String roleName, String relationTypeName)`	指定された型の関係で、指定されたRoleの読取りが可能かどうかをチェックします。
`Integer`	`checkRoleWriting(Role role, String relationTypeName, Boolean initFlag)`	指定された型の関係で、指定されたRoleの設定が可能かどうかをチェックします。
`void`	`createRelation(String relationId, String relationTypeName, RoleList roleList)`	指定された関係タイプの単純な関係(RelationSupportオブジェクト)を作成し、これを関係サービスに追加します。
`void`	`createRelationType(String relationTypeName, RoleInfo[] roleInfoArray)`	RoleInfoオブジェクトから提供されたロール情報を使って、関係タイプ(RelationTypeSupportオブジェクト)を作成し、関係サービスへ追加します。
`Map<ObjectName,List<String>>`	`findAssociatedMBeans(ObjectName mbeanName, String relationTypeName, String roleName)`	関係内の指定されたMBeanに関連付けられたMBeanを取得します。
`Map<String,List<String>>`	`findReferencingRelations(ObjectName mbeanName, String relationTypeName, String roleName)`	指定されたMBeanが参照される関係を取得します。
`List<String>`	`findRelationsOfType(String relationTypeName)`	指定された型の関係の関係IDを返します。
`List<String>`	`getAllRelationIds()`	関係サービスによって処理されるすべての関係のすべての関係IDを返します。
`List<String>`	`getAllRelationTypeNames()`	既知のすべての関係タイプの名前を取得します。
`RoleResult`	`getAllRoles(String relationId)`	関係に含まれるすべてのロールを返します。
`MBeanNotificationInfo[]`	`getNotificationInfo()`	送信される通知のJavaクラス名と通知タイプを含むNotificationInfoオブジェクトを返します。
`boolean`	`getPurgeFlag()`	関係内の参照対象のMBeanの登録解除の通知をいつ受信したか、関係をただちに「パージ」(有効でなくなった関係を検索)する必要があるかどうか、またはpurgeRelationsメソッドが明示的に呼び出される場合にのみパージが実行されるかどうかを示すフラグを返します。
`Map<ObjectName,List<String>>`	`getReferencedMBeans(String relationId)`	関係のさまざまなロールで参照されるMBeanを取得します。
`String`	`getRelationTypeName(String relationId)`	指定された関係の関係タイプの名前を返します。
`List<ObjectName>`	`getRole(String relationId, String roleName)`	指定された関係に含まれる指定されたロール名のロール値を取得します。
`Integer`	`getRoleCardinality(String relationId, String roleName)`	指定されたロール内で現在参照されているMBeanの数を取得します。
`RoleInfo`	`getRoleInfo(String relationTypeName, String roleInfoName)`	指定された関係タイプの指定されたロール名のロール情報を取得します。
`List<RoleInfo>`	`getRoleInfos(String relationTypeName)`	指定された関係タイプのロール情報(RoleInfoオブジェクト)のリストを取得します。
`RoleResult`	`getRoles(String relationId, String[] roleNameArray)`	指定された関係に含まれる指定された名前のロールの値を取得します。
`void`	`handleNotification(Notification notif, Object handback)`	JMX通知が発生したとき呼び出されます。
`Boolean`	`hasRelation(String relationId)`	関係サービス内に指定された関係IDで識別される関係があるかどうかをチェックします。
`void`	`isActive()`	関係サービスがアクティブかどうかをチェックします。
`String`	`isRelation(ObjectName objectName)`	MBeanが関係として関係サービスに追加されている場合、指定されたObjectNameに関連付けられる関係IDを返します。
`ObjectName`	`isRelationMBean(String relationId)`	関係がMBean (ユーザーによって作成され、関係として関係サービスに追加されたもの)によって表される場合、MBeanのObjectNameを返します。
`void`	`postDeregister()`	MBeanサーバーから登録解除したあと、MBeanが必要なオペレーションを実行できるようにします。
`void`	`postRegister(Boolean registrationDone)`	MBeanサーバーへの登録が成功または失敗したあと、MBeanが必要なオペレーションを実行できるようにします。
`void`	`preDeregister()`	MBeanサーバーから登録解除する前に、MBeanが必要なオペレーションを実行できるようにします。
`ObjectName`	`preRegister(MBeanServer server, ObjectName name)`	MBeanサーバーに登録する前に必要なオペレーションをMBeanが実行することを許可します。
`void`	`purgeRelations()`	関係をパージします。
`void`	`removeRelation(String relationId)`	指定された関係タイプを関係サービスから削除します。
`void`	`removeRelationType(String relationTypeName)`	指定された関係タイプを関係サービスから削除します。
`void`	`sendRelationCreationNotification(String relationId)`	関係作成の通知(RelationNotification)を送信します。
`void`	`sendRelationRemovalNotification(String relationId, List<ObjectName> unregMBeanList)`	関係削除の通知(RelationNotification)を送信します。
`void`	`sendRoleUpdateNotification(String relationId, Role newRole, List<ObjectName> oldValue)`	指定された関係内のロール更新の通知(RelationNotification)を送信します。
`void`	`setPurgeFlag(boolean purgeFlag)`	関係内の参照対象のMBeanの登録解除の通知をいつ受信したか、関係をただちに「パージ」(有効でなくなった関係を検索)する必要があるかどうか、またはpurgeRelationsメソッドが明示的に呼び出される場合にのみパージが実行されるかどうかを示すフラグを設定します。
`void`	`setRole(String relationId, Role role)`	指定された関係内の指定されたロールを設定します。
`RoleResult`	`setRoles(String relationId, RoleList roleList)`	指定された関係内の指定されたロールを設定します。
`void`	`updateRoleMap(String relationId, Role newRole, List<ObjectName> oldValue)`	指定された関係内の指定されたロールを更新するため、関係サービス・ロール・マップの更新を処理します。

クラス javax.management.NotificationBroadcasterSupportから継承されたメソッド
addNotificationListener, handleNotification, removeNotificationListener, removeNotificationListener, sendNotification

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

- コンストラクタの詳細
  - RelationService
```
public RelationService(boolean immediatePurgeFlag)
```
    コンストラクタです。
    
    パラメータ:
    
    immediatePurgeFlag - 関係内の参照対象のMBeanの登録解除の通知をいつ受信したか、関係をただちに「パージ」(有効でなくなった関係を検索)する必要があるかどうか、またはpurgeRelationsメソッドが明示的に呼び出される場合にのみパージが実行されるかどうかを示すフラグ。
    trueの場合、ただちにパージを行う必要があります。
- メソッドの詳細
  - isActive
```
public void isActive()
              throws RelationServiceNotRegisteredException
```
    関係サービスがアクティブかどうかをチェックします。現在、関係サービスをMBean Serverに登録する必要があります。
    
    定義:
    
    isActive、インタフェースRelationServiceMBean
    
    例外:
    
    RelationServiceNotRegisteredException - 関係サービスが未登録の場合
  - preRegister
```
public ObjectName preRegister(MBeanServer server,
                              ObjectName name)
                       throws Exception
```
    インタフェースからコピーされた説明: MBeanRegistration
    
    MBeanサーバーに登録する前に必要なオペレーションをMBeanが実行することを許可します。 MBeanの名前を指定しないと、MBeanにより、登録用の名前が提供されます。例外がスローされた場合、MBeanはMBeanサーバーに登録されません。
    
    定義:
    
    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)
```
    インタフェースからコピーされた説明: MBeanRegistration
    
    MBeanサーバーへの登録が成功または失敗したあと、MBeanが必要なオペレーションを実行できるようにします。
    このメソッドの実装がRuntimeExceptionまたはErrorをスローする場合、MBeanサーバーはRuntimeMBeanExceptionまたはRuntimeErrorExceptionの内部でこれらをそれぞれ再スローします。ただし、postRegisterで例外をスローしてもMBeanの状態は変化しません。MBeanがすでに登録されている(registrationDoneがtrueである)場合、MBeanの登録は解除されません。
    
    createMBean()またはregisterMBean()を呼び出すコードでは、このような例外が発行されたときにMBeanの登録が失敗したとみなされることがあるため、これによって混乱が生じる可能性があります。したがって、回避できる場合はpostRegisterの実装で実行時例外またはエラーをスローしないことをお勧めします。
    
    定義:
    
    postRegister、インタフェースMBeanRegistration
    
    パラメータ:
    
    registrationDone - MBeanがMBeanサーバーに正常に登録されたかどうかを示す。登録に失敗した場合の値はfalse。
  - preDeregister
```
public void preDeregister()
                   throws Exception
```
    インタフェースからコピーされた説明: MBeanRegistration
    
    MBeanサーバーから登録解除する前に、MBeanが必要なオペレーションを実行できるようにします。
    
    定義:
    
    preDeregister、インタフェースMBeanRegistration
    
    例外:
    
    Exception - この例外は、MBeanサーバーにキャッチされ、MBeanRegistrationExceptionとして再スローされる。
  - postDeregister
```
public void postDeregister()
```
    インタフェースからコピーされた説明: MBeanRegistration
    
    MBeanサーバーから登録解除したあと、MBeanが必要なオペレーションを実行できるようにします。
    このメソッドの実装がRuntimeExceptionまたはErrorをスローする場合、MBeanサーバーはRuntimeMBeanExceptionまたはRuntimeErrorExceptionの内部でこれらをそれぞれ再スローします。ただし、postDeregisterで例外をスローしてもMBeanの状態は変化しません。MBeanはすでに正常に登録解除されており、その状態のままになります。
    
    unregisterMBean()を呼び出すコードでは、MBeanの登録解除が失敗したとみなされることがあるため、これによって混乱が生じる可能性があります。したがって、回避できる場合はpostDeregisterの実装で実行時例外またはエラーをスローしないことをお勧めします。
    
    定義:
    
    postDeregister、インタフェースMBeanRegistration
  - getPurgeFlag
```
public boolean getPurgeFlag()
```
    関係内の参照対象のMBeanの登録解除の通知をいつ受信したか、関係をただちに「パージ」(有効でなくなった関係を検索)する必要があるかどうか、またはpurgeRelationsメソッドが明示的に呼び出される場合にのみパージが実行されるかどうかを示すフラグを返します。
    trueの場合、ただちにパージを行う必要があります。
    
    定義:
    
    getPurgeFlag、インタフェースRelationServiceMBean
    
    戻り値:
    
    自動的にパージが行われる場合はtrue
    
    関連項目:
    
    setPurgeFlag(boolean)
  - setPurgeFlag
```
public void setPurgeFlag(boolean purgeFlag)
```
    関係内の参照対象のMBeanの登録解除の通知をいつ受信したか、関係をただちに「パージ」(有効でなくなった関係を検索)する必要があるかどうか、またはpurgeRelationsメソッドが明示的に呼び出される場合にのみパージが実行されるかどうかを示すフラグを設定します。
    trueの場合、ただちにパージを行う必要があります。
    
    定義:
    
    setPurgeFlag、インタフェースRelationServiceMBean
    
    パラメータ:
    
    purgeFlag - フラグ
    
    関連項目:
    
    getPurgeFlag()
  - createRelationType
```
public void createRelationType(String relationTypeName,
                               RoleInfo[] roleInfoArray)
                        throws IllegalArgumentException,
                               InvalidRelationTypeException
```
    RoleInfoオブジェクトから提供されたロール情報を使って、関係タイプ(RelationTypeSupportオブジェクト)を作成し、関係サービスへ追加します。
    
    定義:
    
    createRelationType、インタフェースRelationServiceMBean
    
    パラメータ:
    
    relationTypeName - 関係タイプの名前
    
    roleInfoArray - ロール情報の配列
    
    例外:
    
    IllegalArgumentException - パラメータがnullの場合
    
    InvalidRelationTypeException - 次の場合:
    - 同じ名前の関係タイプがすでに存在する場合
    - 同じ名前が2つの異なったロール情報で使用されている場合
    - ロール情報が提供されなかった場合
    - ロール情報としてnullが提供された場合
  - addRelationType
```
public void addRelationType(RelationType relationTypeObj)
                     throws IllegalArgumentException,
                            InvalidRelationTypeException
```
    指定されたオブジェクトを関係タイプとして追加します。このオブジェクトは、RelationTypeインタフェースを実装する必要があります。
    
    定義:
    
    addRelationType、インタフェースRelationServiceMBean
    
    パラメータ:
    
    relationTypeObj - 関係タイプ・オブジェクト(RelationTypeインタフェースを実装)
    
    例外:
    
    IllegalArgumentException - パラメータがnullである場合、またはrelationTypeObj.getRelationTypeName()がnullを返す場合
    
    InvalidRelationTypeException - 次の場合:
    - 同じ名前が2つの異なったロールで使用されている場合
    - ロール情報が提供されなかった場合
    - ロール情報としてnullが提供された場合
    - 同じ名前の関係タイプがすでに存在する場合
  - getAllRelationTypeNames
```
public List<String> getAllRelationTypeNames()
```
    既知のすべての関係タイプの名前を取得します。
    
    定義:
    
    getAllRelationTypeNames、インタフェースRelationServiceMBean
    
    戻り値:
    
    関係タイプの名前(String)のArrayList
  - getRoleInfos
```
public List<RoleInfo> getRoleInfos(String relationTypeName)
                            throws IllegalArgumentException,
                                   RelationTypeNotFoundException
```
    指定された関係タイプのロール情報(RoleInfoオブジェクト)のリストを取得します。
    
    定義:
    
    getRoleInfos、インタフェースRelationServiceMBean
    
    パラメータ:
    
    relationTypeName - 関係タイプの名前
    
    戻り値:
    
    RoleInfoのArrayList
    
    例外:
    
    IllegalArgumentException - パラメータがnullの場合
    
    RelationTypeNotFoundException - その名前の関係タイプが存在しない場合
  - getRoleInfo
```
public RoleInfo getRoleInfo(String relationTypeName,
                            String roleInfoName)
                     throws IllegalArgumentException,
                            RelationTypeNotFoundException,
                            RoleInfoNotFoundException
```
    指定された関係タイプの指定されたロール名のロール情報を取得します。
    
    定義:
    
    getRoleInfo、インタフェースRelationServiceMBean
    
    パラメータ:
    
    relationTypeName - 関係タイプの名前
    
    roleInfoName - ロール名
    
    戻り値:
    
    RoleInfoオブジェクト
    
    例外:
    
    IllegalArgumentException - パラメータがnullの場合
    
    RelationTypeNotFoundException - 関係サービスにとって未知の関係タイプである場合
    
    RoleInfoNotFoundException - 関係タイプにロールが含まれていない場合
  - removeRelationType
```
public void removeRelationType(String relationTypeName)
                        throws RelationServiceNotRegisteredException,
                               IllegalArgumentException,
                               RelationTypeNotFoundException
```
    指定された関係タイプを関係サービスから削除します。
    その型の関係オブジェクトが関係サービスから削除されます。
    
    定義:
    
    removeRelationType、インタフェースRelationServiceMBean
    
    パラメータ:
    
    relationTypeName - 削除される関係タイプの名前
    
    例外:
    
    RelationServiceNotRegisteredException - 関係サービスがMBeanサーバーに登録されていない場合
    
    IllegalArgumentException - パラメータがnullの場合
    
    RelationTypeNotFoundException - その名前の関係タイプが存在しない場合
  - createRelation
```
public void createRelation(String relationId,
                           String relationTypeName,
                           RoleList roleList)
                    throws RelationServiceNotRegisteredException,
                           IllegalArgumentException,
                           RoleNotFoundException,
                           InvalidRelationIdException,
                           RelationTypeNotFoundException,
                           InvalidRoleValueException
```
    指定された関係タイプの単純な関係(RelationSupportオブジェクト)を作成し、これを関係サービスに追加します。
    ロールはパラメータに指定されたロール・リストに従って初期化されます。この方法で初期化されないロールは、ObjectNameの空のArrayListに設定されます。
    RELATION_BASIC_CREATION型のRelationNotificationが送信されます。
    
    定義:
    
    createRelation、インタフェースRelationServiceMBean
    
    パラメータ:
    
    relationId - 関係サービス内の関係を一意に識別するために使用される関係識別子
    
    relationTypeName - 関係サービス内に作成する必要がある関係タイプの名前
    
    roleList - 関係のロールを初期化するためのロール・リスト(nullも可)
    
    例外:
    
    RelationServiceNotRegisteredException - 関係サービスがMBeanサーバーに登録されていない場合
    
    IllegalArgumentException - パラメータがnullの場合。ただし、ロールの初期化が行われない場合nullにすることができるロール・リストを除く
    
    RoleNotFoundException - 関係タイプ内に存在しないロールに値が提供された場合
    
    InvalidRelationIdException - 関係IDがすでに使用されている場合
    
    RelationTypeNotFoundException - 関係サービスにとって未知の関係タイプである場合
    
    InvalidRoleValueException - 次の場合:
    - 同じ名前が2つの異なったロールで使用されている場合
    - 指定された値に含まれる参照対象のMBeanの数が予想最小値より小さい場合
    - 指定された値に含まれる参照対象のMBeanの数が予想最大値を超えている場合
    - 値に含まれる参照対象のMBeanのうち1つが、そのロールのMBeanクラスのオブジェクトでない場合
    - そのロールのMBeanが存在しない場合
  - addRelation
```
public void addRelation(ObjectName relationObjectName)
                 throws IllegalArgumentException,
                        RelationServiceNotRegisteredException,
                        NoSuchMethodException,
                        InvalidRelationIdException,
                        InstanceNotFoundException,
                        InvalidRelationServiceException,
                        RelationTypeNotFoundException,
                        RoleNotFoundException,
                        InvalidRoleValueException
```
    ユーザーによって作成されてMBean Serverに登録されるMBeanを、関係として関係サービスに追加します。
    MBeanを関係として追加するためには、次の条件が満たされている必要があります。
    - Relationインタフェースを実装している
    - RelationService ObjectName用として現在の関係サービスのObjectNameを持っている
    - 現在の関係サービス内で一意かつ未使用の関係IDを持っている
    - 関係タイプ用として関係サービス内で作成された関係タイプを持っている
    - 関係タイプ内で提供されたロール情報に適合するロールを持っている
    
    定義:
    
    addRelation、インタフェースRelationServiceMBean
    
    パラメータ:
    
    relationObjectName - 追加される関係MBeanのObjectName
    
    例外:
    
    IllegalArgumentException - パラメータがnullの場合
    
    RelationServiceNotRegisteredException - 関係サービスがMBeanサーバーに登録されていない場合
    
    NoSuchMethodException - MBeanがRelationインタフェースを実装していない場合
    
    InvalidRelationIdException - 次の場合:
    - MBean内に関係識別子が存在しない
    - 関係識別子が関係サービスですでに使用されている場合
    
    InstanceNotFoundException - 指定されたObjectNameのMBeanが登録されていない場合
    
    InvalidRelationServiceException - 次の場合:
    - MBean内に関係サービス名が存在しない場合
    - MBean内の関係サービス名が現在の関係サービスの関係サービス名でない場合
    
    RelationTypeNotFoundException - 次の場合:
    - MBean内に関係タイプ名が存在しない場合
    - MBean内の関係タイプ名が関係サービス内に作成された関係タイプに対応していない場合
    
    InvalidRoleValueException - 次の場合:
    - ロールに含まれる参照対象のMBeanの数が予想最小値より小さい場合
    - ロールに含まれる参照対象のMBeanの数が予想最大値を超えている場合
    - 値に含まれる参照対象のMBeanのうち1つが、そのロールのMBeanクラスのオブジェクトでない場合
    - ロールに提供されたMBeanが存在しない場合
    
    RoleNotFoundException - 関係タイプ内に存在しないロールに値が提供された場合
  - isRelationMBean
```
public ObjectName isRelationMBean(String relationId)
                           throws IllegalArgumentException,
                                  RelationNotFoundException
```
    関係がMBean (ユーザーによって作成され、関係として関係サービスに追加されたもの)によって表される場合、MBeanのObjectNameを返します。
    
    定義:
    
    isRelationMBean、インタフェースRelationServiceMBean
    
    パラメータ:
    
    relationId - 関係を識別する関係ID
    
    戻り値:
    
    対応する関係MBeanのObjectName。関係がMBeanでない場合はnull
    
    例外:
    
    IllegalArgumentException - パラメータがnullの場合
    
    RelationNotFoundException - このIDに関係が関連付けられていない場合
  - isRelation
```
public String isRelation(ObjectName objectName)
                  throws IllegalArgumentException
```
    MBeanが関係として関係サービスに追加されている場合、指定されたObjectNameに関連付けられる関係IDを返します。
    
    定義:
    
    isRelation、インタフェースRelationServiceMBean
    
    パラメータ:
    
    objectName - 仮定された関係のObjectName
    
    戻り値:
    
    関係ID (String)。ObjectNameが関係サービスによって処理される関係でない場合はnull
    
    例外:
    
    IllegalArgumentException - パラメータがnullの場合
  - hasRelation
```
public Boolean hasRelation(String relationId)
                    throws IllegalArgumentException
```
    関係サービス内に指定された関係IDで識別される関係があるかどうかをチェックします。
    
    定義:
    
    hasRelation、インタフェースRelationServiceMBean
    
    パラメータ:
    
    relationId - 関係を識別する関係ID
    
    戻り値:
    
    boolean型。関係が存在する場合はtrue、存在しない場合はfalse
    
    例外:
    
    IllegalArgumentException - パラメータがnullの場合
  - getAllRelationIds
```
public List<String> getAllRelationIds()
```
    関係サービスによって処理されるすべての関係のすべての関係IDを返します。
    
    定義:
    
    getAllRelationIds、インタフェースRelationServiceMBean
    
    戻り値:
    
    StringのArrayList
  - checkRoleReading
```
public Integer checkRoleReading(String roleName,
                                String relationTypeName)
                         throws IllegalArgumentException,
                                RelationTypeNotFoundException
```
    指定された型の関係で、指定されたRoleの読取りが可能かどうかをチェックします。
    
    定義:
    
    checkRoleReading、インタフェースRelationServiceMBean
    
    パラメータ:
    
    roleName - チェックされるロールの名前
    
    relationTypeName - 関係タイプの名前
    
    戻り値:
    
    発生の可能性がある問題に対応する整数型(RoleUnresolved内の定数で表される)をラップするInteger
    - ロールの読取りが可能な場合は0
    - RoleStatus.NO_ROLE_WITH_NAMEに対応する整数型
    - RoleStatus.ROLE_NOT_READABLEに対応する整数型
    
    例外:
    
    IllegalArgumentException - パラメータがnullの場合
    
    RelationTypeNotFoundException - 関係サービスにとって未知の関係タイプである場合
  - checkRoleWriting
```
public Integer checkRoleWriting(Role role,
                                String relationTypeName,
                                Boolean initFlag)
                         throws IllegalArgumentException,
                                RelationTypeNotFoundException
```
    指定された型の関係で、指定されたRoleの設定が可能かどうかをチェックします。
    
    定義:
    
    checkRoleWriting、インタフェースRelationServiceMBean
    
    パラメータ:
    
    role - チェックされるロール
    
    relationTypeName - 関係タイプの名前
    
    initFlag - ロールの初期化のためにチェックが行われたことを示すフラグ。書込みアクセスの検証は行われない
    
    戻り値:
    
    発生の可能性がある問題に対応する整数型(RoleUnresolved内の定数で表される)をラップするInteger
    - ロールの設定が可能な場合は0
    - RoleStatus.NO_ROLE_WITH_NAMEに対応する整数型
    - RoleStatus.ROLE_NOT_WRITABLEの整数型
    - RoleStatus.LESS_THAN_MIN_ROLE_DEGREEの整数型
    - RoleStatus.MORE_THAN_MAX_ROLE_DEGREEの整数型
    - RoleStatus.REF_MBEAN_OF_INCORRECT_CLASSの整数型
    - RoleStatus.REF_MBEAN_NOT_REGISTEREDの整数型
    
    例外:
    
    IllegalArgumentException - パラメータがnullの場合
    
    RelationTypeNotFoundException - 未知の関係タイプの場合
  - sendRelationCreationNotification
```
public void sendRelationCreationNotification(String relationId)
                                      throws IllegalArgumentException,
                                             RelationNotFoundException
```
    関係作成の通知(RelationNotification)を送信します。通知型は次のとおりです。
    - RelationNotification.RELATION_BASIC_CREATION。関係が関係サービスの内部オブジェクトである場合
    - RelationNotification.RELATION_MBEAN_CREATION。関係が関係として追加されたMBeanである場合
    ソース・オブジェクトは関係サービス自体です。
    関係サービスのcreateRelation()メソッドおよびaddRelation()メソッドで呼び出されます。
    
    定義:
    
    sendRelationCreationNotification、インタフェースRelationServiceMBean
    
    パラメータ:
    
    relationId - 更新された関係の関係識別子
    
    例外:
    
    IllegalArgumentException - パラメータがnullの場合
    
    RelationNotFoundException - 指定された関係IDの関係が存在しない場合
  - sendRoleUpdateNotification
```
public void sendRoleUpdateNotification(String relationId,
                                       Role newRole,
                                       List<ObjectName> oldValue)
                                throws IllegalArgumentException,
                                       RelationNotFoundException
```
    指定された関係内のロール更新の通知(RelationNotification)を送信します。通知型は次のとおりです。
    - RelationNotification.RELATION_BASIC_UPDATE。関係が関係サービスの内部オブジェクトである場合
    - RelationNotification.RELATION_MBEAN_UPDATE。関係が関係として追加されたMBeanである場合
    ソース・オブジェクトは関係サービス自体です。
    関係MBeanのsetRole()メソッド(指定されたロール用)およびsetRoles()メソッド(各ロール用)で呼び出されます。この実装はRelationSupportクラスで提供されます。
    関係サービスのsetRole()メソッド(指定されたロール用)およびsetRoles()メソッド(各ロール用)でも呼び出せます。
    
    定義:
    
    sendRoleUpdateNotification、インタフェースRelationServiceMBean
    
    パラメータ:
    
    relationId - 更新された関係の関係識別子
    
    newRole - 新しいロール(名前と新しい値)
    
    oldValue - 古いロール値(ObjectNameオブジェクトのList)
    
    例外:
    
    IllegalArgumentException - パラメータがnullの場合
    
    RelationNotFoundException - 指定された関係IDの関係が存在しない場合
  - sendRelationRemovalNotification
```
public void sendRelationRemovalNotification(String relationId,
                                            List<ObjectName> unregMBeanList)
                                     throws IllegalArgumentException,
                                            RelationNotFoundException
```
    関係削除の通知(RelationNotification)を送信します。通知型は次のとおりです。
    - RelationNotification.RELATION_BASIC_REMOVAL。関係が関係サービスの内部オブジェクトである場合
    - RelationNotification.RELATION_MBEAN_REMOVAL。関係が関係として追加されたMBeanである場合
    ソース・オブジェクトは関係サービス自体です。
    関係サービスのremoveRelation()メソッドで呼び出されます。
    
    定義:
    
    sendRelationRemovalNotification、インタフェースRelationServiceMBean
    
    パラメータ:
    
    relationId - 更新された関係の関係識別子
    
    unregMBeanList - 関係の削除の結果、登録解除されるMBeanのObjectNameのリスト(nullも可)
    
    例外:
    
    IllegalArgumentException - パラメータがnullの場合
    
    RelationNotFoundException - 指定された関係IDの関係が存在しない場合
  - updateRoleMap
```
public void updateRoleMap(String relationId,
                          Role newRole,
                          List<ObjectName> oldValue)
                   throws IllegalArgumentException,
                          RelationServiceNotRegisteredException,
                          RelationNotFoundException
```
    指定された関係内の指定されたロールを更新するため、関係サービス・ロール・マップの更新を処理します。
    関係MBeanのsetRole()メソッド(指定されたロール用)およびsetRoles()メソッド(各ロール用)で呼び出されます。この実装はRelationSupportクラスで提供されます。
    関係サービスのsetRole()メソッド(指定されたロール用)およびsetRoles()メソッド(各ロール用)でも呼び出せます。
    関係サービスがMBeanの登録解除時も整合性を確保し、クエリーを実行できるようにするには、ロールの更新時にこのメソッドを呼び出す必要があります。
    
    定義:
    
    updateRoleMap、インタフェースRelationServiceMBean
    
    パラメータ:
    
    relationId - 更新された関係の関係識別子
    
    newRole - 新しいロール(名前と新しい値)
    
    oldValue - 古いロール値(ObjectNameオブジェクトのList)
    
    例外:
    
    IllegalArgumentException - パラメータがnullの場合
    
    RelationServiceNotRegisteredException - 関係サービスがMBeanサーバーに登録されていない場合
    
    RelationNotFoundException - 指定されたIDに対応する関係が存在しない場合
  - removeRelation
```
public void removeRelation(String relationId)
                    throws RelationServiceNotRegisteredException,
                           IllegalArgumentException,
                           RelationNotFoundException
```
    指定された関係タイプを関係サービスから削除します。
    RelationNotification通知が送信されます。その型は次のとおりです。
    - RelationNotification.RELATION_BASIC_REMOVAL。関係サービス内専用の関係である場合
    - RelationNotification.RELATION_MBEAN_REMOVAL。関係がMBeanとして登録されている場合
    こうした関係で参照されるMBeanの場合、何も行われません。
    
    定義:
    
    removeRelation、インタフェースRelationServiceMBean
    
    パラメータ:
    
    relationId - 削除される関係の関係ID
    
    例外:
    
    RelationServiceNotRegisteredException - 関係サービスがMBeanサーバーに登録されていない場合
    
    IllegalArgumentException - パラメータがnullの場合
    
    RelationNotFoundException - 指定された関係IDに対応する関係が存在しない場合
  - purgeRelations
```
public void purgeRelations()
                    throws RelationServiceNotRegisteredException
```
    関係をパージします。
    このメソッドは、purgeFlag値に依存します。フラグがtrueに設定されている場合は、関係内の参照対象のMBeanの登録解除を知らせる通知を受信したとき自動的に呼び出されます。フラグがfalseに設定されている場合は呼び出されません。
    その場合、関係の整合性を維持するためにこのメソッドを呼び出すかどうかはユーザーが決定します。 MBeanの登録が解除された後ただちにパージが行われない場合、ObjectNameが再利用され、関係内の参照対象の別のMBeanに割り当てられるときにこのpurgeRelations()メソッドを手動で呼び出すと、問題が発生します。これは、新しいMBeanが認識されず、ObjectNameが登録解除されたMBeanに対応すると見なされるからです。
    動作は、登録解除されたMBeanが参照されるロールのカーディナリティによって決定されます。
    - ロール内のMBean参照を1つ削除したとき参照の数が最小値より少なくなる場合は、関係を削除する必要がある
    - MBean参照を削除したあと残った参照の数がカーディナリティ範囲内である場合は、関係を保持し、handleMBeanUnregistration()コールバックを呼び出して更新する
    
    定義:
    
    purgeRelations、インタフェースRelationServiceMBean
    
    例外:
    
    RelationServiceNotRegisteredException - 関係サービスがMBeanサーバーに登録されていない場合
  - findReferencingRelations
```
public Map<String,List<String>> findReferencingRelations(ObjectName mbeanName,
                                                         String relationTypeName,
                                                         String roleName)
                                                  throws IllegalArgumentException
```
    指定されたMBeanが参照される関係を取得します。
    これは、CIMの「Reference」および「ReferenceName」オペレーションに対応します。
    
    定義:
    
    findReferencingRelations、インタフェースRelationServiceMBean
    
    パラメータ:
    
    mbeanName - MBeanのObjectName
    
    relationTypeName - nullも可。指定した場合、検索ではそのタイプの関係のみが考慮される。それ以外の場合、すべての関係タイプが考慮される。
    
    roleName - nullも可。指定した場合、そのロール内のMBeanが参照される関係のみが返される。それ以外の場合、すべてのロールが考慮される。
    
    戻り値:
    
    HashMap。キーは、MBeanが参照される関係の関係ID。各キーの値はロール名のArrayList (MBeanは同じ関係の複数のロール内で参照可能)
    
    例外:
    
    IllegalArgumentException - パラメータがnullの場合
  - findAssociatedMBeans
```
public Map<ObjectName,List<String>> findAssociatedMBeans(ObjectName mbeanName,
                                                         String relationTypeName,
                                                         String roleName)
                                                  throws IllegalArgumentException
```
    関係内の指定されたMBeanに関連付けられたMBeanを取得します。
    これは、CIMのAssociatorおよびAssociatorNameオペレーションに対応します。
    
    定義:
    
    findAssociatedMBeans、インタフェースRelationServiceMBean
    
    パラメータ:
    
    mbeanName - MBeanのObjectName
    
    relationTypeName - nullも可。指定した場合、検索ではそのタイプの関係のみが考慮される。それ以外の場合、すべての関係タイプが考慮される。
    
    roleName - nullも可。指定した場合、そのロール内のMBeanが参照される関係のみが考慮される。それ以外の場合、すべてのロールが考慮される。
    
    戻り値:
    
    HashMap。キーは指定されたMBeanに関連付けられたMBeanのObjectName。各キーの値は、キーMBeanが指定されたMBeanに関連付けられている関係の関係IDから成るArrayList (これらは複数の異なった関係に関連付け可能)
    
    例外:
    
    IllegalArgumentException - パラメータがnullの場合
  - findRelationsOfType
```
public List<String> findRelationsOfType(String relationTypeName)
                                 throws IllegalArgumentException,
                                        RelationTypeNotFoundException
```
    指定された型の関係の関係IDを返します。
    
    定義:
    
    findRelationsOfType、インタフェースRelationServiceMBean
    
    パラメータ:
    
    relationTypeName - 関係タイプの名前
    
    戻り値:
    
    関係IDのArrayList
    
    例外:
    
    IllegalArgumentException - パラメータがnullの場合
    
    RelationTypeNotFoundException - その名前の関係タイプが存在しない場合
  - getRole
```
public List<ObjectName> getRole(String relationId,
                                String roleName)
                         throws RelationServiceNotRegisteredException,
                                IllegalArgumentException,
                                RelationNotFoundException,
                                RoleNotFoundException
```
    指定された関係に含まれる指定されたロール名のロール値を取得します。
    
    定義:
    
    getRole、インタフェースRelationServiceMBean
    
    パラメータ:
    
    relationId - 関係ID
    
    roleName - ロール名
    
    戻り値:
    
    ロール値となるObjectNameオブジェクトのArrayList
    
    例外:
    
    RelationServiceNotRegisteredException - 関係サービスが未登録の場合
    
    IllegalArgumentException - パラメータがnullの場合
    
    RelationNotFoundException - 指定されたIDに対応する関係が存在しない場合
    
    RoleNotFoundException - 次の場合:
    - 指定された名前のロールが存在しない場合
    または
    - ロールが読取り不可な場合
    
    関連項目:
    
    setRole(java.lang.String, javax.management.relation.Role)
  - getRoles
```
public RoleResult getRoles(String relationId,
                           String[] roleNameArray)
                    throws RelationServiceNotRegisteredException,
                           IllegalArgumentException,
                           RelationNotFoundException
```
    指定された関係に含まれる指定された名前のロールの値を取得します。
    
    定義:
    
    getRoles、インタフェースRelationServiceMBean
    
    パラメータ:
    
    relationId - 関係ID
    
    roleNameArray - 取得されるロールの名前から成る配列
    
    戻り値:
    
    RoleResultオブジェクト。取得に成功したロールのRoleListと取得されなかったロールのRoleUnresolvedListを含む
    
    例外:
    
    RelationServiceNotRegisteredException - 関係サービスがMBeanサーバーに登録されていない場合
    
    IllegalArgumentException - パラメータがnullの場合
    
    RelationNotFoundException - 指定されたIDに対応する関係が存在しない場合
    
    関連項目:
    
    setRoles(java.lang.String, javax.management.relation.RoleList)
  - getAllRoles
```
public RoleResult getAllRoles(String relationId)
                       throws IllegalArgumentException,
                              RelationNotFoundException,
                              RelationServiceNotRegisteredException
```
    関係に含まれるすべてのロールを返します。
    
    定義:
    
    getAllRoles、インタフェースRelationServiceMBean
    
    パラメータ:
    
    relationId - 関係ID
    
    戻り値:
    
    RoleResultオブジェクト。取得に成功したロールのRoleListと読み取れなかったロールのRoleUnresolvedListを含む。
    
    例外:
    
    IllegalArgumentException - パラメータがnullの場合
    
    RelationNotFoundException - 指定されたIDに対応する関係が存在しない場合
    
    RelationServiceNotRegisteredException - 関係サービスがMBeanサーバーに登録されていない場合
  - getRoleCardinality
```
public Integer getRoleCardinality(String relationId,
                                  String roleName)
                           throws IllegalArgumentException,
                                  RelationNotFoundException,
                                  RoleNotFoundException
```
    指定されたロール内で現在参照されているMBeanの数を取得します。
    
    定義:
    
    getRoleCardinality、インタフェースRelationServiceMBean
    
    パラメータ:
    
    relationId - 関係ID
    
    roleName - ロール名
    
    戻り値:
    
    ロール内の現在参照されているMBeanの数
    
    例外:
    
    IllegalArgumentException - パラメータがnullの場合
    
    RelationNotFoundException - 指定されたIDに対応する関係が存在しない場合
    
    RoleNotFoundException - 指定された名前のロールが存在しない場合
  - setRole
```
public void setRole(String relationId,
                    Role role)
             throws RelationServiceNotRegisteredException,
                    IllegalArgumentException,
                    RelationNotFoundException,
                    RoleNotFoundException,
                    InvalidRoleValueException
```
    指定された関係内の指定されたロールを設定します。
    関係の関係タイプに含まれている対応するロール定義に従って、ロールをチェックします。
    関係サービスは、関係の整合性を維持するため、参照対象のMBeanの登録解除を処理することにより、変更を追跡します。
    
    定義:
    
    setRole、インタフェースRelationServiceMBean
    
    パラメータ:
    
    relationId - 関係ID
    
    role - 設定されるロール(名前と新しい値)
    
    例外:
    
    RelationServiceNotRegisteredException - 関係サービスがMBeanサーバーに登録されていない場合
    
    IllegalArgumentException - パラメータがnullの場合
    
    RelationNotFoundException - 指定されたIDに対応する関係が存在しない場合
    
    RoleNotFoundException - ロールが存在しないか、書込み不可である場合
    
    InvalidRoleValueException - ロールに対して提供された値が無効な場合:
    - 指定された値に含まれる参照対象のMBeanの数が予想最小値より小さい場合
    または
    - 指定された値に含まれる参照対象のMBeanの数が予想最大値を超えている場合
    または
    - 値に含まれる参照対象のMBeanのうち1つが、そのロールのMBeanクラスのオブジェクトでない場合
    または
    - そのロールのMBeanが存在しない場合
    
    関連項目:
    
    getRole(java.lang.String, java.lang.String)
  - setRoles
```
public RoleResult setRoles(String relationId,
                           RoleList roleList)
                    throws RelationServiceNotRegisteredException,
                           IllegalArgumentException,
                           RelationNotFoundException
```
    指定された関係内の指定されたロールを設定します。
    関係の関係タイプに含まれている対応するロール定義に従って、ロールをチェックします。
    関係サービスは、関係の整合性を維持するため、参照対象のMBeanの登録解除を処理することにより、変更を追跡します。
    
    定義:
    
    setRoles、インタフェースRelationServiceMBean
    
    パラメータ:
    
    relationId - 関係ID
    
    roleList - 設定されるロールのリスト
    
    戻り値:
    
    RoleResultオブジェクト。設定に成功したロールのRoleListと設定されなかったロールのRoleUnresolvedListを含む
    
    例外:
    
    RelationServiceNotRegisteredException - 関係サービスがMBeanサーバーに登録されていない場合
    
    IllegalArgumentException - パラメータがnullの場合
    
    RelationNotFoundException - 指定されたIDに対応する関係が存在しない場合
    
    関連項目:
    
    getRoles(java.lang.String, java.lang.String[])
  - getReferencedMBeans
```
public Map<ObjectName,List<String>> getReferencedMBeans(String relationId)
                                                 throws IllegalArgumentException,
                                                        RelationNotFoundException
```
    関係のさまざまなロールで参照されるMBeanを取得します。
    
    定義:
    
    getReferencedMBeans、インタフェースRelationServiceMBean
    
    パラメータ:
    
    relationId - 関係ID
    
    戻り値:
    
    HashMapマッピング:
    ObjectName→String (ロール名)から成るArrayList
    
    例外:
    
    IllegalArgumentException - パラメータがnullの場合
    
    RelationNotFoundException - 指定された関係IDに対応する関係が存在しない場合
  - getRelationTypeName
```
public String getRelationTypeName(String relationId)
                           throws IllegalArgumentException,
                                  RelationNotFoundException
```
    指定された関係の関係タイプの名前を返します。
    
    定義:
    
    getRelationTypeName、インタフェースRelationServiceMBean
    
    パラメータ:
    
    relationId - 関係ID
    
    戻り値:
    
    関連付けられた関係タイプの名前
    
    例外:
    
    IllegalArgumentException - パラメータがnullの場合
    
    RelationNotFoundException - 指定された関係IDに対応する関係が存在しない場合
  - handleNotification
```
public void handleNotification(Notification notif,
                               Object handback)
```
    JMX通知が発生したとき呼び出されます。一般に、関係ロール内の参照対象のMBean、または関係になるMBeanの登録解除の通知を処理します。
    
    定義:
    
    handleNotification、インタフェースNotificationListener
    
    パラメータ:
    
    notif - 通知
    
    handback - リスナーによるMBeanエミッタの情報の関連付けに役立つ、不透明なオブジェクト(nullも使用可能)。
  - getNotificationInfo
```
public MBeanNotificationInfo[] getNotificationInfo()
```
    送信される通知のJavaクラス名と通知タイプを含むNotificationInfoオブジェクトを返します。
    
    定義:
    
    getNotificationInfo、インタフェースNotificationBroadcaster
    
    オーバーライド:
    
    getNotificationInfo、クラスNotificationBroadcasterSupport
    
    戻り値:
    
    可能な通知の配列。

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

クラスRelationService

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

メソッドのサマリー

クラス javax.management.NotificationBroadcasterSupportから継承されたメソッド

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

コンストラクタの詳細

RelationService

メソッドの詳細

isActive

preRegister

postRegister

preDeregister

postDeregister

getPurgeFlag

setPurgeFlag

createRelationType

addRelationType

getAllRelationTypeNames

getRoleInfos

getRoleInfo

removeRelationType

createRelation

addRelation

isRelationMBean

isRelation

hasRelation

getAllRelationIds

checkRoleReading

checkRoleWriting

sendRelationCreationNotification

sendRoleUpdateNotification

sendRelationRemovalNotification

updateRoleMap

removeRelation

purgeRelations

findReferencingRelations

findAssociatedMBeans

findRelationsOfType

getRole

getRoles

getAllRoles

getRoleCardinality

setRole

setRoles

getReferencedMBeans

getRelationTypeName

handleNotification

getNotificationInfo