ESIMapper
ESIMapper objects contain the logic to interpret ESIMap object contents. They also create output. ESIMapper objects provide three public methods. The methods are:
map(object : Object, map : ESIMap) : Element
This method creates a mapped Info*Engine element object from the Object argument.
map(inputElement : Element, map : ESIMap) : Element
This method creates a mapped Info*Engine element object from another Info*Engine element object.
map(inputElement : Element, map : ESIMap, includeEmptyAttributes : boolean) : Element
This method creates a mapped Info*Engine element object from another Info*Engine element object. If a false was passed in for includeEmptyAttributes, only those Atts having a value will be returned with the output element. The behaviour of this method is identical to map(inputElement : Element, map : ESIMap) if a true was passed in for includeEmptyAttributes.
map(inputElement : Element, persistedObject : Persistable, map : ESIMap) : Element
This method creates a mapped Info*Engine element object from another Info*Engine element object. If the source element object does not have the value specified in Source_Name of the attributeMapping (or map file) entry, the mapper attempts to obtain the value from the Persistable object in the second method argument.
map(object : Object, map : ESIMap, softTypes : Map) : Element
This method creates a mapped Info*Engine element object from the Object argument. If the method is unable to fetch the value of a given source attribute in the passed ESIMap instance, it creates an entry in the output Map (softTypes) with the relevant source and target attribute names as the key and value. The output Map thus ends up having entries for all the soft attributes that were added to the given object. The caller will then be able to process this Map and proceed to map those soft attributes as appropriate.