org.jibx.extras
Class IdDefRefMapperBase

java.lang.Object
  org.jibx.extras.IdDefRefMapperBase

All Implemented Interfaces:

IAliasable, IMarshaller, IUnmarshaller

public abstract class IdDefRefMapperBase
extends Object
implements IMarshaller, IUnmarshaller, IAliasable

Abstract base custom marshaller/unmarshaller for an object that may have multiple references. The first time an object is seen when marshalling the full XML representation is generated; successive uses of the same object then use XML references to the object ID. To use this class you need to create a subclass with a constructor using the same signature as the one provided (calling the base class constructor from your subclass constructor) and implement the abstract getIdValue(java.lang.Object) method in your subclass. You can also override the provided getAttributeName() method to change the name used for the IDREF attribute, which must not match the name of an attribute used in the normal marshalled form of the object. The name used for this marshaller/unmarshaller in the mapping definition must match the name used for the base object type being handled.

Author:

Dennis M. Sosnoski

Constructor Summary

IdDefRefMapperBase(String uri, int index, String name)
Aliased constructor taking a name definition for reference elements.

Method Summary

protected String	getAttributeName() Method which can be overridden to supply a different name for the ID reference attribute.
protected abstract String	getIdValue(Object item) Get the ID value from object being marshalled.
boolean	isExtension(String mapname)
boolean	isPresent(IUnmarshallingContext ictx)
void	marshal(Object obj, IMarshallingContext ictx)
Object	unmarshal(Object obj, IUnmarshallingContext ictx)

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

IdDefRefMapperBase

public IdDefRefMapperBase(String uri,
                          int index,
                          String name)

Aliased constructor taking a name definition for reference elements. The subclass version will be used by JiBX to define the element name to be used with this custom marshaller/unmarshaller.

Parameters:

uri - namespace URI for the top-level element

index - namespace index corresponding to the defined URI within the marshalling context definitions

name - local name for the reference element

Method Detail

getIdValue

protected abstract String getIdValue(Object item)

Get the ID value from object being marshalled.

Returns:

ID value

getAttributeName

protected String getAttributeName()

Method which can be overridden to supply a different name for the ID reference attribute. The attribute name used by default is just "ref".

isExtension

public boolean isExtension(String mapname)

Specified by:

isExtension in interface IMarshaller

marshal

public void marshal(Object obj,
                    IMarshallingContext ictx)
             throws JiBXException

Specified by:

marshal in interface IMarshaller

Throws:

JiBXException

isPresent

public boolean isPresent(IUnmarshallingContext ictx)
                  throws JiBXException

Specified by:

isPresent in interface IUnmarshaller

Throws:

JiBXException

unmarshal

public Object unmarshal(Object obj,
                        IUnmarshallingContext ictx)
                 throws JiBXException

Specified by:

unmarshal in interface IUnmarshaller

Throws:

JiBXException