javax.management.relation
クラス RelationTypeSupport

java.lang.Object
  javax.management.relation.RelationTypeSupport

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

Serializable, RelationType

public class RelationTypeSupport
extends Object
implements RelationType

RelationTypeSupport オブジェクトは、RelationType インタフェースを実装します。

このオブジェクトは関係型を表現し、その型のすべての関係でサポートされるロールの情報を提供します。

関係型には、関係型名と、RoleInfo オブジェクトで表現されるロール情報のリストが含まれます。

関係型は、次のいずれかの方法で関係サービス内に宣言する必要があります。

- createRelationType() メソッドを使用。このメソッドは、RelationTypeSupport オブジェクトを作成し、関係サービス内に格納する

- addRelationType() メソッドを使用。ユーザは、このメソッドを使って、RelationType インタフェースを実装するオブジェクトを作成する必要がある。このオブジェクトが、関係サービス内の関係型の表現として使用される

導入されたバージョン:

1.5

関連項目:

直列化された形式

コンストラクタの概要

protected	RelationTypeSupport(String theRelTypeName) サブクラス用のコンストラクタです。
	RelationTypeSupport(String theRelTypeName, RoleInfo[] theRoleInfoArray) すべてのロール定義が動的に作成され、パラメータとして渡されるコンストラクタです。

メソッドの概要

protected void	addRoleInfo(RoleInfo theRoleInfo) ロール情報を追加します。
String	getRelationTypeName() 関係型名を返します。
RoleInfo	getRoleInfo(String theRoleInfoName) 指定されたロール情報名のロール情報 (RoleInfo オブジェクト) を返します。
List	getRoleInfos() ロール定義のリスト (RoleInfo オブジェクトから成る ArrayList) を返します。

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

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

コンストラクタの詳細

RelationTypeSupport

public RelationTypeSupport(String theRelTypeName,
                           RoleInfo[] theRoleInfoArray)
                    throws IllegalArgumentException,
                           InvalidRelationTypeException

すべてのロール定義が動的に作成され、パラメータとして渡されるコンストラクタです。

パラメータ:

theRelTypeName - 関係型の名前

theRoleInfoArray - ロール定義 (RoleInfo オブジェクト) のリスト

例外:

IllegalArgumentException - パラメータが null の場合

InvalidRelationTypeException - 次の条件が成立する場合:

- 同じ名前が 2 つの異なったロールで使用されている場合

- ロール情報が提供されなかった場合

- ロール情報として null が提供された場合

RelationTypeSupport

protected RelationTypeSupport(String theRelTypeName)

サブクラス用のコンストラクタです。

パラメータ:

theRelTypeName - 関係型の名前

例外:

IllegalArgumentException - パラメータが null の場合

メソッドの詳細

getRelationTypeName

public String getRelationTypeName()

関係型名を返します。

定義:

インタフェース RelationType 内の getRelationTypeName

戻り値:

関係型名

getRoleInfos

public List getRoleInfos()

ロール定義のリスト (RoleInfo オブジェクトから成る ArrayList) を返します。

定義:

インタフェース RelationType 内の getRoleInfos

戻り値:

RoleInfo から成る ArrayList

getRoleInfo

public RoleInfo getRoleInfo(String theRoleInfoName)
                     throws IllegalArgumentException,
                            RoleInfoNotFoundException

指定されたロール情報名のロール情報 (RoleInfo オブジェクト) を返します。見つからない場合は null を返します。

定義:

インタフェース RelationType 内の getRoleInfo

パラメータ:

theRoleInfoName - ロール情報名

戻り値:

ロール定義が存在しない場合は RoleInfo オブジェクト

例外:

IllegalArgumentException - パラメータが null の場合

RoleInfoNotFoundException - その名前のロール情報が関係型内に存在しない場合

addRoleInfo

protected void addRoleInfo(RoleInfo theRoleInfo)
                    throws IllegalArgumentException,
                           InvalidRelationTypeException

ロール情報を追加します。このメソッドは、関係型の作成後は使用できません。関係型が更新されると、作成時に関係型に関連付けられた関係が、元の関係型に適合しなくなるからです。関係サービス内に宣言された関係型を更新しようとすると、RuntimeException がスローされる可能性があります。

パラメータ:

theRoleInfo - 追加されるロール情報

例外:

IllegalArgumentException - パラメータが null の場合

InvalidRelationTypeException - 現在の関連型に同じ名前のロール情報がすでに含まれている場合