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

public interface RelationServiceMBean

関係サービスは、関係タイプと関係を作成および削除し、整合性を処理し、およびクエリー・メカニズムを提供します。

導入されたバージョン:: 1.5

メソッドのサマリー

修飾子と型

メソッド

説明

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)

関係に含まれるすべてのロールを返します。

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)

指定された関係に含まれる指定された名前のロールの値を取得します。

Boolean

hasRelation(String relationId)

関係サービス内に指定された関係IDで識別される関係があるかどうかをチェックします。

void

isActive()

関係サービスがアクティブかどうかをチェックします。

String

isRelation(ObjectName objectName)

MBeanが関係として関係サービスに追加されている場合、指定されたObjectNameに関連付けられる関係IDを返します。

ObjectName

isRelationMBean(String relationId)

関係がMBean (ユーザーによって作成され、関係として関係サービスに追加されたもの)によって表される場合、MBeanのObjectNameを返します。

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> oldRoleValue)

指定された関係内のロール更新の通知(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> oldRoleValue)

指定された関係内の指定されたロールを更新するため、関係サービス・ロール・マップの更新を処理します。

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

インタフェースRelationServiceMBean

メソッドのサマリー

メソッドの詳細

isActive

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