public abstract static class Marshaller.Listener
extends java.lang.Object
Register an instance of an implementation of this class with a Marshaller
to externally listen
for marshal events.
This class enables pre and post processing of each marshalled object. The event callbacks are called when marshalling from an instance that maps to an xml element or complex type definition. The event callbacks are not called when marshalling from an instance of a Java datatype that represents a simple type definition.
External listener is one of two different mechanisms for defining marshal event callbacks. See Marshal Event Callbacks for an overview.
Marshaller.setListener(Listener)
,
Marshaller.getListener()
Modifier | Constructor and Description |
---|---|
protected |
Listener()
Do-nothing constructor for the derived classes.
|
Modifier and Type | Method and Description |
---|---|
void |
afterMarshal(java.lang.Object source)
Callback method invoked after marshalling
source to XML. |
void |
beforeMarshal(java.lang.Object source)
Callback method invoked before marshalling from
source to XML. |
public void beforeMarshal(java.lang.Object source)
Callback method invoked before marshalling from source
to XML.
This method is invoked just before marshalling process starts to marshal source
.
Note that if the class of source
defines its own beforeMarshal
method,
the class specific callback method is invoked just before this method is invoked.
source
- instance of Jakarta XML Binding mapped class prior to marshalling from it.public void afterMarshal(java.lang.Object source)
Callback method invoked after marshalling source
to XML.
This method is invoked after source
and all its descendants have been marshalled.
Note that if the class of source
defines its own afterMarshal
method,
the class specific callback method is invoked just before this method is invoked.
source
- instance of Jakarta XML Binding mapped class after marshalling it.