IIOMetadataFormat (Java Platform SE 8 )

所有已知实现类：

IIOMetadataFormatImpl
```
public interface IIOMetadataFormat
```
一个对象描述元数据文件的结构 IIOMetadata.getAsTree归来并通过 IIOMetadata.setFromTree和 mergeTree。文档结构描述由一组约束的类型和数量的子元素，可能属于一个给定父元素类型、名称、类型和属性值，可能属于一个元素，以及类型和 Object参考，可以存储在一个节点的值。
注：实现此接口的类必须包含一个方法声明为public static getInstance()返回该类的一个实例。通常，实现建设只有一个实例，它为未来getInstance调用缓存。

这可能是由这类描述的结构是那些表达的使用XML文档类型定义（DTD）的一个子集，在属性和节点中存储的数据类型Object参考能力的一些基本信息的添加。在未来，XML架构可以用来表示这些结构，和许多其他。

IIOMetadataFormat-described结构和DTDs的区别如下：
- 元素可能不包含文本或混合文本与嵌入式标签。
- 一个元素的孩子必须符合一个简单的模式，在文档中描述的CHILD_*常数；
- 在一个元素的存储表示可能包含一个Object。没有规定代表该对象的文本。

Field Summary

Fields
Modifier and Type	Field and Description
`static int`	`CHILD_POLICY_ALL` 一个恒定的返回 `getChildPolicy`表示一个元素必须各有其法律的子元素的一个实例，为。
`static int`	`CHILD_POLICY_CHOICE` 一个恒定的返回 `getChildPolicy`表示一个元素必须有零个或一个孩子，从法律的子元素中选择。
`static int`	`CHILD_POLICY_EMPTY` 一个恒定的返回 `getChildPolicy`表示一个元素可能不会有孩子。
`static int`	`CHILD_POLICY_MAX` 最大有效 `CHILD_POLICY_*`常数，可用于范围检查。
`static int`	`CHILD_POLICY_REPEAT` 一个恒定的返回 `getChildPolicy`表示一个元素必须有零个或更多的子元素的情况下，其独特的法律。
`static int`	`CHILD_POLICY_SEQUENCE` 一个恒定的返回 `getChildPolicy`表示一个元素必须有一个序列的任何法律对它的子元素的实例。
`static int`	`CHILD_POLICY_SOME` 一个恒定的返回 `getChildPolicy`表示一个元素必须有零个或一个实例，它的每个子元素为法律。
`static int`	`DATATYPE_BOOLEAN` 一个常被 `getAttributeDataType`表示一个属性的值是一个布尔值“真”或“假”回来了。
`static int`	`DATATYPE_DOUBLE` 一个常被 `getAttributeDataType`表示一个属性的值是一个双精度小数浮点数字的字符串表示形式返回。
`static int`	`DATATYPE_FLOAT` 一个常被 `getAttributeDataType`表示一个属性的值是十进制浮点数的字符串形式返回。
`static int`	`DATATYPE_INTEGER` 一个常被 `getAttributeDataType`表示一个属性的值是一个整数的字符串形式返回。
`static int`	`DATATYPE_STRING` 一个常被 `getAttributeDataType`表示一个属性的值是一个通用的Unicode字符串返回。
`static int`	`VALUE_ARBITRARY` 一个恒定的返回 `getAttributeValueType`和 `getObjectValueType`表示属性或对象的用户可以设置一个单一的，任意值。
`static int`	`VALUE_ENUMERATION` 一个恒定的返回 `getAttributeValueType`和 `getObjectValueType`表示属性或对象的用户可以设置多个枚举值。
`static int`	`VALUE_LIST` 一个常被 `getAttributeValueType`和 `getObjectValueType`回到显示属性或对象的用户可以设置为列表或数组中的值。
`static int`	`VALUE_NONE` 一个恒定的返回 `getObjectValueType`来表示一个用户对象的缺失。
`static int`	`VALUE_RANGE` 一个恒定的返回 `getAttributeValueType`和 `getObjectValueType`表示属性或对象的用户可设置的值的范围。
`static int`	`VALUE_RANGE_MAX_INCLUSIVE` 一个恒定的返回 `getAttributeValueType`和 `getObjectValueType`表示属性或用户对象可以被设置为一个值的范围。
`static int`	`VALUE_RANGE_MAX_INCLUSIVE_MASK` 一个可能or'ed与 `VALUE_RANGE`获得 `VALUE_RANGE_MAX_INCLUSIVE`值，并与 `VALUE_RANGE_MIN_INCLUSIVE`获得 `VALUE_RANGE_MIN_MAX_INCLUSIVE`。
`static int`	`VALUE_RANGE_MIN_INCLUSIVE` 一个恒定的返回 `getAttributeValueType`和 `getObjectValueType`表示属性或用户对象可以被设置为一个值的范围。
`static int`	`VALUE_RANGE_MIN_INCLUSIVE_MASK` 一个可能or'ed与 `VALUE_RANGE`获得 `VALUE_RANGE_MIN_INCLUSIVE`值，并与 `VALUE_RANGE_MAX_INCLUSIVE`获得 `VALUE_RANGE_MIN_MAX_INCLUSIVE`。
`static int`	`VALUE_RANGE_MIN_MAX_INCLUSIVE` 一个恒定的返回 `getAttributeValueType`和 `getObjectValueType`表示属性或对象的用户可设置的值的范围。

