パッケージ jakarta.xml.bind
インターフェース JAXBContextFactory
public interface JAXBContextFactory新しい
JAXBContextインスタンスを作成するファクトリ。JAXBContextFactory はServiceLoader.load(Class)SE を使用して見つけることができます- 導入:
- 9、JAXB 2.3
メソッドのサマリー
すべてのメソッド インスタンスメソッド 抽象メソッド 修飾子と型 メソッド 説明 JAXBContextcreateContext(ClassSE<?>[] classesToBeBound, MapSE<StringSE,?> properties)JAXBContextクラスの新しいインスタンスを作成します。JAXBContextcreateContext(StringSE contextPath, ClassLoaderSE classLoader, MapSE<StringSE,?> properties)JAXBContextクラスの新しいインスタンスを作成します。
メソッドの詳細
createContext
JAXBContext createContext(ClassSE<?>[] classesToBeBound, MapSE<StringSE,?> properties) throws JAXBException
JAXBContextクラスの新しいインスタンスを作成します。セマンティクスについては、
JAXBContext.newInstance(Class[], java.util.Map)を参照してください- パラメーター:
classesToBeBound- 新しいJAXBContextによって認識される java クラスのリスト。名前付きモジュールにあるclassesToBeBoundのクラスは、少なくともjakarta.xml.bindモジュールに対してopenであるパッケージに含まれている必要があります。空にすることができます。その場合、仕様で定義されたクラスについてのみ知っているJAXBContextが返されます。properties- プロバイダー固有のプロパティ。null にすることができます。これは、空のマップを渡すのと同じことを意味します。- 戻り値:
JAXBContextの新しいインスタンス。- 例外:
JAXBException-JAXBContextの作成中に次のようなエラーが発生した場合(ただしこれらに限定されません):- Jakarta XML Binding の実装は発見されませんでした
- クラスが Jakarta XML Binding アノテーションを誤って使用する
- クラスには衝突するアノテーションがあります (つまり、同じ型名の 2 つのクラス)
- Jakarta XML Binding 実装は、プロバイダー固有の帯域外情報を見つけることができませんでした (開発時に生成された追加ファイルなど。)
classesToBeBoundはjakarta.xml.bindモジュールに対して開かれていません
IllegalArgumentExceptionSE- パラメーターにnullが含まれている場合 (つまり、newInstance(null,someMap);)- 導入:
- 9、JAXB 2.3
createContext
JAXBContext createContext(StringSE contextPath, ClassLoaderSE classLoader, MapSE<StringSE,?> properties) throws JAXBException
JAXBContextクラスの新しいインスタンスを作成します。セマンティクスについては、
JAXBContext.newInstance(String, ClassLoader, java.util.Map)を参照してくださいプロパティの解釈は実装次第です。実装は、理解できないプロパティを見つけた場合、
JAXBExceptionをスローする必要があります。- パラメーター:
contextPath- スキーマ派生クラスを含む java パッケージ名のリスト。名前付きモジュールにあるclassesToBeBoundのクラスは、少なくともjakarta.xml.bindモジュールに対してopenであるパッケージに含まれている必要があります。classLoader- このクラスローダーは、実装クラスを見つけるために使用されます。properties- プロバイダー固有のプロパティ。null にすることができます。これは、空のマップを渡すのと同じことを意味します。- 戻り値:
JAXBContextの新しいインスタンス- 例外:
JAXBException-JAXBContextの作成中に次のようなエラーが発生した場合- パッケージ内で ObjectFactory.class または jaxb.index のいずれかが見つからない
- contextPath に含まれるグローバル要素間の曖昧さ
- コンテキストファクトリプロバイダープロパティの値が見つからない
- 同じ contextPath 上で異なるプロバイダからのスキーマ派生パッケージを混在させる
- パッケージは
jakarta.xml.bindモジュールに対して開かれていません
- 導入:
- 9、JAXB 2.3