Jaxb2Marshaller (Spring Framework API)

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

実装されたすべてのインターフェース:
Aware, BeanClassLoaderAware, InitializingBean, GenericMarshaller, GenericUnmarshaller, Marshaller, MimeMarshaller, MimeUnmarshaller, Unmarshaller
```
public class Jaxb2Marshaller
extends ObjectSE
implements MimeMarshaller, MimeUnmarshaller, GenericMarshaller, GenericUnmarshaller, BeanClassLoaderAware, InitializingBean
```
JAXB 2.2 用の GenericMarshaller インターフェースの実装。
通常、この Bean で "contextPath" または "classesToBeBound" プロパティを設定し、プロパティ、スキーマ、アダプター、リスナーを設定してマーシャラーとアンマーシャラーをカスタマイズし、それを参照します。
導入:
3.0
作成者:
Arjen Poutsma, Juergen Hoeller, Rossen Stoyanchev
関連事項:
setContextPath(java.lang.String), setClassesToBeBound(java.lang.Class<?>...), setJaxbContextProperties(java.util.Map<java.lang.String, ?>), setMarshallerProperties(java.util.Map<java.lang.String, ?>), setUnmarshallerProperties(java.util.Map<java.lang.String, ?>), setSchema(org.springframework.core.io.Resource), setSchemas(org.springframework.core.io.Resource...), setMarshallerListener(javax.xml.bind.Marshaller.Listener), setUnmarshallerListener(javax.xml.bind.Unmarshaller.Listener), setAdapters(javax.xml.bind.annotation.adapters.XmlAdapter<?, ?>...)

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

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

コンストラクターのサマリー
コンストラクター
コンストラクターと説明
Jaxb2Marshaller()

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

メソッドのサマリー

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

クラス java.lang.ObjectSE から継承されたメソッド
cloneSE, equalsSE, finalizeSE, getClassSE, hashCodeSE, notifySE, notifyAllSE, toStringSE, waitSE, waitSE, waitSE

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

クラス Jaxb2Marshaller

フィールドサマリー

コンストラクターのサマリー

メソッドのサマリー

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

フィールドの詳細

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

createUnmarshaller

unmarshalStaxSource

initJaxbUnmarshaller

convertJaxbException