Version: 17.07
Supported Since: 17.07
An XML to JAXB Transformer is a processing element which transforms an XML message payload to a JAXB object payload.
This transformation is done based on a generic set of rules and hence this processing element is most suitable for simple transformations. For complex transformations based on custom rules, Adroitlogic Data Mapping Tool is recommended.
In order to use this processing element, you must first select the Message Transformation dependency from the processor list when you are creating an empty Ultra project. If you have already created a project, you can add this dependency via Component Registry. From Tools menu, select Ultra Studio → Component Registry and from the Processors list, select the Message Transformation dependency. |
Next |
The message will be sent to this outport if the payload transformation is completed successfully |
On Exception |
The message will be sent to this outport if the processing element failed to transform the payload due to some reason |
Context Path |
Basic |
An optional element which specifies a list of colon separated java package names that contain schema-derived classes and/or fully qualified JAXB-annotated classes (including the ObjectFactory). |
Class |
Basic |
The name of the JAXB class to convert the payload into. You can provide this parameter as the example given below.
|
In the following use case, the requirement is to read a message with an XML payload from a File server, convert the message payload to a JAXB object, convert the message payload with the JAXB object to an XML payload and then deliver it to another File server endpoint.
In this flow, the processor outport of File ingress connector is connected to the inport of the XML to JAXB Transformer so that the File message received by the connector is handed over to the transformer next. If the processing element is able to transform the payload from XML to JAXB successfully, the message with the transformed payload is handed over to the JAXB to XML Transformer, as the "Next" outport of the XML to JAXB Transformer is connected to. The successfully transformed payload is then handed over to the File egress connector.
In the case of transformation failure, a log will be generated and then the message flow will complete in an exceptional state, as the "On Exception" outport of the XML to JAXB Transformer is connected to a Logger processing element, followed by an Exceptional Flow End element.