public abstract class IIOMetadataFormatImpl extends Object implements IIOMetadataFormat
IIOMetadataFormat
インタフェースの再使用可能な実装を提供する具象クラスです。 さらに、標準の、プラグインに依存しないjavax_imageio_1.0
形式を表す静的インスタンスがgetStandardFormatInstance
メソッドにより提供されます。
ローカライズされた要素と属性の説明を提供するためには、this.getClass().getName()+"Resources"
のベース名を持つResourceBundle
を、ResourceBundle.getBundle
で使用される通常のメカニズムを介して提供する必要があります。 つまり、サブクラサーは命名規則に従って1つまたは複数の追加クラスを提供します(デフォルトでは、IIMetadataFormatImpl
、文字列"Resources"、国、言語、およびバリアントのアンダースコアで区切られたコードを拡張するサブクラスの完全指定名)。 実行時には、getElementDescription
またはgetAttributeDescription
の呼出しによって、指定されたロケールに従ってこのようなクラスの動的なロードが試行され、要素名、またはあとに「/」文字と属性名が続く要素名がキーとして使用されます。 このキーはResourceBundle
のgetString
メソッドに提供され、ローカライズされたノードまたは属性の説明が返されます。
サブクラスは、setResourceBaseName
メソッドを使用してリソース・バンドルの異なるベース名を提供できます。
必要に応じて、サブクラスは、getElementDescription
およびgetAttributeDescription
の提供された実装をオーバーライドして、独自のローカリゼーション・メカニズムを選択できます。
修飾子と型 | フィールド | 説明 |
---|---|---|
static String |
standardMetadataFormatName |
標準の形式名
"javax_imageio_1.0" が格納されているString 定数。 |
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) |
指定されたルート要素名と子ポリシー(
CHILD_POLICY_REPEAT 以外)を使用して、空白のIIOMetadataFormatImpl インスタンスを構築します。 |
IIOMetadataFormatImpl(String rootName, int minChildren, int maxChildren) |
指定されたルート要素名と
CHILD_POLICY_REPEAT の子ポリシーを使用して、空白のIIOMetadataFormatImpl インスタンスを構築します。 |
修飾子と型 | メソッド | 説明 |
---|---|---|
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) |
新しい属性を、
DATATYPE_BOOLEAN のデータ型で、列挙値TRUE およびFALSE で定義される事前に定義された要素に追加します。 |
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 <T> void |
addObjectValue(String elementName, Class<T> classType, boolean required, T defaultValue) |
指定されたクラス型の
Object 参照を、名前付き要素を実装するノードに格納できるようにします。 |
protected <T> void |
addObjectValue(String elementName, Class<T> classType, boolean required, T defaultValue, List<? extends T> enumeratedValues) |
指定されたクラス型の
Object 参照を、名前付き要素を実装するノードに格納できるようにします。 |
protected <T extends Object & Comparable<? super T>> |
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_ で始まる定数の1つを返します。 |
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_ で始まる定数の1つを返し、名前付き要素内の指定された属性の値が任意であるか、指定された範囲内に限定されるか、一連の列挙値の1つに限定されるか、または空白で区切られた任意の値のリストであるかどうかを示します。 |
String[] |
getChildNames(String elementName) |
名前付き要素の子になることができる要素の名前を示す
String の配列を出現順に返します。 |
int |
getChildPolicy(String elementName) |
名前付き要素の子の有効なパターンを示す、
CHILD_POLICY_ で始まる定数の1つを返します。 |
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) |
要素内に格納された
Object 参照のClass 型を返します。 |
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) |
Object 参照に使用できる値(列挙、範囲、または配列)の型を示すVALUE_ で始まる列挙値の1つを返します。 |
protected String |
getResourceBaseName() |
ResourceBundle を検索するための、現在設定されているベース名を返します。 |
String |
getRootName() |
形式のルート要素の名前を返します。
|
static IIOMetadataFormat |
getStandardFormatInstance() |
javax.imageio.metadata パッケージのコメントに記述されている、標準の、プラグインに依存しないjavax.imageio_1.0 メタデータ・ドキュメント形式を記述するIIOMetadataFormat オブジェクトを返します。 |
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 を検索するための新しいベース名を設定します。 |
public IIOMetadataFormatImpl(String rootName, int childPolicy)
CHILD_POLICY_REPEAT
以外)を使用して、空白のIIOMetadataFormatImpl
インスタンスを構築します。 追加要素と、その属性およびObject
参照情報は、各種のadd
メソッドを使用して追加できます。 rootName
- ルート要素の名前。childPolicy
- CHILD_POLICY_REPEAT
以外の、CHILD_POLICY_*
定数の1つ。IllegalArgumentException
- rootName
がnull
の場合。IllegalArgumentException
- childPolicy
が事前に定義された定数の1つでない場合。public IIOMetadataFormatImpl(String rootName, int minChildren, int maxChildren)
CHILD_POLICY_REPEAT
の子ポリシーを使用して、空白のIIOMetadataFormatImpl
インスタンスを構築します。 追加要素と、その属性および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_*
定数の1つ。IllegalArgumentException
- parentName
がnull
の場合、またはこの形式の有効な要素名でない場合。IllegalArgumentException
- childPolicy
が事前に定義された定数の1つでない場合。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_*
定数の1つ。required
- 属性が存在する必要がある場合はtrue
。defaultValue
- 属性のデフォルト値、またはnull
。IllegalArgumentException
- elementName
がnull
の場合、またはこの形式の有効な要素名でない場合。IllegalArgumentException
- attrName
がnull
の場合。IllegalArgumentException
- dataType
が事前に定義された定数の1つでない場合。protected void addAttribute(String elementName, String attrName, int dataType, boolean required, String defaultValue, List<String> enumeratedValues)
elementName
- 要素の名前。attrName
- 追加される属性の名前。dataType
- 属性のデータ型(文字列形式)で、DATATYPE_*
定数の1つ。required
- 属性が存在する必要がある場合はtrue
。defaultValue
- 属性のデフォルト値、またはnull
。enumeratedValues
- 属性の有効な値が格納されているString
のList
。IllegalArgumentException
- elementName
がnull
の場合、またはこの形式の有効な要素名でない場合。IllegalArgumentException
- attrName
がnull
の場合。IllegalArgumentException
- dataType
が事前に定義された定数の1つでない場合。IllegalArgumentException
- enumeratedValues
がnull
の場合。IllegalArgumentException
- enumeratedValues
にエントリが1つも格納されていない場合。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_*
定数の1つ。required
- 属性が存在する必要がある場合はtrue
。defaultValue
- 属性のデフォルト値、またはnull
。minValue
- String
としての、属性の最小(この値を含むか含まないかはminInclusive
の値によって決まります)の有効な値。maxValue
- String
としての、属性の最大(この値を含むか含まないかはminInclusive
の値によって決まります)の有効な値。minInclusive
- minValue
が範囲に含まれる場合はtrue
。maxInclusive
- maxValue
が範囲に含まれる場合はtrue
。IllegalArgumentException
- elementName
がnull
の場合、またはこの形式の有効な要素名でない場合。IllegalArgumentException
- attrName
がnull
の場合。IllegalArgumentException
- dataType
が事前に定義された定数の1つでない場合。protected void addAttribute(String elementName, String attrName, int dataType, boolean required, int listMinLength, int listMaxLength)
elementName
- 要素の名前。attrName
- 追加される属性の名前。dataType
- 属性のデータ型(文字列形式)で、DATATYPE_*
定数の1つ。required
- 属性が存在する必要がある場合はtrue
。listMinLength
- リスト項目の有効な最小数。listMaxLength
- リスト項目の有効な最大数。IllegalArgumentException
- elementName
がnull
の場合、またはこの形式の有効な要素名でない場合。IllegalArgumentException
- attrName
がnull
の場合。IllegalArgumentException
- dataType
が事前に定義された定数の1つでない場合。IllegalArgumentException
- listMinLength
が負の値の場合、またはlistMaxLength
より大きい場合。protected void addBooleanAttribute(String elementName, String attrName, boolean hasDefaultValue, boolean defaultValue)
DATATYPE_BOOLEAN
のデータ型で、列挙値TRUE
およびFALSE
で定義される事前に定義された要素に追加します。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
参照が以前に許可された場合、以前の設定値は上書きされます。
T
- オブジェクトの型。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
で指定された値の1つである必要があります。
Object
参照が以前に許可された場合、以前の設定値は上書きされます。
T
- オブジェクトの型。elementName
- 要素の名前。classType
- オブジェクト値の有効なクラス型を示すClass
変数。required
- オブジェクト値が存在する必要がある場合はtrue
。defaultValue
- Object
参照のデフォルト値、またはnull
。enumeratedValues
- オブジェクト参照の有効な値が格納されているObject
のList
。IllegalArgumentException
- elementName
がnull
の場合、またはこの形式の有効な要素名でない場合。IllegalArgumentException
- enumeratedValues
がnull
の場合。IllegalArgumentException
- enumeratedValues
にエントリが1つも格納されていない場合。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
参照が以前に許可された場合、以前の設定値は上書きされます。
T
- オブジェクトの型。elementName
- 要素の名前。classType
- オブジェクト値の有効なクラス型を示すClass
変数。defaultValue
- 次のデフォルト値: minValue
- String
としての、オブジェクト値の最小(この値を含むか含まないかはminInclusive
の値によって決まります)の有効な値。maxValue
- String
としての、オブジェクト値の最大(この値を含むか含まないかはminInclusive
の値によって決まります)の有効な値。minInclusive
- minValue
が範囲に含まれる場合はtrue
。maxInclusive
- maxValue
が範囲に含まれる場合はtrue
。IllegalArgumentException
- elementName
がnull
の場合、またはこの形式の有効な要素名でない場合。protected void addObjectValue(String elementName, Class<?> classType, int arrayMinLength, int arrayMaxLength)
Object
参照を、名前付き要素を実装するノードに格納できるようにします。 Object
の値は、少なくともarrayMinLength
の要素、最大でarrayMaxLength
の要素を持つ、classType
で指定されたクラス型のオブジェクトの配列である必要があります。
Object
参照が以前に許可された場合、以前の設定値は上書きされます。
elementName
- 要素の名前。classType
- オブジェクト値の有効なクラス型を示すClass
変数。arrayMinLength
- 配列の最小の有効な長さ。arrayMaxLength
- 配列の最大の有効な長さ。IllegalArgumentException
- elementName
がこの形式の有効な要素名でない場合。protected void removeObjectValue(String elementName)
Object
参照を、名前付き要素を実装するノードに格納できないようにします。elementName
- 要素の名前。IllegalArgumentException
- elementName
がこの形式の有効な要素名でない場合。public String getRootName()
IIOMetadataFormat
getRootName
、インタフェースIIOMetadataFormat
String
。public abstract boolean canNodeAppear(String elementName, ImageTypeSpecifier imageType)
IIOMetadataFormat
ImageTypeSpecifier
で定義された、指定されたタイプのイメージのメタデータ・ドキュメントに表示できる場合は、true
を返します。 たとえば、メタデータ・ドキュメント形式にはイメージの一次色を記述する要素が格納される場合がありますが、グレー・スケール・イメージを記述する場合には使用できません。 canNodeAppear
、インタフェースIIOMetadataFormat
elementName
- 照会される要素の名前。imageType
- メタデータと関連するイメージのタイプを示すImageTypeSpecifier
。true
。public int getElementMinChildren(String elementName)
IIOMetadataFormat
CHILD_POLICY_REPEAT
を持つ名前付き要素の子の最小数を返します。 たとえば、色の一次情報を表す要素には、各一次色に1つ、少なくとも3つの子が必要になる場合があります。 getElementMinChildren
、インタフェースIIOMetadataFormat
elementName
- 照会される要素の名前。int
。public int getElementMaxChildren(String elementName)
IIOMetadataFormat
CHILD_POLICY_REPEAT
を持つ名前付き要素の子の最大数を返します。 たとえば、8ビットのカラー・パレット内のエントリを表す要素は256回まで反復できる場合があります。 Integer.MAX_VALUE
の値を使用して、上限なしを指定することができます。 getElementMaxChildren
、インタフェースIIOMetadataFormat
elementName
- 照会される要素の名前。int
。public String getElementDescription(String elementName, Locale locale)
String
、またはnull
を返します。 説明は、可能であれば、指定されたLocale
にローカライズされます。
デフォルトの実装では、まずsetResourceBaseName
で設定された現在のリソースのベース名を使用してResourceBundle
を検索し、ResourceBundle.getBundle
のコメントに記述された代替メカニズムを使用して、指定されたLocale
を検索します。 ResourceBundle
が見つかった場合は、要素名がそのgetString
メソッドのキーとして使用され、結果が返されます。 ResourceBundle
が見つからないか、そのようなキーが存在しない場合は、null
が返されます。
locale
がnull
の場合、Locale.getLocale
によって返された現在のデフォルトLocale
が使用されます。
getElementDescription
、インタフェースIIOMetadataFormat
elementName
- 要素の名前。locale
- ローカリゼーションを試みる対象となるLocale
。IllegalArgumentException
- elementName
がnull
の場合、またはこの形式の有効な要素名でない場合。setResourceBaseName(java.lang.String)
public int getChildPolicy(String elementName)
IIOMetadataFormat
CHILD_POLICY_
で始まる定数の1つを返します。getChildPolicy
、インタフェースIIOMetadataFormat
elementName
- 照会される要素の名前。CHILD_POLICY_*
定数の1つ。public String[] getChildNames(String elementName)
IIOMetadataFormat
String
の配列を出現順に返します。 要素が子を持つことができない場合は、null
が返されます。 getChildNames
、インタフェースIIOMetadataFormat
elementName
- 照会される要素の名前。String
の配列、またはnull。public String[] getAttributeNames(String elementName)
IIOMetadataFormat
String
の配列を返します。getAttributeNames
、インタフェースIIOMetadataFormat
elementName
- 照会される要素の名前。String
の配列。public int getAttributeValueType(String elementName, String attrName)
IIOMetadataFormat
VALUE_
で始まる定数の1つを返し、名前付き要素内の指定された属性の値が任意であるか、指定された範囲内に限定されるか、一連の列挙値の1つに限定されるか、または空白で区切られた任意の値のリストであるかどうかを示します。getAttributeValueType
、インタフェースIIOMetadataFormat
elementName
- 照会される要素の名前。attrName
- 照会される属性の名前。VALUE_*
定数の1つ。public int getAttributeDataType(String elementName, String attrName)
IIOMetadataFormat
DATATYPE_
で始まる定数の1つを返します。 getAttributeValueType
がVALUE_LIST
を返す場合、有効な値は、返されるデータ型の値の空白で区切られたリストです。 getAttributeDataType
、インタフェースIIOMetadataFormat
elementName
- 照会される要素の名前。attrName
- 照会される属性の名前。DATATYPE_*
定数の1つ。public boolean isAttributeRequired(String elementName, String attrName)
IIOMetadataFormat
true
を返します。isAttributeRequired
、インタフェースIIOMetadataFormat
elementName
- 照会される要素の名前。attrName
- 照会される属性の名前。true
。public String getAttributeDefaultValue(String elementName, String attrName)
IIOMetadataFormat
String
として返します。デフォルト値が利用できない場合はnull
を返します。getAttributeDefaultValue
、インタフェースIIOMetadataFormat
elementName
- 照会される要素の名前。attrName
- 照会される属性の名前。String
、またはnull
。public String[] getAttributeEnumerations(String elementName, String attrName)
IIOMetadataFormat
String
の配列を返します。 このメソッドは、getAttributeValueType
がVALUE_ENUMERATION
を返す場合にだけ呼び出します。 getAttributeEnumerations
、インタフェースIIOMetadataFormat
elementName
- 照会される要素の名前。attrName
- 照会される属性の名前。String
の配列。public String getAttributeMinValue(String elementName, String attrName)
IIOMetadataFormat
getAttributeValueType
の値で判定することができます。 値はString
として返されます。その解釈はgetAttributeDataType
の値により異なります。 このメソッドは、getAttributeValueType
がVALUE_RANGE_*
を返す場合にだけ呼び出します。 getAttributeMinValue
、インタフェースIIOMetadataFormat
elementName
- 照会される要素の名前。attrName
- 照会される属性の名前。String
。public String getAttributeMaxValue(String elementName, String attrName)
IIOMetadataFormat
getAttributeValueType
の値で判定することができます。 値はString
として返されます。その解釈はgetAttributeDataType
の値により異なります。 このメソッドは、getAttributeValueType
がVALUE_RANGE_*
を返す場合にだけ呼び出します。 getAttributeMaxValue
、インタフェースIIOMetadataFormat
elementName
- String
としての、照会される要素の名前。attrName
- 照会される属性の名前。String
。public int getAttributeListMinLength(String elementName, String attrName)
IIOMetadataFormat
String
として定義されます。 このメソッドは、getAttributeValueType
がVALUE_LIST
を返す場合にだけ呼び出します。 getAttributeListMinLength
、インタフェースIIOMetadataFormat
elementName
- 照会される要素の名前。attrName
- 照会される属性の名前。public int getAttributeListMaxLength(String elementName, String attrName)
IIOMetadataFormat
Integer.MAX_VALUE
の値を使用して、上限なしを指定することができます。 属性自体は、空白で区切られた複数の項目が格納されているString
として定義されます。 このメソッドは、getAttributeValueType
がVALUE_LIST
を返す場合にだけ呼び出します。 getAttributeListMaxLength
、インタフェースIIOMetadataFormat
elementName
- 照会される要素の名前。attrName
- 照会される属性の名前。public String getAttributeDescription(String elementName, String attrName, Locale locale)
String
、またはnull
を返します。 説明は、可能であれば、指定されたLocale
にローカライズされます。
デフォルトの実装では、まずsetResourceBaseName
で設定された現在のリソースのベース名を使用してResourceBundle
を検索し、ResourceBundle.getBundle
のコメントに記述された代替メカニズムを使用して、指定されたLocale
を検索します。 ResourceBundle
が見つかった場合は、あとに「/」文字と属性名が続く要素名(elementName+"/"+attrName
)がそのgetString
メソッドのキーとして使用され、結果が返されます。 ResourceBundle
が見つからないか、そのようなキーが存在しない場合は、null
が返されます。
locale
がnull
の場合、Locale.getLocale
によって返された現在のデフォルトLocale
が使用されます。
getAttributeDescription
、インタフェースIIOMetadataFormat
elementName
- 要素の名前。attrName
- 属性の名前。locale
- ローカリゼーションを試みる、対象となるLocale
、またはnull
。IllegalArgumentException
- elementName
がnull
の場合、またはこの形式の有効な要素名でない場合。IllegalArgumentException
- attrName
がnull
の場合、またはこの要素の有効な属性名でない場合。setResourceBaseName(java.lang.String)
public int getObjectValueType(String elementName)
IIOMetadataFormat
Object
参照に使用できる値(列挙、範囲、または配列)の型を示すVALUE_
で始まる列挙値の1つを返します。 指定された要素内にオブジェクトの値を格納できない場合、このメソッドの結果はVALUE_NONE
になります。
有効な値が範囲として定義されるObject
参照は、Comparable
インタフェースを実装する必要があります。
getObjectValueType
、インタフェースIIOMetadataFormat
elementName
- 照会される要素の名前。VALUE_*
定数の1つ。Comparable
public Class<?> getObjectClass(String elementName)
IIOMetadataFormat
Object
参照のClass
型を返します。 この要素にObject
参照を格納できない場合は、IllegalArgumentException
がスローされます。 クラス型が配列である場合、このフィールドは基本となるクラス型を示します(たとえば、int
の配列の場合、このメソッドはint.class
を返します)。
有効な値が範囲として定義されるObject
参照は、Comparable
インタフェースを実装する必要があります。
getObjectClass
、インタフェースIIOMetadataFormat
elementName
- 照会される要素の名前。Class
オブジェクト。public Object getObjectDefaultValue(String elementName)
IIOMetadataFormat
Object
参照のデフォルト値が格納されているObject
を返します。getObjectDefaultValue
、インタフェースIIOMetadataFormat
elementName
- 照会される要素の名前。Object
。public Object[] getObjectEnumerations(String elementName)
IIOMetadataFormat
Object
参照の有効な列挙値が格納されているObject
の配列を返します。 このメソッドは、getObjectValueType
がVALUE_ENUMERATION
を返す場合にだけ呼び出します。
==
演算子で定義されるように(Object.equals
メソッドとは異なります)、列挙値を受け取るノードに関連付けられたObject
は、このメソッドから返される値の1つと等しくなければいけません。
getObjectEnumerations
、インタフェースIIOMetadataFormat
elementName
- 照会される要素の名前。Object
の配列。public Comparable<?> getObjectMinValue(String elementName)
IIOMetadataFormat
Object
参照の有効な最小値を返します。 この値を含むか含まないかは、getObjectValueType
の値で判定することができます。 このメソッドは、getObjectValueType
がVALUE_RANGE
で始まる定数の1つを返す場合にだけ呼び出します。 getObjectMinValue
、インタフェースIIOMetadataFormat
elementName
- 照会される要素の名前。public Comparable<?> getObjectMaxValue(String elementName)
IIOMetadataFormat
Object
参照の有効な最大値を返します。 この値を含むか含まないかは、getObjectValueType
の値で判定することができます。 このメソッドは、getObjectValueType
がVALUE_RANGE
で始まる定数の1つを返す場合にだけ呼び出します。 getObjectMaxValue
、インタフェースIIOMetadataFormat
elementName
- 照会される要素の名前。public int getObjectArrayMinLength(String elementName)
IIOMetadataFormat
Object
参照の定義に使用できる配列要素の最小数を返します。 このメソッドは、getObjectValueType
がVALUE_LIST
を返す場合にだけ呼び出します。 getObjectArrayMinLength
、インタフェースIIOMetadataFormat
elementName
- 照会される要素の名前。Object
参照の配列の有効な最小の長さ。public int getObjectArrayMaxLength(String elementName)
IIOMetadataFormat
Object
参照の定義に使用できる配列要素の最大数を返します。 Integer.MAX_VALUE
の値を使用して、上限なしを指定することができます。 このメソッドは、getObjectValueType
がVALUE_LIST
を返す場合にだけ呼び出します。 getObjectArrayMaxLength
、インタフェースIIOMetadataFormat
elementName
- 照会される要素の名前。Object
参照の配列の有効な最大の長さ。public static IIOMetadataFormat getStandardFormatInstance()
javax.imageio.metadata
パッケージのコメントに記述されている、標準の、プラグインに依存しないjavax.imageio_1.0
メタデータ・ドキュメント形式を記述するIIOMetadataFormat
オブジェクトを返します。IIOMetadataFormat
インスタンス。 バグまたは機能を送信
詳細なAPIリファレンスおよび開発者ドキュメントについては、Java SEのドキュメントを参照してください。 そのドキュメントには、概念的な概要、用語の定義、回避方法、有効なコード例などの、開発者を対象にしたより詳細な説明が含まれています。
Copyright © 1993, 2025, Oracle and/or its affiliates. All rights reserved. Use is subject to license terms. Documentation Redistribution Policyも参照してください。