Utility class to help make accessing the message payload a little more deterministic.
This class can be used by actions/listeners to manage access to the payload on a Message instance. The class is constructed from the configuration of the component (listener, actions etc) using the proxy instance. It checks the configuration for "get-payload-location" and "set-payload-location" configuration properties, defaulting both to the Default Body Location ( {@link Body#DEFAULT_LOCATION}).
Prior to the introduction of this class, there was no standardised pattern for components exchanging data through the ESB Message. It was adhoc in nature, with components needing to have knowledge of where other components set the data in the message. This functionality is still supported through the "get-payload-location" and "set-payload-location" configuration properties, but all ESB now (by default) get and set their data on the {@link Body#DEFAULT_LOCATION}.
Code writen to work against ESB version up to and including version 4.2GA can still use the old adhoc exchange patterns by setting the "core:use.legacy.message.payload.exchange.patterns" config property in the jbossesb-properties.xml file.
@author
tom.fennelly@jboss.com