クラス JAXBElement<T>
- java.lang.ObjectSE
-
- jakarta.xml.bind.JAXBElement<T>
- 実装されているすべてのインターフェース:
SerializableSE
public class JAXBElement<T> extends ObjectSE implements SerializableSE
Xml 要素の Jakarta XML Binding 表現。
このクラスは、スキーマ内の要素宣言と xml ドキュメント内の要素インスタンス値の両方からの Xml 要素に関する情報を次のプロパティで表します。
- 要素の xml タグ
name valueは、要素インスタンスの属性とコンテンツモデルを表します- 要素宣言の
declaredType(xs:element @type属性) - 要素宣言の
scope - ブール
nilプロパティ。(要素インスタンスのxsi:nil属性)
declaredTypeおよびscopeプロパティは、xml 型定義の Jakarta XML Binding クラスバインディングです。Scopeは、JAXBElement.GlobalScopeまたはスキーマ要素宣言を含む複合型定義を表す Java クラスのいずれかです。valueがnullの場合、nilはtrueでなければならないというプロパティの制約があります。属性を使用して nil 要素を表すことができるようにするには、その逆は当てはまりません。nilが true の場合、valueが null でない可能性があるため、nil 要素に関連付けられた属性の値を保持できます。- 導入:
- 1.6、JAXB 2.0
- 作成者:
- Kohsuke Kawaguchi, Joe Fialli
- 関連事項:
- 連載形式
ネストされたクラスの要約
ネストされたクラス 修飾子と型 クラス 説明 static classJAXBElement.GlobalScopexml 要素のグローバルスコープを指定します。
メソッドのサマリー
すべてのメソッド インスタンスメソッド 具象メソッド 修飾子と型 メソッド 説明 ClassSE<T>getDeclaredType()xml 要素宣言の type 属性の Java バインディングを返します。QNameSEgetName()xml 要素のタグ名を返します。ClassSE<?>getScope()xml 要素宣言のスコープを返します。TgetValue()この要素のコンテンツモデルと属性値を返します。booleanisGlobalScope()この xml 要素宣言がグローバルである場合は true を返します。booleanisNil()この要素インスタンスのコンテンツモデルが nil の場合、trueを返します。booleanisTypeSubstituted()この xml 要素インスタンスの値が xml 要素宣言の宣言された型とは異なる型である場合に true を返します。voidsetNil(boolean value)この要素に nil コンテンツがあるかどうかを設定します。voidsetValue(T t)この xml 要素のコンテンツモデルと属性を設定します。
フィールドの詳細
name
protected final QNameSE name
xml 要素のタグ名
scope
protected final ClassSE<?> scope
この xml 要素インスタンスを表す xml 要素宣言のスコープ。次のいずれかの値になります。- グローバル xml 要素宣言の場合はJAXBElement.GlobalScope。ローカル要素宣言には、xml 要素宣言を含む複合型定義の Java クラス表現に設定されたスコープがあります。
value
protected T value
xml 要素の値。xml 要素インスタンスのコンテンツモデルと属性を表します。
nil
protected boolean nil
xml 要素インスタンスに xsi:nil="true" がある場合は true。
コンストラクターの詳細
JAXBElement
public JAXBElement(QNameSE name, ClassSE<T> declaredType, ClassSE<?> scope, T value)
xml 要素インスタンスを作成します。
- パラメーター:
name- xml 要素タグ名の Java バインディングdeclaredType- xml 要素宣言の型の Java バインディングscope- xml 要素宣言のスコープの Java バインディング。null を渡すことは、GlobalScope.classを渡すことと同じです。value- xml 要素の値を表す Java インスタンス。- 関連事項:
getScope(),isTypeSubstituted()
メソッドの詳細
getName
public QNameSE getName()
xml 要素のタグ名を返します。
setValue
public void setValue(T t)
この xml 要素のコンテンツモデルと属性を設定します。
このプロパティが
nullに設定されている場合、isNil()はtrueでなければなりません。制約の詳細はisNil()で説明されています。- 関連事項:
isTypeSubstituted()
getValue
public T getValue()
この要素のコンテンツモデルと属性値を返します。
この値が
nullの場合のプロパティ制約の説明については、isNil()を参照してください。
getScope
public ClassSE<?> getScope()
xml 要素宣言のスコープを返します。- 戻り値:
- この要素がグローバルスコープの場合は
GlobalScope.class。 - 関連事項:
isGlobalScope()
isNil
public boolean isNil()
この要素インスタンスのコンテンツモデルが nil の場合、
trueを返します。getValue()が null の場合、このプロパティは常にtrueを返します。このプロパティがtrueの場合、getValue()には属性に null 以外の値を含めることができます。nil xml 要素が属性を持つことは有効です。
setNil
public void setNil(boolean value)
この要素に nil コンテンツがあるかどうかを設定します。
- 関連事項:
isNil()
isGlobalScope
public boolean isGlobalScope()
この xml 要素宣言がグローバルである場合は true を返します。
isTypeSubstituted
public boolean isTypeSubstituted()
この xml 要素インスタンスの値が xml 要素宣言の宣言された型とは異なる型である場合に true を返します。