org.jibx.binding.model

Class StructureElement

java.lang.Object

org.jibx.binding.model.ElementBase

org.jibx.binding.model.NestingElementBase

org.jibx.binding.model.ContainerElementBase

org.jibx.binding.model.StructureElementBase

org.jibx.binding.model.StructureElement

All Implemented Interfaces:

IComponent

public class StructureElement
extends StructureElementBase

Model component for structure element of binding definition.

Author:

Dennis M. Sosnoski

Property Summary

Properties inherited from class org.jibx.binding.model.StructureElementBase

hasProperty

Field Summary

Fields

Modifier and Type	Field and Description
static StringArray	s_allowedAttributes Enumeration of allowed attribute names

Fields inherited from class org.jibx.binding.model.ElementBase

BINDING_ELEMENT, COLLECTION_ELEMENT, ELEMENT_NAMES, FORMAT_ELEMENT, INCLUDE_ELEMENT, INPUT_ELEMENT, MAPPING_ELEMENT, NAMESPACE_ELEMENT, OUTPUT_ELEMENT, SPLIT_ELEMENT, STRUCTURE_ELEMENT, TEMPLATE_ELEMENT, VALUE_ELEMENT

Constructor Summary

Constructors

Constructor and Description
StructureElement() Default constructor.

Method Summary

Modifier and Type	Method and Description
protected void	classifyComponents(ValidationContext vctx) Classify child components as contributing attributes, content, or both.
TemplateElementBase	getEffectiveMapping() Get actual type mapping.
String	getMapAsName() Get name of mapping type.
org.jibx.runtime.QName	getMapAsQName() Get qualified name of mapping type.
String	getName() Get name.
IClass	getType() Get value type information.
String	getUri() Get specified namespace URI.
boolean	hasAttribute() Check if component defines one or more attribute values of the containing element.
boolean	hasContent() Check if component defines one or more elements or text values as children of the containing element.
boolean	hasDirectName() Check if this structure defines a name directly.
boolean	hasName() Check if component has a name.
void	setMapAsName(String name) Set name of mapping type.
void	setMapAsQName(org.jibx.runtime.QName name) Set qualified name of mapping type.
void	validate(ValidationContext vctx) Validate element information.

Methods inherited from class org.jibx.binding.model.StructureElementBase

getDeclaredType, getField, getFieldName, getFlag, getGet, getGetName, getGetType, getNamespace, getObjectType, getPrefix, getSet, getSetName, getSetType, getTest, getTestName, getUsage, getUsageName, hasObject, hasProperty, isFlagOnly, isImplicit, isOptional, prevalidate, setDeclaredType, setFieldName, setFlagName, setGetName, setName, setPrefix, setSetName, setTestName, setUri, setUsage, setUsageName

Methods inherited from class org.jibx.binding.model.ContainerElementBase

checkCompatibleChildren, getAttributeComponents, getChildObjectType, getContentComponents, getCreateClass, getCreateType, getFactory, getFactoryName, getId, getLabel, getMarshaller, getMarshallerName, getPostset, getPostsetName, getPreget, getPregetName, getPreset, getPresetName, getUnmarshaller, getUnmarshallerName, getUsing, isAllowRepeats, isChoice, isClassified, isFlexible, isNillable, isOrdered, setAllowRepeats, setChoice, setComponents, setCreateType, setFactoryName, setFlexible, setIdChild, setLabel, setMarshallerName, setNillable, setOrdered, setPostsetName, setPregetName, setPresetName, setUnmarshallerName, setUsing, verifyConstruction

Methods inherited from class org.jibx.binding.model.NestingElementBase

addChild, childIterator, children, getDefaultStyle, getDefinitions, getStyle, getStyleName, setStyleName

Methods inherited from class org.jibx.binding.model.ElementBase

getComment, name, setComment, toString, type, validateAttributes

Methods inherited from class java.lang.Object

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

Field Detail

s_allowedAttributes

public static final StringArray s_allowedAttributes

Enumeration of allowed attribute names

Constructor Detail

StructureElement

public StructureElement()

Default constructor.

Method Detail

getMapAsName

public String getMapAsName()

Get name of mapping type.

Returns:

mapping type name (or null if none)

setMapAsName

public void setMapAsName(String name)

Set name of mapping type. This method changes the qualified name to match the mapping type.

Parameters:

name - mapping type name (or null if none)

getMapAsQName

public org.jibx.runtime.QName getMapAsQName()

Get qualified name of mapping type.

Returns:

mapping qualified type name (or null if none)

setMapAsQName

public void setMapAsQName(org.jibx.runtime.QName name)

Set qualified name of mapping type. This method changes the mapping name to match the qualified name.

Parameters:

name - mapping qualified type name (or null if none)

getEffectiveMapping

public TemplateElementBase getEffectiveMapping()

Get actual type mapping. This call is only meaningful after validation.

Returns:

actual type mapping (or null if none)

hasDirectName

public boolean hasDirectName()

Check if this structure defines a name directly.

Returns:

true if name defined, false if not

hasName

public boolean hasName()

Description copied from interface: IComponent

Check if component has a name.

Specified by:

hasName in interface IComponent

Overrides:

hasName in class StructureElementBase

Returns:

true if component has a name, false if not

getName

public String getName()

Description copied from class: StructureElementBase

Get name.

Specified by:

getName in interface IComponent

Overrides:

getName in class StructureElementBase

Returns:

name text

getUri

public String getUri()

Description copied from class: StructureElementBase

Get specified namespace URI.

Specified by:

getUri in interface IComponent

Overrides:

getUri in class StructureElementBase

Returns:

namespace URI (null if not set)

hasAttribute

public boolean hasAttribute()

Description copied from interface: IComponent

Check if component defines one or more attribute values of the containing element. This method is only valid after validation.

Specified by:

hasAttribute in interface IComponent

Overrides:

hasAttribute in class StructureElementBase

Returns:

true if one or more attribute values defined for containing element, false if not

hasContent

public boolean hasContent()

Description copied from interface: IComponent

Check if component defines one or more elements or text values as children of the containing element. This method is only valid after validation.

Specified by:

hasContent in interface IComponent

Overrides:

hasContent in class StructureElementBase

Returns:

true if one or more content values defined for containing element, false if not

getType

public IClass getType()

Description copied from interface: IComponent

Get value type information. This call is only meaningful after prevalidation.

Specified by:

getType in interface IComponent

Overrides:

getType in class StructureElementBase

Returns:

type information

classifyComponents

protected void classifyComponents(ValidationContext vctx)

Classify child components as contributing attributes, content, or both. This method is needed to handle on-demand classification during validation. When a child component is another instance of this class, the method calls itself on the child component prior to checking the child component's contribution.

Overrides:

classifyComponents in class ContainerElementBase

Parameters:

vctx -

validate

public void validate(ValidationContext vctx)

Description copied from class: ElementBase

Validate element information. The validation step is used for checking the interactions between elements, such as name references to other elements. The ElementBase.prevalidate(org.jibx.binding.model.ValidationContext) method will always be called for every element in the binding definition before this method is called for any element. This empty base class implementation should be overridden by each subclass that requires validation handling.

Overrides:

validate in class StructureElementBase

Parameters:

vctx - validation context