JavaTM Platform
Standard Ed. 6

javax.management.modelmbean
クラス ModelMBeanAttributeInfo

java.lang.Object
  上位を拡張 javax.management.MBeanFeatureInfo
      上位を拡張 javax.management.MBeanAttributeInfo
          上位を拡張 javax.management.modelmbean.ModelMBeanAttributeInfo
すべての実装されたインタフェース:
Serializable, Cloneable, DescriptorAccess, DescriptorRead

public class ModelMBeanAttributeInfo
extends MBeanAttributeInfo
implements DescriptorAccess

ModelMBeanAttributeInfo オブジェクトは、ModelMBean の属性を記述します。これは、関連 Descriptor を持ち、DescriptorAccess インタフェースを実装した MBeanAttributeInfo のサブクラスです。

記述子内のフィールドは以下のように定義済みですが、この内容に限定されません。

 name           :属性名  
 descriptorType :必ず attribute   
 value          :属性の現在の値 
 default:属性のデフォルト値 
 displayName    :ディスプレイで使用される属性の名前 
 getMethod      :取得メソッドのオペレーション記述子の名前  
 setMethod      :設定メソッドのオペレーション記述子の名前 
 protocolMap    :Descriptor を実装するオブジェクト interface:属性に適したマッピングでなければならない。
                  エントリは実行時に更新または追加可能
 persistPolicy  :OnUpdate、OnTimer、NoMoreOftenThan、OnUnregister、Always、Never  
 persistPeriod  :持続サイクルの頻度を表す秒数。persistPolicy が OnTimer または NoMoreOftenThan のとき使用  
 currencyTimeLimit :値の有効期間。<0 無効、=0 常に有効、>0 秒
 lastUpdatedTimeStamp :値が設定された時刻  
 visibility     :1 〜 4 の値のうち 1:常に可視 4:ほとんど不可視  
 presentationString :データ表現を可能にするための XML 形式の文字列 
 
デフォルトの記述子には、name、descriptorType、および displayName フィールドが含まれます。

注: 以前のバージョンの仕様との不整合があるため、currencyTimeLimit にはゼロ以下の値を使用しないようにしてください。キャッシュに入った値が有効でないことを示したい場合は、currencyTimeLimit フィールドを省略します。この値が常に有効であることを示したい場合は、このフィールドに非常に大きい値を指定します。

このクラスの serialVersionUID6181543027787327345L です。

導入されたバージョン:
1.5
関連項目:
直列化された形式

フィールドの概要
 
クラス javax.management.MBeanFeatureInfo から継承されたフィールド
description, name
 
コンストラクタの概要
ModelMBeanAttributeInfo(ModelMBeanAttributeInfo inInfo)
          この ModelMBeanAttributeInfo Object から新しい ModelMBeanAttributeInfo オブジェクトを構築します。
ModelMBeanAttributeInfo(String name, String description, Method getter, Method setter)
          デフォルトの記述子で ModelMBeanAttributeInfo オブジェクトを構築します。
ModelMBeanAttributeInfo(String name, String description, Method getter, Method setter, Descriptor descriptor)
          ModelMBeanAttributeInfo オブジェクトを構築します。
ModelMBeanAttributeInfo(String name, String type, String description, boolean isReadable, boolean isWritable, boolean isIs)
          デフォルトの記述子で ModelMBeanAttributeInfo オブジェクトを構築します。
ModelMBeanAttributeInfo(String name, String type, String description, boolean isReadable, boolean isWritable, boolean isIs, Descriptor descriptor)
          デフォルトの記述子で ModelMBeanAttributeInfo オブジェクトを構築します。
 
メソッドの概要
 Object clone()
          この ModelMBeanAttributeInfo を複製して新しい ModelMBeanAttributeInfo を作成し、返します。
 Descriptor getDescriptor()
          ModelMBeanAttributeInfo に関連付けられた Descriptor のコピーを取得します。
 void setDescriptor(Descriptor inDescriptor)
          ModelMBeanAttributeDescriptor に関連付けられた Descriptor (完全置換) を設定します。
 String toString()
          人間が読める形式の ModelMBeanAttributeInfo インスタンスを返します。
 
クラス javax.management.MBeanAttributeInfo から継承されたメソッド
equals, getType, hashCode, isIs, isReadable, isWritable
 
クラス javax.management.MBeanFeatureInfo から継承されたメソッド
getDescription, getName
 
クラス java.lang.Object から継承されたメソッド
finalize, getClass, notify, notifyAll, wait, wait, wait
 

コンストラクタの詳細

ModelMBeanAttributeInfo

public ModelMBeanAttributeInfo(String name,
                               String description,
                               Method getter,
                               Method setter)
                        throws IntrospectionException
デフォルトの記述子で ModelMBeanAttributeInfo オブジェクトを構築します。コンストラクタオブジェクトの Descriptor には、DescriptorKey メタ注釈を含む Method オブジェクト上の注釈が寄与するフィールドが含まれます。

パラメータ:
name - 属性の名前
description - 人間が読める形式の属性の説明省略可能
getter - 属性値の読み込みに使用するメソッド。 属性が書き込み専用の場合は null
setter - 属性値の書き込みに使用するメソッド。 属性が読み取り専用の場合は null
例外:
IntrospectionException - この属性の定義に整合性の問題がある場合

ModelMBeanAttributeInfo

public ModelMBeanAttributeInfo(String name,
                               String description,
                               Method getter,
                               Method setter,
                               Descriptor descriptor)
                        throws IntrospectionException
