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 インタフェースを実装するオブジェクトを作成する必要がある。 このオブジェクトが、関係サービス内の関係型の表現として使用される

このクラスの serialVersionUID は 4611072955724144607L です。

導入されたバージョン:

1.5

関連項目:

直列化された形式

コンストラクタの概要

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

メソッドの概要

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

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

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

コンストラクタの詳細

RelationTypeSupport

public RelationTypeSupport(String relationTypeName,
                           RoleInfo[] roleInfoArray)
                    throws IllegalArgumentException,
                           InvalidRelationTypeException

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

パラメータ:

relationTypeName - 関係型の名前

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

例外:

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

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

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

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

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

RelationTypeSupport

protected RelationTypeSupport(String relationTypeName)

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

パラメータ:

relationTypeName - MBean Server でなければならない

例外:

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

メソッドの詳細

getRelationTypeName

public String getRelationTypeName()

関係型名を返します。

定義:

インタフェース RelationType 内の getRelationTypeName

戻り値:

関係型名

getRoleInfos

public List<RoleInfo> getRoleInfos()

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

定義:

インタフェース RelationType 内の getRoleInfos

戻り値:

RoleInfo から成る ArrayList

getRoleInfo

public RoleInfo getRoleInfo(String roleInfoName)
                     throws IllegalArgumentException,
                            RoleInfoNotFoundException

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

定義:

インタフェース RelationType 内の getRoleInfo

パラメータ:

roleInfoName - ロール情報名

戻り値:

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

例外:

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

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

addRoleInfo

protected void addRoleInfo(RoleInfo roleInfo)
                    throws IllegalArgumentException,
                           InvalidRelationTypeException

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

パラメータ:

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

例外:

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

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