< Vorherige Lektion | Nächste Lektion >

Lerneinheit 2.3: Navigationsregeln verwenden

In dieser Lerneinheit erfahren Sie, wie Navigationsregeln eingerichtet werden, um einen Benutzer der Website auf bestimmte Webseiten zu leiten.

So wie die Seite 'new_record.jsp' eingerichtet ist, müssen Benutzer streng darauf achten, keine ID-Nummer einzugeben, die bereits verwendet wird, da jedem Datensatz in der Datenbank eine eindeutige ID-Nummer zugeordnet sein muss. Dies wurde unter "Doppelte Schlüssel verhindern" in Lerneinheit 1.5: Die Schaltfläche 'Übergeben' programmieren ausführlich erläutert. In dieser Lerneinheit werden Sie überprüfen, ob die eingegebene ID auch eindeutig ist, und im widrigen Fall den Benutzer auf eine Fehlerseite umleiten, die das Problem beschreibt und den Benutzer darüber informiert, wie der Fehler behoben wird.

Mit Hilfe von Navigationsregeln können Sie Benutzer gegebenenfalls auf die Fehlerseite oder die Seite 'all_records.jsp' umleiten, nachdem Sie überprüft haben, ob Benutzer eine doppelte ID-Nummer eingegeben haben oder nicht. Sie werden für diese beiden Möglichkeiten jeweils einen Aliasnamen zuordnen und diese beiden Aliasnamen anschließend mit den entsprechenden Zielseiten verknüpfen. In diesem Beispiel führt ein Fehler auf der Seite 'create_record.jsp' dazu, dass ein Signal an den Aliasnamen ERROR_CREATE gesendet wird, der Benutzer auf die Fehlerseite umleitet. Füllt ein Benutzer die Seite 'create_record.jsp' ordnungsgemäß aus, wird ein Signal an den Aliasnamen MAIN gesendet, der wie gewohnt mit der Seite 'all_records.jsp' verbunden wird.

Die Regeln einrichten

  1. Klicken Sie doppelt auf die Seite new_record.jsp in der Sicht 'Enterprise-Explorer'.
  2. Klicken Sie auf die Schaltfläche Neuen Eintrag übergeben auf der Seite.
  3. Klicken Sie in der Sicht 'Eigenschaften' auf Regel hinzufügen. Das Fenster 'Navigationsregel hinzufügen' wird geöffnet. Die erste Regel leitet den Benutzer auf eine Fehlerseite namens 'create_error.jsp' um, falls beim Erstellen und Festschreiben des neuen Datensatzes in der Datenbank ein Fehler auftritt.
  4. Geben Sie im Feld Seite error_create.jsp ein. Diese Seite existiert nicht. Zum Zwecke dieses Lerntexts müssen Sie sich also einfach vorstellen, sie würde existieren.
  5. Klicken Sie auf den Radioknopf Das Ergebnis mit folgendem Namen.
  6. Geben Sie ERROR_CREATE in das Textfeld hinter dem Radioknopf Das Ergebnis mit folgendem Namen ein.
  7. Klicken Sie auf den Radioknopf Nur diese Seite, da es auf der Site keine weitere Seite gibt, auf der der Benutzer diesen bestimmten Fehler durch Eingabe einer doppelten ID-Nummer auslösen könnte. Klicken Sie auf OK. Die nächste Regel navigiert zur Seite 'all_records.jsp', wenn der Benutzer eine gültige ID-Nummer eingegeben hat.
  8. Klicken Sie auf die Schaltfläche Regel hinzufügen, um das Fenster 'Navigationsregel hinzufügen' erneut zu öffnen.
  9. Wählen Sie im Dialogfenster Seite den Eintrag all_records.jsp aus.
  10. Klicken Sie auf das Markierungsfeld Das Ergebnis mit folgendem Namen, und geben Sie anschließend MAIN in das nachstehende Textfeld ein.
  11. Da Sie diese Regel möglicherweise auf einer weiteren Seite erneut verwenden wollen (beispielsweise auf der Seite 'update_record.jsp'), klicken Sie auf den Radioknopf Alle Seiten unter Diese Regel wird verwendet für. Klicken Sie auf OK. Die beiden Regeln werden nun in der Sicht 'Eigenschaften' angezeigt.

Aliasnamen über Schaltflächenaktion mit 'return'-Anweisungen aufrufen

Jetzt müssen die neuen Navigationsregeln nur noch eingesetzt werden. Sie werden dem Code für die Schaltfläche 'Neuen Eintrag übergeben' zwei return-Anweisungen, d. h. Rückkehranweisungen, hinzufügen. Diese return-Anweisungen rufen den entsprechenden Aliasnamen auf, sodass der Benutzer entsprechend zu der in der Navigationsregel definierten Seite umgeleitet wird.
  1. Klicken Sie auf die Schaltfläche Neuen Eintrag übergeben.
  2. Öffnen Sie die Sicht Schnellbearbeitung.
  3. Suchen Sie in der Sicht 'Schnellbearbeitung' die Zeile } catch (Throwable e) {. Diese catch-Funktion zum Abfangen wird ausgeführt, wenn der Benutzer eine doppelte ID-Nummer eingegeben hat.
  4. Entfernen Sie den gesamten Code zwischen der geöffneten geschweiften Klammer { am Ende dieser Zeile und der nächsten geschlossenen geschweiften Klammer } einige Zeilen weiter unten. Entfernen Sie keine der beiden geschweiften Klammern.
  5. Geben Sie an Stelle des Codes zwischen den geschweiften Klammern den folgenden Text ein:return "ERROR_CREATE";
  6. Entfernen Sie als nächstes den gesamten Code nach der letzten schließenden geschweiften Klammer }, und geben Sie stattdessen den folgenden Text ein: return "MAIN";

    Durch diesen Schritt wird die Aktion 'gotoPage' gelöscht, die Sie in Übung 1.4 hinzugefügt haben. Dieser Code wird nicht mehr benötigt, da die Navigationsregeln nun seine Aufgabe übernehmen.

    Der Code Ihrer Schaltfläche sollte nun folgendermaßen aussehen:

    Sicht 'Schnellbearbeitung'.

  7. Speichern Sie Ihre Seite und testen Sie sie, wenn Sie möchten.
Sie haben optional auch die Möglichkeit, eine einfache Fehlerseite namens 'create_error.jsp' zu erstellen, auf der dem Benutzer erklärt wird, dass während der Erstellung des Eintrags ein Fehler aufgetreten ist und ein anderer ID-Wert eingegeben werden soll. Sie können diese Navigationsregeln testen, indem Sie versuchen, einen neuen Eintrag mit einer bereits vorhandenen ID-Nummer (beispielsweise 1) einzugeben.

Prüfpunkt für die Lerneinheit

Sie haben Lerneinheit 2.3 abgeschlossen. In dieser Lerneinheit haben Sie gelernt, wie Sie Navigationsregeln verwenden, um einen Fehler zu erstellen, wenn Benutzer versuchen, einen ungültigen ID-Wert einzugeben oder den Benutzer zu 'all_recordlist.jsp' umleiten, wenn der Benutzer eine gültige ID eingibt.
< Vorherige Lektion | Nächste Lektion >
Rückmeldung