GuiBuilder goes XML

Warum XML?

XML ist auf dem besten Weg, der Standard für Dokumenten-basierten Informationsaustausch zu werden.
Genau betrachtet ist die Beschreibung eine Oberflächenspezifikation ist auch nur ein Dokument, welches nach klaren Regeln strukturiert ist. Es liegt also nahe, diese Regeln in einer DTD festzulegen, und auf dieser Basis mit einem beliebigen XML-Editor Oberfläche zu spezifizieren.

Wie funktioniert das?

Sie können den Editor des GuiBuilder verwenden, um ihre Oberfläche in XML zu spezifizieren. Hierzu müssen einige formale Dinge eingehalten werden:

• Ein XML-Dokument muß mit der folgenden Zeile beginnen:
  <?xml version="1.0" encoding="ISO-8859-1"?>
  Der Zeichensatz ISO-8859-1 hat den Vorteil, daß hier auch normale deutsche Umlaute eingegeben werden können; lediglich die Zeichen ">" und "<" müssen wie in HTML umschrieben werden ("&gt;" "&lt;").
• Kommentare werden in die Zeichenfolgen <!-- und --> eingeschlossen:
  <!-- Ein Kommentar -->
• Container werden mit einem Begin und Ende-Tag beschrieben:
  <Panel>
...
</Panel>
• Einzelnen Komponenten mit ihren Attributen etwa so:
  <Text label="Name1:" it="15" />
• Der Wert von Attributen wird in XML grundsätzlich in "" eingeschlossen.
• Auf die Groß- und Kleinschreibung ist zu achten.
• Als Datei-Extension ist .xml anzugeben.
• Fehlerhafte XML-Syntax wird vom Parser zurückgewiesen.

Siehe auch Beispiel.xml

Dokumenten-Validierung

Für die Validierung von Spezifikationen dient die Datei "gdl.dtd".

Der Vorteil einer Validierung besteht darin, daß unzulässige Tags und ihre Attribute sowie unzulässige Schachtelungen von Containern vom Parser mit einer Fehlermeldung zurückgewiesen werden.

Um die Validierung einzuschalten, ist nach der Zeile <?xml ...> eine entsprechende Deklaration einzutragen und die gesamte Spezifikation mit den Tags <GDL> ... </GDL> zu umschließen.
Beispiel:

<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE GDL SYSTEM "gdl.dtd">
<GDL>
   <Form label="Beispiel für Validierung">
   ...
   </Form>
</GDL>

In der Datei "GuiBuilderConfig.xml" kann ein Default-Wert für den initialen Inhalt des Editor eingetragen werden.

Hierbei werden verschiedene Defaults gesetzt, je nachdem ob über das file-Protokoll oder per HTTP auf Dateien zugegriffen wird.

Hinweis:
Die Datei "gdl.dtd" wird vom Parser in der Codebase des Applet gesucht.

XML-Editor

Der GuiBuilder kann als XML-Editor verwendet werden, vor allem um Beispieldaten zu speichern und wieder zu laden.

Um die Speicherung der Daten etwas von Layout-Änderungen unabhängig zu machen, werden standardmäßig nur Registerkarten als Unterkontainer bei der Gliedrung des XML-Dokumentes verwendet, also keine nomalen Panels oder Gruppen.

Hierzu werden die Attribute "name" und "ref" verwendet:

• Mit "name" wird der Name einer Oberflächenkomponente festgelegt.
  Wird das Attribut "name=" weggelassen, wird das Attribute "label=" als Namen der Komponente verwendet.
  Dieser Name muß für je Formular oder Dialog und je Registerkarte eindeutig sein.
• Mit "ref" kann das Standardverhalten bei der Schachtelung von Child Containern verändert werden:
  Mit ref="-" wird eine Registerkarte nicht als Container verwendet.
  Umgekehrt kann mit ref="*" ein Panel oder eine Gruppe als Container erzwungen werden.

Für die Speicherung und das Laden von XML-Dokumenten dienen die Methoden "XmlSave()" und "XmlOpen()"; sie können in dem Attribute "file" einem Menüeintrag, einem Button oder einem Tool in der Toolbar zugewiesen werden.

Für die Validierung dieser Dokumente wird guivalues.dtd verwendet.

XML-Navigator

Für die Erfassung tief gestaffelter XML-Dokumente kann das Navigator-Pattern eingesetzt werden:

• In einem Split-Panel wird links eine Tree-Komponente angeordent.
• Für die Gliederung des XML-Dokumentes werden die Schlüsselworte "Element" und "Content" eingesetzt.
• Dem Schlüsselwort "Element" kann mit dem Attribut "file=" eine GuiSpezifikation zugewiesen werden.
• Mit "Content" wird festgelegt, welche Elemente ein Element enthalten darf.
• Die Standard-Methode "NewNode()" öffnet einen Dialog, in dem die zu diesem Knoten erlaubten Unterelemente angeboten werden.
• Mit "CutNode()", "CopyNode()" und "PasteNode()" kann die Struktur des Baums verändert werden.

Als Beispiel siehe Büro.xml.

Konvertierung von GDL nach XML

Im Popup-Menü des Editors gibt es einen Eintrag "Generate XML...".

Mit ihm können "alte" Spezifikation nach XML konvertiert werden.

Risiken und Nebenwirkungen

Eine Erweiterung des Sprachumfangs ist bei dem Einsatz dieser DTD nicht möglich, es sei denn, Sie erweitern auch die DTD entsprechend.

Versionen von Spezifikationen sind nur eingeschränkt möglich (Schlüsselwort "Case" wird bei der XML-Notation als Attribut verwendet). Bei der Konvertierung der "alten" Notation nach XML wird die jeweils eingestellt Variante generiert.

Stand: 4.6.2000

home