方法摘要

所有方法接口方法抽象方法
Modifier and Type	Method and Description
`boolean`	`canNodeAppear(String elementName, ImageTypeSpecifier imageType)` 返回 `true`如果元素（和子树下方）是允许出现的元数据文档图像的类型，由一个 `ImageTypeSpecifier`定义。
`int`	`getAttributeDataType(String elementName, String attrName)` 返回一个常量的 `DATATYPE_`入手，说明在指定的元素的特定属性的值的格式和解释。
`String`	`getAttributeDefaultValue(String elementName, String attrName)` 返回指定属性的默认值，如果它没有明确地提出，在指定的元素，作为一个 `String`，或 `null`如果没有默认值是可用的。
`String`	`getAttributeDescription(String elementName, String attrName, Locale locale)` 返回一个 `String`含有描述的命名属性，或 `null`。
`String[]`	`getAttributeEnumerations(String elementName, String attrName)` 返回包含法律 `String`s枚举值的属性在指定的元素的数组。
`int`	`getAttributeListMaxLength(String elementName, String attrName)` 返回可用于定义此属性的列表项的最大数目。
`int`	`getAttributeListMinLength(String elementName, String attrName)` 返回可用于定义此属性的列表项的最小数目。
`String`	`getAttributeMaxValue(String elementName, String attrName)` 返回属性的最大合法值。
`String`	`getAttributeMinValue(String elementName, String attrName)` 返回属性的最小合法值。
`String[]`	`getAttributeNames(String elementName)` 返回 `String`s上市可能与指定的元素相关的属性名称的数组。
`int`	`getAttributeValueType(String elementName, String attrName)` 返回一个常量的开始 `VALUE_`，指示是否在指定的元素的特定属性的值是任意的，约束在一个特定范围，限制为一组枚举值，或是一个空格分隔的任意值列表。
`String[]`	`getChildNames(String elementName)` 返回 `String`s说明这是允许被命名的元素的孩子元素名称的数组，在它们应该出现的次序。
`int`	`getChildPolicy(String elementName)` 返回一个常量的 `CHILD_POLICY_`入手，为命名元素儿童法律模式说明。
`String`	`getElementDescription(String elementName, Locale locale)` 返回一个包含一个描述 `String`命名的元素，或 `null`。
`int`	`getElementMaxChildren(String elementName)` 返回的命名与儿童政策 `CHILD_POLICY_REPEAT`子元素的最大数目。
`int`	`getElementMinChildren(String elementName)` 返回的命名与儿童政策 `CHILD_POLICY_REPEAT`元儿童的最低数量。
`int`	`getObjectArrayMaxLength(String elementName)` 返回可用于在指定的元素定义 `Object`引用数组元素的最大数目。
`int`	`getObjectArrayMinLength(String elementName)` 返回可用于在指定的元素定义 `Object`参考阵元数最小。
`类<?>`	`getObjectClass(String elementName)` 返回存储在元 `Object`参考 `类`型。
`Object`	`getObjectDefaultValue(String elementName)` 返回一个 `Object`s包含在指定的元素的 `Object`参考默认值。
`Object[]`	`getObjectEnumerations(String elementName)` 返回包含法律的枚举值在指定的元素的 `Object`参考 `Object`s数组。
`Comparable<?>`	`getObjectMaxValue(String elementName)` 返回在指定的元素的 `Object`参考最高法律价值。
`Comparable<?>`	`getObjectMinValue(String elementName)` 返回在指定的元素的 `Object`参考法定最低值。
`int`	`getObjectValueType(String elementName)` 返回的枚举值中的一个开始 `VALUE_`，指示值的类型（枚举，范围，或阵列）是允许的 `Object`参考。
`String`	`getRootName()` 返回格式的根元素的名称。
`boolean`	`isAttributeRequired(String elementName, String attrName)` 返回 `true`如果命名属性必须在指定的元素是存在的。

