Let's say you want to allow some particular XML element to occur 0+ times. For example, the <record>
element can occur multiple times:
<repository>
<record>Record 1</record>
<record>Record 2</record>
<record>Record 3</record>
</repository>
Are there any compelling reasons to include a parent element as a container for these? For example, the following uses the <recordSet>
element to contain the <record>
elements:
<repository>
<recordSet>
<record>Record 1</record>
<record>Record 2</record>
<record>Record 3</record>
</recordSet>
</repository>
I tried to find any related questions before posing this, so my apologies if it has been asked already. Thanks in advance for any and all input!
Edit - July 22, 2009:
Thanks to everyone for the excellent feedback! (I would comment / vote people up, but I don't have enough reputation points quite yet.) I'll probably go ahead with this route, and I also wanted to thank @16bytes for their advice, including to simply name the parent by using the plural of the reoccurring child elements.
Container. xml is the top-level generation properties file used by the batch processor to create enterprise Web service descriptions (in the “bottom-up” scenario), Web services implementation artifacts (in the “top-down” scenario), and message converters for CICS® and IMS applications.
An XML tree starts at a root element and branches from the root to child elements. All elements can have sub elements (child elements): <root> <child>
1.1 The Schema Namespace ( xs ) The XML representation of schema components uses a vocabulary identified by the namespace name http://www.w3.org/2001/XMLSchema . For brevity, the text and examples in this specification use the prefix xs: to stand for this namespace; in practice, any prefix can be used.
XML documents must contain a root element (one that is the parent of all other elements). All elements in an XML document can contain sub elements, text and attributes. The tree represented by an XML document starts at the root element and branches to the lowest level of elements.
You've stumbled across the second of my XML design guide rules (the first being use attributes only for IDs and real meta data, the third being don't use namespaces unless you know what you're doing) that I try to use when designing xml documents. In addition to being a good rule-of-thumb, it also makes your document:
One suggestion, I would try:
<Root>
<Items>
<Item>a</Item>
<Item>b</Item>
<Item>c</Item>
</Items>
</Root>
The simpler "s" suffix is more succinct and easier to remember and apply. If you use a generic collection noun, you or a colleague will forget which one eventually, so you'd see Sets mixed with Lists mixed with Container. But that's more style than good practice and I don't want to start a religious war ;)
(UpperCamel for elements!, lowerCamel for attributes! --sorry)
Having a parent element makes it simpler to identify sections of the XML and makes it simpler for handlers to map the child elements to a collection. If you have a system that forbids the use of attributes (some do, it's annoying), you also need to use wrapper elements to distinguish properties (such as ids) that belong to particular children.
Other than that it is valid to omit the parent element and can make the file markedly less verbose.
In your first example, a user element could be mingled in with the records, this is valid but it might be hard to spot:
<repository>
<record>Record 1</record>
<record>Record 2</record>
<user>Bill</user>
<record>Record 3</record>
</repository>
Whereas with a surrounding element you can separate the collection, and have multiple instances of that collection:
<repositories>
<users>
<user>Bill</user>
</users>
<repository>
<id>id1</id>
<recordSet>
<id>recordSet1</id>
<record>Record 1</record>
<record>Record 2</record>
<record>Record 3</record>
</recordSet>
<recordSet>
<id>recordSet2</id>
<record>Record 1</record>
<record>Record 2</record>
<record>Record 3</record>
</recordSet>
</repository>
<repository>
<id>id2</id>
<recordSet>
<record>Record 1</record>
<record>Record 2</record>
<record>Record 3</record>
</recordSet>
</repository>
</repositories>
Although I also have an instinctive preference for wrapped collections, it is interesting to note that Google have a different opinion.
XML elements that merely wrap repeating child elements SHOULD NOT be used. [Rationale: They are not used in Atom and add nothing.]
That is useful if in your <repository>
you want to allow for multiple <recordSet>
elements:
<repository>
<recordSet id="1">
<record>Record 1</record>
<record>Record 2</record>
<record>Record 3</record>
</recordSet>
<recordSet id="2">
<record>Record 2.1</record>
<record>Record 2.2</record>
<record>Record 2.3</record>
</recordSet>
</repository>
If you love us? You can donate to us via Paypal or buy me a coffee so we can maintain and grow! Thank you!
Donate Us With