Castor XML to Java Function Component

The CastorXMLtoJava Function Component is the mirror-image counterpart to the Castor Java to XML Function Component, and the same section applies here.

Specifically, the CastorXMLtoJava FC creates an Entry or a general Java™ object from an XML document, and it provides the option to get data from certain parts of the XML tree when deserializing the XML document.

In addition to the Castor mapping mechanism which specifies how to build a Java object (possibly of a custom Java class) from an XML node/subtree, this Function Component provides its own logic to specify how to populate Entry Attributes from an XML document. By using XPath queries you can specify which parts of the XML document will be passed to the Castor APIs for deserializing.

This approach both provides ease of use in the IBM Security Directory Integrator context and gives more power when processing custom XML documents, for example XML documents generated by other systems. Through the XPath queries you are able to specify which parts of the XML you are interested in (and get them directly into Entry Attributes) and which are irrelevant for your process and should not be processed. In addition, the writing of the Castor XML Mapping Files is facilitated since you will only have to write mapping rules for the parts of the XML document you are interested in and not for the whole XML document.

The CastorXMLToJava Function Component uses Castor 0.9.5.4. Documentation and information for the Castor library can be obtained from the Castor project web site: http://www.castor.org/