public final class JAXB extends ObjectSE
このクラスで定義されているメソッドは、JAXBContext
、Unmarshaller
、Marshaller
のいくつかの基本操作を組み合わせた便利なメソッドです。これらは、Jakarta XML Binding を初めて使用する開発者にとって好ましいメソッドになるように設計されています。それらには次の特徴があります。
DataBindingException
(JAXBException
を cause
SE として持つ) にラップされます。チェックされた例外を好む人は、残りの 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, waitSE
public 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 URL
SE であり、その後は URL
の処理に従います。public static <T> T unmarshal(StringSE xml, ClassSE<T> type)
xml
- 文字列は最初に絶対 URI
として解釈されます。a valid absolute URI
SE でない場合、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
- Source
SE が表す XML 情報セットが読み取られます。public static void marshal(ObjectSE jaxbObject, FileSE xml)
jaxbObject
- XML にマーシャリングされる Java オブジェクト。このオブジェクトが JAXBElement
の場合、ルートタグ名と本文を提供します。このオブジェクトのクラス定義に XmlRootElement
がある場合、それがルートタグ名として使用され、指定されたオブジェクトが本文を提供します。それ以外の場合、ルートタグ名は the short class name
SE からの infered
SE です。このパラメーターは null であってはなりません。xml
- XML はこのファイルに書き込まれます。すでに存在する場合は上書きされます。DataBindingException
- I/O エラーなどで操作が失敗した場合、バインドできないクラス。public static void marshal(ObjectSE jaxbObject, URLSE xml)
jaxbObject
- XML にマーシャリングされる Java オブジェクト。このオブジェクトが JAXBElement
の場合、ルートタグ名と本文を提供します。このオブジェクトのクラス定義に XmlRootElement
がある場合、それがルートタグ名として使用され、指定されたオブジェクトが本文を提供します。それ以外の場合、ルートタグ名は the short class name
SE からの infered
SE です。このパラメーターは null であってはなりません。xml
- XML は、この URL が指すリソースへの sent
SE になります。すべての URL
がそのような操作をサポートしているわけではなく、正確なセマンティクスは URL
の実装に依存することに注意してください。HTTP URLs
SE の場合、これは HTTP POST を実行します。DataBindingException
- I/O エラーなどで操作が失敗した場合、バインドできないクラス。public static void marshal(ObjectSE jaxbObject, URISE xml)
jaxbObject
- XML にマーシャリングされる Java オブジェクト。このオブジェクトが JAXBElement
の場合、ルートタグ名と本文を提供します。このオブジェクトのクラス定義に XmlRootElement
がある場合、それがルートタグ名として使用され、指定されたオブジェクトが本文を提供します。それ以外の場合、ルートタグ名は the short class name
SE からの infered
SE です。このパラメーターは null であってはなりません。xml
- URI は turned into URL
SE であり、その後は URL
の処理に従います。上記を参照。DataBindingException
- I/O エラーなどで操作が失敗した場合、バインドできないクラス。public static void marshal(ObjectSE jaxbObject, StringSE xml)
jaxbObject
- XML にマーシャリングされる Java オブジェクト。このオブジェクトが JAXBElement
の場合、ルートタグ名と本文を提供します。このオブジェクトのクラス定義に XmlRootElement
がある場合、それがルートタグ名として使用され、指定されたオブジェクトが本文を提供します。それ以外の場合、ルートタグ名は the short class name
SE からの infered
SE です。このパラメーターは null であってはなりません。xml
- 文字列は最初に絶対 URI
として解釈されます。a valid absolute URI
SE でない場合、File
として解釈されます DataBindingException
- I/O エラーなどで操作が失敗した場合、バインドできないクラス。public static void marshal(ObjectSE jaxbObject, OutputStreamSE xml)
jaxbObject
- XML にマーシャリングされる Java オブジェクト。このオブジェクトが JAXBElement
の場合、ルートタグ名と本文を提供します。このオブジェクトのクラス定義に XmlRootElement
がある場合、それがルートタグ名として使用され、指定されたオブジェクトが本文を提供します。それ以外の場合、ルートタグ名は the short class name
SE からの infered
SE です。このパラメーターは null であってはなりません。xml
- XML は指定された OutputStream
SE に送信されます。正常に完了すると、ストリームはこのメソッドによって閉じられます。DataBindingException
- I/O エラーなどで操作が失敗した場合、バインドできないクラス。public static void marshal(ObjectSE jaxbObject, WriterSE xml)
jaxbObject
- XML にマーシャリングされる Java オブジェクト。このオブジェクトが JAXBElement
の場合、ルートタグ名と本文を提供します。このオブジェクトのクラス定義に XmlRootElement
がある場合、それがルートタグ名として使用され、指定されたオブジェクトが本文を提供します。それ以外の場合、ルートタグ名は the short class name
SE からの infered
SE です。このパラメーターは null であってはなりません。xml
- XML は、指定された Writer
SE に文字ストリームとして送信されます。正常に完了すると、ストリームはこのメソッドによって閉じられます。DataBindingException
- I/O エラーなどで操作が失敗した場合、バインドできないクラス。public static void marshal(ObjectSE jaxbObject, ResultSE xml)
jaxbObject
- XML にマーシャリングされる Java オブジェクト。このオブジェクトが JAXBElement
の場合、ルートタグ名と本文を提供します。このオブジェクトのクラス定義に XmlRootElement
がある場合、それがルートタグ名として使用され、指定されたオブジェクトが本文を提供します。それ以外の場合、ルートタグ名は the short class name
SE からの infered
SE です。このパラメーターは null であってはなりません。xml
- XML は Result
SE オブジェクトに送信されます。DataBindingException
- I/O エラーなどで操作が失敗した場合、バインドできないクラス。Copyright © 2018,2020 Eclipse Foundation.
Use is subject to license terms.