クラス Jaxb2Marshaller

java.lang.ObjectSE
org.springframework.oxm.jaxb.Jaxb2Marshaller
実装されたすべてのインターフェース:
AwareBeanClassLoaderAwareInitializingBeanGenericMarshallerGenericUnmarshallerMarshallerMimeMarshallerMimeUnmarshallerUnmarshaller

JAXB 2.2 用の GenericMarshaller インターフェースの実装。

典型的な使用箇所は、この Bean に "contextPath" または "classesToBeBound" プロパティを設定し、プロパティ、スキーマ、アダプター、リスナーを設定してマーシャラーとアンマーシャラーをカスタマイズし、それを参照することです。

導入:
3.0
作成者:
Arjen Poutsma, Juergen Hoeller, Rossen Stoyanchev, Sam Brannen
関連事項:
  • フィールドの詳細

    • 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 - プロパティ
      関連事項:
    • setUnmarshallerProperties

      public void setUnmarshallerProperties(MapSE<StringSE,?> properties)
      JAXB Unmarshaller プロパティを設定します。

      これらのプロパティは、基礎となる JAXB Unmarshaller に設定されます。

      パラメーター:
      properties - プロパティ
      関連事項:
    • 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(StringSE schemaLanguage)
      スキーマ言語を設定します。デフォルトは W3C XML スキーマ: http://www.w3.org/2001/XMLSchema" です。
      関連事項:
    • setSchemaResourceResolver

      public void setSchemaResourceResolver(LSResourceResolverSE schemaResourceResolver)
      スキーマリソースのロードに使用されるリソースリゾルバーを設定します。
      関連事項:
    • 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 などのクラスの使用と組み合わせて有効になります。

      関連事項:
    • setCheckForXmlRootElement

      public void setCheckForXmlRootElement(boolean checkForXmlRootElement)
      supports(Class)@XmlRootElementEE アノテーションをチェックするかどうかを指定します。

      デフォルトは true です。つまり、supports(Class) はこのアノテーションをチェックします。ただし、一部の JAXB 実装(EclipseLink MOXy など)では、外部定義ファイルでバインディングを定義できるため、クラスアノテーションを自由に保つことができます。このプロパティを false に設定すると、これらの JAXB 実装がサポートされます。

      関連事項:
    • setMappedClass

      public void setMappedClass(ClassSE<?> mappedClass)
      部分的な非整列化のための JAXB マップクラスを指定します。
      関連事項:
    • 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 などの初期化コールバックの前に呼び出さます。

      次で指定:
      インターフェース BeanClassLoaderAwaresetBeanClassLoader 
      パラメーター:
      classLoader - 所有クラスローダー
    • afterPropertiesSet

      public void afterPropertiesSet() throws ExceptionSE
      インターフェースからコピーされた説明: InitializingBean
      すべての Bean プロパティを設定し、BeanFactoryAwareApplicationContextAware などを満たした後、包含 BeanFactory によって呼び出されます。

      このメソッドにより、Bean インスタンスは、すべての Bean プロパティが設定されたときに、その全体的な構成の検証と最終的な初期化を実行できます。

      次で指定:
      インターフェース InitializingBeanafterPropertiesSet 
      例外:
      ExceptionSE - 構成の誤り(必須プロパティの設定の失敗など)の場合、またはその他の理由で初期化が失敗した場合
    • getJaxbContext

      public JAXBContextEE getJaxbContext()
      このマーシャラーが使用する JAXBContext を返し、必要に応じて遅延ビルドします。
    • supports

      public boolean supports(ClassSE<?> clazz)
      インターフェースからコピーされた説明: Marshaller
      このマーシャラーが、指定された型のインスタンスをマーシャリングできるかどうかを示します。
      次で指定:
      インターフェース Marshallersupports 
      次で指定:
      インターフェース Unmarshallersupports 
      パラメーター:
      clazz - このマーシャラーがマーシャリングできるかどうか尋ねられているクラス
      戻り値:
      このマーシャラーが実際に提供されたクラスのインスタンスをマーシャリングできる場合は true。それ以外の場合は false 
    • supports

      public boolean supports(TypeSE genericType)
      インターフェースからコピーされた説明: GenericMarshaller
      このマーシャラーが、指定されたジェネリクス型のインスタンスをマーシャリングできるかどうかを示します。
      次で指定:
      インターフェース GenericMarshallersupports 
      次で指定:
      インターフェース GenericUnmarshallersupports 
      パラメーター:
      genericType - このマーシャラーがマーシャリングできるかどうか尋ねられている型
      戻り値:
      このマーシャラーが実際に提供された型のインスタンスをマーシャリングできる場合は true。それ以外の場合は false 
    • marshal

      public void marshal(ObjectSE graph, ResultSE result) throws XmlMappingException
      インターフェースからコピーされた説明: Marshaller
      指定されたルートを持つオブジェクトグラフを指定された ResultSE にマーシャリングします。
      次で指定:
      インターフェース Marshallermarshal 
      パラメーター:
      graph - マーシャリングするオブジェクトグラフのルート
      result - マーシャリングする結果
      例外:
      XmlMappingException - 指定されたオブジェクトを結果に整列化できない場合
    • marshal

      public void marshal(ObjectSE graph, ResultSE result, @Nullable MimeContainer mimeContainer) throws XmlMappingException
      インターフェースからコピーされた説明: MimeMarshaller
      指定されたルートを持つオブジェクトグラフを指定された ResultSE にマーシャリングし、バイナリデータを MimeContainer に書き込みます。
      次で指定:
      インターフェース MimeMarshallermarshal 
      パラメーター:
      graph - マーシャリングするオブジェクトグラフのルート
      result - マーシャリングする結果
      mimeContainer - 抽出されたバイナリコンテンツを書き込む MIME コンテナー
      例外:
      XmlMappingException - 指定されたオブジェクトを結果に整列化できない場合
    • createMarshaller

      public MarshallerEE createMarshaller()
      新しく作成された JAXB マーシャラーを返します。

      メモ: JAXB マーシャラーは必ずしもスレッドセーフではありません。このメソッドは 5.2 以降はパブリックです。

      導入:
      5.2
      関連事項:
    • initJaxbMarshaller

      protected void initJaxbMarshaller(MarshallerEE marshaller) throws JAXBExceptionEE
      カスタム初期化動作のために具体的な JAXB マーシャラーによってオーバーライドできるテンプレートメソッド。JAXB Marshaller の作成後、およびそれぞれのプロパティが設定された後に呼び出されます。

      デフォルトの実装では、defined propertiesvalidation event handlerschemaslisteneradapters を設定します。

      例外:
      JAXBExceptionEE
    • unmarshal

      public ObjectSE unmarshal(SourceSE source) throws XmlMappingException
      インターフェースからコピーされた説明: Unmarshaller
      指定された SourceSE をオブジェクトグラフに非整列化します。
      次で指定:
      インターフェース Unmarshallerunmarshal 
      パラメーター:
      source - マーシャリングのソース
      戻り値:
      オブジェクトグラフ
      例外:
      XmlMappingException - 指定されたソースをオブジェクトにマップできない場合
    • unmarshal

      public ObjectSE unmarshal(SourceSE source, @Nullable MimeContainer mimeContainer) throws XmlMappingException
      インターフェースからコピーされた説明: MimeUnmarshaller
      指定された SourceSE をオブジェクトグラフに非整列化し、MimeContainer からバイナリ添付ファイルを読み取ります。
      次で指定:
      インターフェース MimeUnmarshallerunmarshal 
      パラメーター:
      source - マーシャリングのソース
      mimeContainer - 抽出されたバイナリコンテンツを読み取る MIME コンテナー
      戻り値:
      オブジェクトグラフ
      例外:
      XmlMappingException - 指定されたソースをオブジェクトにマップできない場合
    • createUnmarshaller

      public UnmarshallerEE createUnmarshaller()
      新しく作成された JAXB アンマーシャラーを返します。

      メモ: JAXB アンマーシャラーは必ずしもスレッドセーフではありません。このメソッドは 5.2 以降はパブリックです。

      導入:
      5.2
      関連事項:
    • unmarshalStaxSource

      protected ObjectSE unmarshalStaxSource(UnmarshallerEE jaxbUnmarshaller, SourceSE staxSource) throws JAXBExceptionEE
      例外:
      JAXBExceptionEE
    • initJaxbUnmarshaller

      protected void initJaxbUnmarshaller(UnmarshallerEE unmarshaller) throws JAXBExceptionEE
      カスタム初期化動作のために具体的な JAXB マーシャラーによってオーバーライドできるテンプレートメソッド。JAXB Marshaller の作成後、およびそれぞれのプロパティが設定された後に呼び出されます。

      デフォルトの実装では、defined propertiesvalidation event handlerschemaslisteneradapters を設定します。

      例外:
      JAXBExceptionEE
    • convertJaxbException

      protected XmlMappingException convertJaxbException(JAXBExceptionEE ex)
      指定された JAXBException を org.springframework.oxm 階層からの適切な例外に変換します。
      パラメーター:
      ex - 発生した JAXBException 
      戻り値:
      対応する XmlMappingException