ModelMBeanAttributeInfo オブジェクトを構築します。コンストラクタオブジェクトの Descriptor には、DescriptorKey メタ注釈を含む Method オブジェクト上の注釈が寄与するフィールドが含まれます。

パラメータ:
name - 属性の名前
description - 人間が読める形式の属性の説明省略可能
getter - 属性値の読み込みに使用するメソッド。 属性が書き込み専用の場合は null
setter - 属性値の書き込みに使用するメソッド。 属性が読み取り専用の場合は null
descriptor - この Attribute インスタンス用として適切なメタデータを含む Descriptor インスタンス。null の場合、デフォルトの記述子が作成される。 displayName フィールドを持たない記述子には、displayName フィールドがデフォルト値で追加される
例外:
IntrospectionException - この属性の定義に整合性の問題がある場合
RuntimeOperationsException - IllegalArgumentException をラップする。記述子が無効である場合、記述子フィールド name が name パラメータと等しくない場合、または記述子フィールド DescriptorType が attribute と等しくない場合

ModelMBeanAttributeInfo

public ModelMBeanAttributeInfo(String name,
                               String type,
                               String description,
                               boolean isReadable,
                               boolean isWritable,
                               boolean isIs)
デフォルトの記述子で ModelMBeanAttributeInfo オブジェクトを構築します。

パラメータ:
name - 属性の名前
type - 属性の型またはクラス名
description - 人間が読める形式の属性の説明
isReadable - 属性が取得メソッドを持つ場合は true、そうでない場合は false
isWritable - 属性が設定メソッドを持つ場合は true、そうでない場合は false
isIs - 属性が is 取得メソッドを持つ場合は true、そうでない場合は false

ModelMBeanAttributeInfo

public ModelMBeanAttributeInfo(String name,
                               String type,
                               String description,
                               boolean isReadable,
                               boolean isWritable,
                               boolean isIs,
                               Descriptor descriptor)
デフォルトの記述子で ModelMBeanAttributeInfo オブジェクトを構築します。

パラメータ:
name - 属性の名前
type - 属性の型またはクラス名
description - 人間が読める形式の属性の説明
isReadable - 属性が取得メソッドを持つ場合は true、そうでない場合は false
isWritable - 属性が設定メソッドを持つ場合は true、そうでない場合は false
isIs - 属性が is 取得メソッドを持つ場合は true、そうでない場合は false
descriptor - この Attribute インスタンス用として適切なメタデータを含む Descriptor インスタンス。null の場合、デフォルトの記述子が作成される。 displayName フィールドを持たない記述子には、displayName フィールドがデフォルト値で追加される
例外:
RuntimeOperationsException - IllegalArgumentException をラップする。記述子が無効である場合、記述子フィールド name が name パラメータと等しくない場合、または記述子フィールド DescriptorType が attribute と等しくない場合

ModelMBeanAttributeInfo

public ModelMBeanAttributeInfo(ModelMBeanAttributeInfo inInfo)
この ModelMBeanAttributeInfo Object から新しい ModelMBeanAttributeInfo オブジェクトを構築します。デフォルトの記述子が作成されます。

パラメータ:
inInfo - 複製される ModelMBeanAttributeInfo
メソッドの詳細

getDescriptor

public Descriptor getDescriptor()
ModelMBeanAttributeInfo に関連付けられた Descriptor のコピーを取得します。

定義:
インタフェース DescriptorRead 内の getDescriptor
オーバーライド:
クラス MBeanFeatureInfo 内の getDescriptor
戻り値:
ModelMBeanAttributeInfo オブジェクトに 関連付けられた Descriptor
関連項目:
setDescriptor(javax.management.Descriptor)

setDescriptor

public void setDescriptor(Descriptor inDescriptor)
ModelMBeanAttributeDescriptor に関連付けられた Descriptor (完全置換) を設定します。新しい Descriptor が null の場合、関連 Descriptor はデフォルトの記述子に戻ります。Descriptor の割り当て前には、妥当性検査が行われます。新しい Descriptor が無効である場合、IllegalArgumentException をラップする RuntimeOperationsException がスローされます。

定義:
インタフェース DescriptorAccess 内の setDescriptor
パラメータ:
inDescriptor - ModelMBeanAttributeInfo に関連付けられた Descriptor を 置換する
例外:
RuntimeOperationsException - 無効な Descriptor の IllegalArgumentException をラップする
関連項目:
getDescriptor()

clone

public Object clone()
この ModelMBeanAttributeInfo を複製して新しい ModelMBeanAttributeInfo を作成し、返します。

オーバーライド:
クラス MBeanAttributeInfo 内の clone
戻り値:
このインスタンスの複製
例外:
RuntimeOperationsException - フィールド名またはフィールド値が不正である場合。 なんらかの理由で記述子の作成に失敗した場合、この例外がスローされる
関連項目:
Cloneable

toString

public String toString()
人間が読める形式の ModelMBeanAttributeInfo インスタンスを返します。

オーバーライド:
クラス MBeanAttributeInfo 内の toString
戻り値:
このオブジェクトの文字列表現

JavaTM Platform
Standard Ed. 6

バグの報告と機能のリクエスト
さらに詳しい API リファレンスおよび開発者ドキュメントについては、Java SE 開発者用ドキュメントを参照してください。開発者向けの詳細な解説、概念の概要、用語の定義、バグの回避策、およびコード実例が含まれています。

Copyright 2006 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms. Documentation Redistribution Policy も参照してください。