コンストラクターの詳細

• MarshallingMessageConverter

  public MarshallingMessageConverter()

  Marshaller または Unmarshaller が設定されていない新しい MarshallingMessageConverter を構築します。マーシャラーは、構築後に setMarshaller(Marshaller) および setUnmarshaller(Unmarshaller) を呼び出して設定する必要があります。

• MarshallingMessageConverter

  public MarshallingMessageConverter(Marshaller marshaller)

  指定された Marshaller セットで新しい MarshallingMessageConverter を構築します。

  指定された Marshaller が Unmarshaller インターフェースも実装している場合、マーシャリングとアンマーシャリングの両方に使用されます。そうでない場合、例外がスローされます。

  Spring のすべての Marshaller 実装も Unmarshaller インターフェースを実装するため、このコンストラクターを安全に使用できることに注意してください。

  パラメーター:

  marshaller - マーシャラーおよびアンマーシャラーとして使用されるオブジェクト

  例外:

  IllegalArgumentExceptionSE - marshaller が Unmarshaller インターフェースも実装していない場合

• MarshallingMessageConverter

  public MarshallingMessageConverter(Marshaller marshaller,
                                     Unmarshaller unmarshaller)

  指定された Marshaller と Unmarshaller で新しい MarshallingMessageConverter を構築します。

  パラメーター:

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

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

メソッドの詳細

• 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, javax.jms.Session, org.springframework.oxm.Marshaller), marshalToBytesMessage(java.lang.Object, javax.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(javax.jms.TextMessage, org.springframework.oxm.Unmarshaller), unmarshalFromBytesMessage(javax.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()EE, 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()EE, 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 マッピングエラーの場合