Interface UnmarshalListener

All Known Implementing Classes:
MappingUnmarshallListener, UnmarshalListenerAdapter, UnmarshalListenerDelegate
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.
This is already a new version of this interface with enhanced callback methods. The orginial implementation still exists but is deprecated UnmarshalListener.

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

The first definition of this interface was by Paul Christmann, Keith Visco and Arnaud Blandin.

Since:
1.2
Version:
$Revision$
Author:
Joachim Grueneis, jgrueneis AT codehaus DOT org

  • Method Summary

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

  • Method Details

    • initialized

      void initialized(Object target, Object parent)
      This method is called when an object has just been initialized by the Unmarshaller.
      Parameters:
      target - the Object that was initialized.
      parent - the parent of the target that was initialized

    • attributesProcessed

      void attributesProcessed(Object target, Object parent)
      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:
      target - the Object the object being unmarshalled.
      parent - the parent of the target being unmarshalled

    • fieldAdded

      void fieldAdded(String fieldName, Object parent, Object child)
      This method is called after a child object has been added during the unmarshalling. This method will be called after
      invalid reference 
      #unmarshalled(Object)
      has been called for the child.
      Parameters:
      fieldName - The Name of the field the child is being added to.
      parent - The Object being unmarshalled.
      child - The Object that was just added.

    • unmarshalled

      void unmarshalled(Object target, Object parent)
      This method is called after an object has been completely unmarshalled, including all of its children (if any).
      Parameters:
      target - the Object that was unmarshalled.
      parent - the parent of the target that was unmarshalled