Jaxb2Marshaller (Spring Framework 5.1.1.RELEASE API)

java.lang.Object
- org.springframework.oxm.jaxb.Jaxb2Marshaller

実装済みのインターフェース一覧:
Aware, BeanClassLoaderAware, InitializingBean, GenericMarshaller, GenericUnmarshaller, Marshaller, MimeMarshaller, MimeUnmarshaller, Unmarshaller
```
public class Jaxb2Marshaller
extends java.lang.Object
implements MimeMarshaller, MimeUnmarshaller, GenericMarshaller, GenericUnmarshaller, BeanClassLoaderAware, InitializingBean
```
JAXB 2.2 用の GenericMarshaller インターフェースの実装。
典型的な使用箇所は、この Bean に "contextPath" または "classesToBeBound" プロパティを設定し、プロパティ、スキーマ、アダプター、リスナーを設定してマーシャラーとアンマーシャラーをカスタマイズし、それを参照することです。
導入:
3.0
作成者:
Arjen Poutsma, Juergen Hoeller, Rossen Stoyanchev
関連事項:
setContextPath(String), setClassesToBeBound(Class[]), setJaxbContextProperties(Map), setMarshallerProperties(Map), setUnmarshallerProperties(Map), setSchema(Resource), setSchemas(Resource[]), setMarshallerListener(javax.xml.bind.Marshaller.Listener), setUnmarshallerListener(javax.xml.bind.Unmarshaller.Listener), setAdapters(XmlAdapter[])

フィールド概要
フィールド
修飾子と型フィールドと説明
protected Log logger
サブクラスで利用可能なロガー。

フィールド
修飾子と型	フィールドと説明
`protected Log`	`logger` サブクラスで利用可能なロガー。

コンストラクター概要
コンストラクター
コンストラクターと説明
Jaxb2Marshaller()

コンストラクター
コンストラクターと説明
`Jaxb2Marshaller()`

方法の概要

