Package org.jibx.binding.def
Interface IMapping
-
- All Superinterfaces:
ILinkable
- All Known Implementing Classes:
MappingBase,MappingDefinition,MappingDirect,PrecompiledAbstractMapping,PrecompiledConcreteMapping
public interface IMapping extends ILinkable
Interface for mapping definitions.- Author:
- Dennis M. Sosnoski
-
-
Method Summary
All Methods Instance Methods Abstract Methods Modifier and Type Method Description voidaddExtension(MappingDefinition mdef)Add extension to abstract mapping.voidaddNamespace(NamespaceDefinition ns)Add namespace.IComponentbuildRef(IContainer parent, IContextObj objc, java.lang.String type, PropertyDefinition prop)Build reference to mapping.voidgenerateCode(boolean force)Generate required code for mapping.ITypeBindinggetBinding()Get the actual binding for a mapping.java.lang.StringgetBoundType()Get class name handled by mapping.IComponentgetImplComponent()Get binding component implementing mapping.java.lang.StringgetMappingName()Get the mapping name used in binding tables.ClassFilegetMarshaller()Get marshaller class used for mapping.NameDefinitiongetName()Get mapped element name.java.util.ArrayListgetNamespaces()Get namespaces defined for mapping.java.lang.StringgetReferenceType()Get class name of type to be assumed for references to this mapping.java.lang.StringgetTypeName()Get type name.ClassFilegetUnmarshaller()Get unmarshaller class used for mapping.booleanisAbstract()Check if mapping is abstract.booleanisBase()Check if mapping has extensions.-
Methods inherited from interface org.jibx.binding.def.ILinkable
setLinkages
-
-
-
-
Method Detail
-
getBoundType
java.lang.String getBoundType()
Get class name handled by mapping.- Returns:
- name of class bound by mapping
-
getReferenceType
java.lang.String getReferenceType()
Get class name of type to be assumed for references to this mapping.- Returns:
- reference type class name name
-
getImplComponent
IComponent getImplComponent()
Get binding component implementing mapping. This call is only valid for mappings with child components, not for mappings defined using marshallers or unmarshallers.- Returns:
- binding component implementing this mapping
-
getMarshaller
ClassFile getMarshaller() throws JiBXException
Get marshaller class used for mapping.- Returns:
- marshaller class information
- Throws:
JiBXException- if error in configuration
-
getUnmarshaller
ClassFile getUnmarshaller() throws JiBXException
Get unmarshaller class used for mapping.- Returns:
- unmarshaller class information
- Throws:
JiBXException- if error in configuration
-
getName
NameDefinition getName()
Get mapped element name.- Returns:
- mapped element name information (may be
nullif no element name defined for mapping)
-
getTypeName
java.lang.String getTypeName()
Get type name.- Returns:
- qualified type name, in text form (
nullif unnamed)
-
getMappingName
java.lang.String getMappingName()
Get the mapping name used in binding tables.- Returns:
- name
-
addNamespace
void addNamespace(NamespaceDefinition ns) throws JiBXException
Add namespace. This adds a namespace definition to those active for the mapping.- Parameters:
ns- namespace definition to be added- Throws:
JiBXException- if error in defining namespace
-
isAbstract
boolean isAbstract()
Check if mapping is abstract.- Returns:
trueif an abstract mapping,falseif not
-
isBase
boolean isBase()
Check if mapping has extensions.- Returns:
trueif one or more mappings extend this mapping,falseif not
-
addExtension
void addExtension(MappingDefinition mdef) throws JiBXException
Add extension to abstract mapping. This call is only valid for abstract mappings.- Parameters:
mdef- extension mapping definition- Throws:
JiBXException- if configuration error
-
buildRef
IComponent buildRef(IContainer parent, IContextObj objc, java.lang.String type, PropertyDefinition prop) throws JiBXException
Build reference to mapping. Constructs and returns the component for handling the mapping.- Parameters:
parent- containing binding definition structureobjc- current object contexttype- mapped value typeprop- property definition (may benull)- Returns:
- constructed mapping reference component
- Throws:
JiBXException- if configuration error
-
getNamespaces
java.util.ArrayList getNamespaces()
Get namespaces defined for mapping.- Returns:
- namespace definitions (may be
nullif none)
-
generateCode
void generateCode(boolean force) throws JiBXExceptionGenerate required code for mapping.- Parameters:
force- add marshaller/unmarshaller classes for abstract non-base mappings flag (not passed on to children)- Throws:
JiBXException- if error in transformation
-
getBinding
ITypeBinding getBinding()
Get the actual binding for a mapping. This is only usable with mappings defined by a binding; if the mapping is instead defined by specifying marshaller and unmarshaller classes this will just return null.- Returns:
- binding structure, or
nullif none
-
-