JAXBObjectModifier (dom4j 1.6.1 API)

org.dom4j.jaxb Interface JAXBObjectModifier

public interface JAXBObjectModifier

JAXBObjectHandler implementations can be registered with the JAXBModifier in order to change unmarshalled XML fragments.

Author:

Wonne Keysers (Realsoftware.be)

modifyObject

public javax.xml.bind.Element modifyObject(javax.xml.bind.Element jaxbElement)
                                    throws Exception

Called when the JAXBModifierhas finished parsing the xml path the handler was registered for. The provided object is the unmarshalled representation of the XML fragment. It can be casted to the appropriate implementation class that is generated by the JAXB compiler.
The modified JAXB element that returns from this method will be marshalled by the JAXBModifierand put in the DOM4J tree.

Parameters:

jaxbElement - the JAXB object to be modified

Returns:

the modified JAXB object, or null when it must be removed.

Throws:

Exception - possibly thrown by the implementation.