Tutorial:
JavaScout ProjectAssist, Task-Frame Finalisierung (Java_Fatclient_01) –
Verwenden des 'DocumentListener' und anderer 'Listener'

Haupt-Thema dieses Schrittes ist die Klasse 'DocumentListener'.

Ein Objekt der Klasse 'DocumentListener' wird allen GUI-Elementen hinzugefügt und bei der Veränderung des (angezeigten) Wertes eines GUI-Elementes löst der 'DocumentListener' einen 'Event' aus.
Das Auslösen eines 'Event's und die Implementierung des passenden Codes wurde bereits im Document Tutorial: JavaScout ProjectAssist, Start-Frame Grundlagen (Java_Fatclient_01) – Auswählen der Geschäftsanwendung behandelt.

Zum Hinzufügen des 'DocumentListener's wird eine Methode verwendet, die bereits in der Basisklasse JSBS_TaskFrame implementiert ist. Diese Methode fügt auch andere 'Listener' (z.B. einen, der darauf reagiert wenn der Positionszeiger / 'Cursor' in einem Eingabefeld platziert wird) zu den GUI-Elementen hinzu.

Inhaltsverzeichnis:

Voriger Schritt:Task-Frame Grundlagen – Liste der Daten anzeigen und zur Bearbeitung auswählen 

Vorbemerkung 
Vorbedingungen 
Klasse JS_ProjAssist_Project__DocumentListener eröffnen 
Individueller Code in JS_ProjAssist_Project__DocumentListener, Teil 1 
* Importieren der Bibliotheken 
* Erben der Basisklasse JSBS_TaskFrame__DocumentListener 
* Definieren der Variablen 
* 'Constructor' der Klasse 
* Abfragen, in welchem GUI-Element eine Eingabe erfolgt ist 
Zusätzlicher Code in JS_ProjAssist_Project 
Prüf-Regeln und Hinweis-Text in der Datei 'DisplayStrings.xml' 
Zwischen-Test 1 
MouseListener zur Tabelle mit den gefundenen Datensätzen hinzufügen 
Zwischen-Test 2 
Individueller Code in JS_ProjAssist_Project__DocumentListener, Teil 2: Aktivieren / Deaktivieren von Schaltflächen 
* Methode checkEntriesOK() zum Prüfen auf fehlerfreie Eingabe 
* Methode zum Aktivieren/Deaktivieren der Schaltfläche [ Speichern ] 
* Methode zum Aktivieren/Deaktivieren der Schaltfläche [ Kopieren ] 
* Methode zum Aktivieren/Deaktivieren aller Schaltflächen 
* Aufrufen der Methode zum Aktivieren/Deaktivieren aller Schaltflächen 
End-Test 
Gesamter Code am Ende des Schrittes 
* Klasse JS_ProjAssist_Project 
* Klasse JS_ProjAssist_Project__ActionHandler 
* Klasse JS_ProjAssist_Project__DocumentListener 
Weitere Schritte und verwandte Dokumentation 

Nächster Schritt: Letzte Feinheiten

Vorbemerkung

▲ zum Inhaltsverzeichnis

Vorbedingungen:

• Voriger Schritt Task-Frame Grundlagen – Liste der Daten anzeigen und zur Bearbeitung auswählen abgeschlossen.

▲ zum Inhaltsverzeichnis

Klasse JS_ProjAssist_Project__DocumentListener eröffnen

Das Eröffnen der neuen Klasse wird nur in Stichworten und ohne Abbildungen dokumentiert.
Wenn Sie sich unsicher sind, sehen Sie bitte unter Schritt 2: Klasse für das StartFrame eröffnen nach, wie eine Klasse eröffnet wird.

Package: js_projassist.client
Name: JS_ProjAssist_Project__DocumentListener
[ ] public static void main(String[] args)   (nicht markiert)
[ ] Constructors from superclass   (nicht markiert)
[ ] Inherited abstract methods   (nicht markiert)

▲ zum Inhaltsverzeichnis

Individueller Code in JS_ProjAssist_Project__DocumentListener, Teil 1

Zuerst wird der grundlegende Code des 'DocumentListener' implementiert.
Das ist neben dem Import der Bibliotheken, der Vererbung und der Definition der Variablen auch das Abfragen, von welchem GUI-Element der 'DocumentEvent' ausgelöst wurde und danach das Prüfen der Eingabe im entsprechenden GUI-Element.

Den kompletten Code der Klasse finden Sie im Abschnitt Gesamter Code für JS_ProjAssist_Project__DocumentListener.

▲ zum Inhaltsverzeichnis

Importieren der Bibliotheken

package js_projassist.client;
/*
 * Packages mit den Klassen für die Behandlung von Document und -Event. */
import javax.swing.text.Document;
import javax.swing.event.DocumentEvent;
/*
 * Package mit der Basisklassen für das TaskFrame. */
import js_base.frame.*;
/* */
public class JS_ProjAssist_Project__DocumentListener extends JSBS_TaskFrame__DocumentListener {

Es werden Bibliotheken mit den Klassen für das 'Document', 'DocumentEvent' und den Basisklassen für Fenster (frames) importiert.
In der Bibliothek js_base.frame ist auch die Basisklasse JSBS_TaskFrame__DocumentListener enthalten.

▲ zum Inhaltsverzeichnis

Erben der Basisklasse JSBS_TaskFrame_DocumentListener

/* */
public class JS_ProjAssist_Project__DocumentListener extends JSBS_TaskFrame__DocumentListener {
/*

In der Basisklasse JSBS_TaskFrame_DocumentListener ist der Code für die Behandlung jener GUI-Elemente, die in der Basisklasse JSBS_TaskFrame definiert sind, enthalten.
In der Basisklasse wird auch das Aktivieren / Deaktivieren der Schaltflächen [ Bearbeiten ] (btn_Get) und [ Löschen ] (btn_Delete) gesteuert.

▲ zum Inhaltsverzeichnis

Definieren der Variablen

public class JS_ProjAssist_Project__DocumentListener extends JSBS_TaskFrame__DocumentListener {
/*
 * Referenz auf das zugehörige Task-Frame. */
    private JS_ProjAssist_Project frmTF;
/*
 * Objekte der Klasse 'Document', die für die Textaufbereitung bei GUI-Elementen zuständig sind.
 * Diese werden aus Performanz-Gründen im 'Constructor' aus den GUI-Elementen herausgelesen und
 * in den folgenden Variablen gehalten. */
    private Document doc_txt_ProjectCode;
    private Document doc_txt_LanguageCode;
    private Document doc_txt_TargetDirectoryName;
/*
 * Merker (Flags) ob die Eingaben in den GUI-Elementen korrekt sind. */
    private boolean bol_txt_ProjectCode_OK;
    private boolean bol_txt_LanguageCode_OK;
    private boolean bol_txt_TargetDirectoryName_OK;
/*
 * Constructor der Klasse.

In der Klasse sind 3 Arten von Variablen notwendig.

• Die Referenz auf das aufrufende Task-Frame.
  Diese Referenz wird im 'Constructor' der Klasse übernommen und ist notwendig, um auch in anderen Methoden auf die GUI-Elemente der Task-Frame-Klasse zugreifen zu können.
  
  /*
 * Referenz auf das zugehörige Task-Frame. */
    private JS_ProjAssist_Project frmTF;

• Die 'Document'-Objekte der GUI-Elemente, deren Wert vom Anwender verändert werden kann.
Diese 'Document'-Objekte werden in der Constructor-Methode für die jeweiligen Eingabefelder ermittelt.
Der Grund dafür ist eine wesentliche Verbesserung der Performanz des Programms. Aus dem 'DocumentEvent' (siehe Abfragen, in welchem GUI-Element eine Eingabe erfolgt ist) kann nur das 'Document' des jeweiligen GUI-Elementes ermittelt werden – nicht aber das GUI-Element selbst. Um nicht erst dann für jedes GUI-Element das 'Document' auslesen zu müssen (um ermitteln zu können, in welchem GUI-Element eine Eingabe durch den Anwender erfolgt ist), werden die jeweiligen 'Document's in den Variablen für den Vergleich gehalten.

/*
 * Objekte der Klasse 'Document', die für die Textaufbereitung bei GUI-Elementen zuständig sind.
 * Diese werden aus Performanz-Gründen im 'Constructor' aus den GUI-Elementen herausgelesen und
 * in den folgenden Variablen gehalten. */
    private Document doc_txt_ProjectCode;
    private Document doc_txt_LanguageCode;
    private Document doc_txt_TargetDirectoryName;

• Die Flags (Merker) für jedes GUI-Element (dessen Wert verändert werden kann), ob der Eingabewert dir festgelegte Prüfung bestanden hat.
Die Prüf-Regeln sind in der XML-Struktur mit den sprachabhängigen Texten für die GUI-Elemente (Datei 'DisplayStrings.xml') definiert und werden durchgeführt wenn der vom Anwender eingegebene Wert aus dem GUI-Element ausgelesen wird.
Das 'Auslesen' der Werte ist unter Abfragen, in welchem GUI-Element eine Eingabe erfolgt ist dokumentiert.

/*
 * Merker (Flags) ob die Eingaben in den GUI-Elementen korrekt sind. */
    private boolean bol_txt_ProjectCode_OK;
    private boolean bol_txt_LanguageCode_OK;
    private boolean bol_txt_TargetDirectoryName_OK;

▲ zum Inhaltsverzeichnis

'Constructor' der Klasse