すべてのメソッドインスタンスメソッド具象メソッド
修飾子と型	メソッドと説明
`void`	`afterPropertiesSet()` すべての Bean プロパティを設定し、`BeanFactoryAware`、`ApplicationContextAware` などを満たした後、包含 `BeanFactory` によって呼び出されます。
`protected XmlMappingException`	`convertJaxbException(JAXBExceptionEE ex)` 指定された `JAXBException` を `org.springframework.oxm` 階層からの適切な例外に変換します。
`protected MarshallerEE`	`createMarshaller()` 新しく作成された JAXB マーシャラーを返します。
`protected UnmarshallerEE`	`createUnmarshaller()` 新しく作成された JAXB アンマーシャラーを返します。
`java.lang.Class<?>[]`	`getClassesToBeBound()` 新しく作成された JAXBContext によって認識される Java クラスのリストを返します。
`java.lang.String`	`getContextPath()` JAXB コンテキストパスを返します。
`JAXBContextEE`	`getJaxbContext()` このマーシャラーが使用する JAXBContext を返し、必要に応じて遅延ビルドします。
`java.lang.String[]`	`getPackagesToScan()` JAXB2 アノテーションを検索するパッケージを返します。
`protected void`	`initJaxbMarshaller(MarshallerEE marshaller)` カスタム初期化動作のために具体的な JAXB マーシャラーによってオーバーライドできるテンプレートメソッド。
`protected void`	`initJaxbUnmarshaller(UnmarshallerEE unmarshaller)` カスタム初期化動作のために具体的な JAXB マーシャラーによってオーバーライドできるテンプレートメソッド。
`boolean`	`isProcessExternalEntities()` XML 外部エンティティを許可するかどうかの構成値を返します。
`boolean`	`isSupportDtd()` DTD 解析がサポートされているかどうか。
`void`	`marshal(java.lang.Object graph, javax.xml.transform.Result result)` 指定されたルートを持つオブジェクトグラフを提供された `Result` にマーシャリングします。
`void`	`marshal(java.lang.Object graph, javax.xml.transform.Result result, MimeContainer mimeContainer)` 指定されたルートを持つオブジェクトグラフを提供された `Result` にマーシャリングし、バイナリデータを `MimeContainer` に書き込みます。
`void`	`setAdapters(XmlAdapterEE<?,?>... adapters)` JAXB `Marshaller` および `Unmarshaller` に登録する `XmlAdapter` を指定します。
`void`	`setBeanClassLoader(java.lang.ClassLoader classLoader)` Bean `class loader` を Bean インスタンスに提供するコールバック。
`void`	`setCheckForXmlRootElement(boolean checkForXmlRootElement)` `supports(Class)` が `@XmlRootElement`EE アノテーションをチェックするかどうかを指定します。
`void`	`setClassesToBeBound(java.lang.Class<?>... classesToBeBound)` Java クラスのリストを、新しく作成された JAXBContext によって認識されるように設定します。
`void`	`setContextPath(java.lang.String contextPath)` JAXB コンテキストパスを設定します。
`void`	`setContextPaths(java.lang.String... contextPaths)` 複数の JAXB コンテキストパスを設定します。
`void`	`setJaxbContextProperties(java.util.Map<java.lang.String,?> jaxbContextProperties)` `JAXBContext` プロパティを設定します。
`void`	`setLazyInit(boolean lazyInit)` このマーシャラーの `JAXBContext`EE を遅延初期化するかどうかを設定します。
`void`	`setMappedClass(java.lang.Class<?> mappedClass)` 部分的な非整列化のための JAXB マップクラスを指定します。
`void`	`setMarshallerListener(Marshaller.ListenerEE marshallerListener)` JAXB `Marshaller` に登録する `Marshaller.Listener` を指定します。
`void`	`setMarshallerProperties(java.util.Map<java.lang.String,?> properties)` JAXB `Marshaller` プロパティを設定します。
`void`	`setMtomEnabled(boolean mtomEnabled)` MTOM サポートを有効にするかどうかを指定します。
`void`	`setPackagesToScan(java.lang.String... packagesToScan)` クラスパスに JAXB2 アノテーションを含むクラスを検索するようにパッケージを設定します。
`void`	`setProcessExternalEntities(boolean processExternalEntities)` 非整列化時に外部 XML エンティティが処理されるかどうかを示します。
`void`	`setSchema(Resource schemaResource)` 検証に使用するスキーマリソースを設定します。
`void`	`setSchemaLanguage(java.lang.String schemaLanguage)` スキーマ言語を設定します。
`void`	`setSchemaResourceResolver(org.w3c.dom.ls.LSResourceResolver schemaResourceResolver)` スキーマリソースのロードに使用されるリソースリゾルバーを設定します。
`void`	`setSchemas(Resource... schemaResources)` 検証に使用するスキーマリソースを設定します。
`void`	`setSupportDtd(boolean supportDtd)` DTD 解析をサポートする必要があるかどうかを示します。
`void`	`setSupportJaxbElementClass(boolean supportJaxbElementClass)` `supports(Class)` が `JAXBElement`EE クラスの `true` を返すかどうかを指定します。
`void`	`setUnmarshallerListener(Unmarshaller.ListenerEE unmarshallerListener)` `Unmarshaller.Listener` が JAXB `Unmarshaller` に登録されるように設定します。
`void`	`setUnmarshallerProperties(java.util.Map<java.lang.String,?> properties)` JAXB `Unmarshaller` プロパティを設定します。
`void`	`setValidationEventHandler(ValidationEventHandlerEE validationEventHandler)` JAXB 検証イベントハンドラーを設定します。
`boolean`	`supports(java.lang.Class<?> clazz)` このマーシャラーが、指定された型のインスタンスをマーシャリングできるかどうかを示します。
`boolean`	`supports(java.lang.reflect.Type genericType)` このマーシャラーが、指定されたジェネリクス型のインスタンスをマーシャリングできるかどうかを示します。
`java.lang.Object`	`unmarshal(javax.xml.transform.Source source)` 指定された `Source` をオブジェクトグラフに非整列化します。
`java.lang.Object`	`unmarshal(javax.xml.transform.Source source, MimeContainer mimeContainer)` 指定された `Source` をオブジェクトグラフに非整列化し、`MimeContainer` からバイナリ添付ファイルを読み取ります。
`protected java.lang.Object`	`unmarshalStaxSource(UnmarshallerEE jaxbUnmarshaller, javax.xml.transform.Source staxSource)`

