Java javax.management.openmbean 类 CompositeType（JDK5）

所有类

javax.management.openmbean
类 CompositeType

java.lang.Object
  javax.management.openmbean.OpenType
      javax.management.openmbean.CompositeType

所有已实现的接口：

Serializable

public class CompositeType
   
   
   
   
   
extends OpenType
   
   
   
   
   
   
   
   
   
   
implements Serializable
   
   
   
   
   

CompositeType 类是开放类型 类，其实例描述 CompositeData 值的类型。

从以下版本开始：

1.5

另请参见：

序列化表格

CompositeType

public CompositeType(String typeName,
                     String description,
                     String[] itemNames,
                     String[] itemDescriptions,
                     OpenType[] itemTypes)
              throws OpenDataException

构造一个 CompositeType 实例，检查给定参数的有效性。下面描述了每个参数的有效性约束。

注意，内部复制三个数组参数（itemNames、itemDescriptions 和 itemTypes）的内容，以便此构造方法的调用方对这些数组的任何后续修改不会影响构造的 CompositeType 实例。

此复合类型表示的复合数据值的 Java 类名（即：getClassName 方法返回的类名）设置为 CompositeData.class.getName() 返回的字符串值。

参数：

typeName - 为此实例表示的复合类型给出的名称；不能为 null 或空字符串。
 

description - 此实例表示的复合类型的可读描述；不能为 null 或空字符串。
 

itemNames - 在此 CompositeType 实例所描述的复合数据值中包含的项名称；不能为 null，并且至少应包含一个元素；任何元素不能为 null 或空字符串。注意，所给出的项名称的顺序对于区分 CompositeType 实例并不重要；项名称按升序字典顺序排序进行内部存储。
 

itemDescriptions - 此 CompositeType 实例描述的复合数据值中包含的项的描述（与 itemNames 的顺序相同）；应与 itemNames 的大小相同；任何元素不能为 null 或空字符串。
 

itemTypes - 描述此 CompositeType 实例描述的复合数据值中包含的项的开放类型实例（与 itemNames 的顺序相同）；应与 itemNames 的大小相同；任何元素不能为 null。
 

抛出：

IllegalArgumentException - 如果 typeName 或 description 为 null 或空字符串，或者 itemNames 或 itemDescriptions 或 itemTypes 为 null，或者 itemNames 或 itemDescriptions 的任何元素为 null 或空字符串，或者 itemTypes 的任何元素为 null，或者 itemNames 或 itemDescriptions 或 itemTypes 的大小不同。
 

OpenDataException - 如果 itemNames 包含重复的项名称（区分大小写，但是移除了前导和尾部空格）。

containsKey

public boolean containsKey(String itemName)

如果此 CompositeType 实例定义了其名称为 itemName 的项，则返回 true。

参数：

itemName - 项的名称。

返回：

如果此名称的项存在，则返回 true。

getDescription

public String getDescription(String itemName)

返回其名称是 itemName 的项的描述，如果此 CompositeType 实例未定义任何名称是 itemName 的项，则返回 null。

参数：

itemName - 项的名称。

返回：

描述。

getType

public OpenType getType(String itemName)

返回其名称是 itemName 的项的开放类型，如果 CompositeType 实例未定义任何名称是 itemName 的项，则返回 null。

参数：

itemName - 项的名称。

返回：

类型。

keySet

public Set keySet()

返回此 CompositeType 实例定义的所有项名称的不可修改的 Set 视图。集合的迭代器将按升序返回项名称。

返回：

String 的 Set。

isValue

public boolean isValue(Object obj)

测试 obj 是否为此 CompositeType 实例可以描述的值。

如果 obj 为 null，或者不是 javax.management.openmbean.CompositeData 的实例，则 isValue 返回 false。如果 obj 是 javax.management.openmbean.CompositeData 的实例，则测试其复合类型与此 CompositeType 实例的相等性，当且仅当 equals 返回 true 时，isValue 才返回 true。
 

指定者：

类 OpenType 中的 isValue

参数：

obj - 要测试其开放类型与此 CompositeType 的相等性的值。

返回：

如果 obj 是此复合类型的值，则返回 true，否则返回 false。

equals

public boolean equals(Object obj)

比较指定的 obj 参数与此 CompositeType 实例的相等性。

当且仅当以下所有语句为 true 时，两个 CompositeType 实例才相等：

• 它们的类型名称相同
• 它们的项名称和类型相同

 

指定者：

类 OpenType 中的 equals

参数：

obj - 与此 CompositeType 实例比较相等性的对象；如果 obj 为 null，则 equals 返回 false。

返回：

如果指定的对象等于此 CompositeType 实例，则返回 true。

另请参见：

Object.hashCode(), Hashtable

hashCode

public int hashCode()

返回此 CompositeType 实例的哈希码值。

CompositeType 实例的哈希码是在 equals 比较中使用的所有信息元素的哈希码的总和（即：名称、项名称和项类型）。这确保了 t1.equals(t2) 意味着对于任何两个 CompositeType 实例 t1 和 t2 而言，都存在 t21.hashCode()==t2.hashCode()，这是方法 Object.hashCode() 的通用协定所要求的。

由于 CompositeType 实例是不可变的，此实例的哈希码在首次调用 hashCode 时计算一次，然后对于后续的调用返回相同的值。

指定者：

类 OpenType 中的 hashCode

返回：

此 CompositeType 实例的哈希码值

另请参见：

Object.equals(java.lang.Object), Hashtable