方法详细信息

• getFieldValue

  Object getFieldValue​(String fieldName)
                throws RuntimeOperationsException

  返回特定字段名称的值，如果该名称没有值，则返回null。

  参数

  fieldName - 字段名称。

  结果

  相应的值，如果该字段不存在，则返回null。

  异常

  RuntimeOperationsException - 如果字段名称是非法的。

• setField

  void setField​(String fieldName,
                Object fieldValue)
         throws RuntimeOperationsException

  设置特定字段名称的值。 这将修改现有字段或添加新字段。

  字段值将在设置之前进行验证。 如果它无效，则抛出异常。 有效性的含义取决于描述符的实现。

  参数

  fieldName - 要设置的字段名称。 不能为null或为空。

  fieldValue - 要为字段名称设置的字段值。 如果这是该字段的有效值，则可以为null。

  异常

  RuntimeOperationsException - 如果字段名称或字段值非法（包装异常为IllegalArgumentException ）; 或者描述符是不可变的（包装异常是UnsupportedOperationException ）。

• getFields

  String[] getFields()

  以字符串数组的形式返回此描述符中包含的所有字段。

  结果

  字符串数组字段，格式为fieldName = fieldValue
  如果字段的值不是String，则将在其上调用toString（）方法，并将括在括号中的返回值用作返回数组中字段的值。 如果字段的值为null，则返回数组中的字段值将为空。 如果描述符为空，您将获得一个空数组。

  另请参见：

  setFields(java.lang.String[], java.lang.Object[])

• getFieldNames

  String[] getFieldNames()

  返回描述符中的所有字段名称。

  结果

  字段名称的字符串数组。 如果描述符为空，您将获得一个空数组。

• getFieldValues

  Object[] getFieldValues​(String... fieldNames)

  以对象数组的形式返回描述符中的所有字段值。 返回值的顺序与fieldNames String数组参数的顺序相同。

  参数

  fieldNames - 应为其返回值的字段名称的字符串数组。 如果数组为空，则返回一个空数组。 如果数组为null，则返回所有值，就好像参数是getFieldNames()返回的数组一样 。 如果数组中的字段名称不存在（包括它为null或空字符串的情况），则返回null，以便返回匹配的数组元素。

  结果

  字段值的对象数组。 如果fieldNames的列表为空，您将获得一个空数组。

• removeField

  void removeField​(String fieldName)

  从描述符中删除字段。

  参数

  fieldName - 要删除的字段的字符串名称。 如果字段名称非法或未找到该字段，则不会引发异常。

  异常

  RuntimeOperationsException - 如果给定名称的字段存在且描述符是不可变的。 包装的例外将是UnsupportedOperationException 。

• setFields

  void setFields​(String[] fieldNames,
                 Object[] fieldValues)
          throws RuntimeOperationsException

  将字段名称数组中的所有字段设置为字段值数组中具有相同索引的新值。 数组大小必须匹配。

  字段值将在设置之前进行验证。 如果它无效，则抛出异常。 如果数组为空，则不会发生任何更改。

  参数

  fieldNames - 字段名称的字符串数组。 数组和数组元素不能为null。

  fieldValues - 相应字段值的对象数组。 该数组不能为null。 数组的元素可以为null。

  异常

  RuntimeOperationsException - 如果更改因任何原因失败。 如果fieldNames或fieldValues为空，或者如果数组的长度不同，或者其中一个数组中存在非法值，则包装的异常为IllegalArgumentException 。 如果描述符是不可变的，则包装的异常是UnsupportedOperationException ，并且调用将更改其内容。

  另请参见：

  getFields()

• clone

  Object clone()
        throws RuntimeOperationsException

  返回与此描述符相等的描述符。 对返回的描述符的更改将不会对此描述符产生任何影响，反之亦然。 如果此描述符是不可变的，则它可以通过返回自身来满足此条件。

  结果

  描述符等于此描述符。

  异常

  RuntimeOperationsException - 表示字段名称或字段值的非法值。 如果描述符构造因任何原因失败，则抛出此异常。

• isValid

  boolean isValid()
           throws RuntimeOperationsException

  如果所有字段都具有给定其名称的合法值，则返回true。

  结果

  如果值是合法的，则为true。

  异常

  RuntimeOperationsException - 如果由于任何原因有效性检查失败，将抛出此异常。 如果描述符无效，则该方法返回false，但如果确定有效性的尝试失败，则抛出此异常。

• equals

  boolean equals​(Object obj)

  将此描述符与给定对象进行比较。 如果给定对象也是描述符，并且两个描述符具有相同的字段名称（可能在大小写上有所不同）和相同的关联值，则对象是相等的。 如果满足以下条件，则两个描述符中字段的相应值相等：

  • 如果一个值为null，则另一个值也必须为null。
  • 如果一个值是原始数组，那么另一个必须是具有相同元素的相同类型的基本数组。
  • 如果一个值是一个对象数组，那么另一个值必须也是， Arrays.deepEquals(Object[],Object[])必须返回true。
  • 否则Object.equals(Object)必须返回true。

  重写：

  equals在类 Object

  参数

  obj - 要与之比较的对象。

  结果

  true如果对象相同; 否则为false 。

  从以下版本开始：

  1.6

  另请参见：

  Object.hashCode() ， HashMap

• hashCode

  int hashCode()

  返回此描述符的哈希码值。 哈希码被计算为描述符中每个字段的哈希码的总和。 名称为n且值为v的字段的哈希码为n.toLowerCase().hashCode() ^ h 。 这里h的哈希码为v ，计算如下：

  • 如果v为null，则h为0。
  • 如果v是基本数组，则使用h的适当重载计算java.util.Arrays.hashCode 。
  • 如果v是一个对象数组然后h使用计算Arrays.deepHashCode(Object[]) 。
  • 否则h是v.hashCode() 。

  重写：

  hashCode在类 Object

  结果

  此对象的哈希码值。

  从以下版本开始：

  1.6

  另请参见：

  Object.equals(java.lang.Object) ， System.identityHashCode(java.lang.Object)