Das Property-Element der Mappingdefinition bezieht sich immer auf die direkte Objektstruktur, genauer gesagt auf eine Property.
<Property name="Kunden" listElementName="Kunde" elementName="Kundenliste" className="List[Kundemstamm]">
<Property name="m_konto" elementName="Kundennummer" required="true" />
<Property name="m_sa" elementName="Satzart" default="1" />
<Property name="firma" elementName="Firma" const="1" />
</Property>
Das Vaterobjekt hat eine Property namens Kunden, die eine Liste vom Typ Kunde darstellt. Für jeden dieser Kunden gibt es ein XML-Element das Kunde heisst. Für jeden dieser Kunden gibt es jeweils ein Zwangselement namens Kundennummer, ein Satzart Element das, wenn nicht angegeben, den Wert 1 hat und ein Firma-Element das immer 1 liefert.
Alle diese Kundenelemente werden unter das Element Kundenliste gruppiert.
Die resultierende XML-Struktur sieht also so aus:
<Kundenliste>
<Kunde>
<Kundennummer />
<Satzart>1</Satzart>
</Kunde>
<Kunde>
...
</Kunde>
...
</Kundenliste>
Name der Property auf die sich das Mapping bezieht.
Name des XML-Elementes auf den sich die Property bezieht.
Nur bei Listen. Ist die Property ein Listentyp muss dieses Attribut gesetzt werden. Jedes Item dieser Liste hat dann den listElementName als Elementnamen.
Ist darüberhinaus das elementName Attribut gesetzt, werden die Listenelemente unter diesem zusätzlich Gruppiert, sonst werden sie einfach dem Vaterelement zugeordnet.
Schalter der angibt, ob ein Element gesetzt werden muss! Also ein Zwangsparameter.
Ein Standardwert, auf den zurückgegriffen wird, wenn kein Wert gesetzt ist. Kann nicht in Verbindung mit required="true" verwendet werden!
Ein Wert der alles überschreibt und wenn angegeben immer Verwendung findet.
Kann bei einigen Typen für eine Formatierung angegen werden. z.B. DateTime.
Muss bei Properties mit Kindern und Listen angeben werden. Dort können auch mit Semikolon getrennt, verscheidene spezifiziert werden.
Bei generischen Typen muss der Typ mit den in Klammern angegebennen generischen Parametern, die wiederum mit Doppelpunkt getrennt werden, angegeben werden,
z.B:
List[Kundenstamm]
GenericTypeWrapper[List[int]:List[string]]
Dictionary[string:int]