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, 2017, Oracle and/or its affiliates. All rights reserved. Use is subject to license terms. Documentation Redistribution Policyも参照してください。