クラス MarshallingMessageConverter

メソッドの詳細

• setMarshaller

  public void setMarshaller(Marshaller marshaller)

  このメッセージコンバーターで使用する Marshaller を設定します。

• setUnmarshaller

  public void setUnmarshaller(Unmarshaller unmarshaller)

  このメッセージコンバーターで使用する Unmarshaller を設定します。

• setTargetType

  public void setTargetType(MessageType targetType)

  toMessage(Object, Session) が BytesMessageEE または TextMessageEE にマーシャリングするかどうかを指定します。

  デフォルトは MessageType.BYTES です。つまり、このコンバーターは BytesMessageEE にマーシャリングします。このコンバーターのデフォルトバージョンは MessageType.BYTES および MessageType.TEXT のみをサポートすることに注意してください。

  関連事項:

  • MessageType.BYTES
  • MessageType.TEXT

• afterPropertiesSet

  public void afterPropertiesSet()

  インターフェースからコピーされた説明: InitializingBean

  すべての Bean プロパティを設定し、BeanFactoryAware、ApplicationContextAware などを満たした後、包含 BeanFactory によって呼び出されます。

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

  次で指定:

  インターフェース InitializingBean の afterPropertiesSet 

• toMessage

  public MessageEE toMessage(ObjectSE object, SessionEE session) throws JMSExceptionEE, MessageConversionException

  この実装は、指定されたオブジェクトを TextMessageEE または BytesMessageEE にマーシャリングします。目的のメッセージ型は、"marshalTo" プロパティを設定することで定義できます。

  次で指定:

  インターフェース MessageConverter の toMessage 

  パラメーター:

  object - 変換するオブジェクト

  session - JMS メッセージの作成に使用するセッション

  戻り値:

  JMS メッセージ

  例外:

  JMSExceptionEE - JMS API メソッドによってスローされた場合

  MessageConversionException - 変換に失敗した場合

  関連事項:

  • marshalToTextMessage(java.lang.Object, jakarta.jms.Session, org.springframework.oxm.Marshaller)
  • marshalToBytesMessage(java.lang.Object, jakarta.jms.Session, org.springframework.oxm.Marshaller)

• fromMessage

  public ObjectSE fromMessage(MessageEE message) throws JMSExceptionEE, MessageConversionException

  この実装は、指定された MessageEE をオブジェクトに非整列化します。

  次で指定:

  インターフェース MessageConverter の fromMessage 

  パラメーター:

  message - 変換するメッセージ

  戻り値:

  変換された Java オブジェクト

  例外:

  JMSExceptionEE - JMS API メソッドによってスローされた場合

  MessageConversionException - 変換に失敗した場合

  関連事項:

  • unmarshalFromTextMessage(jakarta.jms.TextMessage, org.springframework.oxm.Unmarshaller)
  • unmarshalFromBytesMessage(jakarta.jms.BytesMessage, org.springframework.oxm.Unmarshaller)

• marshalToTextMessage

  protected TextMessageEE marshalToTextMessage(ObjectSE object, SessionEE session, Marshaller marshaller) throws JMSExceptionEE, IOExceptionSE, XmlMappingException

  指定されたオブジェクトを TextMessageEE にマーシャリングします。

  パラメーター:

  object - 整列化されるオブジェクト

  session - 現在の JMS セッション

  marshaller - 使用するマーシャラー

  戻り値:

  結果のメッセージ

  例外:

  JMSExceptionEE - JMS メソッドによってスローされた場合

  IOExceptionSE - I/O エラーの場合

  XmlMappingException - OXM マッピングエラーの場合

  関連事項:

  • Session.createTextMessage()
  • Marshaller.marshal(Object, Result)

• marshalToBytesMessage

  protected BytesMessageEE marshalToBytesMessage(ObjectSE object, SessionEE session, Marshaller marshaller) throws JMSExceptionEE, IOExceptionSE, XmlMappingException

  指定されたオブジェクトを BytesMessageEE にマーシャリングします。

  パラメーター:

  object - 整列化されるオブジェクト

  session - 現在の JMS セッション

  marshaller - 使用するマーシャラー

  戻り値:

  結果のメッセージ

  例外:

  JMSExceptionEE - JMS メソッドによってスローされた場合

  IOExceptionSE - I/O エラーの場合

  XmlMappingException - OXM マッピングエラーの場合

  関連事項:

  • Session.createBytesMessage()
  • Marshaller.marshal(Object, Result)

• marshalToMessage

  protected MessageEE marshalToMessage(ObjectSE object, SessionEE session, Marshaller marshaller, MessageType targetType) throws JMSExceptionEE, IOExceptionSE, XmlMappingException

  カスタムメッセージマーシャリングを可能にするテンプレートメソッド。setTargetType(org.springframework.jms.support.converter.MessageType) が MessageType.TEXT または MessageType.BYTES でない場合に呼び出されます。

  デフォルトの実装は IllegalArgumentExceptionSE をスローします。

  パラメーター:

  object - マーシャリングするオブジェクト

  session - JMS セッション

  marshaller - 使用するマーシャラー

  targetType - ターゲットメッセージ型 (TEXT または BYTES 以外)

  戻り値:

  結果のメッセージ

  例外:

  JMSExceptionEE - JMS メソッドによってスローされた場合

  IOExceptionSE - I/O エラーの場合

  XmlMappingException - OXM マッピングエラーの場合

• unmarshalFromTextMessage

  protected ObjectSE unmarshalFromTextMessage(TextMessageEE message, Unmarshaller unmarshaller) throws JMSExceptionEE, IOExceptionSE, XmlMappingException

  指定された TextMessageEE をオブジェクトに非整列化します。

  パラメーター:

  message - メッセージ

  unmarshaller - 使用するアンマーシャラー

  戻り値:

  非整列化オブジェクト

  例外:

  JMSExceptionEE - JMS メソッドによってスローされた場合

  IOExceptionSE - I/O エラーの場合

  XmlMappingException - OXM マッピングエラーの場合

  関連事項:

  • Unmarshaller.unmarshal(Source)

• unmarshalFromBytesMessage

  protected ObjectSE unmarshalFromBytesMessage(BytesMessageEE message, Unmarshaller unmarshaller) throws JMSExceptionEE, IOExceptionSE, XmlMappingException

  指定された BytesMessageEE をオブジェクトに非整列化します。

  パラメーター:

  message - メッセージ

  unmarshaller - 使用するアンマーシャラー

  戻り値:

  非整列化オブジェクト

  例外:

  JMSExceptionEE - JMS メソッドによってスローされた場合

  IOExceptionSE - I/O エラーの場合

  XmlMappingException - OXM マッピングエラーの場合

  関連事項:

  • Unmarshaller.unmarshal(Source)

• unmarshalFromMessage

  protected ObjectSE unmarshalFromMessage(MessageEE message, Unmarshaller unmarshaller) throws JMSExceptionEE, IOExceptionSE, XmlMappingException

  カスタムメッセージの非整列化を可能にするテンプレートメソッド。TextMessageEE または BytesMessageEE 以外のメッセージで fromMessage(Message) が呼び出されると呼び出されます。

  デフォルトの実装は IllegalArgumentExceptionSE をスローします。

  パラメーター:

  message - メッセージ

  unmarshaller - 使用するアンマーシャラー

  戻り値:

  非整列化オブジェクト

  例外:

  JMSExceptionEE - JMS メソッドによってスローされた場合

  IOExceptionSE - I/O エラーの場合

  XmlMappingException - OXM マッピングエラーの場合