org.exolab.castor.xml
Interface UnmarshalListener

public interface UnmarshalListener

An interface to allow external "listening" to objects when they are being unmarshalled for various tracking purposes and potential modification. An implementation of this interface may be registered with the Unmarshaller.

The UnmarshalListener interface does not report on native data types that are unmarshalled.

Version:

$Revision: 1.1.1.1 $

Author:

Paul Christmann, Keith Visco, Arnaud Blandin

Method Summary

void	attributesProcessed(java.lang.Object object) This method is called once the attributes have been processed.
void	fieldAdded(java.lang.String fieldName, java.lang.Object parent, java.lang.Object child) This method is called after a child object has been added during the unmarshalling.
void	initialized(java.lang.Object object) This method is called when an object has just been initialized by the Unmarshaller.
void	unmarshalled(java.lang.Object object) This method is called after an object has been completely unmarshalled, including all of its children (if any).

Method Detail

initialized

public void initialized(java.lang.Object object)

This method is called when an object has just been initialized by the Unmarshaller.

Parameters:

object - the Object that was initialized.

attributesProcessed

public void attributesProcessed(java.lang.Object object)

This method is called once the attributes have been processed. It indicates that the the fields of the given object corresponding to attributes in the XML document have been set.

Parameters:

object - the Object the object being unmarshalled.

fieldAdded

public void fieldAdded(java.lang.String fieldName,
                       java.lang.Object parent,
                       java.lang.Object child)

This method is called after a child object has been added during the unmarshalling. This method will be called after unmarshalled has been called for the child.

Parameters:

fieldName - the Name of the field the child is being added to.

child - the Object that was just added.

unmarshalled

public void unmarshalled(java.lang.Object object)

This method is called after an object has been completely unmarshalled, including all of its children (if any).

Parameters:

object - the Object that was unmarshalled.