©
This document uses PHP Chinese website manual Release
|
JavaTM 2 Platform Standard Ed. 6 |
|||||||||
上一个类 下一个类 | 框架 无框架 | |||||||||
摘要: 嵌套 | 字段 | 构造方法 | 方法 | 详细信息: 字段 | 构造方法 | 方法 |
java.lang.Object javax.imageio.metadata.IIOMetadataFormatImpl
public abstract class IIOMetadataFormatImpl
提供 IIOMetadataFormat
接口的可重用实现的具体类。此外,通过 getStandardFormatInstance
方法提供一个表示标准的、插件无关的 javax_imageio_1.0
格式的静态实例。
为了提供元素和属性的本地化的描述,应该通过 ResourceBundle.getBundle
使用的常规机制来提供基本名称为 this.getClass().getName() + "Resources"
的 ResourceBundle
。简单地说,子类根据命名约定(默认情况下为扩展 IIMetadataFormatImpl
的子类的完全限定名,加上字符串 "Resources",加上国家/地区、语言和由下划线分隔的变体代码)提供一个或多个其他类。在运行期间,调用 getElementDescription
或 getAttributeDescription
将尝试根据提供的语言环境动态加载这些类,并将使用元素名称或者后跟 '/' 字符再后跟作为键的属性名的元素名称。此键将提供给 ResourceBundle
的 getString
方法,并返回所得到的节点或属性的本地化描述。
子类可以使用 setResourceBaseName
方法为资源包提供另外的基本名称。
在需要时,子类可以通过重写提供的 getElementDescription
和 getAttributeDescription
实现来选择它自己的本地化机制。
ResourceBundle.getBundle(String,Locale)
字段摘要 | |
---|---|
static String |
standardMetadataFormatName
包含标准格式名称 "javax_imageio_1.0" 的 String 常量。 |
从接口 javax.imageio.metadata.IIOMetadataFormat 继承的字段 |
---|
CHILD_POLICY_ALL, CHILD_POLICY_CHOICE, CHILD_POLICY_EMPTY, CHILD_POLICY_MAX, CHILD_POLICY_REPEAT, CHILD_POLICY_SEQUENCE, CHILD_POLICY_SOME, DATATYPE_BOOLEAN, DATATYPE_DOUBLE, DATATYPE_FLOAT, DATATYPE_INTEGER, DATATYPE_STRING, VALUE_ARBITRARY, VALUE_ENUMERATION, VALUE_LIST, VALUE_NONE, VALUE_RANGE, VALUE_RANGE_MAX_INCLUSIVE, VALUE_RANGE_MAX_INCLUSIVE_MASK, VALUE_RANGE_MIN_INCLUSIVE, VALUE_RANGE_MIN_INCLUSIVE_MASK, VALUE_RANGE_MIN_MAX_INCLUSIVE |
构造方法摘要 | |
---|---|
IIOMetadataFormatImpl(String rootName,
int childPolicy)
构造一个空的 IIOMetadataFormatImpl 实例,使其具有给定根元素名称和子策略(CHILD_POLICY_REPEAT 除外)。 |
|
IIOMetadataFormatImpl(String rootName,
int minChildren,
int maxChildren)
构造一个空的 IIOMetadataFormatImpl 实例,使其具有给定根元素名称和子策略 CHILD_POLICY_REPEAT 。 |
方法摘要 | ||
---|---|---|
protected void |
addAttribute(String elementName,
String attrName,
int dataType,
boolean required,
int listMinLength,
int listMaxLength)
将新属性添加到以前定义的元素中,该元素将由值的列表定义。 |
|
protected void |
addAttribute(String elementName,
String attrName,
int dataType,
boolean required,
String defaultValue)
将新属性添加到以前定义的可以被设置为任意值的元素中。 |
|
protected void |
addAttribute(String elementName,
String attrName,
int dataType,
boolean required,
String defaultValue,
List<String> enumeratedValues)
将新属性添加到以前定义的元素中,该元素将由一组枚举值定义。 |
|
protected void |
addAttribute(String elementName,
String attrName,
int dataType,
boolean required,
String defaultValue,
String minValue,
String maxValue,
boolean minInclusive,
boolean maxInclusive)
将新属性添加到以前定义的元素中,该元素将由一系列值定义。 |
|
protected void |
addBooleanAttribute(String elementName,
String attrName,
boolean hasDefaultValue,
boolean defaultValue)
将新属性添加到以前定义的元素中,该元素将由枚举值 TRUE 和 FALSE 定义,数据类型为 DATATYPE_BOOLEAN 。 |
|
protected void |
addChildElement(String elementName,
String parentName)
将现有元素添加到给定父节点类型的合法子节点的列表中。 |
|
protected void |
addElement(String elementName,
String parentName,
int childPolicy)
使用某个子策略( CHILD_POLICY_REPEAT 除外)将新元素类型添加到此元数据文档格式中。 |
|
protected void |
addElement(String elementName,
String parentName,
int minChildren,
int maxChildren)
使用子策略 CHILD_POLICY_REPEAT 将新元素类型添加到此元数据文档格式中。 |
|
protected void |
addObjectValue(String elementName,
Class<?> classType,
int arrayMinLength,
int arrayMaxLength)
允许将给定类类型的 Object 引用存储在实现指定元素的节点中。 |
|
protected
|
addObjectValue(String elementName,
Class<T> classType,
boolean required,
T defaultValue)
允许将给定类类型的 Object 引用存储在实现指定元素的节点中。 |
|
protected
|
addObjectValue(String elementName,
Class<T> classType,
boolean required,
T defaultValue,
List<? extends T> enumeratedValues)
允许将给定类类型的 Object 引用存储在实现指定元素的节点中。 |
|
protected
|
addObjectValue(String elementName,
Class<T> classType,
T defaultValue,
Comparable<? super T> minValue,
Comparable<? super T> maxValue,
boolean minInclusive,
boolean maxInclusive)
允许将给定类类型的 Object 引用存储在实现指定元素的节点中。 |
|
abstract boolean |
canNodeAppear(String elementName,
ImageTypeSpecifier imageType)
如果允许元素(和它下面的子树)在给定类型(由 ImageTypeSpecifier 定义)的图像的元数据文档中出现,则返回 true 。 |
|
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 数组,其包含指定元素中给定属性的合法枚举值。 |
|
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 数组,该数组列出了与指定元素关联的属性的名称。 |
|
int |
getAttributeValueType(String elementName,
String attrName)
返回以 VALUE_ 开头的常量之一,指示指定元素中给定属性的值是任意值、被限制在指定范围中的值、被限制为一组枚举值之一,还是一个任意值的以空白分隔的列表。 |
|
String[] |
getChildNames(String elementName)
返回一个按出现顺序排列的 String 数组,指示允许作为指定元素子元素的元素的名称。 |
|
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 引用的最小数组元素数。 |
|
Class<?> |
getObjectClass(String elementName)
返回存储在元素中的 Class 类型的 Object 引用。 |
|
Object |
getObjectDefaultValue(String elementName)
返回包含指定元素中 Object 引用的默认值的 Object 。 |
|
Object[] |
getObjectEnumerations(String elementName)
返回一个 Object 数组,该数组包含指定元素中 Object 引用的合法枚举值。 |
|
Comparable<?> |
getObjectMaxValue(String elementName)
返回指定元素中 Object 引用的最大合法值。 |
|
Comparable<?> |
getObjectMinValue(String elementName)
返回指定元素中 Object 引用的最小合法值。 |
|
int |
getObjectValueType(String elementName)
返回以 VALUE_ 开头的枚举值之一,指示允许用于 Object 引用的值(枚举、范围或数组)的类型。 |
|
protected String |
getResourceBaseName()
返回当前设置的用于查找 ResourceBundle 的基本名称。 |
|
String |
getRootName()
返回格式的根元素的名称。 |
|
static IIOMetadataFormat |
getStandardFormatInstance()
返回描述标准、插件无关的 javax.imageio_1.0 元数据文档格式的 IIOMetadataFormat 对象,该文档格式在 javax.imageio.metadata 包的注释中描述。 |
|
boolean |
isAttributeRequired(String elementName,
String attrName)
如果指定属性必须在指定元素中存在,则返回 true 。 |
|
protected void |
removeAttribute(String elementName,
String attrName)
从以前定义的元素中移除属性。 |
|
protected void |
removeElement(String elementName)
从格式中移除元素。 |
|
protected void |
removeObjectValue(String elementName)
禁止将 Object 引用存储在实现指定元素的节点中。 |
|
protected void |
setResourceBaseName(String resourceBaseName)
设置用于查找包含此格式的元素和属性描述的 ResourceBundle 新基本名称。 |
从类 java.lang.Object 继承的方法 |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
字段详细信息 |
---|
public static final String standardMetadataFormatName
"javax_imageio_1.0"
的 String
常量。
构造方法详细信息 |
---|
public IIOMetadataFormatImpl(String rootName, int childPolicy)
IIOMetadataFormatImpl
实例,使其具有给定根元素名称和子策略(CHILD_POLICY_REPEAT
除外)。其他元素及其属性以及 Object
引用信息可以使用各种 add
方法添加。
rootName
- 根元素的名称。childPolicy
- CHILD_POLICY_REPEAT
之外的 CHILD_POLICY_*
常量之一。
IllegalArgumentException
- 如果 rootName
为 null
。
IllegalArgumentException
- 如果 childPolicy
不是预定义的常量之一。public IIOMetadataFormatImpl(String rootName, int minChildren, int maxChildren)
IIOMetadataFormatImpl
实例,使其具有给定根元素名称和子策略 CHILD_POLICY_REPEAT
。其他元素及其属性以及 Object
引用信息可以使用各种 add
方法添加。
rootName
- 根元素的名称。minChildren
- 节点的最小子节点数。maxChildren
- 节点的最大子节点数。
IllegalArgumentException
- 如果 rootName
为 null
。
IllegalArgumentException
- 如果 minChildren
为负或大于 maxChildren
。方法详细信息 |
---|
protected void setResourceBaseName(String resourceBaseName)
ResourceBundle
新基本名称。
在首次调用此方法之前,基本名称将等于 this.getClass().getName() + "Resources"
。
resourceBaseName
- 包含新基本名称的 String
。
IllegalArgumentException
- 如果 resourceBaseName
为 null
。getResourceBaseName()
protected String getResourceBaseName()
ResourceBundle
的基本名称。
String
。setResourceBaseName(java.lang.String)
protected void addElement(String elementName, String parentName, int childPolicy)
CHILD_POLICY_REPEAT
除外)将新元素类型添加到此元数据文档格式中。
elementName
- 新元素的名称。parentName
- 将作为新元素的父元素的元素的名称。childPolicy
- CHILD_POLICY_REPEAT
之外的 CHILD_POLICY_*
常量之一,指示新元素的子策略。
IllegalArgumentException
- 如果 parentName
为 null
或者不是此格式的合法元素名称。
IllegalArgumentException
- 如果 childPolicy
不是预定义的常量之一。protected void addElement(String elementName, String parentName, int minChildren, int maxChildren)
CHILD_POLICY_REPEAT
将新元素类型添加到此元数据文档格式中。
elementName
- 新元素的名称。parentName
- 将作为新元素的父元素的元素的名称。minChildren
- 节点的最小子节点数。maxChildren
- 节点的最大子节点数。
IllegalArgumentException
- 如果 parentName
为 null
或者不是此格式的合法元素名称。
IllegalArgumentException
- 如果 minChildren
为负或大于 maxChildren
。protected void addChildElement(String elementName, String parentName)
parentName
- 将作为元素的新父元素的元素的名称。elementName
- 要作为子元素添加的元素的名称。
IllegalArgumentException
- 如果 elementName
为 null
或者不是此格式的合法元素名称。
IllegalArgumentException
- 如果 parentName
为 null
或者不是此格式的合法元素名称。protected void removeElement(String elementName)
elementName
- 要移除的元素的名称。protected void addAttribute(String elementName, String attrName, int dataType, boolean required, String defaultValue)
elementName
- 元素的名称。attrName
- 要添加的属性的名称。dataType
- 属性的数据类型(字符串格式),DATATYPE_*
常量之一。required
- 如果属性必须存在,则为 true
。defaultValue
- 属性的默认值,或者为 null
。
IllegalArgumentException
- 如果 elementName
为 null
或者不是此格式的合法元素名称。
IllegalArgumentException
- 如果 attrName
为 null
。
IllegalArgumentException
- 如果 dataType
不是预定义的常量之一。protected void addAttribute(String elementName, String attrName, int dataType, boolean required, String defaultValue, List<String> enumeratedValues)
elementName
- 元素的名称。attrName
- 要添加的属性的名称。dataType
- 属性的数据类型(字符串格式),DATATYPE_*
常量之一。required
- 如果属性必须存在,则为 true
。defaultValue
- 属性的默认值,或者为 null
。enumeratedValues
- 包含属性合法值的 String
组成的 List
。
IllegalArgumentException
- 如果 elementName
为 null
或者不是此格式的合法元素名称。
IllegalArgumentException
- 如果 attrName
为 null
。
IllegalArgumentException
- 如果 dataType
不是预定义的常量之一。
IllegalArgumentException
- 如果 enumeratedValues
为 null
。
IllegalArgumentException
- 如果 enumeratedValues
不包含至少一项。
IllegalArgumentException
- 如果 enumeratedValues
包含不为 String
的元素或者为 null
。protected void addAttribute(String elementName, String attrName, int dataType, boolean required, String defaultValue, String minValue, String maxValue, boolean minInclusive, boolean maxInclusive)
elementName
- 元素的名称。attrName
- 要添加的属性的名称。dataType
- 属性的数据类型(字符串格式),DATATYPE_*
常量之一。required
- 如果属性必须存在,则为 true
。defaultValue
- 属性的默认值,或者为 null
。minValue
- 属性的最小(是否包括两端的值取决于 minInclusive
的值)合法值(String
形式)。maxValue
- 属性的最大(是否包括两端的值取决于 minInclusive
的值)合法值(String
形式)。minInclusive
- 如果包括 minValue
,则为 true
。maxInclusive
- 如果包括 maxValue
,则为 true
。
IllegalArgumentException
- 如果 elementName
为 null
或者不是此格式的合法元素名称。
IllegalArgumentException
- 如果 attrName
为 null
。
IllegalArgumentException
- 如果 dataType
不是预定义的常量之一。protected void addAttribute(String elementName, String attrName, int dataType, boolean required, int listMinLength, int listMaxLength)
elementName
- 元素的名称。attrName
- 要添加的属性的名称。dataType
- 属性的数据类型(字符串格式),DATATYPE_*
常量之一。required
- 如果属性必须存在,则为 true
。listMinLength
- 列表项的最小合法数。listMaxLength
- 列表项的最大合法数。
IllegalArgumentException
- 如果 elementName
为 null
或者不是此格式的合法元素名称。
IllegalArgumentException
- 如果 attrName
为 null
。
IllegalArgumentException
- 如果 dataType
不是预定义的常量之一。
IllegalArgumentException
- 如果 listMinLength
为负或大于 listMaxLength
。protected void addBooleanAttribute(String elementName, String attrName, boolean hasDefaultValue, boolean defaultValue)
TRUE
和 FALSE
定义,数据类型为 DATATYPE_BOOLEAN
。
elementName
- 元素的名称。attrName
- 要添加的属性的名称。hasDefaultValue
- 如果默认值应该存在,则为 true
。defaultValue
- boolean
值形式的属性默认值;如果 hasDefaultValue
为 false
,则忽略该参数。
IllegalArgumentException
- 如果 elementName
为 null
或者不是此格式的合法元素名称。
IllegalArgumentException
- 如果 attrName
为 null
。protected void removeAttribute(String elementName, String attrName)
elementName
- 元素的名称。attrName
- 要移除的属性的名称。
IllegalArgumentException
- 如果 elementName
为 null
或者不是此格式的合法元素名称。protected <T> void addObjectValue(String elementName, Class<T> classType, boolean required, T defaultValue)
Object
引用存储在实现指定元素的节点中。Object
的值是不受约束的(其类类型除外)。
如果以前允许 Object
引用,则重写以前的设置值。
elementName
- 元素的名称。classType
- 指示对象值的合法类类型的 Class
变量。required
- 如果对象值必须存在,则为 true
。defaultValue
- Object
引用的默认值,或者为 null
。
IllegalArgumentException
- 如果 elementName
为 null
或者不是此格式的合法元素名称。protected <T> void addObjectValue(String elementName, Class<T> classType, boolean required, T defaultValue, List<? extends T> enumeratedValues)
Object
引用存储在实现指定元素的节点中。Object
的值必须为 enumeratedValues
给出的值之一。
如果以前允许 Object
引用,则重写以前的设置值。
elementName
- 元素的名称。classType
- 指示对象值的合法类类型的 Class
变量。required
- 如果对象值必须存在,则为 true
。defaultValue
- Object
引用的默认值,或者为 null
。enumeratedValues
- 包含对象引用的合法值的 Object
组成的 List
。
IllegalArgumentException
- 如果 elementName
为 null
或者不是此格式的合法元素名称。
IllegalArgumentException
- 如果 enumeratedValues
为 null
。
IllegalArgumentException
- 如果 enumeratedValues
不包含至少一项。
IllegalArgumentException
- 如果 enumeratedValues
包含不为 classType
指定的类类型的实例或者为 null
。protected <T extends Object & Comparable<? super T>> void addObjectValue(String elementName, Class<T> classType, T defaultValue, Comparable<? super T> minValue, Comparable<? super T> maxValue, boolean minInclusive, boolean maxInclusive)
Object
引用存储在实现指定元素的节点中。Object
的值必须在 minValue
和 maxValue
给出的范围中。此外,类类型必须实现 Comparable
接口。
如果以前允许 Object
引用,则重写以前的设置值。
elementName
- 元素的名称。classType
- 指示对象值的合法类类型的 Class
变量。defaultValue
- 默认值minValue
- 对象值的最小(是否包括两端的值取决于 minInclusive
的值)合法值(String
形式)。maxValue
- 对象值的最大(是否包括两端的值取决于 minInclusive
的值)合法值(String
形式)。minInclusive
- 如果包括 minValue
,则为 true
。maxInclusive
- 如果包括 maxValue
,则为 true
。
IllegalArgumentException
- 如果 elementName
为 null
或者不是此格式的合法元素名称。protected void addObjectValue(String elementName, Class<?> classType, int arrayMinLength, int arrayMaxLength)
Object
引用存储在实现指定元素的节点中。Object
的值必须为 classType
给出的类类型的对象数组,该数组的元素至少为 arrayMinLength
至多为 arrayMaxLength
。
如果以前允许 Object
引用,则重写以前的设置值。
elementName
- 元素的名称。classType
- 指示对象值的合法类类型的 Class
变量。arrayMinLength
- 数组的最小合法长度。arrayMaxLength
- 数组的最大合法长度。
IllegalArgumentException
- 如果 elementName
不是此格式的合法元素名称。protected void removeObjectValue(String elementName)
Object
引用存储在实现指定元素的节点中。
elementName
- 元素的名称。
IllegalArgumentException
- 如果 elementName
不是此格式的合法元素名称。public String getRootName()
IIOMetadataFormat
复制的描述
IIOMetadataFormat
中的 getRootName
String
。public abstract boolean canNodeAppear(String elementName, ImageTypeSpecifier imageType)
IIOMetadataFormat
复制的描述ImageTypeSpecifier
定义)的图像的元数据文档中出现,则返回 true
。例如,元数据文档格式可能包含描述图像原色的元素,该元素在写入灰度级图像时是不允许出现的。
IIOMetadataFormat
中的 canNodeAppear
elementName
- 要查询的元素的名称。imageType
- 指示将与元数据关联的图像类型的 ImageTypeSpecifier
。
true
。public int getElementMinChildren(String elementName)
IIOMetadataFormat
复制的描述CHILD_POLICY_REPEAT
的指定元素的最小子元素数。例如,表示原色信息的元素可能需要具有至少 3 个子元素,每种原色一个子元素。
IIOMetadataFormat
中的 getElementMinChildren
elementName
- 要查询的元素的名称。
int
。public int getElementMaxChildren(String elementName)
IIOMetadataFormat
复制的描述CHILD_POLICY_REPEAT
的指定元素的最大子元素数。例如,表示 8 位调色板条目的元素可能允许重复多达 256 次。Integer.MAX_VALUE
的值可用于指定不存在上限。
IIOMetadataFormat
中的 getElementMaxChildren
elementName
- 要查询的元素的名称。
int
。public String getElementDescription(String elementName, Locale locale)
String
,或者 null
。如果可能,应将描述本地化为提供的 Locale
。
默认实现利用在 ResourceBundle.getBundle
的注释中描述的应变机制 (fallback mechanism),首先使用由 setResourceBaseName
设置的当前资源基本名称以及所提供的 Locale
查找 ResourceBundle
。如果找到 ResourceBundle
,则将元素名称用作其 getString
方法的键并返回结果。如果未找到 ResourceBundle
或者不存在这样的键,则返回 null
。
如果 locale
为 null
,则使用 Locale.getLocale
返回的当前默认 Locale
。
IIOMetadataFormat
中的 getElementDescription
elementName
- 元素的名称。locale
- 尝试进行本地化的 Locale
。
IllegalArgumentException
- 如果 elementName
为 null
或者不是此格式的合法元素名称。setResourceBaseName(java.lang.String)
public int getChildPolicy(String elementName)
IIOMetadataFormat
复制的描述CHILD_POLICY_
开头的常量之一,指示指定元素子元素的合法模式。
IIOMetadataFormat
中的 getChildPolicy
elementName
- 要查询的元素的名称。
CHILD_POLICY_*
常量之一。public String[] getChildNames(String elementName)
IIOMetadataFormat
复制的描述String
数组,指示允许作为指定元素子元素的元素的名称。如果元素不能有子元素,则返回 null
。
IIOMetadataFormat
中的 getChildNames
elementName
- 要查询的元素的名称。
String
数组,或 null。public String[] getAttributeNames(String elementName)
IIOMetadataFormat
复制的描述String
数组,该数组列出了与指定元素关联的属性的名称。
IIOMetadataFormat
中的 getAttributeNames
elementName
- 要查询的元素的名称。
String
数组。public int getAttributeValueType(String elementName, String attrName)
IIOMetadataFormat
复制的描述VALUE_
开头的常量之一,指示指定元素中给定属性的值是任意值、被限制在指定范围中的值、被限制为一组枚举值之一,还是一个任意值的以空白分隔的列表。
IIOMetadataFormat
中的 getAttributeValueType
elementName
- 要查询的元素的名称。attrName
- 要查询的属性的名称。
VALUE_*
常量之一。public int getAttributeDataType(String elementName, String attrName)
IIOMetadataFormat
复制的描述DATATYPE_
开头的常量之一,指示指定元素中给定属性的值的格式和解释。如果 getAttributeValueType
返回 VALUE_LIST
,则合法值为返回数据类型的值的以空白分隔的列表。
IIOMetadataFormat
中的 getAttributeDataType
elementName
- 要查询的元素的名称。attrName
- 要查询的属性的名称。
DATATYPE_*
常量之一。public boolean isAttributeRequired(String elementName, String attrName)
IIOMetadataFormat
复制的描述true
。
IIOMetadataFormat
中的 isAttributeRequired
elementName
- 要查询的元素的名称。attrName
- 要查询的属性的名称。
true
。public String getAttributeDefaultValue(String elementName, String attrName)
IIOMetadataFormat
复制的描述String
的形式返回其默认值;如果不存在可用的默认值,则返回 null
。
IIOMetadataFormat
中的 getAttributeDefaultValue
elementName
- 要查询的元素的名称。attrName
- 要查询的属性的名称。
String
,或者 null
。public String[] getAttributeEnumerations(String elementName, String attrName)
IIOMetadataFormat
复制的描述String
数组,其包含指定元素中给定属性的合法枚举值。只应在 getAttributeValueType
返回 VALUE_ENUMERATION
的情况下调用此方法。
IIOMetadataFormat
中的 getAttributeEnumerations
elementName
- 要查询的元素的名称。attrName
- 要查询的属性的名称。
String
数组。public String getAttributeMinValue(String elementName, String attrName)
IIOMetadataFormat
复制的描述getAttributeValueType
的值确定。该值以 String
的形式返回;其解释依赖于 getAttributeDataType
的值。只应在 getAttributeValueType
返回 VALUE_RANGE_*
的情况下调用此方法。
IIOMetadataFormat
中的 getAttributeMinValue
elementName
- 要查询的元素的名称。attrName
- 要查询的属性的名称。
String
。public String getAttributeMaxValue(String elementName, String attrName)
IIOMetadataFormat
复制的描述getAttributeValueType
的值确定。该值以 String
的形式返回;其解释依赖于 getAttributeDataType
的值。只应在 getAttributeValueType
返回 VALUE_RANGE_*
的情况下调用此方法。
IIOMetadataFormat
中的 getAttributeMaxValue
elementName
- 要查询的 String
形式的元素名称。attrName
- 要查询的属性的名称。
String
。public int getAttributeListMinLength(String elementName, String attrName)
IIOMetadataFormat
复制的描述String
。只应在 getAttributeValueType
返回 VALUE_LIST
的情况下调用此方法。
IIOMetadataFormat
中的 getAttributeListMinLength
elementName
- 要查询的元素的名称。attrName
- 要查询的属性的名称。
public int getAttributeListMaxLength(String elementName, String attrName)
IIOMetadataFormat
复制的描述Integer.MAX_VALUE
的值可用于指定不存在上限。属性本身被定义为一个包含多个由空白分隔的项的 String
。只应在 getAttributeValueType
返回 VALUE_LIST
的情况下调用此方法。
IIOMetadataFormat
中的 getAttributeListMaxLength
elementName
- 要查询的元素的名称。attrName
- 要查询的属性的名称。
public String getAttributeDescription(String elementName, String attrName, Locale locale)
String
,或者 null
。如果可能,应将描述本地化为提供的 Locale
。
默认实现利用在 ResourceBundle.getBundle
的注释中描述的应变机制,首先使用由 setResourceBaseName
设置的当前资源基本名称以及所提供的 Locale
查找 ResourceBundle
。如果找到 ResourceBundle
,则将后跟 "/" 字符再后跟属性名 (elementName + "/" + attrName
) 的元素名称用作其 getString
方法的键,并返回结果。如果未找到 ResourceBundle
或者不存在这样的键,则返回 null
。
如果 locale
为 null
,则使用 Locale.getLocale
返回的当前默认 Locale
。
IIOMetadataFormat
中的 getAttributeDescription
elementName
- 元素的名称。attrName
- 属性的名称。locale
- 尝试进行本地化的 Locale
,或者为 null
。
IllegalArgumentException
- 如果 elementName
为 null
或者不是此格式的合法元素名称。
IllegalArgumentException
- 如果 attrName
为 null
或者不是此元素的合法属性名称。setResourceBaseName(java.lang.String)
public int getObjectValueType(String elementName)
IIOMetadataFormat
复制的描述VALUE_
开头的枚举值之一,指示允许用于 Object
引用的值(枚举、范围或数组)的类型。如果在给定元素中无法存储任何对象值,则此方法的结果将为 VALUE_NONE
。
合法值被定义为范围的 Object
引用必须实现 Comparable
接口。
IIOMetadataFormat
中的 getObjectValueType
elementName
- 要查询的元素的名称。
VALUE_*
常量之一。Comparable
public Class<?> getObjectClass(String elementName)
IIOMetadataFormat
复制的描述Class
类型的 Object
引用。如果此元素不能包含 Object
引用,则抛出 IllegalArgumentException
。如果类类型为数组,则此字段指示底层类类型(例如,对于 int
的数组,此方法将返回 int.class
)。
合法值被定义为范围的 Object
引用必须实现 Comparable
接口。
IIOMetadataFormat
中的 getObjectClass
elementName
- 要查询的元素的名称。
Class
对象。public Object getObjectDefaultValue(String elementName)
IIOMetadataFormat
复制的描述Object
引用的默认值的 Object
。
IIOMetadataFormat
中的 getObjectDefaultValue
elementName
- 要查询的元素的名称。
Object
对象。public Object[] getObjectEnumerations(String elementName)
IIOMetadataFormat
复制的描述Object
数组,该数组包含指定元素中 Object
引用的合法枚举值。只应在 getObjectValueType
返回 VALUE_ENUMERATION
的情况下调用此方法。
与接受枚举值的节点关联的 Object
必须等于此方法返回的值之一,这里的等于是由 ==
运算符(而不是 Object.equals
方法)定义的。
IIOMetadataFormat
中的 getObjectEnumerations
elementName
- 要查询的元素的名称。
Object
数组。public Comparable<?> getObjectMinValue(String elementName)
IIOMetadataFormat
复制的描述Object
引用的最小合法值。是否包括此值可由 getObjectValueType
的值确定。只应在 getObjectValueType
返回以 VALUE_RANGE
开头的常量之一的情况下调用此方法。
IIOMetadataFormat
中的 getObjectMinValue
elementName
- 要查询的元素的名称。
public Comparable<?> getObjectMaxValue(String elementName)
IIOMetadataFormat
复制的描述Object
引用的最大合法值。是否包括此值可由 getObjectValueType
的值确定。只应在 getObjectValueType
返回以 VALUE_RANGE
开头的常量之一的情况下调用此方法。
IIOMetadataFormat
中的 getObjectMaxValue
elementName
- 要查询的元素的名称。
public int getObjectArrayMinLength(String elementName)
IIOMetadataFormat
复制的描述Object
引用的最小数组元素数。只应在 getObjectValueType
返回 VALUE_LIST
的情况下调用此方法。
IIOMetadataFormat
中的 getObjectArrayMinLength
elementName
- 要查询的元素的名称。
Object
引用的最小有效数组长度。public int getObjectArrayMaxLength(String elementName)
IIOMetadataFormat
复制的描述Object
引用的最大数组元素数。Integer.MAX_VALUE
的值可用于指定不存在上限。只应在 getObjectValueType
返回 VALUE_LIST
的情况下调用此方法。
IIOMetadataFormat
中的 getObjectArrayMaxLength
elementName
- 要查询的元素的名称。
Object
引用的最大有效数组长度。public static IIOMetadataFormat getStandardFormatInstance()
javax.imageio_1.0
元数据文档格式的 IIOMetadataFormat
对象,该文档格式在 javax.imageio.metadata
包的注释中描述。
IIOMetadataFormat
实例。
|
JavaTM 2 Platform Standard Ed. 6 |
|||||||||
上一个类 下一个类 | 框架 无框架 | |||||||||
摘要: 嵌套 | 字段 | 构造方法 | 方法 | 详细信息: 字段 | 构造方法 | 方法 |
版权所有 2004 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策。