- Field Detail
  - CHILD_POLICY_EMPTY
```
static final int CHILD_POLICY_EMPTY
```
    一个恒定的返回 getChildPolicy表示一个元素可能不会有孩子。换言之，它需要是一个叶节点。
    
    另请参见：
    
    Constant Field Values
  - CHILD_POLICY_ALL
```
static final int CHILD_POLICY_ALL
```
    一个恒定的返回 getChildPolicy表示一个元素必须各有其法律的子元素的一个实例，为。在DTD中，元素的内容是由一个序列 a,b,c,d,...定义。
    
    另请参见：
    
    Constant Field Values
  - CHILD_POLICY_SOME
```
static final int CHILD_POLICY_SOME
```
    一个恒定的返回 getChildPolicy表示一个元素必须有零个或一个实例，它的每个子元素为法律。在DTD中，元素的内容是由一个序列 a?,b?,c?,d?,...定义。
    
    另请参见：
    
    Constant Field Values
  - CHILD_POLICY_CHOICE
```
static final int CHILD_POLICY_CHOICE
```
    一个恒定的返回 getChildPolicy表示一个元素必须有零个或一个孩子，从法律的子元素中选择。在DTD中，元素的内容是由一个选择 a|b|c|d|...定义。
    
    另请参见：
    
    Constant Field Values
  - CHILD_POLICY_SEQUENCE
```
static final int CHILD_POLICY_SEQUENCE
```
    一个恒定的返回 getChildPolicy表示一个元素必须有一个序列的任何法律对它的子元素的实例。在DTD中，元素的内容是由一个序列 (a|b|c|d|...)*定义。
    
    另请参见：
    
    Constant Field Values
  - CHILD_POLICY_REPEAT
```
static final int CHILD_POLICY_REPEAT
```
    一个恒定的返回 getChildPolicy表示一个元素必须有零个或更多的子元素的情况下，其独特的法律。在DTD中，元素的内容是由主演的表达 a*定义。
    
    另请参见：
    
    Constant Field Values
  - CHILD_POLICY_MAX
```
static final int CHILD_POLICY_MAX
```
    最大有效 CHILD_POLICY_*常数，可用于范围检查。
    
    另请参见：
    
    Constant Field Values
  - VALUE_NONE
```
static final int VALUE_NONE
```
    一个恒定的返回 getObjectValueType来表示一个用户对象的缺失。
    
    另请参见：
    
    Constant Field Values
  - VALUE_ARBITRARY
```
static final int VALUE_ARBITRARY
```
    一个恒定的返回 getAttributeValueType和 getObjectValueType表示属性或对象的用户可以设置一个单一的，任意值。
    
    另请参见：
    
    Constant Field Values
  - VALUE_RANGE
```
static final int VALUE_RANGE
```
    一个恒定的返回 getAttributeValueType和 getObjectValueType表示属性或对象的用户可设置的值的范围。该范围的最小值和最大值都是唯一的。建议在两端都包括整数的范围，和唯一的范围只用于浮点数据。
    
    另请参见：
    
    VALUE_RANGE_MIN_MAX_INCLUSIVE， Constant Field Values
  - VALUE_RANGE_MIN_INCLUSIVE_MASK
```
static final int VALUE_RANGE_MIN_INCLUSIVE_MASK
```
    一个可能or'ed与 VALUE_RANGE获得 VALUE_RANGE_MIN_INCLUSIVE值，并与 VALUE_RANGE_MAX_INCLUSIVE获得
    同样，价值可能and'ed与getAttributeValueTypeor getObjectValueType值确定该范围的最小值是包容。
    VALUE_RANGE_MIN_MAX_INCLUSIVE。
    
    另请参见：
    
    Constant Field Values
  - VALUE_RANGE_MAX_INCLUSIVE_MASK
