JavaTM 2 Platform
Standard Ed. 6

javax.management.modelmbean
類別 ModelMBeanOperationInfo

java.lang.Object
  繼承者 javax.management.MBeanFeatureInfo
      繼承者 javax.management.MBeanOperationInfo
          繼承者 javax.management.modelmbean.ModelMBeanOperationInfo
所有已實作的介面:
Serializable, Cloneable, DescriptorAccess, DescriptorRead

public class ModelMBeanOperationInfo
extends MBeanOperationInfo
implements DescriptorAccess

ModelMBeanOperationInfo 物件描述了 ModelMBean 的管理操作。它是 MBeanOperationInfo 的一個子類別,添加了關聯的 Descriptor 和 DescriptorAccess 介面實作。

描述符中的欄位定義如下,但不限於此: 
 name           : 操作的名稱 
 descriptorType : 必須為 "operation"  
 class          : 其中定義了方法(完全限定)的類別
 role           : 必須為 "operation"、"getter" 或 "setter"
 targetObject   : 將在其上執行此方法的物件
 targetType     : targetObject 的物件參考型別可以為:ObjectReference | Handle | EJBHandle | IOR | MIReference。
 value          : 操作的快取記憶體值
 currencyTimeLimit : 快取記憶體值的有效時間
 lastUpdatedTimeStamp : 當設置快取記憶體值時
 visibility            : 1-4,其中 1 表示總是可見;4 表示幾乎不可見
 presentationString : 用於描述如何呈現操作的 xml 格式的字元串
 
預設的描述符包含 name、descriptorType、displayName 和 role 欄位。

註:由於與此規範的以前版本不一致,因此對於 currencyTimeLimit,建議不要使用負值或零。要指示某個快取記憶體的值永遠無效,請忽略 currencyTimeLimit 欄位。要指示它總是有效,請為此欄位使用一個非常大的值。

此類別的 serialVersionUID6532732096650090465L

從以下版本開始:
1.5
另請參見:
序列化表格

欄位摘要
 
從類別 javax.management.MBeanOperationInfo 繼承的欄位
ACTION, ACTION_INFO, INFO, UNKNOWN
 
從類別 javax.management.MBeanFeatureInfo 繼承的欄位
description, name
 
建構子摘要
ModelMBeanOperationInfo(ModelMBeanOperationInfo inInfo)
          根據此 ModelMBeanOperation Object 建構新的 ModelMBeanOperationInfo 物件。
ModelMBeanOperationInfo(String description, Method operationMethod)
          建構帶有預設描述符的 ModelMBeanOperationInfo 物件。
ModelMBeanOperationInfo(String description, Method operationMethod, Descriptor descriptor)
          建構 ModelMBeanOperationInfo 物件。
ModelMBeanOperationInfo(String name, String description, MBeanParameterInfo[] signature, String type, int impact)
          建構帶有預設描述符的 ModelMBeanOperationInfo 物件。
ModelMBeanOperationInfo(String name, String description, MBeanParameterInfo[] signature, String type, int impact, Descriptor descriptor)
          建構 ModelMBeanOperationInfo 物件。
 
方法摘要
 Object clone()
          創建並返回新的 ModelMBeanOperationInfo,它是此 ModelMBeanOperationInfo 的副本。
 Descriptor getDescriptor()
          返回 ModelMBeanOperationInfo 的關聯 Descriptor 的副本。
 void setDescriptor(Descriptor inDescriptor)
          設置 ModelMBeanOperationInfo 的關聯 Descriptor(完全取代)。
 String toString()
          以可讀形式返回包含 ModelMBeanOperationInfo 全部內容的字元串。
 
從類別 javax.management.MBeanOperationInfo 繼承的方法
equals, getImpact, getReturnType, getSignature, hashCode
 
從類別 javax.management.MBeanFeatureInfo 繼承的方法
getDescription, getName
 
從類別 java.lang.Object 繼承的方法
finalize, getClass, notify, notifyAll, wait, wait, wait
 

建構子詳細資訊

ModelMBeanOperationInfo

public ModelMBeanOperationInfo(String description,
                               Method operationMethod)
建構帶有預設描述符的 ModelMBeanOperationInfo 物件。已建構物件的 Descriptor 套件括 Method 物件(包含 DescriptorKey 元註釋)產生的欄位。

參數:
operationMethod - 描述 MBean 操作的 java.lang.reflect.Method 物件。
description - 操作的可讀描述。

ModelMBeanOperationInfo

public ModelMBeanOperationInfo(String description,
                               Method operationMethod,
                               Descriptor descriptor)
