XML Showcase

Details: Kategorie: operation.dsl

Dieser Showcase soll den lesenden Zugriff auf ein XML Dokument darstellen. Die darin enthaltenen Daten sollen als Objekte dem umgebenden System bereitgestellt werden. Das XML Dokument ist hierbei wie folgt strukturiert:

<?xml version="1.0" encoding="UTF-8"?>
<Bestellung>
<Stammdaten
  kundennummer = "HZ-3428.2623.1243"
  anrede = "Herr"
  vorname = "Max"
  nachname = "Mustermann"
  strasse = "Road to Hell"
  hausnummer = "666"
  postleitzahl = "66666"
  ort = "Helsinki"
/>
<Bestellpositionen>
<Position
  lfdNr = "1"
  artikelnummer = "12430520"
  artikelbezeichnung = "iBirne Notebook"
  einzelpreis = "950,00"
  menge = "1"
  gesamtpreis = "950,00"
/>
<Position
  lfdNr = "2"
  artikelnummer = "23498522"
  artikelbezeichnung = "Friedhof der Kuscheltiere"
  einzelpreis = "12,95"
  menge = "4"
  gesamtpreis = "51,80"
/>
<Position
  lfdNr = "3"
  artikelnummer = "56930366"
  artikelbezeichnung = "Michaels Scheuermilch"
  einzelpreis = ""
  menge = ""
  gesamtpreis = ""
/>
<Position
  lfdNr = "4"
  artikelnummer = "28582956"
  artikelbezeichnung = 'Badewanne "Gaby"'
  menge = "0"
/>
<Position
  lfdNr = "5"
  artikelnummer = "45636262"
  artikelbezeichnung = "Fliegende Untertasse"
  einzelpreis = "10000000,00"
  menge = "-1"
  gesamtpreis = ""
/>
<Position
  lfdNr = "6"
  artikelnummer = "87295296"
  einzelpreis = "0,55"
  menge = "1"
  gesamtpreis = "0,55"
/>
</Bestellpositionen>

<Lieferadresse>
  <vorname>J.</vorname>
  <nachname>Suéz</nachname>
  <strasse>Stairway to Heaven</strasse>
  <hausnummer>7</hausnummer>
  <postleitzahl>77777</postleitzahl>
  <ort>Rom</ort>
</Lieferadresse>

<Rechnungsadresse></Rechnungsadresse>

</Bestellung>

Um die Daten adäquat abzubilden, sind zunächst die benötigten Transportobjekte zu definieren:

Customer.java

public class Customer {
  private String kundennummer;
  private String anrede;
  private String vorname;
  private String nachname;
  private String strasse;
  private String hausnummer;
  private String postleitzahl;
  private String ort;

// + getter und setter
}

Orderitem.java

public class Orderitem {
  private Long lfdNr;
  private String artikelnummer;
  private String artikelbezeichnung;
  private Double einzelpreis;
  private Long menge;
  private Double gesamtpreis;

// + getter und setter
}

Address.java

public class Address {
  private String vorname;
  private String nachname;
  private String strasse;
  private String hausnummer;
  private String postleitzahl;
  private String ort;

// + getter und setter
}

BillingAddress.java

public class BillingAddress extends Address {}

ShippingAddress.java

public class ShippingAddress extends Address {}

Für die Erzeugung von Orderitems nutzen wir eine Factory-Klasse:

OrderitemFactory.java

public class OrderitemFactory {
public Orderitem createNew() {
return new Orderitem();
}
}

Danach kann in einer separaten Textdatei (Showcase.odsl) die DSL-Operationen beschrieben werden:

Stammdaten:
Für jedes Element 'Stammdaten'
in Datei ${dateiname}
führe aus
${customer}.Kundennummer = [Element].kundennummer;
${customer}.Anrede = [Element].anrede;
${customer}.Vorname = [Element].vorname;
${customer}.Nachname = [Element].nachname;
${customer}.Strasse = [Element].strasse;
${customer}.Hausnummer = [Element].hausnummer;
${customer}.Postleitzahl = [Element].postleitzahl;
${customer}.Ort = [Element].ort;

Bestellpositionen:
Für jedes Element 'Position'
bei dem lfdNr ist nicht leer
und artikelnummer ist nicht leer
und einzelpreis ist nicht leer
und menge größer als 0
in Element 'Bestellpositionen'
in Datei ${dateiname}
führe aus
${bestellposition} = ${orderitem}.createNew();
${bestellposition}.LfdNr = [Element].lfdNr;
${bestellposition}.Artikelnummer = [Element].artikelnummer;
${bestellposition}.Artikelbezeichnung = [Element].artikelbezeichnung;
${bestellposition}.Einzelpreis = [Element].einzelpreis;
${bestellposition}.Menge = [Element].menge;
${bestellposition}.Gesamtpreis = [Element].gesamtpreis;
${orderitems}.add( ${bestellposition} );

Rechnungsadresse:
Für jedes Element bei dem Elementtyp in ( 'vorname',
'nachname',
'strasse',
'hausnummer',
'postleitzahl',
'ort' )
in Element 'Rechnungsadresse'
in Datei ${dateiname}
führe aus
${attributname} = [Element].Elementtyp;
${billingaddress}.${attributname} = [Element].textContent;

Lieferadresse:
Für jedes Element bei dem Elementtyp in ( 'vorname',
'nachname',
'strasse',
'hausnummer',
'postleitzahl',
'ort' )
in Element 'Lieferadresse'
in Datei ${dateiname}
führe aus
${attributname} = [Element].Elementtyp;
${shippingaddress}.${attributname} = [Element].textContent;

Nun kann der Zugriff auf die XML Datei erfolgen.

String filename = ".\\XML Showcase.xml";

OperationDsl dsl = new OperationDsl();

XmlPlugin xml = new XmlPlugin();
FilePlugin file = new FilePlugin();

dsl.addPlugin(xml);
dsl.addPlugin(file);

Customer customer = new Customer();
List<Orderitem> orderitems = new LinkedList<Orderitem>();
BillingAddress billingAddress = new BillingAddress();ShippingAddress shippingAddress = new ShippingAddress();

DslContext context = new DslContext();
context.addExternalParameter("dateiname", filename);
context.addExternalParameter("customer", customer);
context.addExternalParameter("orderitems", orderitems);
context.addExternalParameter("orderitem", new OrderitemFactory());
context.addExternalParameter("shippingaddress", shippingAddress);
context.addExternalParameter("billingaddress", billingAddress);

DslExpressions readOrder = dsl.parseFile("ShowCase.odsl", Locale.GERMAN);
readOrder.execute(context);

// Ab hier stehen die Daten in den Transportobjekten zur Verfügung

...