```
static final int VALUE_RANGE_MAX_INCLUSIVE_MASK
```
    一个可能or'ed与 VALUE_RANGE获得 VALUE_RANGE_MAX_INCLUSIVE值，并与 VALUE_RANGE_MIN_INCLUSIVE获得 VALUE_RANGE_MIN_MAX_INCLUSIVE。
    同样，价值可能and'ed与getAttributeValueTypeor getObjectValueType值确定该范围的最大值是包容。
    
    另请参见：
    
    Constant Field Values
  - VALUE_RANGE_MIN_INCLUSIVE
```
static final int VALUE_RANGE_MIN_INCLUSIVE
```
    一个恒定的返回 getAttributeValueType和 getObjectValueType表示属性或用户对象可以被设置为一个值的范围。该范围的最小值（但不是最大值）是包含的。
    
    另请参见：
    
    Constant Field Values
  - VALUE_RANGE_MAX_INCLUSIVE
```
static final int VALUE_RANGE_MAX_INCLUSIVE
```
    一个恒定的返回 getAttributeValueType和 getObjectValueType表示属性或用户对象可以被设置为一个值的范围。范围的最大值（但不是最小值）是包含的。
    
    另请参见：
    
    Constant Field Values
  - VALUE_RANGE_MIN_MAX_INCLUSIVE
```
static final int VALUE_RANGE_MIN_MAX_INCLUSIVE
```
    一个恒定的返回 getAttributeValueType和 getObjectValueType表示属性或对象的用户可设置的值的范围。该范围的最小值和最大值都包含在内。建议在两端都包括整数的范围，和唯一的范围只用于浮点数据。
    
    另请参见：
    
    Constant Field Values
  - VALUE_ENUMERATION
```
static final int VALUE_ENUMERATION
```
    一个恒定的返回 getAttributeValueType和 getObjectValueType表示属性或对象的用户可以设置多个枚举值。在属性的情况下，这些价值观是 Strings；的对象，他们是 Objects实现给定的类或接口。
    DATATYPE_BOOLEAN型属性值应该被标记为枚举。
    
    另请参见：
    
    Constant Field Values
  - VALUE_LIST
```
static final int VALUE_LIST
```
    一个常被 getAttributeValueType和 getObjectValueType回到显示属性或对象的用户可以设置为列表或数组中的值。在属性的情况下，名单将由空格分隔的值在一个 String；对于对象，数组将被使用。
    
    另请参见：
    
    Constant Field Values
  - DATATYPE_STRING
```
static final int DATATYPE_STRING
```
    一个常被 getAttributeDataType表示一个属性的值是一个通用的Unicode字符串返回。
    
    另请参见：
    
    Constant Field Values
  - DATATYPE_BOOLEAN
```
static final int DATATYPE_BOOLEAN
```
    一个常被 getAttributeDataType表示一个属性的值是一个布尔值“真”或“假”回来了。datatype_boolean型属性值应该被标记为枚举类型和允许值应是字符串值“真”或“假”，虽然一个插件还可能意识到低或混合的情况下等价物。
    
    另请参见：
    
    Constant Field Values
  - DATATYPE_INTEGER
```
static final int DATATYPE_INTEGER
```
    一个常被 getAttributeDataType表示一个属性的值是一个整数的字符串形式返回。
    
    另请参见：
    
    Constant Field Values
  - DATATYPE_FLOAT
```
static final int DATATYPE_FLOAT
```
    一个常被 getAttributeDataType表示一个属性的值是十进制浮点数的字符串形式返回。
    
    另请参见：
    
    Constant Field Values
  - DATATYPE_DOUBLE
```
static final int DATATYPE_DOUBLE
```
    一个常被 getAttributeDataType表示一个属性的值是一个双精度小数浮点数字的字符串表示形式返回。
    
    另请参见：
    
    Constant Field Values
- 方法详细信息
  - getRootName
```
String getRootName()
```
    返回格式的根元素的名称。
    
    结果
    
    一个 String。
  - canNodeAppear
```
boolean canNodeAppear(String elementName,
                      ImageTypeSpecifier imageType)
```
    返回 true如果元素（和子树下方）是允许出现的元数据文档图像的类型，由一个 ImageTypeSpecifier定义。例如，一个元数据文档格式可能包含一个描述图像的原始颜色的元素，当写入一个灰度图像时，不允许使用一个元素。
    
    参数
    
    elementName -元素被查询的名称。
    
    imageType - ImageTypeSpecifier显示图像，将与元数据相关的类型。
    
    结果
    
    true如果节点为给定类型的图像有意义。
  - getElementMinChildren