クラス java.lang.Object から継承されたメソッド
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- フィールドの詳細
  - logger
```
protected final Log logger
```
    サブクラスで利用可能なロガー。
- コンストラクターの詳細
  - Jaxb2Marshaller
```
public Jaxb2Marshaller()
```
- メソッドの詳細
  - setContextPaths
```
public void setContextPaths(java.lang.String... contextPaths)
```
    複数の JAXB コンテキストパスを設定します。コンテキストパスの指定された配列は、JAXB でサポートされているように、コロン区切りの文字列に変換されます。
  - setContextPath
```
public void setContextPath(@Nullable
                           java.lang.String contextPath)
```
    JAXB コンテキストパスを設定します。
    このプロパティを設定するには、"classesToBeBound" または "packagesToScan" が必要です。
  - getContextPath
```
@Nullable
public java.lang.String getContextPath()
```
    JAXB コンテキストパスを返します。
  - setClassesToBeBound
```
public void setClassesToBeBound(@Nullable
                                java.lang.Class<?>... classesToBeBound)
```
    Java クラスのリストを、新しく作成された JAXBContext によって認識されるように設定します。
    このプロパティを設定するには、"contextPath" または "packagesToScan" が必要です。
  - getClassesToBeBound
```
@Nullable
public java.lang.Class<?>[] getClassesToBeBound()
```
    新しく作成された JAXBContext によって認識される Java クラスのリストを返します。
  - setPackagesToScan
```
public void setPackagesToScan(@Nullable
                              java.lang.String... packagesToScan)
```
    クラスパスに JAXB2 アノテーションが付いたクラスを検索するようにパッケージを設定します。これは Spring ベースの検索を使用しているため、Spring のコンポーネントスキャン機能（ClassPathBeanDefinitionScanner）に類似しています。
    このプロパティを設定するには、"contextPath" または "classesToBeBound" が必要です。
  - getPackagesToScan
```
@Nullable
public java.lang.String[] getPackagesToScan()
```
    JAXB2 アノテーションを検索するパッケージを返します。
  - setJaxbContextProperties
```
public void setJaxbContextProperties(java.util.Map<java.lang.String,?> jaxbContextProperties)
```
    JAXBContext プロパティを設定します。これらの実装固有のプロパティは、基になる JAXBContext に設定されます。
  - setMarshallerProperties
```
public void setMarshallerProperties(java.util.Map<java.lang.String,?> properties)
```
    JAXB Marshaller プロパティを設定します。これらのプロパティは、基礎となる JAXB Marshaller で設定され、インデントなどの機能を可能にします。
    パラメーター:
    properties - プロパティ
    関連事項:
    Marshaller.setProperty(String, Object)EE, Marshaller.JAXB_ENCODINGEE, Marshaller.JAXB_FORMATTED_OUTPUTEE, Marshaller.JAXB_NO_NAMESPACE_SCHEMA_LOCATIONEE, Marshaller.JAXB_SCHEMA_LOCATIONEE
  - setUnmarshallerProperties
```
public void setUnmarshallerProperties(java.util.Map<java.lang.String,?> properties)
```
    JAXB Unmarshaller プロパティを設定します。これらのプロパティは、基礎となる JAXB Unmarshaller で設定されます。
    パラメーター:
    properties - プロパティ
    関連事項:
    Unmarshaller.setProperty(String, Object)EE
  - setMarshallerListener
```
public void setMarshallerListener(Marshaller.ListenerEE marshallerListener)
```
    JAXB Marshaller に登録する Marshaller.Listener を指定します。
  - setUnmarshallerListener
```
public void setUnmarshallerListener(Unmarshaller.ListenerEE unmarshallerListener)
```
    Unmarshaller.Listener が JAXB Unmarshaller に登録されるように設定します。
  - setValidationEventHandler
```
public void setValidationEventHandler(ValidationEventHandlerEE validationEventHandler)
```
    JAXB 検証イベントハンドラーを設定します。このイベントハンドラーは、マーシャリング API の呼び出し中に検証エラーが発生した場合に JAXB によって呼び出されます。
  - setAdapters
```
public void setAdapters(XmlAdapterEE<?,?>... adapters)
```
    JAXB Marshaller および Unmarshaller に登録する XmlAdapter を指定します。
  - setSchema
