パッケージ jakarta.xml.bind.annotation

Java プログラム要素を XML スキーママッピングにカスタマイズするためのアノテーションを定義します。

このドキュメントでの JAXB への参照は、特に明記されていない限り、Jakarta XML Binding を指します。

パッケージ仕様

次の表は、各プログラム要素に関連付けることができる Jakarta XML Binding マッピングアノテーションを示しています。

Java プログラム要素を XML スキーママッピングにカスタマイズするためのアノテーション
プログラム要素 Jakarta XML Binding アノテーション
パッケージ
クラス
列挙型
JavaBean プロパティ / フィールド
パラメーター

用語

JavaBean プロパティとフィールド : マッピングの目的上、フィールドと JavaBean プロパティの間に意味上の違いはありません。JavaBean プロパティに適用できるアノテーションは、常にフィールドに適用できます。Javadoc のドキュメントでは、簡潔にするために、JavaBean プロパティまたはプロパティという用語は、JavaBean プロパティまたはフィールドのいずれかを意味するために使用されます。必要に応じて、両方が明示的に記載されています。

トップレベルクラス : マッピングの目的で、トップレベルクラスと静的ネストクラスの間に意味上の違いはありません。最上位クラスに適用できるアノテーションは、ネストされた静的クラスにいつでも適用できます。Javadoc のドキュメントでは、簡潔にするために、「トップレベルクラス」または単にクラスという用語は、トップレベルクラスまたはネストされた静的クラスのいずれかを意味するために使用されます。

マッピングアノテーション :JSR175 プログラミングアノテーション機能に基づく Jakarta XML Binding 定義のプログラムアノテーション。

一般的な使用上の制約

以下の使用上の制約は、アノテーション以外にも適用されるため、ここで定義されています。

  • プロパティの場合、特定のアノテーションを読み取りプロパティまたは書き込みプロパティのいずれかに適用できますが、両方に適用することはできません。
  • プロパティ名は、マップされているクラスのスーパークラスのいずれかの他のプロパティ名とは異なっている必要があります。
  • マップされたフィールド名またはマップされたプロパティの大文字と小文字を区別しない名前は、クラス内で一意である必要があります。

表記

名前空間接頭部

このパッケージの XML スキーマフラグメントでは、次の名前空間プレフィックスが使用されています。

XML スキーマフラグメント名前空間プレフィックス
接頭辞 名前空間 ノート
xshttp://www.w3.org/2001/XMLSchemaXML スキーマ名前空間の名前空間
参照 http://ws-i.org/profiles/basic/1.1/xsdswaref スキーマコンポーネントの名前空間
xsihttp://www.w3.org/2001/XMLSchema-instance インスタンスの XML スキーマ名前空間
導入:
1.6、JAXB 2.0