```
int getElementMinChildren(String elementName)
```
    返回的命名与儿童政策 CHILD_POLICY_REPEAT子元素的最小数量。例如，代表颜色的主要信息元素可能需要至少3个孩子，一个小学。
    
    参数
    
    elementName -元素被查询的名称。
    
    结果
    
    一个 int。
    
    异常
    
    IllegalArgumentException -如果 elementName是 null或不为这种格式的法律元素名称。
    
    IllegalArgumentException -如果指定的元素没有一个 CHILD_POLICY_REPEAT儿童政策。
  - getElementMaxChildren
```
int getElementMaxChildren(String elementName)
```
    返回的命名与儿童政策 CHILD_POLICY_REPEAT子元素的最大数目。例如，一个元素代表一个在一个8位调色板的条目可能被允许重复多达256次。一个价值 Integer.MAX_VALUE可用于指定没有上限。
    
    参数
    
    elementName -元素被查询的名称。
    
    结果
    
    一个 int。
    
    异常
    
    IllegalArgumentException -如果 elementName是 null或不为这种格式的法律元素名称。
    
    IllegalArgumentException -如果指定的元素没有一个 CHILD_POLICY_REPEAT儿童政策。
  - getElementDescription
```
String getElementDescription(String elementName,
                             Locale locale)
```
    返回一个包含一个描述 String命名的元素，或 null。说明将定位为提供 Locale如果可能的话。
    如果locale是null，当前默认的Locale返回Locale.getLocale将使用。
    
    参数
    
    elementName -元素的名称。
    
    locale - Locale，定位将尝试。
    
    结果
    
    元素描述。
    
    异常
    
    IllegalArgumentException -如果 elementName是 null，或是不是一个合法的元素名称为这种格式。
  - getChildPolicy
```
int getChildPolicy(String elementName)
```
    返回一个常量的 CHILD_POLICY_入手，为命名元素儿童法律模式说明。
    
    参数
    
    elementName -元素被查询的名称。
    
    结果
    
    其中的一个 CHILD_POLICY_*常数。
    
    异常
    
    IllegalArgumentException -如果 elementName是 null或不为这种格式的法律元素名称。
  - getChildNames
```
String[] getChildNames(String elementName)
```
    返回 Strings说明这是允许被命名的元素的孩子元素名称的数组，在它们应该出现的次序。如果元素不能有孩子， null返回。
    
    参数
    
    elementName -元素被查询的名称。
    
    结果
    
    对 Strings数组，或空。
    
    异常
    
    IllegalArgumentException -如果 elementName是 null或不为这种格式的法律元素名称。
  - getAttributeNames
```
String[] getAttributeNames(String elementName)
```
    返回 Strings上市可能与指定的元素相关的属性名称的数组。
    
    参数
    
    elementName -元素被查询的名称。
    
    结果
    
    对 Strings数组。
    
    异常
    
    IllegalArgumentException -如果 elementName是 null或不为这种格式的法律元素名称。
  - getAttributeValueType
```
int getAttributeValueType(String elementName,
                          String attrName)
```
    返回一个常量的开始 VALUE_，指示是否在指定的元素的特定属性的值是任意的，约束在一个特定范围，限制为一组枚举值，或是一个空格分隔的任意值列表。
    
    参数
    
    elementName -元素被查询的名称。
    
    attrName -属性被查询的名称。
    
    结果
    
    其中的一个 VALUE_*常数。
    
    异常
    
    IllegalArgumentException -如果 elementName是 null或不为这种格式的法律元素名称。
    
    IllegalArgumentException -如果 attrName是 null或不是该元素的法律属性名称。
  - getAttributeDataType
```
int getAttributeDataType(String elementName,
                         String attrName)
```
    返回一个常量的 DATATYPE_入手，说明在指定的元素的特定属性的值的格式和解释。如果 getAttributeValueType返回 VALUE_LIST，那么法律价值是一个空白的返回数据类型常用的值列表。
    
    参数
    
    elementName -元素被查询的名称。
    
    attrName -属性被查询的名称。
    
    结果
    
    其中的一个 DATATYPE_*常数。
    
    异常
    
    IllegalArgumentException -如果 elementName是 null或不为这种格式的法律元素名称。
    
    IllegalArgumentException -如果 attrName是 null或不是该元素的法律属性名称。
  - isAttributeRequired