```
public void setSchema(Resource schemaResource)
```
    検証に使用するスキーマリソースを設定します。
  - setSchemas
```
public void setSchemas(Resource... schemaResources)
```
    検証に使用するスキーマリソースを設定します。
  - setSchemaLanguage
```
public void setSchemaLanguage(java.lang.String schemaLanguage)
```
    スキーマ言語を設定します。デフォルトは W3C XML スキーマ: http://www.w3.org/2001/XMLSchema" です。
    関連事項:
    XMLConstants.W3C_XML_SCHEMA_NS_URI, XMLConstants.RELAXNG_NS_URI
  - setSchemaResourceResolver
```
public void setSchemaResourceResolver(org.w3c.dom.ls.LSResourceResolver schemaResourceResolver)
```
    スキーマリソースのロードに使用されるリソースリゾルバーを設定します。
    関連事項:
    SchemaFactory.setResourceResolver(org.w3c.dom.ls.LSResourceResolver), setSchema(Resource), setSchemas(Resource[])
  - setLazyInit
```
public void setLazyInit(boolean lazyInit)
```
    このマーシャラーの JAXBContextEE を遅延初期化するかどうかを設定します。デフォルトは、起動時に初期化する false です。true に切り替えることができます。
    初期化は、afterPropertiesSet() が呼び出された場合にのみ適用されます。
  - setMtomEnabled
```
public void setMtomEnabled(boolean mtomEnabled)
```
    MTOM サポートを有効にするかどうかを指定します。デフォルトは false です。XOP/ MTOM を使用したマーシャリングは有効になっていません。
  - setSupportJaxbElementClass
```
public void setSupportJaxbElementClass(boolean supportJaxbElementClass)
```
    supports(Class) が JAXBElementEE クラスの true を返すかどうかを指定します。
    デフォルトは false です。つまり、supports(Class) は JAXBElement クラスに対して常に false を返します（ただし、supports(Type) は JAXBElement の型パラメーターを取得できるため、true を返すことができます）。
    ModelAndView は実行時に型パラメーター情報を提供しないため、このプロパティは通常、MarshallingView などのクラスの使用と組み合わせて有効になります。
    関連事項:
    supports(Class), supports(Type)
  - setCheckForXmlRootElement
```
public void setCheckForXmlRootElement(boolean checkForXmlRootElement)
```
    supports(Class) が @XmlRootElementEE アノテーションをチェックするかどうかを指定します。
    デフォルトは true です。つまり、supports(Class) はこのアノテーションをチェックします。ただし、一部の JAXB 実装（EclipseLink MOXy など）では、外部定義ファイルでバインディングを定義できるため、クラスアノテーションを自由に保つことができます。このプロパティを false に設定すると、これらの JAXB 実装がサポートされます。
    関連事項:
    supports(Class), supports(Type)
  - setMappedClass
```
public void setMappedClass(java.lang.Class<?> mappedClass)
```
    部分的な非整列化のための JAXB マップクラスを指定します。
    関連事項:
    Unmarshaller.unmarshal(javax.xml.transform.Source, Class)EE
  - setSupportDtd
```
public void setSupportDtd(boolean supportDtd)
```
    DTD 解析をサポートする必要があるかどうかを示します。
    デフォルトは false で、DTD が無効になっています。
  - isSupportDtd
```
public boolean isSupportDtd()
```
    DTD 解析がサポートされているかどうか。
  - setProcessExternalEntities
```
public void setProcessExternalEntities(boolean processExternalEntities)
```
    非整列化時に外部 XML エンティティが処理されるかどうかを示します。
    デフォルトは false です。これは、外部エンティティが解決されないことを意味します。unmarshal(Source) に渡される Source が SAXSource または StreamSource である場合にのみ、外部エンティティの処理が有効または無効になることに注意してください。DOMSource または StAXSource インスタンスには影響しません。
    注意 : このオプションを true に設定すると、setSupportDtd(boolean) が true に自動的に設定されます。
  - isProcessExternalEntities
```
public boolean isProcessExternalEntities()
```
    XML 外部エンティティを許可するかどうかの構成値を返します。
  - setBeanClassLoader
