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