```
boolean isAttributeRequired(String elementName,
                            String attrName)
```
    返回 true如果命名属性必须在指定的元素是存在的。
    
    参数
    
    elementName -元素被查询的名称。
    
    attrName -属性被查询的名称。
    
    结果
    
    true如果属性必须存在。
    
    异常
    
    IllegalArgumentException -如果 elementName是 null或不为这种格式的法律元素名称。
    
    IllegalArgumentException -如果 attrName是 null或不是该元素的法律属性名称。
  - getAttributeDefaultValue
```
String getAttributeDefaultValue(String elementName,
                                String attrName)
```
    返回指定属性的默认值，如果它没有明确地提出，在指定的元素，作为一个 String，或 null如果没有默认值是可用的。
    
    参数
    
    elementName -元素被查询的名称。
    
    attrName -属性被查询的名称。
    
    结果
    
    一个 String包含默认值，或 null。
    
    异常
    
    IllegalArgumentException -如果 elementName是 null或不为这种格式的法律元素名称。
    
    IllegalArgumentException -如果 attrName是 null或不是该元素的法律属性名称。
  - getAttributeEnumerations
```
String[] getAttributeEnumerations(String elementName,
                                  String attrName)
```
    返回包含法律 Strings枚举值的属性在指定的元素的数组。这种方法只应该在 getAttributeValueType返回 VALUE_ENUMERATION叫。
    
    参数
    
    elementName -元素被查询的名称。
    
    attrName -属性被查询的名称。
    
    结果
    
    对 Strings数组。
    
    异常
    
    IllegalArgumentException -如果 elementName是 null或不为这种格式的法律元素名称。
    
    IllegalArgumentException -如果 attrName是 null或不是该元素的法律属性名称。
    
    IllegalArgumentException如果给定的属性是未定义的枚举。
  - getAttributeMinValue
```
String getAttributeMinValue(String elementName,
                            String attrName)
```
    返回属性的最小合法值。不管这价值是包容或排斥的可能是由 getAttributeValueType值确定。价值是一 String返回；它的解释是依赖于 getAttributeDataType价值。这种方法只应该在 getAttributeValueType返回 VALUE_RANGE_*叫。
    
    参数
    
    elementName -元素被查询的名称。
    
    attrName -属性被查询的名称。
    
    结果
    
    一个 String包含该属性的最小合法值。
    
    异常
    
    IllegalArgumentException -如果 elementName是 null或不为这种格式的法律元素名称。
    
    IllegalArgumentException -如果 attrName是 null或不是该元素的法律属性名称。
    
    IllegalArgumentException如果给定的属性是未定义的范围。
  - getAttributeMaxValue
```
String getAttributeMaxValue(String elementName,
                            String attrName)
```
    返回属性的最大合法值。不管这价值是包容或排斥的可能是由 getAttributeValueType值确定。价值是一 String返回；它的解释是依赖于 getAttributeDataType价值。这种方法只应该在 getAttributeValueType返回 VALUE_RANGE_*叫。
    
    参数
    
    elementName -元素被查询的名称，作为一个 String。
    
    attrName -属性被查询的名称。
    
    结果
    
    一个 String包含该属性的最大的法律价值。
    
    异常
    
    IllegalArgumentException -如果 elementName是 null或不为这种格式的法律元素名称。
    
    IllegalArgumentException -如果 attrName是 null或不是该元素的法律属性名称。
    
    IllegalArgumentException如果给定的属性是未定义的范围。
  - getAttributeListMinLength
```
int getAttributeListMinLength(String elementName,
                              String attrName)
```
    返回可用于定义此属性的列表项的最小数目。属性本身被定义为一个包含多个空格分隔的项目 String。这种方法只应该在 getAttributeValueType返回 VALUE_LIST叫。
    
    参数
    
    elementName -元素被查询的名称。
    
    attrName -属性被查询的名称。
    
    结果
    
    属性的列表项的最小合法数。
    
    异常
    
    IllegalArgumentException -如果 elementName是 null或不为这种格式的法律元素名称。
    
    IllegalArgumentException -如果 attrName是 null或不是该元素的法律属性名称。
    
    IllegalArgumentException如果给定的属性没有定义为一个列表。
  - getAttributeListMaxLength
