DataModel

...

1. By default each <field> starts out life as an <element> with text content.
2. A <field> can be set to be an attribute on the <class> element by using the <field xml.attribute="true"> syntax.
3. field/name becomes the name of the element (or attribute key).
   1. field#xml.tagName can be used to change the name of the element (or attribute key)
4. field/version is unused.
5. field/description is unused.
6. field/type is one of the following
   • boolean
   • char
   • double
   • int
   • long
   • short
   • date
   • String
   • Boolean
   • DOM (currently only supported by xpp3 generators)
   • Another <class> this can only be achieved through an association tag
7. field/association dictates the multiplicity of a field (1 to many, or 0 to many so far) allows linking to other classes of the model
   1. generated readers and writers do not enforce the multiplicity rules (yet)
   2. field/association must have at a minimum the <type> element defined.
   3. field/association/multiplicity dictates the multiplicity of a field (1 or * : 0 to many so far)
   4. field/association/type only refers to other <class> id's, no java primitives allowed here.
      1. field/association/type will be used to determine the name of the nested elements.
      2. singular form of the field tagname will be used for the nested element name.
         • s/(.*)ies$/\1y/g - "Properies" becomes "Property"
         • s/(.*(ch)?)es$/\1/g - "Branches" becomes "Branch"
         • s/(.*)s$/\1/g - "Reports" becomes "Report"
      3. field/association#xml.associationTagName can be used to specify an overridden nested element name.
      4. To learn more about tagName resolution, see TagName resolution
   5. field#xml.listStyle defaults to "wrapped".
      1. Example of field#xml.listStyle="wrapped"

         Code Block
         xml
         <!-- Model --> <class> <name>example</name> <fields> <field xml.listStyle="wrapped"> <name>components</name> <version>4.0.0</version> <association> <type>Component</type> <multiplicity>*</multiplicity> </association> </field> </fields> </class> <class> <name>Component</name> <version>4.0.0</version> <fields> <field> <name>name</name> <type>String</type> </field> </fields> </class>

         Code Block
         xml
         <!-- xml --> <example> <components> <component> <name>foo</name> </component> <component> <name>bar</name> </component> </components> </example>

      2. Example of field#xml.listStyle="flat"

         Code Block
         xml
         <!-- Model --> <class> <name>example</name> <fields> <field xml.listStyle="flat"> <name>components</name> <version>4.0.0</version> <association> <type>Component</type> <multiplicity>*</multiplicity> </association> </field> </fields> </class> <class> <name>Component</name> <version>4.0.0</version> <fields> <field> <name>name</name> <type>String</type> </field> </fields> </class>

         Code Block
         xml
         <!-- xml --> <example> <component> <name>foo</name> </component> <component> <name>bar</name> </component> </example>