    private boolean bol_txt_LanguageCode_OK;
/*
 * Constructor der Klasse.
 * Code darin wird aufgerufen wenn ein Objekt dieser Klasse erstellt wird.
 * Als Parameter wird das jeweilig TaskFrame übernommen. */
    public JS_ProjAssist_Project__DocumentListener(JS_ProjAssist_Project parmTF) {
/*
 * Aufruf des Constructors der Basisklasse (JSBS_TaskFrame__DocumentListener).
 * Darin werden die Klasse des aufrufenden TaskFrames und die 'Document's der GUI-Elemente,
 * die in der Basisklasse (JSBS_TaskFrame) definiert sind, in die dort definierten
 * Variablen übertragen. */
        super (parmTF);
/* 
 * Übernehmen der als Parameter übergebenen Referenz auf das aufrufende Task-Frame
 * in die Variable dieser Klasse. */
        frmTF = parmTF;
/* 
 * 'Herausholen' des jeweiligen 'Document' aus den GUI-Elementen für die Eingabe von Werten.
 * Das wird aus Performanz-Gründen einmalig im 'Constructor' durchgeführt. */
        doc_txt_ProjectCode = frmTF.get_txt_ProjectCode().getDocument();
        doc_txt_LanguageCode = frmTF.get_txt_LanguageCode().getDocument();
        doc_txt_TargetDirectoryName = frmTF.get_txt_TargetDirectoryName().getDocument();
/* 
 * Erstmaliges 'Setzen' der OK-Flags.
 * Für alle als 'Mandatory' definierten GUI-Elemente wird 'false' gesetzt.
 * Damit wird bewirkt, daß beim erstmaligen Aufrufen des Task-Frames in leere Felder,
 * die als 'Mandatory' definiert sind, Werte eingegeben werden müssen. */
        bol_txt_ProjectCode_OK =
            frmTF.structJSBS_EntryRules.checkMandatory(frmTF.get_txt_ProjectCode());
        bol_txt_LanguageCode_OK =
            frmTF.structJSBS_EntryRules.checkMandatory(frmTF.get_txt_LanguageCode());
        bol_txt_TargetDirectoryName_OK =
            frmTF.structJSBS_EntryRules.checkMandatory(frmTF.get_txt_TargetDirectoryName());
    }

Der 'Constructor' der Klasse enthält Code für folgende Verarbeitungen:

• Aufrufen des 'Constructors' der geerbten Klasse.
Für den dabei ausgeführten Code sehen Sie bitte bei der Basisklasse JSBS_TaskFrame__DocumentListener nach.

/*
 * Aufruf des Constructors der Basisklasse (JSBS_TaskFrame__DocumentListener).
 * Darin werden die Klasse des aufrufenden TaskFrames und die 'Document's der GUI-Elemente,
 * die in der Basisklasse (JSBS_TaskFrame) definiert sind, in die dort definierten
 * Variablen übertragen. */
        super (parmTF);

• Ermitteln des jeweiligen 'Document' der GUI-Elemente, für die der Benutzer eine Eingabe tätigen kann.
Der Sinn dieses Algorithmus wurde bereits im Abschnitt Definieren der Variablen dokumentiert.

/* 
 * 'Herausholen' des jeweiligen 'Document' aus den GUI-Elementen für die Eingabe von Werten.
 * Das wird aus Performanz-Gründen einmalig im 'Constructor' durchgeführt. */
        doc_txt_ProjectCode = frmTF.get_txt_ProjectCode().getDocument();
        doc_txt_LanguageCode = frmTF.get_txt_LanguageCode().getDocument();
        doc_txt_TargetDirectoryName = frmTF.get_txt_TargetDirectoryName().getDocument();

• Beim ersten Aufruf des Task-Frames sind alle Eingabefelder noch leer.
Für Felder, bei denen eine Eingabe nicht zwingend erforderlich ist (definiert als 'Mandatory'), erfolgt vom Anwender unter Umständen keine Eingabe. Damit erfolgt auch keine Prüfung und das Flag bleibt so, wie es zu Beginn gesetzt wurde.

Der 'Beginn' ist in dieser Methode und mit dem folgenden Code werden Flags danach gesetzt, ob die zugehörenden Eingaben als 'Mandatory' definiert sind oder nicht.

Da die Deifinition von 'Mandatory' in der Datei 'DisplayStrings.xml' erfolgt kann das Zuweisen von true oder false nicht im Programm codiert werden sondern muß über die dokumentierte Methode erfolgen.

/* 
 * Erstmaliges 'Setzen' der OK-Flags.
 * Für alle als 'Mandatory' definierten GUI-Elemente wird 'false' gesetzt.
 * Damit wird bewirkt, daß beim erstmaligen Aufrufen des Task-Frames in leere Felder,
 * die als 'Mandatory' definiert sind, Werte eingegeben werden müssen. */
        bol_txt_ProjectCode_OK =
            frmTF.structJSBS_EntryRules.checkMandatory(frmTF.get_txt_ProjectCode());
        bol_txt_LanguageCode_OK =
            frmTF.structJSBS_EntryRules.checkMandatory(frmTF.get_txt_LanguageCode());
        bol_txt_TargetDirectoryName_OK =
            frmTF.structJSBS_EntryRules.checkMandatory(frmTF.get_txt_TargetDirectoryName());

  
  

▲ zum Inhaltsverzeichnis

Abfragen, in welchem GUI-Element eine Eingabe erfolgt ist

In dieser Methode wird abgefragt, von welchem 'Document' (eines GUI-Elementes) der 'Event' ausgelöst wurde.
Anschließend wird der betreffende geänderte Wert geprüft und – wenn die Prüf-Regeln bestanden wurden - auf die zugehörige Variable des dafür vorgesehenen BO übertragen.

Im Detail sind nur die einzelnen Anweisungen für ein GUI-Element beschrieben; den kompletten Code finden Sie im Abschnitt Gesamter Code für JS_ProjAssist_Project__DocumentListener.

/*
 * Methode die indirekt aufgerufen wird wenn ein Wert eines GUI-Elements verändert wird.
 * 'Indirekt aufgerufen' bedeutet, daß die mit dem 'DocumentListener' zu implementierenden
 * 'abstrakten Methoden' in der Basisklasse (JSBS_TaskFrame__DocumentListener) 'konkret'
 * implementiert sind und in diesen Methoden diese Methode (anyUpdate) aufgerufen wird.
 * Dieser Code ist also das 'Überschreiben' der Methode der geerbten Klasse. */
    public void anyUpdate(DocumentEvent e) {
/*
 * Aufruf der Methode in der geerbten Klasse.
 * Damit werden die in den Basisklassen definierten GUI-Elemente verarbeitet. */
        super.anyUpdate(e);
/* 
 * 'Document' welches den Event ausgelöst hat, aus dem Event ermitteln. */
        Document edoc = e.getDocument();
/* 
 * 'Document' mit allen als Variable definierten (und im Constructor ermittelten)
 * 'Document's der GUI-Elemente vergleichen. */
        if (edoc == doc_txt_ProjectCode) {
/* Wert des GUI-Elementes in die Hilfs-Variable (definiert in der geerbten Klasse)
 * übertragen. In der verwendeten Methode wird auch die Prüfung auf Gültigkeit
 * des eingegebenen Wertes durchgeführt und der Hintergrund des GUI-Elements eingefärbt. */
          strAuxString =
            JSBS_GUIServices.getTextFromJTextField(frmTF.get_txt_ProjectCode(), frmTF);
/* Wenn der eingegebene Wert nicht den Prüf-Regeln entspricht dann ist von der Methode
 * zurückgelieferte Wert 'null'. Das wird abgefragt und damit das Flag gesetzt. */
          bol_txt_ProjectCode_OK = (strAuxString == null);
/* Wenn der eingegebene Wert die Prüf-Regeln bestanden hat dann wird der Wert auf das
 * zugehörige Attribut des BO übertragen. */
          bol_txt_ProjectCode_OK = (strAuxString == null);
          if (bol_txt_ProjectCode_OK)
            frmTF.structJS_ProjAssist_ProjectLanguage_BOC_Processed.ProjectCode =
            strAuxString;
        }
/* 
 * Nächstes 'Document' vergleichen. */
        if (edoc == doc_txt_LanguageCode) {
. . . . . . . .
. . . . . . . .

Zuerst wird die Methode in der geerbten Klasse aufgerufen.
Das ist notwendig, weil beim 'Überschreiben' einer Methode die Methode mit gleichem Namen in der geerbten Klasse 'stillgelegt' ist.
In der geerbten Klasse werden alle GUI-Elemente bearbeitet, die schon in der Basisklasse JSBS_TaskFrame definiert sind.

    public void anyUpdate(DocumentEvent e) {
/*
 * Aufruf der Methode in der geerbten Klasse.
 * Damit werden die in den Basisklassen definierten GUI-Elemente verarbeitet. */
        super.anyUpdate(e);
/* 

Aus dem im Parameter übergebenen 'Event' wird 'herausgelöst' von welchem 'Document' dieser ausgelöst wurde.
Anschließend wird durch Vergleich des 'Document's ermittelt, in welchem GUI-Element die Eingabe erfolgt ist.

/* 
 * 'Document' welches den Event ausgelöst hat, aus dem Event ermitteln. */
        Document edoc = e.getDocument();
/* 
 * 'Document' mit allen als Variable definierten (und im Constructor ermittelten)
 * 'Document's der GUI-Elemente vergleichen. */
        if (edoc == doc_txt_ProjectCode) {
/* Wert des GUI-Elementes in die Hilfs-Variable (definiert in der geerbten Klasse)

Der Eingabe-Wert des GUI-Elementes wird durch eine leistungsfähige Methode der Basisklassen (siehe Klasse JSBS_GUIServices) auf eine Hilfs-Variable (in der geerbten Klasse definiert) übertragen.
Die Methode zum 'Auslesen' des Wertes führt auch gleichzeitig die Prüfung durch, ob der eingegebene Wert den (eventuell) definierten Prüf-Regeln entspricht und färbt (abhängig von bestandener / nicht bestandener Prüfung) den Hintergrund des GUI-Elements.

Wenn die Eingabe nicht der Prüf-Regel entspricht wird der Wert 'null' zurückgeliefert und in die Hilfs-Variable übertragen.

/* Wert des GUI-Elementes in die Hilfs-Variable (definiert in der geerbten Klasse)
 * übertragen. In der verwendeten Methode wird auch die Prüfung auf Gültigkeit
 * des eingegebenen Wertes durchgeführt und der Hintergrund des GUI-Elements eingefärbt. */
          strAuxString =
            JSBS_GUIServices.getTextFromJTextField(frmTF.get_txt_ProjectCode(), frmTF);
/* Wenn der eingegebene Wert nicht den Prüf-Regeln entspricht dann ist von der Methode
 * zurückgelieferte Wert 'null'. Das wird abgefragt und damit das Flag gesetzt. */
          bol_txt_ProjectCode_OK = ( strAuxString != null);
/* Wenn der eingegebene Wert die Prüf-Regeln bestanden hat dann wird der Wert auf das

Durch eine boolsche Operation (mit kürzest-möglichem Code – aber hoffentlich durchschaubar) wird das entsprechende Flag gesetzt.
Wenn die Prüf-Regeln erfüllt sind, wird der Wert aus dem Eingabe-Feld in die entsprechende Variable des dafür vorgesehenen BO übertragen.

/* Wenn der eingegebene Wert die Prüf-Regeln bestanden hat dann wird der Wert auf das
 * zugehörige Attribut des BO übertragen. */
          if (bol_txt_ProjectCode_OK)
            frmTF.structJS_ProjAssist_ProjectLanguage_BOC_Processed.ProjectCode =
            strAuxString;
        }

▲ zum Inhaltsverzeichnis

Zusätzlicher Code in JS_ProjAssist_Project

• Für den 'DocumentListener' muß ein Objekt definiert werden.
  
  /* */
public class JS_ProjAssist_Project extends JSBS_TaskFrame {
/*
 * Zugehöriges DocumentListener Objekt definieren. */
    protected JS_ProjAssist_Project__DocumentListener
                structJS_ProjAssist_Project__DocumentListener;
/*

• Als zusätzliche Schritte müssen der 'DocumentListener' 'konstruiert' werden und anschließend zu den betroffenen GUI-Elementen hinzugefügt werden.
  Das Hinzufügen geschieht durch Aufruf der Methode addListeners(...) (implementiert in der Basisklasse JSBS_TaskFrame).
  In dieser Methode werden noch weitere 'Listener' zu den GUI-Elementen hinzugefügt. Für eine detaillierte Information dazu sehen Sie bitte im Code der geerbten Basisklasse nach.
  
  /* 
 * Methode mit den Initialisierungen die notwendig sind nachdem das Frame (Window)
 * angezeigt wird. */
    private void initialize_after_frame() {
/* Methode zum Zuordnen des sprachabhängigen Textes zu den GUI-Elementen aufrufen. */
      JSBS_GUIServices.processLanguageDependantElements(this);
/* DocumentListener konstruieren und anschlißend die Methode der geerbten Klasse
 * aufrufen mit der die notwendigen Listener zu den GUI-Elementen hinzugefügt werden. */
      structJS_ProjAssist_Project__DocumentListener =
          new JS_ProjAssist_Project__DocumentListener(this);
      addListeners(this.getContentPane(), structJS_ProjAssist_Project__DocumentListener);
/* Methode zum Anzeigen der aktuell gültigen Projekt-/Sprach-Kombinationen aufrufen. */
      JS_ProjAssist_Project__ActionHandler.redisplayList(this);
    }

• Für das korrekte funktionieren des Anwendungsprogramms ist es notwendig, für Variable, die Teil des Anwender-bekannten Schlüssels sind, ein Wert erfaßt werden muß (definiert als 'Mandatory').
  Die Prüf-Regeln sind generell in der XML-Struktur in der Datei 'DisplayStrings.xml' festgelegt.
  Um zu verhindern, daß bei einer unpassenden Erfassung der Prüf-Regeln ein unerwünschtes Verhalten des Programms auftritt, werden Eingaben, die unbedingt erforderlich sind, innerhalb des Programm-Codes festgelegt.
  Diese Festlegung ist immer 'stärker' als die Prüf-Regeln aus der Datei 'DisplayStrings.xml'.
  Die verwendete Datenstruktur (Variable) structJSBS_EntryRules ist in der geerbten Klasse (JSBS_TaskFrame) definiert.
  
  /* 
 * Methode mit den Initialisierungen die notwendig sind nachdem das Frame (Window)
 * angezeigt wird. */
    private void initialize_after_frame() {
/* Methode zum Zuordnen des sprachabhängigen Textes zu den GUI-Elementen aufrufen. */
      JSBS_GUIServices.processLanguageDependantElements(this);
/* DocumentListener konstruieren und anschlißend die Methode der geerbten Klasse
 * aufrufen mit der die notwendigen Listener zu den GUI-Elementen hinzugefügt werden. */
      structJS_ProjAssist_Project__DocumentListener =
          new JS_ProjAssist_Project__DocumentListener(this);
      addListeners(this.getContentPane(), structJS_ProjAssist_Project__DocumentListener);
/* GUI-Elemente, bei denen eine Eingabe zwingend erforderlich ist ('Mandatory'),
 * festlegen. Die Festlegung hier ist 'stärker' als eine eventuelle Prüf-Regel
 * in der Datei 'DisplayStrings.xml'. */
      structJSBS_EntryRules.addApplicationMandatoryGUIElement(get_txt_ProjectCode());
      structJSBS_EntryRules.addApplicationMandatoryGUIElement(get_txt_LanguageCode());
/* Methode zum Anzeigen der aktuell gültigen Projekt-/Sprach-Kombinationen aufrufen. */
      JS_ProjAssist_Project__ActionHandler.redisplayList(this);
    }

▲ zum Inhaltsverzeichnis

Prüf-Regeln und Hinweis-Texte in der Datei 'DisplayStrings.xml'

Die Datei 'DisplayStrings.xml' wurde in Tutorial: JavaScout ProjectAssist, Start-Frame Grundlagen (Java_Fatclient_01) – Text für die GUI-Elemente von XML-Datei einlesen > XML-Struktur für sprachabhängige Texte konstruieren erstellt.
Der sprachabhängige Text für das Task-Frame wurde in Tutorial: JavaScout ProjectAssist, Task-Frame Grundlagen (Java_Fatclient_01) – Klasse für das Task-Frame zu Verwaltung von Projekt und Sprache eröffnen > Datei mit der XML-Struktur mit den sprachabhängigen Texten erweitern erfaßt.

In den folgenden Vorlagen sind nur die neuen Teile der Datei 'DisplayStrings.xml' dokumentiert.
Bitte fügen Sie die Texte in die Datei ein und achten Sie darauf, daß Sie nicht bestehenden Text versehentlich löschen !

Im Bereich <CommonElements> werden bei den Definitionen für die GUI-Elemente für die Eingabe von Projekt-Code und Sprach-Code folgende Prüf-Regeln erfaßt.

<root>
. . . . .
. . . . .
  <CommonElements>
    <CommonElement>
      <ElementName>btn_Continue</ElementName>
. . . . .
. . . . .
    <CommonElement>
      <ElementName>lbl_LanguageCode</ElementName>
      <ElementText>ISO-Sprach-Code:</ElementText>
      <ToolTipText>Code der Sprache für die die Daten gelten</ToolTipText>
    </CommonElement>
    <CommonElement>
      <ElementName>lbl_ProjectCode</ElementName>
      <ElementText>Projekt-Code:</ElementText>
      <ToolTipText>Code des Projektes für das die Daten gelten</ToolTipText>
    </CommonElement>
    <CommonElement>
      <ElementName>txt_LanguageCode</ElementName>
      <ToolTipText>Code der Sprache für die die Daten gelten</ToolTipText>
      <InfoMessage>Code der Sprache für die die Daten gelten</InfoMessage>
      <MinimumLength>2</MinimumLength>
      <MaximumLength>4</MaximumLength>
    </CommonElement>
    <CommonElement>
      <ElementName>txt_ProjectCode</ElementName>
      <ToolTipText>Code des Projektes für das die Daten gelten</ToolTipText>
      <InfoMessage>Code des Projektes für das die Daten gelten</InfoMessage>
      <MinimumLength>4</MinimumLength>
      <MaximumLength>16</MaximumLength>
    </CommonElement>
    <CommonElement>
. . . . .
. . . . .
  </CommonElements>
  <FrameIndividual>
    <Frame>
. . . . .
. . . . .

Im Bereich <SupplementaryText> werden die Texte erfaßt, die bei Fehlern angezeigt werden. Das Auslesen erfolgt durch Methoden in der Basisklasse JSBS_GUIServices.

</root>
  <SupplementaryText>
    <Element>
      <ElementName>Project__ActionHandler*FD_TitleBar</ElementName>
      <MessageText>Project__ActionHandler*FD_TitleBar</MessageText>
    </Element>
    <Element>
      <ElementName>JSBS_StringTooShort</ElementName>
      <MessageText>Eingabe zu kurz; mindestens notwendig:</MessageText>
    </Element>
    <Element>
      <ElementName>JSBS_StringTooLong</ElementName>
      <MessageText>Eingabe zu lang; maximal erlaubt:</MessageText>
    </Element>
  </SupplementaryText>
. . . . .
. . . . .
</root>

▲ zum Inhaltsverzeichnis

Zwischen-Test 1

Die Einstellungen und die Angabe der zu verwendenden Sprache als Parameter wurden schon im Schritt 2 ausgeführt und bleiben als Einstellung für das 'Project' erhalten.
Die Abfolge zum Starten wurde bereits in den beiden vorigen Schritten mit Abbildungen dokumentiert; deswegen folgen nur Stichworte:

• Zum Starten wird Run > Open Run Dialog ausgewählt.

• Im anschließend erscheinenden Fenster (Run) werden die Einstellungen nicht verändert und durch Anklicken der Schaltfläche [ Run ] das Programm gestartet.

▲ zum Inhaltsverzeichnis

MouseListener zur Tabelle mit den gefundenen Datensätzen hinzufügen

Um einen angezeigten Datensatz auch mit der Maus auswählen zu können, muß das GUI-Element pnl_SelectionListTable mit einem MouseListener versehen werden.
Der zusätzliche Code wird in der Methode initialize_frame() in der Klasse JS_ProjAssist_Project implementiert.

Hintergrundinformation:
Das Hinzufügen des MouseListener kann nicht in der Basisklasse erfolgen weil das GUI-Element pnl_SelectionListTable erst 'konstruiert' werden muß bevor der Listener hinzugefügt werden kann.
Auf das Hinzufügen von MouseListener zu allen GUI-Elementen in der Methode addListeners(...) (siehe Abschnitt Zusätzlicher Code in JS_ProjAssist_Project) wird aus Performanz-Gründen verzichtet.

/* 
 * Methode mit der das Frame (Window) angezeigt wird. */
    private void initialize_frame() {
/* Frame (Window) sichtbar machen (anzeigen). */
. . . . . . .
. . . . . . .
      setContentPane(get_pnl_Main());
/* Mouse-Listener zu der JTable, in der die auswählbaren Business-Objects angezeigt
 * werden, hinzufügen. Damit wird beim Anklicken einer Zeile der JTable die Nummer der
 * Zeile in das JTextField für die Auswahl (txt_Selection) übertragen.
 * Das Feststellen der Zeile und das Übertragen wird durch eine Methode in der
 * geerbten Basisklasse durchgeführt. */
      get_pnl_SelectionListTable().addMouseListener(this);
    }

▲ zum Inhaltsverzeichnis

Zwischen-Test 2

Die Einstellungen und die Angabe der zu verwendenden Sprache als Parameter wurden schon im Schritt 2 ausgeführt und bleiben als Einstellung für das 'Project' erhalten.
Die Abfolge zum Starten wurde bereits in den beiden vorigen Schritten mit Abbildungen dokumentiert; deswegen folgen nur Stichworte:

• Zum Starten wird Run > Open Run Dialog ausgewählt.

• Im anschließend erscheinenden Fenster (Run) werden die Einstellungen nicht verändert und durch Anklicken der Schaltfläche [ Run ] das Programm gestartet.

▲ zum Inhaltsverzeichnis

Individueller Code in JS_ProjAssist_Project__DocumentListener, Teil 2: Aktivieren / Deaktivieren von Schaltflächen

Um dem Anwender klar zu zeigen, welche 'Aktion' er durchführen kann, werden nur jene Schaltflächen aktiviert, die die eingegebenen Daten auch weiter verarbeiten können.

Die Steuerung der Schaltflächen beschränkt sich in diesem Tutorial nur auf jene Schaltflächen, die in diesem Tutorial auch verwendet werden ([ Speichern ] und [ Speichern ]; weiters [ Bearbeiten ] und [ Löschen ] die bereits in der geerbten Basisklasse gesteuert werden).

▲ zum Inhaltsverzeichnis

Methode checkEntriesOK() zum Prüfen auf fehlerfreie Eingabe

/*
 * Methode, die alle Flags (boolsche Variablen die signalisieren, ob die Eingabe im zugehörigen
 * GUI-Element die Eingabe-Regel erfüllt) zu einer boolschen Variable zusammenfaßt.
 * Die dafür verwendete Variable ist in der geerbten Klasse definiert. */
    private void checkEntriesOK() {
/* Boolsche Operation die prüft, ob alle Eingaben den Eingabe-Regeln entsprechen. */
        bolCompleteEntryOK =
              bol_txt_ProjectCode_OK
           && bol_txt_LanguageCode_OK
           && bol_txt_TargetDirectoryName_OK;
    }

Es ist häufig notwendig zu Prüfen, ob die Eingabe der Werte in den Feldern fehlerfrei ist.
Deswegen ist bereits in der geerbten Basis-Klasse eine Variable dafür vorgesehen (bolCompleteEntryOK) und die boolsche Verknüpfung wird in einer eigenen Methode implementiert.

▲ zum Inhaltsverzeichnis

Methode zum Aktivieren/Deaktivieren der Schaltfläche [ Speichern ]

/*
 * Methode, die prüft ob die Schaltfläche 'btn_Store' (Speichern) zu aktivieren oder zu
 * deaktivieren ist. */
    private void setButtonStatus_Store() {
/* Zuerst die Methode aufrufen, die alle OK-Flags in eine Variable zusammenfaßt. */
        checkEntriesOK();
/*
 * Boolsche Operation innerhalb der 'setEnabled'-Methode des JButton:
 * Es müssen alle Eingaben (in den GUI-Elementen) der jeweiligen Eingabe-Regel entsprechen
 * (geprüft über 'bolCompleteEntryOK')
 *  und
 * mindestens eine Variable des BO muß verändert worden sein
 * (geprüft durch den Vergleich des BO nach dem Lesen von / Speichern auf der Datenbank oder
 * nach dem 'Kopieren' mit dem BO, daß die aktuellen Eingaben in den GUI-Elementen enthält). */
        frmTF.get_btn_Store().setEnabled(bolCompleteEntryOK &&
              (frmTF.structJS_ProjAssist_ProjectLanguage_BOC_Read.isDifferent(
                  frmTF.structJS_ProjAssist_ProjectLanguage_BOC_Processed)));
    }

Um einen klar strukturierten Code zu erreichen wird die Prüfung für jede Schaltfläche in einer eigener Methode implementiert – auch um den Preis, redundante Verarbeitungen auszuführen.

In dieser Methode wird zuerst die Methode zum Prüfen, ob alle Eingabe-Werte die jeweiligen Eingabe-Regeln erfüllen, aufgerufen.
Die Schaltfläche wird dann aktiviert, wenn alle Eingabe-Werte fehlerfrei sind und überhaupt ein Eingabe-Wert verändert wurde.
Die Prüfung auf Veränderung wird durchgeführt, indem das BO (Business Object) mit den aktuell angezeigten Werten mit jenem BO, daß die Werte zum Zeitpunkt der Datenbank-Operation (Speichern oder Lesen) enthält, verglichen wird.

▲ zum Inhaltsverzeichnis

Methode zum Aktivieren/Deaktivieren der Schaltfläche [ Kopieren ]

/*
 * Methode, die prüft ob die Schaltfläche 'btn_Copy' (Kopieren) zu aktivieren oder zu
 * deaktivieren ist. */
    private void setButtonStatus_Copy() {
/* Zuerst die Methode aufrufen, die alle OK-Flags in eine Variable zusammenfaßt. */
        checkEntriesOK();
/*
 * Boolsche Operation innerhalb der 'setEnabled'-Methode des JButton:
 * Es müssen alle Eingaben (in den GUI-Elementen) der jeweiligen Eingabe-Regel entsprechen
 * (geprüft über 'bolCompleteEntryOK')
 *  und
 * es darf keine Variable des BO seit dem letzen Lesen von / schreiben auf die Datenbank
 * verändert worden sein
 * (geprüft durch den Vergleich des BO nach dem Lesen von / Speichern auf der Datenbank oder
 * nach dem 'Kopieren' mit dem BO, daß die aktuellen Eingaben in den GUI-Elementen enthält). */
        frmTF.get_btn_Copy().setEnabled(bolCompleteEntryOK &&
              ! (frmTF.structJS_ProjAssist_ProjectLanguage_BOC_Read.isDifferent(
                    frmTF.structJS_ProjAssist_ProjectLanguage_BOC_Processed)));
    }

Ein BO kann kopiert werden, wenn noch kein Wert einer Variable verändert wurde.
Das Abfragen, ob alle eingegebenen Werte fehlerfrei sind, verhindert, daß die Schaltfläche aktiviert wird wenn das Frame 'konstruiert' wurde.
Zu diesem Zeitpunkt sind zwar die Variablen-werte beider BO identisch – aber noch keine Werte angezeigt.

▲ zum Inhaltsverzeichnis

Methode zum Aktivieren/Deaktivieren aller Schaltflächen

/*
 * Methode, die alle Methoden, die einzelne Schaltflächen (JButtons) aktivieren bzw.
 * deaktivieren. */
    public void setButtonStatus() {
/* Button-Status für die Schaltflächen zur Auswahl oder zum Löschen eines BO (Datensatzes)
 * setzen. Diese Methode ist in der geerbten Basis-Klasse implementiert. */
        super.setButtonStatus_Selection();
/* Methoden dieser Klasse aufrufen. */
        setButtonStatus_Store();
        setButtonStatus_Copy();
    }

In dieser Methode wurde der Einfachheit des Codes der Vorzug gegeben – und Methoden redundant ausgeführt.

Dabei werden alle Methoden zum Prüfen und Aktivieren / Deaktivieren der einzelnen Schaltflächen aufgerufen.

▲ zum Inhaltsverzeichnis

Aufrufen der Methode zum Aktivieren/Deaktivieren aller Schaltflächen

Die Prüfung, ob einzelne Schaltflächen zu aktivieren oder zu deaktivieren sind, muß an verschiedenen Stellen des Anwendungsprogramms aufgerufen werden.

• Nachdem das Frame 'konstruiert' wurde (Klasse JS_ProjAssist_Project) :

/* 
 * Methode mit den Initialisierungen die notwendig sind nachdem das Frame (Window)
 * angezeigt wird. */
    private void initialize_after_frame() {
/* Methode zum Zuordnen des sprachabhängigen Textes zu den GUI-Elementen aufrufen. */
. . . . .
. . . . .
      JS_ProjAssist_Project__ActionHandler.redisplayList(this);
/* 
 * Prüfen und Aktivieren / Deaktivieren von Schaltflächen (JButtons). */
      structJS_ProjAssist_Project__DocumentListener.setButtonStatus();
    }

• Nach dem Speichern eines BO (Klasse JS_ProjAssist_Project__ActionHandler) :

/*
 * Methode die ausgeführt wird wenn eingegebene Daten auf der Datenbank gespeichert
 * werden sollen. */
    private static void store(JS_ProjAssist_Project parmTF) {
/* 
 * Werte aus den GUI-Elementen auf die Variablen des BO übertragen.
. . . . .
. . . . .
      redisplayList(parmTF);
/*
 * Methode zum Aktivieren / Deaktivieren von Schaltflächen (JButtons) aufrufen. */
        parmTF.structJS_ProjAssist_Project__DocumentListener.setButtonStatus();
    }

• Nach dem Kopieren eines BO (Klasse JS_ProjAssist_Project__ActionHandler) :

/*
 * Methode die ausgeführt wird wenn eingegebene Daten, die auf der Datenbank gespeichert
 * sind, verändert und als neuer Datensatz gespeichert werden sollen. */
    private static void copy(JS_ProjAssist_Project parmTF) {
/* 
 * Anwender darauf aufmerksam machen, daß der Anwender-bekannte Schlüssel
. . . . .
. . . . .
        parmTF.get_txt_LanguageCode().setEditable(true);
/*
 * Methode zum Aktivieren / Deaktivieren von Schaltflächen (JButtons) aufrufen. */
        parmTF.structJS_ProjAssist_Project__DocumentListener.setButtonStatus();
    }

• Nach jeder Eingabe des Benutzers in einem GUI-Element (Klasse JS_ProjAssist_Project__DocumentListener) :

/*
 * Methode die indirekt aufgerufen wird wenn ein Wert eines GUI-Elements verändert wird.
 * 'Indirekt aufgerufen' bedeutet, daß die mit dem 'DocumentListener' zu implementierenden
 * 'abstrakten Methoden' in der Basisklasse (JSBS_TaskFrame__DocumentListener) 'konkret'
 * implementiert sind und in diesen Methoden diese Methode (anyUpdate) aufgerufen wird.
 * Dieser Code ist also das 'Überschreiben' der Methode der geerbten Klasse. */
    public void anyUpdate(DocumentEvent e) {
/*
 * Aufruf der Methode in der geerbten Klasse.
. . . . .
. . . . .
        }
/* 
 * Prüfen und Aktivieren / Deaktivieren von Schaltflächen (JButtons). */
        setButtonStatus();
    }

▲ zum Inhaltsverzeichnis

End-Test

Die Einstellungen und die Angabe der zu verwendenden Sprache als Parameter wurden schon im Schritt 2 ausgeführt und bleiben als Einstellung für das 'Project' erhalten.
Die Abfolge zum Starten wurde bereits in den beiden vorigen Schritten mit Abbildungen dokumentiert; deswegen folgen nur Stichworte:

• Zum Starten wird Run > Open Run Dialog ausgewählt.

• Im anschließend erscheinenden Fenster (Run) werden die Einstellungen nicht verändert und durch Anklicken der Schaltfläche [ Run ] das Programm gestartet.

▲ zum Inhaltsverzeichnis

Gesamter Code am Ende des Schrittes

▲ zum Inhaltsverzeichnis

Klasse JS_ProjAssist_Project

package js_projassist.client;
/*
 * Packages mit den GUI-Elementen. */
import java.awt.*;
import javax.swing.*;
/*
 * Package mit den Klassen zum Bearbeiten von Events */
import java.awt.event.*;
/*
 * Package mit der Basisklasse für das TaskFrame. */
import js_base.frame.*;
/*
 * Package mit den Business-Objects. */
import js_projassist.boc.*;
/* */
public class JS_ProjAssist_Project extends JSBS_TaskFrame {
/*
 * Zugehöriges DocumentListener Objekt definieren. */
    protected JS_ProjAssist_Project__DocumentListener
                structJS_ProjAssist_Project__DocumentListener;
/*
 * Business-Objects (Client-Side-Klasse) definieren. */
    protected JS_ProjAssist_ProjectLanguage_BOC
                structJS_ProjAssist_ProjectLanguage_BOC_Read;
    protected JS_ProjAssist_ProjectLanguage_BOC
                structJS_ProjAssist_ProjectLanguage_BOC_Processed;
/*
 * Liste mit Business-Objects (Client-Side-Klasse) für die Anzeige definieren. */
    protected JS_ProjAssist_ProjectLanguage_BOC_Set
                structJS_ProjAssist_ProjectLanguage_BOC_Set;
/*
 * GUI-Elemente die für diesen Task-Frame spezifisch sind. */
    protected JLabel lbl_ProjectCode;
    protected JTextField txt_ProjectCode;
    protected JLabel lbl_LanguageCode;
    protected JTextField txt_LanguageCode;
    protected JLabel lbl_TargetDirectoryName;
    protected JTextField txt_TargetDirectoryName;
    protected JButton btn_TargetDirectorySelection;
/*
 * Constructor der Klasse.
 * Code darin wird aufgerufen wenn ein Objekt dieser Klasse erstellt wird.
 * Als Parameter wird das StartFrame (CommandCenter) übernommen;
 * das StartFrame enthält alle Einstellungen, die für die gesamte Anwendung gelten
 * und die Verbindung zu Datenbank oder Java-Application-Server (JAS). */
    public JS_ProjAssist_Project(JS_ProjAssist_CommandCenter parmCC) {
/*
 * Aufruf des Constructors der Basisklasse (JSBS_TaskFrame).
 * Darin werden die Klasse des StartFrames und eventuell Werte einzelner Variablen
 * in lokale Variablen übertragen. */
        super (parmCC);
/* 
 * Aufrufen der Methoden mit den individuellen Initialisierungen für diese Klasse. */
      initialize_before_frame();
      initialize_frame();
      initialize_after_frame();
    }
/* 
 * Methode mit den Initialisierungen die notwendig sind bevor das Frame (Window)
 * angezeigt wird. */
    private void initialize_before_frame() {
/* 
 * 'Konstruieren' der Business-Objects, die in diesem Task-Frame verwendet werden. */
      structJS_ProjAssist_ProjectLanguage_BOC_Read =
                new JS_ProjAssist_ProjectLanguage_BOC(this);
      structJS_ProjAssist_ProjectLanguage_BOC_Processed =
                new JS_ProjAssist_ProjectLanguage_BOC(this);
      structJS_ProjAssist_ProjectLanguage_BOC_Set =
                new JS_ProjAssist_ProjectLanguage_BOC_Set(this);
    }
/* 
 * Methode mit der das Frame (Window) angezeigt wird. */
    private void initialize_frame() {
/* Frame (Window) sichtbar machen (anzeigen). */
      setVisible(true);
/* Anfangsgröße festlegen. */
      setSize(800, 600);
/* Grund-Panel mit den weiteren GUI-Elementen anzeigen.
 * Die GUI-Elemente und deren Anordnung sind in der geerbten Klasse
 * (JSBS_StartFrame) festgelegt. */
      setContentPane(get_pnl_Main());
/* Mouse-Listener zu der JTable, in der die auswählbaren Business-Objects angezeigt
 * werden, hinzufügen. Damit wird beim Anklicken einer Zeile der JTable die Nummer der
 * Zeile in das JTextField für die Auswahl (txt_Selection) übertragen.
 * Das Feststellen der Zeile und das Übertragen wird durch eine Methode in der
 * geerbten Basisklasse durchgeführt. */
      get_pnl_SelectionListTable().addMouseListener(this);
    }
/* 
 * Methode mit den Initialisierungen die notwendig sind nachdem das Frame (Window)
 * angezeigt wird. */
    private void initialize_after_frame() {
/* Methode zum Zuordnen des sprachabhängigen Textes zu den GUI-Elementen aufrufen. */
      JSBS_GUIServices.processLanguageDependantElements(this);
/* DocumentListener konstruieren und anschlißend die Methode der geerbten Klasse
 * aufrufen mit der die notwendigen Listener zu den GUI-Elementen hinzugefügt werden. */
      structJS_ProjAssist_Project__DocumentListener =
          new JS_ProjAssist_Project__DocumentListener(this);
      addListeners(this.getContentPane(), structJS_ProjAssist_Project__DocumentListener);
/* GUI-Elemente, bei denen eine Eingabe zwingend erforderlich ist ('Mandatory'),
 * festlegen. Die Festlegung hier ist 'stärker' als eine eventuelle Prüf-Regel
 * in der Datei 'DisplayStrings.xml'. */
      structJSBS_EntryRules.addApplicationMandatoryGUIElement(get_txt_ProjectCode());
      structJSBS_EntryRules.addApplicationMandatoryGUIElement(get_txt_LanguageCode());
/* Methode zum Anzeigen der aktuell gültigen Projekt-/Sprach-Kombinationen aufrufen. */
      JS_ProjAssist_Project__ActionHandler.redisplayList(this);
/* 
 * Prüfen und Aktivieren / Deaktivieren von Schaltflächen (JButtons). */
      structJS_ProjAssist_Project__DocumentListener.setButtonStatus();
    }
/* 
 * ******************************
 * Methoden zum 'Construct' (Initialisierung) der einzelnen GUI-Elemente.
 * */
    protected JLabel get_lbl_ProjectCode() {
/* Zuerst Prüfen, ob die Variable bereits 'constructed' (initialisiert) ist. */
      if (lbl_ProjectCode == null) {
/* Variable noch nicht 'constructed'; Code für die Initialisierung folgt. */
        try {
          lbl_ProjectCode = new JLabel();
          lbl_ProjectCode.setName("lbl_ProjectCode");
          lbl_ProjectCode.setHorizontalAlignment(SwingConstants.TRAILING);
        }
        catch (Throwable Exc) {
/* Fehler beim 'construct' ist sehr unwahrscheinlich und kann nur beim 'Starten'
 * des Tasks auftreten.
 * Deswegen werden Fehlermeldungen nur auf der Konsole ausgegeben. */
          System.out.println("Error while building lbl_ProjectCode in class JS_ProjAssist_Project");
          Exc.printStackTrace();
        }
      }
      return lbl_ProjectCode;
    }
/* */
    protected JTextField get_txt_ProjectCode() {
/* Zuerst Prüfen, ob die Variable bereits 'constructed' (initialisiert) ist. */
      if (txt_ProjectCode == null) {
/* Variable noch nicht 'constructed'; Code für die Initialisierung folgt. */
        try {
          txt_ProjectCode = new JTextField();
          txt_ProjectCode.setName("txt_ProjectCode");
        }
        catch (Throwable Exc) {
          System.out.println("Error while building txt_ProjectCode in class JS_ProjAssist_Project");
          Exc.printStackTrace();
        }
      }
      return txt_ProjectCode;
    }
/* */
    protected JLabel get_lbl_LanguageCode() {
/* Zuerst Prüfen, ob die Variable bereits 'constructed' (initialisiert) ist. */
      if (lbl_LanguageCode == null) {
/* Variable noch nicht 'constructed'; Code für die Initialisierung folgt. */
        try {
          lbl_LanguageCode = new JLabel();
          lbl_LanguageCode.setName("lbl_LanguageCode");
          lbl_LanguageCode.setHorizontalAlignment(SwingConstants.TRAILING);
        }
        catch (Throwable Exc) {
/* Fehler beim 'construct' ist sehr unwahrscheinlich und kann nur beim 'Starten'
 * des Tasks auftreten.
 * Deswegen werden Fehlermeldungen nur auf der Konsole ausgegeben. */
          System.out.println("Error while building lbl_LanguageCode in class JS_ProjAssist_Project");
          Exc.printStackTrace();
        }
      }
      return lbl_LanguageCode;
    }
/* */
    protected JTextField get_txt_LanguageCode() {
/* Zuerst Prüfen, ob die Variable bereits 'constructed' (initialisiert) ist. */
      if (txt_LanguageCode == null) {
/* Variable noch nicht 'constructed'; Code für die Initialisierung folgt. */
        try {
          txt_LanguageCode = new JTextField();
          txt_LanguageCode.setName("txt_LanguageCode");
        }
        catch (Throwable Exc) {
          System.out.println("Error while building txt_LanguageCode in class JS_ProjAssist_Project");
          Exc.printStackTrace();
        }
      }
      return txt_LanguageCode;
    }
/* */
    protected JLabel get_lbl_TargetDirectoryName() {
/* Zuerst Prüfen, ob die Variable bereits 'constructed' (initialisiert) ist. */
      if (lbl_TargetDirectoryName == null) {
/* Variable noch nicht 'constructed'; Code für die Initialisierung folgt. */
        try {
          lbl_TargetDirectoryName = new JLabel();
          lbl_TargetDirectoryName.setName("lbl_TargetDirectoryName");
          lbl_TargetDirectoryName.setHorizontalAlignment(SwingConstants.LEADING);
        }
        catch (Throwable Exc) {
/* Fehler beim 'construct' ist sehr unwahrscheinlich und kann nur beim 'Starten'
 * des Tasks auftreten.
 * Deswegen werden Fehlermeldungen nur auf der Konsole ausgegeben. */
          System.out.println("Error while building lbl_TargetDirectoryName in class JS_ProjAssist_Project");
          Exc.printStackTrace();
        }
      }
      return lbl_TargetDirectoryName;
    }
/* */
    protected JTextField get_txt_TargetDirectoryName() {
/* Zuerst Prüfen, ob die Variable bereits 'constructed' (initialisiert) ist. */
      if (txt_TargetDirectoryName == null) {
/* Variable noch nicht 'constructed'; Code für die Initialisierung folgt. */
        try {
          txt_TargetDirectoryName = new JTextField();
          txt_TargetDirectoryName.setName("txt_TargetDirectoryName");
/* Direkte Eingabe nicht erlauben; nur über Auswahl aus der Verzeichnis-Struktur. */
          txt_TargetDirectoryName.setEnabled(false);
        }
        catch (Throwable Exc) {
          System.out.println("Error while building txt_TargetDirectoryName in class JS_ProjAssist_Project");
          Exc.printStackTrace();
        }
      }
      return txt_TargetDirectoryName;
    }
/* */
    protected JButton get_btn_TargetDirectorySelection() {
/* Zuerst Prüfen, ob die Variable bereits 'constructed' (initialisiert) ist. */
      if (btn_TargetDirectorySelection == null) {
/* Variable noch nicht 'constructed'; Code für die Initialisierung folgt. */
        try {
          btn_TargetDirectorySelection = new JButton();
          btn_TargetDirectorySelection.setName("btn_TargetDirectorySelection");
/* 
 * Durch den 'ActionListener' wird beim Anklicken der Schaltfläche mit der Maustaste
 * die Methode 'actionPerformed' aufgerufen. */
          btn_TargetDirectorySelection.addActionListener(this);
/* 
 * Über den 'ActionCommand' kann in the Methode 'actionPerformed' abgefragt werden,
 * welche Schaltfläche angeklickt wurde. */
          btn_TargetDirectorySelection.setActionCommand("btn_TargetDirectorySelection");
        }
        catch (Throwable Exc) {
          System.out.println("Error while building btn_TargetDirectorySelection in class JS_ProjAssist_Project");
          Exc.printStackTrace();
        }
      }
      return btn_TargetDirectorySelection;
    }
/* 
 * ******************************
 * Methode zum 'Construct' (Initialisierung) des Panels mit den GUI-Elementen für
 * die Abwicklung des Geschäftsfalles.
 * Diese Methode überschreibt das 'Construct' des JPanel (mit gleichem Namen) in der
 * geerbten Methode aus der Klasse JSBS_TaskFrame.
 * */
    protected JPanel get_pnl_DetailFields() {
/* Zuerst Prüfen, ob die Variable bereits 'constructed' (initialisiert) ist. */
      if (pnl_DetailFields == null) {
/* Variable noch nicht 'constructed'; Code für die Initialisierung folgt. */
        try {
          pnl_DetailFields = new JPanel();
          pnl_DetailFields.setName("pnl_DetailFields");
/* 
 * Mit der folgenden Anweisung wird die Eigenschaft 'GridBagLayout festgelegt
 * 'GridBagLayout' unterteilt das JPanel in 'dehnbare' Felder; damit 'wachsen' oder
 * 'schrumpfen' darin platzierte GUI-Elemente abhängig von der Größe des JPanel. */
          pnl_DetailFields.setLayout(new GridBagLayout());
/* 
 * Die folgenden Anweisungen platzieren GUI-Elemente in den 'Feldern' des JPanel. */
/* Zuerst wird eine Variable für die Platzierungs-Eigenschaften erstellt. */
          GridBagConstraints gbc_lbl_ProjectCode = new GridBagConstraints();
/* Definition der Platzierungs-Eigenschaften. */
          gbc_lbl_ProjectCode.gridx = 0;
          gbc_lbl_ProjectCode.gridy = 0;
          gbc_lbl_ProjectCode.fill = GridBagConstraints.HORIZONTAL;
          gbc_lbl_ProjectCode.weightx = 1;
          gbc_lbl_ProjectCode.anchor = GridBagConstraints.LINE_END;
          gbc_lbl_ProjectCode.insets = new Insets(3, 3, 3, 3);
/* Platzieren des GUI-Elements auf dem JPanel. */
          get_pnl_DetailFields().add(get_lbl_ProjectCode(), gbc_lbl_ProjectCode);
/* 
 * Platzieren des nächsten GUI-Elements. */
          GridBagConstraints gbc_txt_ProjectCode = new GridBagConstraints();
/* Definition der Platzierungs-Eigenschaften. */
          gbc_txt_ProjectCode.gridx = 1;
          gbc_txt_ProjectCode.gridy = 0;
          gbc_txt_ProjectCode.fill = GridBagConstraints.HORIZONTAL;
          gbc_txt_ProjectCode.weightx = 1;
          gbc_txt_ProjectCode.anchor = GridBagConstraints.LINE_START;
          gbc_txt_ProjectCode.insets = new Insets(3, 3, 3, 3);
/* Platzieren des GUI-Elements auf dem JPanel. */
          get_pnl_DetailFields().add(get_txt_ProjectCode(), gbc_txt_ProjectCode);
/* 
 * Platzieren des nächsten GUI-Elements. */
          GridBagConstraints gbc_lbl_LanguageCode = new GridBagConstraints();
/* Definition der Platzierungs-Eigenschaften. */
          gbc_lbl_LanguageCode.gridx = 0;
          gbc_lbl_LanguageCode.gridy = 1;
          gbc_lbl_LanguageCode.fill = GridBagConstraints.HORIZONTAL;
          gbc_lbl_LanguageCode.weightx = 1;
          gbc_lbl_LanguageCode.anchor = GridBagConstraints.LINE_END;
          gbc_lbl_LanguageCode.insets = new Insets(3, 3, 3, 3);
/* Platzieren des GUI-Elements auf dem JPanel. */
          get_pnl_DetailFields().add(get_lbl_LanguageCode(), gbc_lbl_LanguageCode);
/* 
 * Platzieren des nächsten GUI-Elements. */
          GridBagConstraints gbc_txt_LanguageCode = new GridBagConstraints();
/* Definition der Platzierungs-Eigenschaften. */
          gbc_txt_LanguageCode.gridx = 1;
          gbc_txt_LanguageCode.gridy = 1;
          gbc_txt_LanguageCode.fill = GridBagConstraints.HORIZONTAL;
          gbc_txt_LanguageCode.weightx = 1;
          gbc_txt_LanguageCode.anchor = GridBagConstraints.LINE_START;
          gbc_txt_LanguageCode.insets = new Insets(3, 3, 3, 3);
/* Platzieren des GUI-Elements auf dem JPanel. */
          get_pnl_DetailFields().add(get_txt_LanguageCode(), gbc_txt_LanguageCode);
/* 
 * Platzieren des nächsten GUI-Elements. */
          GridBagConstraints gbc_lbl_TargetDirectoryName = new GridBagConstraints();
/* Definition der Platzierungs-Eigenschaften. */
          gbc_lbl_TargetDirectoryName.gridx = 0;
          gbc_lbl_TargetDirectoryName.gridy = 2;
          gbc_lbl_TargetDirectoryName.fill = GridBagConstraints.HORIZONTAL;
          gbc_lbl_TargetDirectoryName.weightx = 1;
          gbc_lbl_TargetDirectoryName.anchor = GridBagConstraints.LINE_START;
          gbc_lbl_TargetDirectoryName.insets = new Insets(3, 3, 3, 3);
/* Platzieren des GUI-Elements auf dem JPanel. */
          get_pnl_DetailFields().add(get_lbl_TargetDirectoryName(), gbc_lbl_TargetDirectoryName);
/* 
 * Platzieren des nächsten GUI-Elements. */
          GridBagConstraints gbc_txt_TargetDirectoryName = new GridBagConstraints();
/* Definition der Platzierungs-Eigenschaften. */
          gbc_txt_TargetDirectoryName.gridx = 0;
          gbc_txt_TargetDirectoryName.gridy = 3;
          gbc_txt_TargetDirectoryName.fill = GridBagConstraints.HORIZONTAL;
          gbc_txt_TargetDirectoryName.weightx = 1;
          gbc_txt_TargetDirectoryName.anchor = GridBagConstraints.LINE_START;
          gbc_txt_TargetDirectoryName.insets = new Insets(3, 3, 3, 3);
/* Platzieren des GUI-Elements auf dem JPanel. */
          get_pnl_DetailFields().add(get_txt_TargetDirectoryName(), gbc_txt_TargetDirectoryName);
/* 
 * Platzieren des nächsten GUI-Elements. */
          GridBagConstraints gbc_btn_TargetDirectorySelection = new GridBagConstraints();
/* Definition der Platzierungs-Eigenschaften. */
          gbc_btn_TargetDirectorySelection.gridx = 1;
          gbc_btn_TargetDirectorySelection.gridy = 2;
          gbc_btn_TargetDirectorySelection.fill = GridBagConstraints.BOTH;
          gbc_btn_TargetDirectorySelection.weightx = 1;
          gbc_btn_TargetDirectorySelection.gridheight = 2;
          gbc_btn_TargetDirectorySelection.anchor = GridBagConstraints.LINE_START;
          gbc_btn_TargetDirectorySelection.insets = new Insets(3, 3, 3, 3);
/* Platzieren des GUI-Elements auf dem JPanel. */
          get_pnl_DetailFields().add(get_btn_TargetDirectorySelection(), gbc_btn_TargetDirectorySelection);
        }
        catch (Throwable Exc) {
/* Fehler beim 'construct' ist sehr unwahrscheinlich und kann nur beim 'Starten'
 * des Tasks auftreten.
 * Deswegen werden Fehlermeldungen nur auf der Konsole ausgegeben. */
          System.out.println("Error while building pnl_DetailFields in class JS_ProjAssist_Project");
          Exc.printStackTrace();
        }
      }
      return pnl_DetailFields;
    }
/*
 * Methode die ausgeführt wird wenn ein Klick mit einer Maustaste
 * auf ein GUI-Element, dem der ActionListener hinzugefügt wurde, erfolgt. */
    public void actionPerformed(ActionEvent e) {
/*
 * Gleichnamige Methode in der geerbten Basisklasse aufrufen.
 * Damit werden die 'geerbten' Verarbeitungen (die für alle Anwendungsprogramme
 * gleich sein können) zuerst ausgeführt. */
      super.actionPerformed(e);
/*
 * Weitere Verarbeitung in einer eigenen Klasse mit statischen Methoden. */
      JS_ProjAssist_Project__ActionHandler.handleEvent(this, e);
    }
}