com.sap.cloud.sdk.s4hana.datamodel.messaging.jms

Class JmsMessagingVdmConverter

java.lang.Object

com.sap.cloud.sdk.s4hana.datamodel.messaging.jms.JmsMessagingVdmConverter

@Beta
public class JmsMessagingVdmConverter
extends Object

Generic converter for turning JMS messages into Messaging VDM objects. This relies on MessageFactoryMapper objects to pick the right MessageFactory based on the message topics. Multiple MessageFactoryMapper objects can be configured, and each MessageFactoryMapper can have mappings for the same message topic. In this case, the mapping of the most recently added MessageFactoryMapper is used.

Constructor Summary

Constructors

Constructor and Description
JmsMessagingVdmConverter() Creates a converter instance with the built-in mappings from VdmMessages added.
JmsMessagingVdmConverter(MessageFactoryMapper... messageFactoryMappers) Creates a converter instance with the built-in mappings from VdmMessages added, plus the provided MessageFactoryMapper instances on top.

Method Summary

Modifier and Type	Method and Description
void	addMessageFactoryMappers(MessageFactoryMapper... messageFactoryMappers) Augment existing converter with provided MessageFactoryMapper instances.
Message	fromJmsMessage(javax.jms.Message incomingMessage) Translates JMS messages into Messaging VDM objects.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

JmsMessagingVdmConverter

public JmsMessagingVdmConverter()

Creates a converter instance with the built-in mappings from VdmMessages added.

JmsMessagingVdmConverter

public JmsMessagingVdmConverter(@Nonnull
                                MessageFactoryMapper... messageFactoryMappers)

Creates a converter instance with the built-in mappings from VdmMessages added, plus the provided MessageFactoryMapper instances on top. Note that in case of duplicate mappings, the one from the right-most MessageFactoryMapper will be used.

Parameters:

messageFactoryMappers - Mapping classes that implement the MessageFactoryMapper interface and map topics to message factory class names.

Method Detail

addMessageFactoryMappers

public void addMessageFactoryMappers(@Nonnull
                                     MessageFactoryMapper... messageFactoryMappers)

Augment existing converter with provided MessageFactoryMapper instances. Note that in case of duplicate mappings, the one from the right-most MessageFactoryMapper will be used.

Parameters:

messageFactoryMappers - Mapping classes that implement the MessageFactoryMapper interface and map topics to message factory class names.

fromJmsMessage

@Nullable
public Message fromJmsMessage(@Nullable
                                        javax.jms.Message incomingMessage)
                                 throws MessagingException

Translates JMS messages into Messaging VDM objects.

Parameters:

incomingMessage - The original JMS message.

Returns:

A Messaging VDM object representation of the original JMS message.

Throws:

MessagingException - If there are problems parsing the JMS message or converting it to a Messaging VDM object.