```
int getAttributeListMaxLength(String elementName,
                              String attrName)
```
    返回可用于定义此属性的列表项的最大数目。一个价值 Integer.MAX_VALUE可用于指定没有上限。属性本身被定义为一个包含多个空格分隔的项目 String。这种方法只应该在 getAttributeValueType返回 VALUE_LIST叫。
    
    参数
    
    elementName -元素被查询的名称。
    
    attrName -属性被查询的名称。
    
    结果
    
    属性的最大的列表项的合法数目。
    
    异常
    
    IllegalArgumentException -如果 elementName是 null或不为这种格式的法律元素名称。
    
    IllegalArgumentException -如果 attrName是 null或不是该元素的法律属性名称。
    
    IllegalArgumentException如果给定的属性没有定义为一个列表。
  - getAttributeDescription
```
String getAttributeDescription(String elementName,
                               String attrName,
                               Locale locale)
```
    返回一个 String含有描述的命名属性，或 null。说明将定位为提供 Locale如果可能的话。
    如果locale是null，当前默认的Locale返回Locale.getLocale将使用。
    
    参数
    
    elementName -元素的名称。
    
    attrName -属性的名称。
    
    locale - Locale，定位将尝试。
    
    结果
    
    属性描述。
    
    异常
    
    IllegalArgumentException -如果 elementName是 null，或是不是一个合法的元素名称为这种格式。
    
    IllegalArgumentException -如果 attrName是 null或不是该元素的法律属性名称。
  - getObjectValueType
```
int getObjectValueType(String elementName)
```
    返回的枚举值中的一个开始 VALUE_，指示值的类型（枚举，范围，或阵列）是允许的 Object参考。如果没有对象的值可以存储在给定的元素，这种方法的结果将是 VALUE_NONE。
    Object引用的法律价值是指一种范围必须实现Comparable接口。
    
    参数
    
    elementName -元素被查询的名称。
    
    结果
    
    其中的一个 VALUE_*常数。
    
    异常
    
    IllegalArgumentException -如果 elementName是 null或不为这种格式的法律元素名称。
    
    另请参见：
    
    Comparable
  - getObjectClass
```
类<?> getObjectClass(String elementName)
```
    返回存储在元 Object参考 类型。如果此元素不能包含一个 Object参考，一个 IllegalArgumentException将抛出。如果该类类型的数组，该字段指示的基本类型（例如，为 ints，这个方法将返回一个数组 int.class）。
    Object引用的法律价值是指一种范围必须实现Comparable接口。
    
    参数
    
    elementName -元素被查询的名称。
    
    结果
    
    一个 类对象。
    
    异常
    
    IllegalArgumentException -如果 elementName是 null或不为这种格式的法律元素名称。
    
    IllegalArgumentException -如果指定元素不能包含一个对象的值（即，如果 getObjectValueType(elementName) == VALUE_NONE）。
  - getObjectDefaultValue
```
Object getObjectDefaultValue(String elementName)
```
    返回一个 Objects包含在指定的元素的 Object参考默认值。
    
    参数
    
    elementName -元素被查询的名称。
    
    结果
    
    一个 Object。
    
    异常
    
    IllegalArgumentException -如果 elementName是 null或不为这种格式的法律元素名称。
    
    IllegalArgumentException -如果指定元素不能包含一个对象的值（即，如果 getObjectValueType(elementName) == VALUE_NONE）。
  - getObjectEnumerations
```
Object[] getObjectEnumerations(String elementName)
```
    返回包含法律的枚举值在指定的元素的 Object参考 Objects数组。这种方法只应该在 getObjectValueType返回 VALUE_ENUMERATION叫。
    一个节点接受枚举值关联的Object必须等于一个值，该方法返回的，由==算子定义的（相对于Object.equals法）。
    
    参数
    
    elementName -元素被查询的名称。
    
    结果
    
    对 Objects数组。
    
    异常
    
    IllegalArgumentException -如果 elementName是 null或不为这种格式的法律元素名称。
    
    IllegalArgumentException -如果指定元素不能包含一个对象的值（即，如果 getObjectValueType(elementName) == VALUE_NONE）。
    
    IllegalArgumentException -如果 Object不定义为枚举。
  - getObjectMinValue
