Class Unmarshaller.Listener
- java.lang.Object
-
- javax.xml.bind.Unmarshaller.Listener
- Enclosing interface:
- Unmarshaller
public abstract static class Unmarshaller.Listener extends Object
Register an instance of an implementation of this class with
Unmarshaller
to externally listen for unmarshal events. This class enables pre and post processing of an instance of a JAXB mapped class as XML data is unmarshalled into it. The event callbacks are called when unmarshalling XML content into a JAXBElement instance or a JAXB mapped class that represents a complex type definition. The event callbacks are not called when unmarshalling to an instance of a Java datatype that represents a simple type definition. External listener is one of two different mechanisms for defining unmarshal event callbacks. See Unmarshal Event Callbacks for an overview. (@link #setListener(Listener)} (@link #getListener()}- Since:
- JAXB2.0
Constructors
Constructor and Description |
---|
Listener() |
Methods
Modifier and Type | Method and Description |
---|---|
void |
afterUnmarshal(Object target,
Object parent)
Callback method invoked after unmarshalling XML data into target . |
void |
beforeUnmarshal(Object target,
Object parent)
Callback method invoked before unmarshalling into target . |
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
Constructors
Listener
public Listener()
Methods
beforeUnmarshal
public void beforeUnmarshal(Object target, Object parent)
Callback method invoked before unmarshalling into
target
. This method is invoked immediately after target
was created and before the unmarshalling of this object begins. Note that if the class of target
defines its own beforeUnmarshal
method, the class specific callback method is invoked before this method is invoked.- Parameters:
-
target
- non-null instance of JAXB mapped class prior to unmarshalling into it. -
parent
- instance of JAXB mapped class that will eventually referencetarget
.null
whentarget
is root element.
afterUnmarshal
public void afterUnmarshal(Object target, Object parent)
Callback method invoked after unmarshalling XML data into
target
. This method is invoked after all the properties (except IDREF) are unmarshalled into target
, but before target
is set into its parent
object. Note that if the class of target
defines its own afterUnmarshal
method, the class specific callback method is invoked before this method is invoked.- Parameters:
-
target
- non-null instance of JAXB mapped class prior to unmarshalling into it. -
parent
- instance of JAXB mapped class that will referencetarget
.null
whentarget
is root element.
© 1993, 2020, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://docs.oracle.com/javase/8/docs/api/javax/xml/bind/Unmarshaller.Listener.html