public final class JAXB extends ObjectSE
このクラスで定義されているメソッドは、JAXBContext、Unmarshaller、Marshaller のいくつかの基本操作を組み合わせた便利なメソッドです。これらは、Jakarta XML Binding を初めて使用する開発者にとって好ましいメソッドになるように設計されています。それらには次の特徴があります。
DataBindingException (JAXBException を causeSE として持つ) にラップされます。チェックされた例外を好む人は、残りの Jakarta XML Binding API を直接使用することが期待されます。 さらに、unmarshal メソッドには次の特徴があります。
DataBindingException で失敗します。 同様に、marshal メソッドには次の特徴があります。
DataBindingException で失敗します。 このクラスのすべてのメソッドでは、すべてのパラメーターに null 以外の引数が必要です。unmarshal メソッドは、例外で失敗するか、null 以外の値を返します。
| 修飾子と型 | メソッドと説明 |
|---|---|
static void | marshal(ObjectSE jaxbObject, FileSE xml)Java オブジェクトツリーを XML に書き込み、指定された場所に保存します。 |
static void | marshal(ObjectSE jaxbObject, OutputStreamSE xml)Java オブジェクトツリーを XML に書き込み、指定された場所に保存します。 |
static void | marshal(ObjectSE jaxbObject, ResultSE xml)Java オブジェクトツリーを XML に書き込み、指定された場所に保存します。 |
static void | marshal(ObjectSE jaxbObject, StringSE xml)Java オブジェクトツリーを XML に書き込み、指定された場所に保存します。 |
static void | marshal(ObjectSE jaxbObject, URISE xml)Java オブジェクトツリーを XML に書き込み、指定された場所に保存します。 |
static void | marshal(ObjectSE jaxbObject, URLSE xml)Java オブジェクトツリーを XML に書き込み、指定された場所に保存します。 |
static void | marshal(ObjectSE jaxbObject, WriterSE xml)Java オブジェクトツリーを XML に書き込み、指定された場所に保存します。 |
static <T> T | unmarshal(FileSE xml, ClassSE<T> type) 指定された XML 入力から Java オブジェクトツリーを読み込みます。 |
static <T> T | unmarshal(InputStreamSE xml, ClassSE<T> type) 指定された XML 入力から Java オブジェクトツリーを読み込みます。 |
static <T> T | unmarshal(ReaderSE xml, ClassSE<T> type) 指定された XML 入力から Java オブジェクトツリーを読み込みます。 |
static <T> T | unmarshal(SourceSE xml, ClassSE<T> type) 指定された XML 入力から Java オブジェクトツリーを読み込みます。 |
static <T> T | unmarshal(StringSE xml, ClassSE<T> type) 指定された XML 入力から Java オブジェクトツリーを読み込みます。 |
static <T> T | unmarshal(URISE xml, ClassSE<T> type) 指定された XML 入力から Java オブジェクトツリーを読み込みます。 |
static <T> T | unmarshal(URLSE xml, ClassSE<T> type) 指定された XML 入力から Java オブジェクトツリーを読み込みます。 |
cloneSE, equalsSE, finalizeSE, getClassSE, hashCodeSE, notifySE, notifyAllSE, toStringSE, waitSE, waitSE, waitSEpublic static <T> T unmarshal(FileSE xml, ClassSE<T> type)
xml - ファイル全体を XML として読み取ります。public static <T> T unmarshal(URLSE xml, ClassSE<T> type)
xml - URL が指すリソース全体が読み取られます。public static <T> T unmarshal(URISE xml, ClassSE<T> type)
xml - URI は turned into URLSE であり、その後は URL の処理に従います。public static <T> T unmarshal(StringSE xml, ClassSE<T> type)
xml - 文字列は最初に絶対 URI として解釈されます。a valid absolute URISE でない場合、File として解釈されます public static <T> T unmarshal(InputStreamSE xml, ClassSE<T> type)
xml - ストリーム全体が XML 情報セットとして読み取られます。正常に完了すると、ストリームはこのメソッドによって閉じられます。public static <T> T unmarshal(ReaderSE xml, ClassSE<T> type)
xml - 文字ストリームは XML 情報セットとして読み取られます。XML のエンコーディング宣言は無視されます。正常に完了すると、ストリームはこのメソッドによって閉じられます。public static <T> T unmarshal(SourceSE xml, ClassSE<T> type)
xml - SourceSE が表す XML 情報セットが読み取られます。public static void marshal(ObjectSE jaxbObject, FileSE xml)
jaxbObject - XML にマーシャリングされる Java オブジェクト。このオブジェクトが JAXBElement の場合、ルートタグ名と本文を提供します。このオブジェクトのクラス定義に XmlRootElement がある場合、それがルートタグ名として使用され、指定されたオブジェクトが本文を提供します。それ以外の場合、ルートタグ名は the short class nameSE からの inferedSE です。このパラメーターは null であってはなりません。xml - XML はこのファイルに書き込まれます。すでに存在する場合は上書きされます。DataBindingException - I/O エラーなどで操作が失敗した場合、バインドできないクラス。public static void marshal(ObjectSE jaxbObject, URLSE xml)
jaxbObject - XML にマーシャリングされる Java オブジェクト。このオブジェクトが JAXBElement の場合、ルートタグ名と本文を提供します。このオブジェクトのクラス定義に XmlRootElement がある場合、それがルートタグ名として使用され、指定されたオブジェクトが本文を提供します。それ以外の場合、ルートタグ名は the short class nameSE からの inferedSE です。このパラメーターは null であってはなりません。xml - XML は、この URL が指すリソースへの sentSE になります。すべての URL がそのような操作をサポートしているわけではなく、正確なセマンティクスは URL の実装に依存することに注意してください。HTTP URLsSE の場合、これは HTTP POST を実行します。DataBindingException - I/O エラーなどで操作が失敗した場合、バインドできないクラス。public static void marshal(ObjectSE jaxbObject, URISE xml)
jaxbObject - XML にマーシャリングされる Java オブジェクト。このオブジェクトが JAXBElement の場合、ルートタグ名と本文を提供します。このオブジェクトのクラス定義に XmlRootElement がある場合、それがルートタグ名として使用され、指定されたオブジェクトが本文を提供します。それ以外の場合、ルートタグ名は the short class nameSE からの inferedSE です。このパラメーターは null であってはなりません。xml - URI は turned into URLSE であり、その後は URL の処理に従います。上記を参照。DataBindingException - I/O エラーなどで操作が失敗した場合、バインドできないクラス。public static void marshal(ObjectSE jaxbObject, StringSE xml)
jaxbObject - XML にマーシャリングされる Java オブジェクト。このオブジェクトが JAXBElement の場合、ルートタグ名と本文を提供します。このオブジェクトのクラス定義に XmlRootElement がある場合、それがルートタグ名として使用され、指定されたオブジェクトが本文を提供します。それ以外の場合、ルートタグ名は the short class nameSE からの inferedSE です。このパラメーターは null であってはなりません。xml - 文字列は最初に絶対 URI として解釈されます。a valid absolute URISE でない場合、File として解釈されます DataBindingException - I/O エラーなどで操作が失敗した場合、バインドできないクラス。public static void marshal(ObjectSE jaxbObject, OutputStreamSE xml)
jaxbObject - XML にマーシャリングされる Java オブジェクト。このオブジェクトが JAXBElement の場合、ルートタグ名と本文を提供します。このオブジェクトのクラス定義に XmlRootElement がある場合、それがルートタグ名として使用され、指定されたオブジェクトが本文を提供します。それ以外の場合、ルートタグ名は the short class nameSE からの inferedSE です。このパラメーターは null であってはなりません。xml - XML は指定された OutputStreamSE に送信されます。正常に完了すると、ストリームはこのメソッドによって閉じられます。DataBindingException - I/O エラーなどで操作が失敗した場合、バインドできないクラス。public static void marshal(ObjectSE jaxbObject, WriterSE xml)
jaxbObject - XML にマーシャリングされる Java オブジェクト。このオブジェクトが JAXBElement の場合、ルートタグ名と本文を提供します。このオブジェクトのクラス定義に XmlRootElement がある場合、それがルートタグ名として使用され、指定されたオブジェクトが本文を提供します。それ以外の場合、ルートタグ名は the short class nameSE からの inferedSE です。このパラメーターは null であってはなりません。xml - XML は、指定された WriterSE に文字ストリームとして送信されます。正常に完了すると、ストリームはこのメソッドによって閉じられます。DataBindingException - I/O エラーなどで操作が失敗した場合、バインドできないクラス。public static void marshal(ObjectSE jaxbObject, ResultSE xml)
jaxbObject - XML にマーシャリングされる Java オブジェクト。このオブジェクトが JAXBElement の場合、ルートタグ名と本文を提供します。このオブジェクトのクラス定義に XmlRootElement がある場合、それがルートタグ名として使用され、指定されたオブジェクトが本文を提供します。それ以外の場合、ルートタグ名は the short class nameSE からの inferedSE です。このパラメーターは null であってはなりません。xml - XML は ResultSE オブジェクトに送信されます。DataBindingException - I/O エラーなどで操作が失敗した場合、バインドできないクラス。Copyright © 2018,2020 Eclipse Foundation.
Use is subject to license terms.