概觀  軟體套件   類別  使用  階層樹  已過時  索引  說明 
JavaTM 2 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 的屬性。它是 MBeanAttributeInfo 的一個子類別，添加了關聯的 Descriptor 和 DescriptorAccess 介面實作。

描述符中的欄位定義如下，但不限於此： 

 name           : 屬性名稱 
 descriptorType : 必須為 "attribute"   
 value          : 屬性的當前值
 default        : 屬性的預設值
 displayName    : 將在顯示中使用的屬性名稱
 getMethod      : get 方法的操作描述符名稱
 setMethod      : set 方法的操作描述符名稱
 protocolMap    : 實作 Descriptor 介面的物件：映射關係必須適用於該屬性並且項可以在運行時進行更新或擴充。
 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 欄位。要指示它總是有效，請對此欄位使用一個非常大的值。

此類別的 serialVersionUID 為 6181543027787327345L。

從以下版本開始：
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 套件括 Method 物件（包含 DescriptorKey 元註釋）產生的欄位。

參數：
name - 屬性名稱。
description - 屬性的可讀描述。它是可選的。
getter - 用於讀取屬性值的方法。如果該屬性是只寫的，則此參數可以為 null。
setter - 用於寫入屬性值的方法。如果該屬性是只讀的，則此參數可以為 null。
拋出：
IntrospectionException - 如果此屬性的定義中存在一致性問題。

ModelMBeanAttributeInfo

public ModelMBeanAttributeInfo(String name,
                               String description,
                               Method getter,
                               Method setter,
                               Descriptor descriptor)
                        throws IntrospectionException
建構 ModelMBeanAttributeInfo 物件。已建構物件的 Descriptor 套件括 Method 物件（包含 DescriptorKey 元註釋）產生的欄位。

參數：
name - 屬性名稱。
description - 屬性的可讀描述。它是可選的。
getter - 用於讀取屬性值的方法。如果該屬性是只寫的，則此參數可以為 null。
setter - 用於寫入屬性值的方法。如果該屬性是只讀的，則此參數可以為 null。
descriptor - 套件含此 Attribute 實例的適當元資料的 Descriptor 的實例。如果此參數為 null，則將創建預設描述符。如果描述符不包含 "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" 欄位，則用預設值將此欄位添加到描述符中。
拋出：
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 - 如果 Names 或 Values 欄位的值為非法值。如果因為某種原因導致描述符建構失敗，則將拋出此異常。
另請參見：
Cloneable

toString

public String toString()
返回 ModelMBeanAttributeInfo 實例的可讀版本。

覆寫：
類別 MBeanAttributeInfo 中的 toString
返回：
該物件的字元串表示形式。
概觀  軟體套件   類別  使用  階層樹  已過時  索引  說明 
JavaTM 2 Platform
Standard Ed. 6
 上一個類別   下一個類別 框架    無框架    
摘要： 巢狀 | 欄位 | 建構子 | 方法 詳細資訊： 欄位 | 建構子 | 方法
提交錯誤或意見

版權所有 2008 Sun Microsystems, Inc. 保留所有權利。請遵守GNU General Public License, version 2 only。