模块  java.desktop

Interface IIOMetadataFormat

  • 所有已知实现类:
    IIOMetadataFormatImpl

    public interface IIOMetadataFormat
    描述从IIOMetadata.getAsTree返回并传递到IIOMetadata.setFromTreemergeTree的元数据文档结构的对象。 文档结构由对可能属于给定父元素类型的子元素的类型和数量的一组约束,可能属于元素的属性的名称,类型和值以及Object的类型和值Object可以存储在节点处的引用。

    注意:实现此接口的类应包含声明为public static getInstance()的方法,该方法返回该类的实例。 通常,实现将仅构造单个实例并将其缓存以供将来调用getInstance

    如果插件是作为命名模块的一部分提供的,那么该模块必须将包含实现类的包导出到

      java.desktop 
    模块通过合格的出口。 除非出于其他原因需要,否则不建议使用不合格的出口。 无法导出包将导致运行时访问失败。

    可以由此类描述的结构是使用XML文档类型定义(DTD)表达的结构的子集,添加了关于属性的数据类型的一些基本信息以及在节点内存储Object引用的能力。 将来,XML Schema可用于表示这些结构以及许多其他结构。

    IIOMetadataFormat描述的结构和DTD之间的差异如下:

    • 元素可能不包含带有嵌入标记的文本或混合文本。
    • 元素的子元素必须符合CHILD_*常量文档中描述的一些简单模式之一;
    • 元素的内存中表示可以包含对Object的引用。 没有规定以文本方式表示此类对象。
    • 字段汇总

      字段  
      变量和类型 字段 描述
      static int CHILD_POLICY_ALL
      getChildPolicy返回的 getChildPolicy ,表示元素必须按 getChildPolicy具有每个合法子元素的单个实例。
      static int CHILD_POLICY_CHOICE
      getChildPolicy返回的 getChildPolicy ,表示元素必须具有零个或一个子元素,从其合法子元素中选择。
      static int CHILD_POLICY_EMPTY
      getChildPolicy返回的 getChildPolicy ,表示元素可能没有任何子元素。
      static int CHILD_POLICY_MAX
      最大有效 CHILD_POLICY_*常数,用于范围检查。
      static int CHILD_POLICY_REPEAT
      getChildPolicy返回的 getChildPolicy ,表示元素必须具有其唯一合法子元素的零个或多个实例。
      static int CHILD_POLICY_SEQUENCE
      getChildPolicy返回的 getChildPolicy ,表示元素必须具有任何合法子元素的实例序列。
      static int CHILD_POLICY_SOME
      getChildPolicy返回的 getChildPolicy用于指示元素必须按顺序包含其每个合法子元素的零个或一个实例。
      static int DATATYPE_BOOLEAN
      getAttributeDataType返回的 getAttributeDataType指示属性的值是布尔值'true'或'false'之一。
      static int DATATYPE_DOUBLE
      getAttributeDataType返回的 getAttributeDataType指示属性的值是双精度十进制浮点数的字符串表示形式。
      static int DATATYPE_FLOAT
      getAttributeDataType返回的 getAttributeDataType指示属性的值是十进制浮点数的字符串表示形式。
      static int DATATYPE_INTEGER
      getAttributeDataType返回的 getAttributeDataType指示属性的值是整数的字符串表示形式。
      static int DATATYPE_STRING
      getAttributeDataType返回的 getAttributeDataType指示属性的值是常规Unicode字符串。
      static int VALUE_ARBITRARY
      getAttributeValueTypegetObjectValueType返回的 getAttributeValueType ,指示属性或用户对象可以设置单个任意值。
      static int VALUE_ENUMERATION
      getAttributeValueTypegetObjectValueType返回的 getAttributeValueType ,指示属性或用户对象可以设置多个枚举值之一。
      static int VALUE_LIST
      getAttributeValueTypegetObjectValueType返回的 getAttributeValueType ,指示可以将属性或用户对象设置为值列表或数组。
      static int VALUE_NONE
      getObjectValueType返回的 getObjectValueType ,表示缺少用户对象。
      static int VALUE_RANGE
      getAttributeValueTypegetObjectValueType返回的 getAttributeValueType ,表示可以为属性或用户对象设置值范围。
      static int VALUE_RANGE_MAX_INCLUSIVE
      getAttributeValueTypegetObjectValueType返回的 getAttributeValueType ,表示属性或用户对象可以设置为值范围。
      static int VALUE_RANGE_MAX_INCLUSIVE_MASK
      可以使用 VALUE_RANGE获得 VALUE_RANGE_MAX_INCLUSIVE ,并使用 VALUE_RANGE_MIN_INCLUSIVE获得 VALUE_RANGE_MIN_MAX_INCLUSIVE
      static int VALUE_RANGE_MIN_INCLUSIVE
      getAttributeValueTypegetObjectValueType返回的 getAttributeValueType ,表示属性或用户对象可以设置为值范围。
      static int VALUE_RANGE_MIN_INCLUSIVE_MASK
      可以使用 VALUE_RANGE获取 VALUE_RANGE_MIN_INCLUSIVE ,并使用 VALUE_RANGE_MAX_INCLUSIVE获取 VALUE_RANGE_MIN_MAX_INCLUSIVE
      static int VALUE_RANGE_MIN_MAX_INCLUSIVE
      getAttributeValueTypegetObjectValueType返回的 getAttributeValueType ,表示可以为属性或用户对象设置值范围。
    • 字段详细信息

      • CHILD_POLICY_EMPTY

        static final int CHILD_POLICY_EMPTY
        getChildPolicy返回的getChildPolicy ,表示元素可能没有任何子元素。 换句话说,它需要是叶节点。
        另请参见:
        常数字段值
      • CHILD_POLICY_ALL

        static final int CHILD_POLICY_ALL
        getChildPolicy返回的getChildPolicy ,表示元素必须按getChildPolicy具有每个合法子元素的单个实例。 在DTD术语中,元素的内容由序列a,b,c,d,...定义。
        另请参见:
        常数字段值
      • CHILD_POLICY_SOME

        static final int CHILD_POLICY_SOME
        getChildPolicy返回的getChildPolicy用于指示元素必须按顺序包含其每个合法子元素的零个或一个实例。 在DTD术语中,元素的内容由序列a?,b?,c?,d?,...定义。
        另请参见:
        常数字段值
      • CHILD_POLICY_CHOICE

        static final int CHILD_POLICY_CHOICE
        getChildPolicy返回的getChildPolicy ,指示元素必须具有从其合法子元素中选择的零个或一个子元素。 在DTD术语中,元素的内容由选择a|b|c|d|...定义。
        另请参见:
        常数字段值
      • CHILD_POLICY_SEQUENCE

        static final int CHILD_POLICY_SEQUENCE
        getChildPolicy返回的getChildPolicy ,表示元素必须具有任何合法子元素的实例序列。 在DTD术语中,元素的内容由序列(a|b|c|d|...)*定义。
        另请参见:
        常数字段值
      • CHILD_POLICY_REPEAT

        static final int CHILD_POLICY_REPEAT
        getChildPolicy返回的getChildPolicy ,表示元素必须具有其唯一合法子元素的零个或多个实例。 在DTD术语中,元素的内容由星号表达式a*定义。
        另请参见:
        常数字段值
      • CHILD_POLICY_MAX

        static final int CHILD_POLICY_MAX
        最大有效值 CHILD_POLICY_*常量,用于范围检查。
        另请参见:
        常数字段值
      • VALUE_NONE

        static final int VALUE_NONE
        getObjectValueType返回的 getObjectValueType ,表示缺少用户对象。
        另请参见:
        常数字段值
      • VALUE_ARBITRARY

        static final int VALUE_ARBITRARY
        getAttributeValueTypegetObjectValueType返回的 getAttributeValueType ,表示属性或用户对象可以设置为单个任意值。
        另请参见:
        常数字段值
      • VALUE_RANGE

        static final int VALUE_RANGE
        getAttributeValueTypegetObjectValueType返回的getAttributeValueType ,指示可以为属性或用户对象设置值范围。 范围的最小值和最大值都是独占的。 建议两端都包含整数范围,并且该排除范围仅用于浮点数据。
        另请参见:
        VALUE_RANGE_MIN_MAX_INCLUSIVE常数字段值
      • VALUE_RANGE_MIN_INCLUSIVE_MASK

        static final int VALUE_RANGE_MIN_INCLUSIVE_MASK
        可以使用VALUE_RANGE获得VALUE_RANGE_MIN_INCLUSIVE ,并使用VALUE_RANGE_MAX_INCLUSIVE获得VALUE_RANGE_MIN_MAX_INCLUSIVE

        类似地,该值可以用值getAttributeValueTypegetObjectValueType来确定,以确定该范围的最小值是否包括在内。

        另请参见:
        常数字段值
      • VALUE_RANGE_MAX_INCLUSIVE_MASK

        static final int VALUE_RANGE_MAX_INCLUSIVE_MASK
        可以使用VALUE_RANGE获得VALUE_RANGE_MAX_INCLUSIVE ,并使用VALUE_RANGE_MIN_INCLUSIVE获得VALUE_RANGE_MIN_MAX_INCLUSIVE

        类似地,该值可以用值getAttributeValueTypegetObjectValueType来确定,以确定该范围的最大值是否包括在内。

        另请参见:
        常数字段值
      • VALUE_RANGE_MIN_INCLUSIVE

        static final int VALUE_RANGE_MIN_INCLUSIVE
        getAttributeValueTypegetObjectValueType返回的getAttributeValueType ,表示属性或用户对象可以设置为值范围。 范围的最小值(但不是最大值)包括在内。
        另请参见:
        常数字段值
      • VALUE_RANGE_MAX_INCLUSIVE

        static final int VALUE_RANGE_MAX_INCLUSIVE
        getAttributeValueTypegetObjectValueType返回的getAttributeValueType ,指示属性或用户对象可以设置为值范围。 范围的最大值(但不是最小值)包括在内。
        另请参见:
        常数字段值
      • VALUE_RANGE_MIN_MAX_INCLUSIVE

        static final int VALUE_RANGE_MIN_MAX_INCLUSIVE
        getAttributeValueTypegetObjectValueType返回的getAttributeValueType ,表示可以为属性或用户对象设置值范围。 该范围的最小值和最大值都包括在内。 建议两端都包含整数范围,并且该排除范围仅用于浮点数据。
        另请参见:
        常数字段值
      • VALUE_ENUMERATION

        static final int VALUE_ENUMERATION
        getAttributeValueTypegetObjectValueType返回的getAttributeValueType ,指示属性或用户对象可以设置多个枚举值之一。 在属性的情况下,这些值是String s; 对于对象,它们是实现给定类或接口的Object

        类型DATATYPE_BOOLEAN属性值应标记为枚举。

        另请参见:
        常数字段值
      • VALUE_LIST

        static final int VALUE_LIST
        getAttributeValueTypegetObjectValueType返回的getAttributeValueType ,表示可以将属性或用户对象设置为值列表或数组。 在属性的情况下,列表将由String内的空格分隔值String ; 对于对象,将使用数组。
        另请参见:
        常数字段值
      • DATATYPE_STRING

        static final int DATATYPE_STRING
        getAttributeDataType返回的 getAttributeDataType指示属性的值是常规Unicode字符串。
        另请参见:
        常数字段值
      • DATATYPE_BOOLEAN

        static final int DATATYPE_BOOLEAN
        getAttributeDataType返回的getAttributeDataType指示属性的值是布尔值'true'或'false'之一。 类型为DATATYPE_BOOLEAN的属性值应标记为枚举,并且允许的值应为字符串文字值“TRUE”或“FALSE”,尽管插件也可识别较低或混合大小写等效项。
        另请参见:
        常数字段值
      • DATATYPE_INTEGER

        static final int DATATYPE_INTEGER
        getAttributeDataType返回的 getAttributeDataType指示属性的值是整数的字符串表示形式。
        另请参见:
        常数字段值
      • DATATYPE_FLOAT

        static final int DATATYPE_FLOAT
        getAttributeDataType返回的 getAttributeDataType指示属性的值是十进制浮点数的字符串表示形式。
        另请参见:
        常数字段值
      • DATATYPE_DOUBLE

        static final int DATATYPE_DOUBLE
        getAttributeDataType返回的 getAttributeDataType指示属性的值是双精度十进制浮点数的字符串表示形式。
        另请参见:
        常数字段值
    • 方法详细信息

      • 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的指定元素的最CHILD_POLICY_REPEAT元素CHILD_POLICY_REPEAT 例如,表示颜色主要信息的元素可能需要至少有3个子节点,每个主节点对应一个子节点。
        参数
        elementName - 要查询的元素的名称。
        结果
        int
        异常
        IllegalArgumentException - 如果 elementNamenull或者不是此格式的合法元素名称。
        IllegalArgumentException - 如果指定的元素没有子策略 CHILD_POLICY_REPEAT
      • getElementMaxChildren

        int getElementMaxChildren​(String elementName)
        返回具有子策略CHILD_POLICY_REPEAT的指定元素的最大子元素CHILD_POLICY_REPEAT 例如,可以允许表示8位调色板中的条目的元素重复多达256次。 Integer.MAX_VALUE可用于指定不存在上限。
        参数
        elementName - 要查询的元素的名称。
        结果
        int
        异常
        IllegalArgumentException - 如果 elementNamenull或者不是此格式的合法元素名称。
        IllegalArgumentException - 如果指定的元素没有子策略 CHILD_POLICY_REPEAT
      • getElementDescription

        String getElementDescription​(String elementName,
                                     Locale locale)
        返回String含有指定元素,或的描述null 如果可能,将对所提供的Locale进行本地化描述。

        如果localenull ,当前的默认Locale由归国Locale.getLocale将被使用。

        参数
        elementName - 元素的名称。
        locale - 将尝试本地化的 Locale
        结果
        元素描述。
        异常
        IllegalArgumentException - 如果 elementNamenull ,或者不是此格式的合法元素名称。
      • getChildPolicy

        int getChildPolicy​(String elementName)
        返回以 CHILD_POLICY_开头的常量 CHILD_POLICY_ ,指示命名元素的子 CHILD_POLICY_的合法模式。
        参数
        elementName - 要查询的元素的名称。
        结果
        CHILD_POLICY_*常量之一。
        异常
        IllegalArgumentException - 如果 elementNamenull或者不是此格式的合法元素名称。
      • getChildNames

        String[] getChildNames​(String elementName)
        返回一个String的数组,指示允许作为命名元素的子元素的元素的名称, String显示顺序排列。 如果元素不能有子元素,则返回null
        参数
        elementName - 要查询的元素的名称。
        结果
        一个 String的数组,或null。
        异常
        IllegalArgumentException - 如果 elementNamenull或者不是此格式的合法元素名称。
      • getAttributeNames

        String[] getAttributeNames​(String elementName)
        返回一个 String的数组, String列出了可能与指定元素关联的属性的名称。
        参数
        elementName - 要查询的元素的名称。
        结果
        String的数组。
        异常
        IllegalArgumentException - 如果 elementNamenull或者不是此格式的合法元素名称。
      • getAttributeValueType

        int getAttributeValueType​(String elementName,
                                  String attrName)
        返回以 VALUE_开头的常量 VALUE_ ,指示命名元素中给定属性的值是否是任意的,约束在指定范围内,约束为一组枚举值之一,还是以空格分隔的列表任意值。
        参数
        elementName - 要查询的元素的名称。
        attrName - 要查询的属性的名称。
        结果
        VALUE_*常量之一。
        异常
        IllegalArgumentException - 如果 elementNamenull或者不是此格式的合法元素名称。
        IllegalArgumentException - 如果 attrNamenull或者不是此元素的合法属性名称。
      • getAttributeDataType

        int getAttributeDataType​(String elementName,
                                 String attrName)
        返回以DATATYPE_开头的常量DATATYPE_ ,指示命名元素中给定属性的值的格式和解释。 如果getAttributeValueType返回VALUE_LIST ,则合法值是返回数据类型的值的getAttributeValueType VALUE_LIST列表。
        参数
        elementName - 要查询的元素的名称。
        attrName - 要查询的属性的名称。
        结果
        DATATYPE_*常量之一。
        异常
        IllegalArgumentException - 如果 elementNamenull或者不是此格式的合法元素名称。
        IllegalArgumentException - 如果 attrNamenull或者不是此元素的合法属性名称。
      • isAttributeRequired

        boolean isAttributeRequired​(String elementName,
                                    String attrName)
        如果命名属性必须存在于指定元素中,则返回 true
        参数
        elementName - 要查询的元素的名称。
        attrName - 要查询的属性的名称。
        结果
        true如果该属性必须存在。
        异常
        IllegalArgumentException - 如果 elementNamenull或者不是此格式的合法元素名称。
        IllegalArgumentException - 如果 attrNamenull或者不是该元素的合法属性。
      • getAttributeDefaultValue

        String getAttributeDefaultValue​(String elementName,
                                        String attrName)
        如果未在命名元素中显式出现,则返回指定属性的默认值,如果没有可用的默认值,则 Stringnull
        参数
        elementName - 要查询的元素的名称。
        attrName - 要查询的属性的名称。
        结果
        a String包含默认值,或 null
        异常
        IllegalArgumentException - 如果 elementNamenull或者不是此格式的合法元素名称。
        IllegalArgumentException - 如果 attrNamenull或者不是该元素的合法属性名称。
      • getAttributeEnumerations

        String[] getAttributeEnumerations​(String elementName,
                                          String attrName)
        返回一个String的数组, String包含指定元素中给定属性的合法枚举值。 仅当getAttributeValueType返回VALUE_ENUMERATION时才应调用此方法。
        参数
        elementName - 要查询的元素的名称。
        attrName - 要查询的属性的名称。
        结果
        String的数组。
        异常
        IllegalArgumentException - 如果 elementNamenull或者不是此格式的合法元素名称。
        IllegalArgumentException - 如果 attrNamenull或者不是此元素的合法属性名称。
        IllegalArgumentException - 如果给定属性未定义为枚举。
      • getAttributeMinValue

        String getAttributeMinValue​(String elementName,
                                    String attrName)
        返回属性的最小合法值。 此值是包含还是排他,可以通过值getAttributeValueType确定。 该值以String形式返回; 其解释取决于getAttributeDataType的值。 仅当getAttributeValueType返回VALUE_RANGE_*时才应调用此方法。
        参数
        elementName - 要查询的元素的名称。
        attrName - 要查询的属性的名称。
        结果
        String包含属性的最小合法值。
        异常
        IllegalArgumentException - 如果 elementNamenull或者不是此格式的合法元素名称。
        IllegalArgumentException - 如果 attrNamenull或者不是此元素的合法属性名称。
        IllegalArgumentException - 如果给定属性未定义为范围。
      • getAttributeMaxValue

        String getAttributeMaxValue​(String elementName,
                                    String attrName)
        返回属性的最大合法值。 此值是包含还是排他,可以通过值getAttributeValueType确定。 该值以String形式返回; 其解释取决于getAttributeDataType的值。 仅当getAttributeValueType返回VALUE_RANGE_*时才应调用此方法。
        参数
        elementName - 要查询的元素的名称,如 String
        attrName - 要查询的属性的名称。
        结果
        String包含属性的最大合法值。
        异常
        IllegalArgumentException - 如果 elementNamenull或者不是此格式的合法元素名称。
        IllegalArgumentException - 如果 attrNamenull或者不是此元素的合法属性名称。
        IllegalArgumentException - 如果给定属性未定义为范围。
      • getAttributeListMinLength

        int getAttributeListMinLength​(String elementName,
                                      String attrName)
        返回可用于定义此属性的最小列表项数。 属性本身定义为包含多个以空格分隔的多个项目的String 仅当getAttributeValueType返回VALUE_LIST时才应调用此方法。
        参数
        elementName - 要查询的元素的名称。
        attrName - 要查询的属性的名称。
        结果
        属性的最小合法列表项数。
        异常
        IllegalArgumentException - 如果 elementNamenull或者不是此格式的合法元素名称。
        IllegalArgumentException - 如果 attrNamenull或者不是此元素的合法属性名称。
        IllegalArgumentException - 如果给定属性未定义为列表。
      • getAttributeListMaxLength

        int getAttributeListMaxLength​(String elementName,
                                      String attrName)
        返回可用于定义此属性的最大列表项数。 Integer.MAX_VALUE可用于指定不存在上限。 属性本身定义为包含多个以空格分隔的多个项目的String 仅当getAttributeValueType返回VALUE_LIST时才应调用此方法。
        参数
        elementName - 要查询的元素的名称。
        attrName - 要查询的属性的名称。
        结果
        属性的最大合法列表项数。
        异常
        IllegalArgumentException - 如果 elementNamenull或者不是此格式的合法元素名称。
        IllegalArgumentException - 如果 attrNamenull或者不是此元素的合法属性名称。
        IllegalArgumentException - 如果给定属性未定义为列表。
      • getAttributeDescription

        String getAttributeDescription​(String elementName,
                                       String attrName,
                                       Locale locale)
        返回String含有指定属性,或的描述null 如果可能,将对所提供的Locale进行本地化描述。

        如果localenull ,当前的默认Locale由归国Locale.getLocale将被使用。

        参数
        elementName - 元素的名称。
        attrName - 属性的名称。
        locale - 将尝试本地化的 Locale
        结果
        属性描述。
        异常
        IllegalArgumentException - 如果 elementNamenull ,或者不是此格式的合法元素名称。
        IllegalArgumentException - 如果 attrNamenull或者不是此元素的合法属性名称。
      • getObjectValueType

        int getObjectValueType​(String elementName)
        返回以VALUE_开头的枚举值VALUE_ ,指示Object引用允许的值的类型(枚举,范围或数组)。 如果在给定元素中不能存储任何对象值,则此方法的结果将为VALUE_NONE

        Object将其合法值定义为范围的引用必须实现Comparable接口。

        参数
        elementName - 要查询的元素的名称。
        结果
        VALUE_*常量之一。
        异常
        IllegalArgumentException - 如果 elementNamenull或者不是此格式的合法元素名称。
        另请参见:
        Comparable
      • getObjectClass

        <?> getObjectClass​(String elementName)
        返回元素中存储的Object引用的类型。 如果此元素可能不包含Object引用,则将引发IllegalArgumentException 如果类类型是数组,则此字段指示基础类类型( 例如 ,对于int的数组,此方法将返回int.class )。

        Object将其合法值定义为范围的引用必须实现Comparable接口。

        参数
        elementName - 要查询的元素的名称。
        结果
        一个 对象。
        异常
        IllegalArgumentException - 如果 elementNamenull或者不是此格式的合法元素名称。
        IllegalArgumentException - 如果指定的元素不能包含对象值( ,如果为 getObjectValueType(elementName) == VALUE_NONE )。
      • getObjectDefaultValue

        Object getObjectDefaultValue​(String elementName)
        返回 Object s,其中包含指定元素中 Object引用的默认值。
        参数
        elementName - 要查询的元素的名称。
        结果
        Object
        异常
        IllegalArgumentException - 如果 elementNamenull或者不是此格式的合法元素名称。
        IllegalArgumentException - 如果指定的元素不能包含对象值( ,如果为 getObjectValueType(elementName) == VALUE_NONE )。
      • getObjectEnumerations

        Object[] getObjectEnumerations​(String elementName)
        返回一个Object的数组, Object包含指定元素中Object引用的合法枚举值。 仅当getObjectValueType返回VALUE_ENUMERATION时才应调用此方法。

        与接受枚举值的节点关联的Object必须等于此方法返回的值之一,如==运算符所定义(而不是Object.equals方法)。

        参数
        elementName - 要查询的元素的名称。
        结果
        Object的数组。
        异常
        IllegalArgumentException - 如果 elementNamenull或者不是此格式的合法元素名称。
        IllegalArgumentException - 如果指定的元素不能包含对象值( ,如果 getObjectValueType(elementName) == VALUE_NONE )。
        IllegalArgumentException - 如果 Object未定义为枚举。
      • getObjectMinValue

        Comparable<?> getObjectMinValue​(String elementName)
        返回指定元素中Object引用的最小合法值。 此值是包含还是排他,可以通过值getObjectValueType确定。 仅当getObjectValueType返回以VALUE_RANGE开头的常量之一时,才应调用此方法。
        参数
        elementName - 要查询的元素的名称。
        结果
        属性的最小合法值。
        异常
        IllegalArgumentException - 如果 elementNamenull或者不是此格式的合法元素名称。
        IllegalArgumentException - 如果指定的元素不能包含对象值( ,如果为 getObjectValueType(elementName) == VALUE_NONE )。
        IllegalArgumentException - 如果 Object未定义为范围。
      • getObjectMaxValue

        Comparable<?> getObjectMaxValue​(String elementName)
        返回指定元素中Object引用的最大合法值。 此值是包含还是排他,可以通过值getObjectValueType确定。 仅当getObjectValueType返回以VALUE_RANGE开头的常量之一时,才应调用此方法。
        参数
        elementName - 要查询的元素的名称。
        结果
        属性的最小合法值。
        异常
        IllegalArgumentException - 如果 elementNamenull或者不是此格式的合法元素名称。
        IllegalArgumentException - 如果指定的元素不能包含对象值( ,如果为 getObjectValueType(elementName) == VALUE_NONE )。
        IllegalArgumentException - 如果未将 Object定义为范围。
      • getObjectArrayMinLength

        int getObjectArrayMinLength​(String elementName)
        返回可用于在命名元素中定义Object引用的最小数组元素数。 仅当getObjectValueType返回VALUE_LIST时才应调用此方法。
        参数
        elementName - 要查询的元素的名称。
        结果
        Object参考的最小有效数组长度。
        异常
        IllegalArgumentException - 如果 elementNamenull或者不是此格式的合法元素名称。
        IllegalArgumentException - 如果指定的元素不能包含对象值( getObjectValueType(elementName) == VALUE_NONE )。
        IllegalArgumentException - 如果 Object不是数组。
      • getObjectArrayMaxLength

        int getObjectArrayMaxLength​(String elementName)
        返回可用于在命名元素中定义Object引用的最大数组元素数。 Integer.MAX_VALUE可用于指定不存在上限。 仅当getObjectValueType返回VALUE_LIST时才应调用此方法。
        参数
        elementName - 要查询的元素的名称。
        结果
        Object参考的最大有效数组长度。
        异常
        IllegalArgumentException - 如果 elementNamenull或者不是此格式的合法元素名称。
        IllegalArgumentException - 如果指定的元素不能包含对象值( ,如果 getObjectValueType(elementName) == VALUE_NONE )。
        IllegalArgumentException - 如果 Object不是数组。