建構 ModelMBeanOperationInfo 物件。已建構物件的 Descriptor 套件括 Method 物件(包含 DescriptorKey 元註釋)產生的欄位。

參數:
operationMethod - 描述 MBean 操作的 java.lang.reflect.Method 物件。
description - 操作的可讀描述。
descriptor - 套件含此 ModelMBeanOperationInfo 實例的適當元資料的 Descriptor 的一個實例。如果該參數為 null,則將創建預設描述符。如果描述符不包含 "displayName" 或 "role" 欄位,則以預設值將這些欄位添加到描述符中。
拋出:
RuntimeOperationsException - 套件裝一個 IllegalArgumentException。描述符無效;描述符 "name" 欄位不等於操作名稱;描述符 "DescriptorType" 欄位不等於 "operation";描述符 "role" 欄位不等於 "operation"、"getter" 或 "setter"。

ModelMBeanOperationInfo

public ModelMBeanOperationInfo(String name,
                               String description,
                               MBeanParameterInfo[] signature,
                               String type,
                               int impact)
建構帶有預設描述符的 ModelMBeanOperationInfo 物件。

參數:
name - 方法名稱。
description - 操作的可讀描述。
signature - 描述方法的參數的 MBeanParameterInfo 物件。
type - 方法返回值的型別。
impact - 方法的影響,為 INFO、ACTION、ACTION_INFO、UNKNOWN 之一。

ModelMBeanOperationInfo

public ModelMBeanOperationInfo(String name,
                               String description,
                               MBeanParameterInfo[] signature,
                               String type,
                               int impact,
                               Descriptor descriptor)
建構 ModelMBeanOperationInfo 物件。

參數:
name - 方法名稱。
description - 操作的可讀描述。
signature - 描述方法的參數的 MBeanParameterInfo 物件。
type - 方法返回值的型別。
impact - 方法的影響,為 INFO、ACTION、ACTION_INFO、UNKNOWN 之一。
descriptor - 套件含此 MBeanOperationInfo 實例的適當元資料的 Descriptor 的實例。如果該參數為 null,是將創建預設描述符。如果描述符不包含 "displayName" 或 "role" 欄位,則以預設值將這些欄位添加到描述符中。
拋出:
RuntimeOperationsException - 套件裝一個 IllegalArgumentException。描述符無效;描述符 "name" 欄位不等於操作名稱;描述符 "DescriptorType" 欄位不等於 "operation";描述符 "role" 欄位不等於 "operation"、"getter" 或 "setter"。

ModelMBeanOperationInfo

public ModelMBeanOperationInfo(ModelMBeanOperationInfo inInfo)
根據此 ModelMBeanOperation Object 建構新的 ModelMBeanOperationInfo 物件。

參數:
inInfo - 要複製的 ModelMBeanOperationInfo
方法詳細資訊

clone

public Object clone()
創建並返回新的 ModelMBeanOperationInfo,它是此 ModelMBeanOperationInfo 的副本。

覆寫:
類別 MBeanOperationInfo 中的 clone
返回:
此實例的一個副本。
另請參見:
Cloneable

getDescriptor

public Descriptor getDescriptor()
返回 ModelMBeanOperationInfo 的關聯 Descriptor 的副本。

指定者:
介面 DescriptorRead 中的 getDescriptor
覆寫:
類別 MBeanFeatureInfo 中的 getDescriptor
返回:
與 ModelMBeanOperationInfo 物件關聯的 Descriptor。
另請參見:
setDescriptor(javax.management.Descriptor)

setDescriptor

public void setDescriptor(Descriptor inDescriptor)
設置 ModelMBeanOperationInfo 的關聯 Descriptor(完全取代)。如果新 Descriptor 為 null,則該關聯 Descriptor 恢復為預設描述符。在分派 Descriptor 之前先驗證它。如果新 Descriptor 無效,則拋出包裹 IllegalArgumentException 的 RuntimeOperationsException。

指定者:
介面 DescriptorAccess 中的 setDescriptor
參數:
inDescriptor - 替換與 ModelMBeanOperation 關聯的 Descriptor。
拋出:
RuntimeOperationsException - 套件裝一個無效 Descriptor 的 IllegalArgumentException。
另請參見:
getDescriptor()

toString

public String toString()
以可讀形式返回包含 ModelMBeanOperationInfo 全部內容的字元串。

覆寫:
類別 MBeanOperationInfo 中的 toString
返回:
該物件的字元串表示形式。

JavaTM 2 Platform
Standard Ed. 6

提交錯誤或意見

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