パッケージ jakarta.xml.bind
インターフェース JAXBContextFactory
public interface JAXBContextFactory
新しい
JAXBContext
インスタンスを作成するファクトリ。JAXBContextFactory はServiceLoader.load(Class)
SE を使用して見つけることができます- 導入:
- 9、JAXB 2.3
メソッドのサマリー
すべてのメソッド インスタンスメソッド 抽象メソッド 修飾子と型 メソッド 説明 JAXBContext
createContext(ClassSE<?>[] classesToBeBound, MapSE<StringSE,?> properties)
JAXBContext
クラスの新しいインスタンスを作成します。JAXBContext
createContext(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