| org.jibx.runtime.IUnmarshaller
All known Subclasses: org.jibx.extras.IdDefRefMapperBase, org.jibx.extras.HashMapperStringToComplex, org.jibx.extras.DomListMapper, org.jibx.extras.HashMapperStringToSchemaType, org.jibx.extras.DomElementMapper, org.jibx.extras.DomFragmentMapper, org.jibx.extras.DiscardElementMapper, org.jibx.extras.ObjectArrayMapper, org.jibx.extras.DiscardListMapper, org.jibx.extras.TypedArrayMapper, org.jibx.extras.IdRefMapperBase, org.jibx.extras.Dom4JElementMapper, org.jibx.extras.Dom4JListMapper,
IUnmarshaller | public interface IUnmarshaller (Code) | | Unmarshaller interface definition. This interface must be implemented
by the handler for unmarshalling an object.
Instances of classes implementing this interface must be serially
reusable, meaning they can store state information while in the process
of unmarshalling an object but must reset all state when called to
unmarshal another object after the first one is done (even if the first
object throws an exception during unmarshalling).
The JiBX framework will only create one instance of an unmarshaller class
for each mapped class using that unmarshaller. Generally the unmarshaller
instance will not be called recursively, but this may happen in cases where
the binding definition includes recursive mappings and the unmarshaller
uses other unmarshallers (as opposed to handling all children directly).
author: Dennis M. Sosnoski version: 1.0 |
isPresent | public boolean isPresent(IUnmarshallingContext ctx) throws JiBXException(Code) | | Check if instance present in XML. This method can be called when the
unmarshalling context is positioned at or just before the start of the
data corresponding to an instance of this mapping. It verifies that the
expected data is present.
Parameters: ctx - unmarshalling context true if expected parse data found,false if not throws: JiBXException - on error in unmarshalling process |
unmarshal | public Object unmarshal(Object obj, IUnmarshallingContext ctx) throws JiBXException(Code) | | Unmarshal instance of handled class. This method call is responsible
for all handling of the unmarshalling of an object from XML text,
including creating the instance of the handled class if an instance is
not supplied. When it is called the unmarshalling context is always
positioned at or just before the start tag corresponding to the start of
the class data.
Parameters: obj - object to be unmarshalled (may be null ) Parameters: ctx - unmarshalling context unmarshalled object (may be null ) throws: JiBXException - on error in unmarshalling process |
|
|