Package org.simpleframework.xml.core
Class ModelSection
java.lang.Object
org.simpleframework.xml.core.ModelSection
The
ModelSection
represents a section that is backed
by a Model
instance. This is used to expose the XML
structure of a schema class. In addition to wrapping the model
this will also apply a Style
to the names of the
attributes and elements of the class schema.-
Field Summary
FieldsModifier and TypeFieldDescriptionprivate LabelMap
Represents a mapping between styled names and attributes.private LabelMap
Represents a mapping between styled names and elements.private Model
This is the model that contains the elements and attributes.private ModelMap
Represents a mapping between styled names and models. -
Constructor Summary
Constructors -
Method Summary
Modifier and TypeMethodDescriptiongetAttribute
(String name) This is used to acquire the full attribute path for this section.Returns aLabelMap
that contains the details for all fields and methods marked with XML annotations.getElement
(String name) Returns the named element as aLabel
object.Returns aLabelMap
that contains the details for all fields and methods marked with XML annotations.Returns aLabelMap
that contains the details for all fields and methods marked with XML annotations.getName()
This is used to return the name of the section.This is used to acquire the full element path for this section.This is used to acquire the path prefix for the section.getSection
(String name) Returns the named section as aSection
object.getText()
This is used to acquire the text label for this section if one has been specified.boolean
To differentiate between a section and an element this can be used.iterator()
This will return the names of all elements contained within the model.Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
Methods inherited from interface java.lang.Iterable
forEach, spliterator
-
Field Details
-
attributes
Represents a mapping between styled names and attributes. -
elements
Represents a mapping between styled names and elements. -
models
Represents a mapping between styled names and models. -
model
This is the model that contains the elements and attributes.
-
-
Constructor Details
-
ModelSection
Constructor for theModelSection
object. This is used to wrap aModel
in such a way that it can not be modified. This allows it to be used concurrently.- Parameters:
model
- this is the model this section will wrap
-
-
Method Details
-
getName
This is used to return the name of the section. The name is must be a valid XML element name. It is used when a style is applied to a path as the section name must be styled. -
getPrefix
This is used to acquire the path prefix for the section. The path prefix is used when the section is transformed in to an XML structure. This ensures that the XML element created to represent the section contains the optional prefix. -
getPath
This is used to acquire the full element path for this section. The element path is simply the fully qualified path for this expression with the provided name appended. If this is an empty path, the provided name is returned. -
getAttribute
This is used to acquire the full attribute path for this section. The attribute path is simply the fully qualified path for this expression with the provided name appended. If this is an empty path, the provided name is returned.- Specified by:
getAttribute
in interfaceSection
- Parameters:
name
- this is the name of the attribute to be used- Returns:
- a fully qualified path for the specified name
- Throws:
Exception
-
iterator
This will return the names of all elements contained within the model. This includes the names of all XML elements that have been registered as well as any other models that have been added. Iteration is done in an ordered manner, according to the registration of elements and models. -
isSection
To differentiate between a section and an element this can be used. When iterating over the elements within the section the names of both elements and sections are provided. So in order to determine how to interpret the structure this can be used. -
getModels
Returns aLabelMap
that contains the details for all fields and methods marked with XML annotations. All of the attribute annotations are considered and gathered by name in this map. Also, if there is an associatedStyle
for serialization the attribute names are renamed with this.- Returns:
- returns the attributes associated with this section
- Throws:
Exception
-
getText
This is used to acquire the text label for this section if one has been specified. A text label can only exist in a section if there are no elements associated with the section and the section is not composite, as in it does not contain any further sections. -
getAttributes
Returns aLabelMap
that contains the details for all fields and methods marked with XML annotations. All of the attribute annotations are considered and gathered by name in this map. Also, if there is an associatedStyle
for serialization the attribute names are renamed with this.- Specified by:
getAttributes
in interfaceSection
- Returns:
- returns the attributes associated with this section
- Throws:
Exception
-
getElements
Returns aLabelMap
that contains the details for all fields and methods marked with XML annotations. All of the element annotations are considered and gathered by name in this map. Also, if there is an associatedStyle
for serialization the element names are renamed with this.- Specified by:
getElements
in interfaceSection
- Returns:
- returns the elements associated with this section
- Throws:
Exception
-
getElement
Returns the named element as aLabel
object. For convenience this method is provided so that when iterating over the names of the elements in the section a specific one of interest can be acquired.To ensure that elements of the same name are not referenced more than once this will remove the element once acquired. This ensures that they are visited only once in serialization.
- Specified by:
getElement
in interfaceSection
- Parameters:
name
- the name of the element that is to be acquired- Returns:
- this returns the label associated with the name
- Throws:
Exception
-
getSection
Returns the named section as aSection
object. For convenience this method is provided so that when iterating over the names of the elements in the section a specific one of interest can be acquired.To ensure that models of the same name are not referenced more than once this will remove the model once acquired. This ensures that they are visited only once in serialization.
- Specified by:
getSection
in interfaceSection
- Parameters:
name
- the name of the element that is to be acquired- Returns:
- this returns the section associated with the name
- Throws:
Exception
-