Lekcja 2.3: Używanie reguł nawigacji

W ramach tej lekcji użytkownik dowie się, w jaki sposób konfigurować reguły nawigacji, aby przekierować użytkownika serwisu do określonych stron WWW.

Sposób, w jaki ustawiana jest strona new_record.jsp, powoduje, że użytkownicy muszą być bardzo ostrożni i nie podać numeru ID, który jest już wykorzystywany, ponieważ każdy rekord w bazie danych musi mieć unikalny numer ID. Szczegółowe wyjaśnienia można znaleźć w uwadze "Unikanie zduplikowanych kluczy" w sekcji Lekcja 1.5: Programowanie przycisku Wyślij. W tej lekcji użytkownik sprawdzi unikalność podanego numeru ID i jeśli nie będzie on unikalny, użytkownik końcowy zobaczy stronę błędu opisującą problem oraz informującą, jak go poprawić.

Reguły nawigacji umożliwiają skierowanie użytkowników do strony błędu lub strony all_records.jsp po sprawdzeniu, czy wprowadzono podwójny numer ID, czy nie. Dla obu możliwych wyników należy podać aliasy, a następnie powiązać je z odpowiednimi stronami docelowymi. W tym przykładzie błąd na stronie create_record.jsp spowoduje zasygnalizowanie aliasu ERROR_CREATE, który prześle użytkowników na stronę błędu. Jeśli użytkownicy wypełnią stronę create_record.jsp poprawnie, spowoduje to zasygnalizowanie aliasu MAIN, który będzie powiązany jak zwykle ze stroną all_records.jsp.

Konfigurowanie reguł

Kliknij dwukrotnie stronę new_record.jsp w widoku Nawigator projektów.
Kliknij na stronie przycisk Prześlij nową zawartość.
W widoku Właściwości kliknij przycisk Dodaj regułę. Zostanie otwarte okno Dodaj regułę nawigacji. Jeśli podczas tworzenia i wprowadzania do bazy danych nowego rekordu wystąpi błąd, pierwsza reguła odeśle użytkownika do strony błędu o nazwie create_error.jsp.
W polu Strona wpisz error_create.jsp. Ta strona nie istnieje, ale dla celów tego kursu można wyobrazić sobie, że istnieje.
Kliknij przełącznik Wynik o nazwie.
W polu tekstowym po przełączniku Wynik o nazwie wpisz ERROR_CREATE.
Kliknij przełącznik Tylko ta strona, ponieważ na żadnej innej stronie tego serwisu użytkownik nie będzie mógł wyzwolić tego konkretnego błędu przez wpisanie podwójnego numeru ID. Kliknij przycisk OK. Jeśli użytkownik wpisze poprawny numer ID, następna reguła spowoduje przejście do strony all_records.jsp.
Kliknij przycisk Dodaj regułę, aby ponownie otworzyć okno Dodaj regułę nawigacji.
Za pomocą pola rozwijanego Strona wybierz plik all_records.jsp.
Kliknij pole wyboru Wynik o nazwie i wpisz MAIN w polu tekstowym obok.
Ponieważ ta reguła może być wykorzystana na innej stronie (na przykład update_record.jsp), kliknij przełącznik Wszystkie strony w sekcji Ta reguła jest używana dla. Kliknij przycisk OK. Obie reguły są teraz wyświetlane w widoku Właściwości.

Zwracanie aliasów z działania przycisku

Teraz pozostało jedynie wprowadzenie reguł nawigacji do działania. Do kodu przycisku Prześlij nową zawartość zostaną dodane dwie instrukcje powrotu. Te instrukcje powrotu przywołują odpowiednie aliasy, tak że użytkownik jest odsyłany do odpowiedniej strony, ustawionej w regułach nawigacji.

Kliknij przycisk Prześlij nową zawartość.
Otwórz widok Szybka edycja.
W widoku Szybka edycja odszukaj wiersz } catch (Throwable e) {. Ta funkcja catch jest uruchamiana, jeśli użytkownik wprowadził podwójny numer ID.
Usuń cały kod między otwierającym nawiasem klamrowym { znajdującym się na końcu tego wiersza, a zamykającym nawiasem klamrowym } kilka wierszy niżej. Nie usuwaj nawiasów klamrowych.
W miejscu kodu między nawiasami klamrowymi wpisz następujący tekst: return "ERROR_CREATE";.
Następnie usuń cały kod poniżej ostatniego zamykającego nawiasu klamrowego } i w to miejsce wpisz tekst: return "MAIN";.
W tym kroku usunięto działanie gotoPage, które dodano w ćwiczeniu 1.4. Ten kod nie jest już potrzebny, ponieważ reguły nawigacji robią to samo.

Kod przycisku powinien teraz wyglądać następująco:
Zapisz stronę i przetestuj ją, jeśli chcesz.

Opcjonalnie można utworzyć prostą stronę błędu o nazwie create_error.jsp, która będzie zawierała wyjaśnienie, że błąd wystąpił podczas tworzenia ich zawartości oraz że należy użyć innej wartości ID. Następnie reguły nawigacji można przetestować, próbując dodać nową zawartość, która korzysta z istniejącej wartości ID (takiej jak 1).

Punkt kontrolny lekcji

Lekcja 2.3 została zakończona. W ramach tej lekcji użytkownik dowiedział się, w jaki sposób korzystać z reguł nawigacji w celu utworzenia błędu, gdy użytkownik końcowy próbuje wprowadzić niepoprawną wartość numeru ID lub aby wysłać użytkownika do strony all_recordlist.jsp, jeśli wprowadzi poprawny numer ID.

< Wstecz | Dalej >