```
public void setBeanClassLoader(java.lang.ClassLoader classLoader)
```
    インターフェースからコピーされた説明: BeanClassLoaderAware
    Bean class loader を Bean インスタンスに提供するコールバック。
    通常の Bean プロパティの設定後、ただし InitializingBean's InitializingBean.afterPropertiesSet() メソッドやカスタム init-method などの初期化コールバックの前に呼び出されます。
    次で指定:
    インターフェース BeanClassLoaderAware 内の setBeanClassLoader
    パラメーター:
    classLoader - 所有クラスローダー
  - afterPropertiesSet
```
public void afterPropertiesSet()
                        throws java.lang.Exception
```
    インターフェースからコピーされた説明: InitializingBean
    すべての Bean プロパティを設定し、BeanFactoryAware、ApplicationContextAware などを満たした後、包含 BeanFactory によって呼び出されます。
    このメソッドにより、Bean インスタンスは、すべての Bean プロパティが設定されたときに、その全体的な構成の検証と最終的な初期化を実行できます。
    次で指定:
    インターフェース InitializingBean 内の afterPropertiesSet
    例外:
    java.lang.Exception - 構成の誤り（必須プロパティの設定の失敗など）の場合、またはその他の理由で初期化が失敗した場合
  - getJaxbContext
```
public JAXBContextEE getJaxbContext()
```
    このマーシャラーが使用する JAXBContext を返し、必要に応じて遅延ビルドします。
  - supports
```
public boolean supports(java.lang.Class<?> clazz)
```
    インターフェースからコピーされた説明: Marshaller
    このマーシャラーが、指定された型のインスタンスをマーシャリングできるかどうかを示します。
    次で指定:
    インターフェース Marshaller 内の supports
    次で指定:
    インターフェース Unmarshaller 内の supports
    パラメーター:
    clazz - このマーシャラーがマーシャリングできるかどうか尋ねられているクラス
    戻り値:
    このマーシャラーが実際に提供されたクラスのインスタンスをマーシャリングできる場合は true。それ以外の場合は false
  - supports
```
public boolean supports(java.lang.reflect.Type genericType)
```
    インターフェースからコピーされた説明: GenericMarshaller
    このマーシャラーが、指定されたジェネリクス型のインスタンスをマーシャリングできるかどうかを示します。
    次で指定:
    インターフェース GenericMarshaller 内の supports
    次で指定:
    インターフェース GenericUnmarshaller 内の supports
    パラメーター:
    genericType - このマーシャラーがマーシャリングできるかどうか尋ねられている型
    戻り値:
    このマーシャラーが実際に提供された型のインスタンスをマーシャリングできる場合は true。それ以外の場合は false
  - marshal
```
public void marshal(java.lang.Object graph,
                    javax.xml.transform.Result result)
             throws XmlMappingException
```
    インターフェースからコピーされた説明: Marshaller
    指定されたルートを持つオブジェクトグラフを提供された Result にマーシャリングします。
    次で指定:
    インターフェース Marshaller 内の marshal
    パラメーター:
    graph - マーシャリングするオブジェクトグラフのルート
    result - マーシャリングする結果
    例外:
    XmlMappingException - 指定されたオブジェクトを結果に整列化できない場合
  - marshal
```
public void marshal(java.lang.Object graph,
                    javax.xml.transform.Result result,
                    @Nullable
                    MimeContainer mimeContainer)
             throws XmlMappingException
```
    インターフェースからコピーされた説明: MimeMarshaller
    指定されたルートを持つオブジェクトグラフを提供された Result にマーシャリングし、バイナリデータを MimeContainer に書き込みます。
    次で指定:
    インターフェース MimeMarshaller 内の marshal
    パラメーター:
    graph - マーシャリングするオブジェクトグラフのルート
    result - マーシャリングする結果
    mimeContainer - 抽出されたバイナリコンテンツを書き込む MIME コンテナー
    例外:
    XmlMappingException - 指定されたオブジェクトを結果に整列化できない場合
  - createMarshaller
```
protected MarshallerEE createMarshaller()
```
    新しく作成された JAXB マーシャラーを返します。JAXB マーシャラーは必ずしもスレッドセーフではありません。
  - initJaxbMarshaller
