public final class JAXB extends Object
このクラスで定義されるメソッドは、JAXBContext
、Unmarshaller
、およびMarshaller
のいくつかの基本オペレーションが組み合わされた簡易メソッドです。 これらのメソッドは、JAXBを使い始めたばかりの開発者に最適なメソッドとなるように設計されています。 次の特徴があります。
JAXBException
がそのcause
となる) DataBindingException
にラップされます。 チェック例外を好むユーザーは残りのJAXB APIを直接使用するものと想定されています。
また、unmarshalメソッドには次の特徴があります。
DataBindingException
を生成して失敗します。
同様に、marshalメソッドには次の特徴があります。
DataBindingException
を生成して失敗します。
このクラスのすべてのメソッドでは、すべてのパラメータにnull以外の引数が必要です。 unmarshalメソッドは例外を生成して失敗するか、null以外の値を返します。
修飾子と型 | メソッド | 説明 |
---|---|---|
static void |
marshal(Object jaxbObject, File xml) |
Javaオブジェクト・ツリーをXMLに書き込み、指定された場所に格納します。
|
static void |
marshal(Object jaxbObject, OutputStream xml) |
Javaオブジェクト・ツリーをXMLに書き込み、指定された場所に格納します。
|
static void |
marshal(Object jaxbObject, Result xml) |
Javaオブジェクト・ツリーをXMLに書き込み、指定された場所に格納します。
|
static void |
marshal(Object jaxbObject, String xml) |
Javaオブジェクト・ツリーをXMLに書き込み、指定された場所に格納します。
|
static void |
marshal(Object jaxbObject, URI xml) |
Javaオブジェクト・ツリーをXMLに書き込み、指定された場所に格納します。
|
static void |
marshal(Object jaxbObject, URL xml) |
Javaオブジェクト・ツリーをXMLに書き込み、指定された場所に格納します。
|
static void |
marshal(Object jaxbObject, Writer xml) |
Javaオブジェクト・ツリーをXMLに書き込み、指定された場所に格納します。
|
static <T> T |
unmarshal(File xml, Class<T> type) |
指定されたXML入力からJavaオブジェクト・ツリーを読み込みます。
|
static <T> T |
unmarshal(InputStream xml, Class<T> type) |
指定されたXML入力からJavaオブジェクト・ツリーを読み込みます。
|
static <T> T |
unmarshal(Reader xml, Class<T> type) |
指定されたXML入力からJavaオブジェクト・ツリーを読み込みます。
|
static <T> T |
unmarshal(Source xml, Class<T> type) |
指定されたXML入力からJavaオブジェクト・ツリーを読み込みます。
|
static <T> T |
unmarshal(String xml, Class<T> type) |
指定されたXML入力からJavaオブジェクト・ツリーを読み込みます。
|
static <T> T |
unmarshal(URI xml, Class<T> type) |
指定されたXML入力からJavaオブジェクト・ツリーを読み込みます。
|
static <T> T |
unmarshal(URL xml, Class<T> type) |
指定されたXML入力からJavaオブジェクト・ツリーを読み込みます。
|
public static <T> T unmarshal(File xml, Class<T> type)
xml
- ファイル全体がXMLとして読み込まれる。public static <T> T unmarshal(URL xml, Class<T> type)
xml
- URLで示されるリソース全体が読み込まれる。public static <T> T unmarshal(URI xml, Class<T> type)
xml
- URIがturned into URL
、そのあとでURLの処理が実行される。public static <T> T unmarshal(String xml, Class<T> type)
xml
- 文字列は、最初に絶対URIと解釈される。 a valid absolute URI
でない場合は、Fileと解釈される public static <T> T unmarshal(InputStream xml, Class<T> type)
xml
- ストリーム全体がXML情報セットとして読み込まれる。 正常に完了した時点で、このメソッドによってストリームが閉じられる。 public static <T> T unmarshal(Reader xml, Class<T> type)
xml
- 文字ストリームがXML情報セットとして読み込まれる。 XMLのエンコーディング宣言は無視される。 正常に完了した時点で、このメソッドによってストリームが閉じられる。 public static <T> T unmarshal(Source xml, Class<T> type)
xml
- Source
で示されるXML情報セットが読み込まれる。public static void marshal(Object jaxbObject, File xml)
jaxbObject
- XMLに整列化するJavaオブジェクト。 このオブジェクトがJAXBElement
の場合は、それがルート・タグ名と本体を提供する。 このオブジェクトのクラス定義にXmlRootElement
が含まれている場合は、それがルート・タグ名として使用され、指定されたオブジェクトが本体を提供する。 それ以外の場合は、ルート・タグ名はinfered
からthe short class name
。 このパラメータはnullであってはならない。 xml
- XMLはこのファイルに書き込まれる。 すでに存在する場合は上書きされる。 DataBindingException
- 入出力エラーやバインド不可のクラスなどのために、操作が失敗した場合。public static void marshal(Object jaxbObject, URL xml)
jaxbObject
- XMLに整列化するJavaオブジェクト。 このオブジェクトがJAXBElement
の場合は、それがルート・タグ名と本体を提供する。 このオブジェクトのクラス定義にXmlRootElement
が含まれている場合は、それがルート・タグ名として使用され、指定されたオブジェクトが本体を提供する。 それ以外の場合は、ルート・タグ名はinfered
からthe short class name
。 このパラメータはnullであってはならない。 xml
- XMLはこのURLで示されるソースにsent
される。 すべてのURLがそのようなオペレーションをサポートするとは限らず、正確なセマンティックスはURLの実装によって異なる。 HTTP URLs
の場合は、HTTP POSTを実行する。 DataBindingException
- 入出力エラーやバインド不可のクラスなどのために、操作が失敗した場合。public static void marshal(Object jaxbObject, URI xml)
jaxbObject
- XMLに整列化するJavaオブジェクト。 このオブジェクトがJAXBElement
の場合は、それがルート・タグ名と本体を提供する。 このオブジェクトのクラス定義にXmlRootElement
が含まれている場合は、それがルート・タグ名として使用され、指定されたオブジェクトが本体を提供する。 それ以外の場合は、ルート・タグ名はinfered
からthe short class name
。 このパラメータはnullであってはならない。 xml
- URIがturned into URL
、そのあとでURLの処理が実行される。 (上述を参照) DataBindingException
- 入出力エラーやバインド不可のクラスなどのために、操作が失敗した場合。public static void marshal(Object jaxbObject, String xml)
jaxbObject
- XMLに整列化するJavaオブジェクト。 このオブジェクトがJAXBElement
の場合は、それがルート・タグ名と本体を提供する。 このオブジェクトのクラス定義にXmlRootElement
が含まれている場合は、それがルート・タグ名として使用され、指定されたオブジェクトが本体を提供する。 それ以外の場合は、ルート・タグ名はinfered
からthe short class name
。 このパラメータはnullであってはならない。 xml
- 文字列は、最初に絶対URIと解釈される。 a valid absolute URI
でない場合は、Fileと解釈される DataBindingException
- 入出力エラーやバインド不可のクラスなどのために、操作が失敗した場合。public static void marshal(Object jaxbObject, OutputStream xml)
jaxbObject
- XMLに整列化するJavaオブジェクト。 このオブジェクトがJAXBElement
の場合は、それがルート・タグ名と本体を提供する。 このオブジェクトのクラス定義にXmlRootElement
が含まれている場合は、それがルート・タグ名として使用され、指定されたオブジェクトが本体を提供する。 それ以外の場合は、ルート・タグ名はinfered
からthe short class name
。 このパラメータはnullであってはならない。 xml
- XMLは指定されたOutputStream
に送信される。 正常に完了した時点で、このメソッドによってストリームが閉じられる。 DataBindingException
- 入出力エラーやバインド不可のクラスなどのために、操作が失敗した場合。public static void marshal(Object jaxbObject, Writer xml)
jaxbObject
- XMLに整列化するJavaオブジェクト。 このオブジェクトがJAXBElement
の場合は、それがルート・タグ名と本体を提供する。 このオブジェクトのクラス定義にXmlRootElement
が含まれている場合は、それがルート・タグ名として使用され、指定されたオブジェクトが本体を提供する。 それ以外の場合は、ルート・タグ名はinfered
からthe short class name
。 このパラメータはnullであってはならない。 xml
- XMLは指定されたWriter
に文字ストリームとして送信される。 正常に完了した時点で、このメソッドによってストリームが閉じられる。 DataBindingException
- 入出力エラーやバインド不可のクラスなどのために、操作が失敗した場合。public static void marshal(Object jaxbObject, Result xml)
jaxbObject
- XMLに整列化するJavaオブジェクト。 このオブジェクトがJAXBElement
の場合は、それがルート・タグ名と本体を提供する。 このオブジェクトのクラス定義にXmlRootElement
が含まれている場合は、それがルート・タグ名として使用され、指定されたオブジェクトが本体を提供する。 それ以外の場合は、ルート・タグ名はinfered
からthe short class name
。 このパラメータはnullであってはならない。 xml
- XMLはResult
オブジェクトに送信される。DataBindingException
- 入出力エラーやバインド不可のクラスなどのために、操作が失敗した場合。 バグまたは機能を送信
詳細なAPIリファレンスおよび開発者ドキュメントについては、Java SEのドキュメントを参照してください。 そのドキュメントには、概念的な概要、用語の定義、回避方法、有効なコード例などの、開発者を対象にしたより詳細な説明が含まれています。
Copyright © 1993, 2025, Oracle and/or its affiliates. All rights reserved. Use is subject to license terms. Documentation Redistribution Policyも参照してください。