```
Comparable<?> getObjectMinValue(String elementName)
```
    返回在指定的元素的 Object参考法定最低值。不管这价值是包容或排斥的可能是由 getObjectValueType值确定。这种方法只应该在 getObjectValueType返回一开始 VALUE_RANGE称为常数。
    
    参数
    
    elementName -元素被查询的名称。
    
    结果
    
    属性的最小的法律价值。
    
    异常
    
    IllegalArgumentException -如果 elementName是 null或不为这种格式的法律元素名称。
    
    IllegalArgumentException -如果指定元素不能包含一个对象的值（即，如果 getObjectValueType(elementName) == VALUE_NONE）。
    
    IllegalArgumentException -如果 Object不定义为一个范围。
  - getObjectMaxValue
```
Comparable<?> getObjectMaxValue(String elementName)
```
    返回在指定的元素的 Object参考最高法律价值。不管这价值是包容或排斥的可能是由 getObjectValueType值确定。这种方法只应该在 getObjectValueType返回一开始 VALUE_RANGE称为常数。
    
    参数
    
    elementName -元素被查询的名称。
    
    结果
    
    属性的最小的法律价值。
    
    异常
    
    IllegalArgumentException -如果 elementName是 null或不为这种格式的法律元素名称。
    
    IllegalArgumentException -如果指定元素不能包含一个对象的值（即，如果 getObjectValueType(elementName) == VALUE_NONE）。
    
    IllegalArgumentException -如果 Object不定义为一个范围。
  - getObjectArrayMinLength
```
int getObjectArrayMinLength(String elementName)
```
    返回可用于在指定的元素定义 Object参考阵元数最小。这种方法只应该在 getObjectValueType返回 VALUE_LIST叫。
    
    参数
    
    elementName -元素被查询的名称。
    
    结果
    
    最小有效的数组长度为 Object参考。
    
    异常
    
    IllegalArgumentException -如果 elementName是 null或不为这种格式的法律元素名称。
    
    IllegalArgumentException -如果指定元素不能包含一个对象的值（即，如果 getObjectValueType(elementName) == VALUE_NONE）。
    
    IllegalArgumentException -如果 Object不是数组。
  - getObjectArrayMaxLength
```
int getObjectArrayMaxLength(String elementName)
```
    返回可用于在指定的元素定义 Object引用数组元素的最大数目。一个价值 Integer.MAX_VALUE可用于指定没有上限。这种方法只应该在 getObjectValueType返回 VALUE_LIST叫。
    
    参数
    
    elementName -元素被查询的名称。
    
    结果
    
    最大有效的数组长度为 Object参考。
    
    异常
    
    IllegalArgumentException -如果 elementName是 null或不为这种格式的法律元素名称。
    
    IllegalArgumentException -如果指定元素不能包含一个对象的值（即，如果 getObjectValueType(elementName) == VALUE_NONE）。
    
    IllegalArgumentException -如果 Object不是数组。

Submit a bug or feature
For further API reference and developer documentation, see Java SE Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.
Copyright © 1993, 2014, Oracle and/or its affiliates. All rights reserved.

Interface IIOMetadataFormat

Field Summary

方法摘要

Field Detail

CHILD_POLICY_EMPTY

CHILD_POLICY_ALL

CHILD_POLICY_SOME

CHILD_POLICY_CHOICE

CHILD_POLICY_SEQUENCE

CHILD_POLICY_REPEAT

CHILD_POLICY_MAX

VALUE_NONE

VALUE_ARBITRARY

VALUE_RANGE

VALUE_RANGE_MIN_INCLUSIVE_MASK

VALUE_RANGE_MAX_INCLUSIVE_MASK

VALUE_RANGE_MIN_INCLUSIVE

VALUE_RANGE_MAX_INCLUSIVE

VALUE_RANGE_MIN_MAX_INCLUSIVE

VALUE_ENUMERATION

VALUE_LIST

DATATYPE_STRING

DATATYPE_BOOLEAN

DATATYPE_INTEGER

DATATYPE_FLOAT

DATATYPE_DOUBLE

方法详细信息

getRootName

canNodeAppear

getElementMinChildren

getElementMaxChildren

getElementDescription

getChildPolicy

getChildNames

getAttributeNames

getAttributeValueType

getAttributeDataType

isAttributeRequired

getAttributeDefaultValue

getAttributeEnumerations

getAttributeMinValue

getAttributeMaxValue

getAttributeListMinLength

getAttributeListMaxLength

getAttributeDescription

getObjectValueType

getObjectClass

getObjectDefaultValue

getObjectEnumerations

getObjectMinValue

getObjectMaxValue

getObjectArrayMinLength

getObjectArrayMaxLength