```
protected void initJaxbMarshaller(MarshallerEE marshaller)
                           throws JAXBExceptionEE
```
    カスタム初期化動作のために具体的な JAXB マーシャラーによってオーバーライドできるテンプレートメソッド。JAXB Marshaller の作成後、およびそれぞれのプロパティが設定された後に呼び出されます。
    デフォルトの実装では、defined properties、validation event handler、schemas、listener、adapters を設定します。
    例外:
    JAXBExceptionEE
  - unmarshal
```
public java.lang.Object unmarshal(javax.xml.transform.Source source)
                           throws XmlMappingException
```
    インターフェースからコピーされた説明: Unmarshaller
    指定された Source をオブジェクトグラフに非整列化します。
    次で指定:
    インターフェース Unmarshaller 内の unmarshal
    パラメーター:
    source - マーシャリングのソース
    戻り値:
    オブジェクトグラフ
    例外:
    XmlMappingException - 指定されたソースをオブジェクトにマップできない場合
  - unmarshal
```
public java.lang.Object unmarshal(javax.xml.transform.Source source,
                                  @Nullable
                                  MimeContainer mimeContainer)
                           throws XmlMappingException
```
    インターフェースからコピーされた説明: MimeUnmarshaller
    指定された Source をオブジェクトグラフに非整列化し、MimeContainer からバイナリ添付ファイルを読み取ります。
    次で指定:
    インターフェース MimeUnmarshaller 内の unmarshal
    パラメーター:
    source - マーシャリングのソース
    mimeContainer - 抽出されたバイナリコンテンツを読み取る MIME コンテナー
    戻り値:
    オブジェクトグラフ
    例外:
    XmlMappingException - 指定されたソースをオブジェクトにマップできない場合
  - unmarshalStaxSource
```
protected java.lang.Object unmarshalStaxSource(UnmarshallerEE jaxbUnmarshaller,
                                               javax.xml.transform.Source staxSource)
                                        throws JAXBExceptionEE
```
    例外:
    JAXBExceptionEE
  - createUnmarshaller
```
protected UnmarshallerEE createUnmarshaller()
```
    新しく作成された JAXB アンマーシャラーを返します。注: JAXB アンマーシャラーは必ずしもスレッドセーフではありません。
  - initJaxbUnmarshaller
```
protected void initJaxbUnmarshaller(UnmarshallerEE unmarshaller)
                             throws JAXBExceptionEE
```
    カスタム初期化動作のために具体的な JAXB マーシャラーによってオーバーライドできるテンプレートメソッド。JAXB Marshaller の作成後、およびそれぞれのプロパティが設定された後に呼び出されます。
    デフォルトの実装では、defined properties、validation event handler、schemas、listener、adapters を設定します。
    例外:
    JAXBExceptionEE
  - convertJaxbException
```
protected XmlMappingException convertJaxbException(JAXBExceptionEE ex)
```
    指定された JAXBException を org.springframework.oxm 階層からの適切な例外に変換します。
    パラメーター:
    ex - 発生した JAXBException
    戻り値:
    対応する XmlMappingException

クラス Jaxb2Marshaller

フィールド概要

コンストラクター概要

方法の概要

クラス java.lang.Object から継承されたメソッド

フィールドの詳細

logger

コンストラクターの詳細

Jaxb2Marshaller

メソッドの詳細

setContextPaths

setContextPath

getContextPath

setClassesToBeBound

getClassesToBeBound

setPackagesToScan

getPackagesToScan

setJaxbContextProperties

setMarshallerProperties

setUnmarshallerProperties

setMarshallerListener

setUnmarshallerListener

setValidationEventHandler

setAdapters

setSchema

setSchemas

setSchemaLanguage

setSchemaResourceResolver

setLazyInit

setMtomEnabled

setSupportJaxbElementClass

setCheckForXmlRootElement

setMappedClass

setSupportDtd

isSupportDtd

setProcessExternalEntities

isProcessExternalEntities

setBeanClassLoader

afterPropertiesSet

getJaxbContext

supports

supports

marshal

marshal

createMarshaller

initJaxbMarshaller

unmarshal

unmarshal

unmarshalStaxSource

createUnmarshaller

initJaxbUnmarshaller

convertJaxbException