Visualizzazione delle informazioni dinamiche sulle pagine Web con JavaServer Faces > Modulo 2: Aggiunta di funzioni avanzate >
< Indietro | Avanti >

Lezione 2.3: Utilizzo di regole di navigazione

In questa lezione si apprenderà come impostare le regole di navigazione per reindirizzare un utente del sito a pagine Web specifiche.

Configurando la pagina new_record.jsp, gli utenti devono prestare molta attenzione a non immettere un numero ID già utilizzato, poiché ciascun record nel database deve avere un numero ID univoco. Questo è spiegato in maggior dettaglio nella nota "Evita chiavi duplicate" in Lezione 1.5: Programmazione del pulsante Inoltra. In questa lezione si effettuerà una verifica per controllare se l'ID immesso è univoco; in caso contrario, indirizzare l'utente a una pagina di errore che descrive il problema proponendo la soluzione.

Le regole di navigazione consentono di indirizzare gli utenti alla pagina di errore o alla pagina all_records.jsp dopo aver verificato se gli utenti hanno immesso o meno un numero ID duplicato. A questi due possibili esiti verranno assegnati degli alias, che verranno quindi collegati alle pagine di destinazione corrette. In questo esempio, un errore nella pagina create_record.jsp verrà segnalato all'alias ERROR_CREATE, che indirizzerà gli utenti alla pagina di errore. Se gli utenti riempiono correttamente la pagina create_record.jsp, verrà segnalato all'alias MAIN, che verrà collegato normalmente alla pagina all_records.jsp.

Impostazione delle regole

  1. In Selezione progetti fare doppio clic sulla pagina new_record.jsp.
  2. Nella pagina fare clic sul pulsante Pubblica nuovo elenco.
  3. Nella vista Proprietà fare clic su Aggiungi regola. Viene aperta la finestra Aggiungi regola di navigazione. La prima regola invierà l'utente a una pagina di errore denominata create_error.jsp in caso di problemi durante la creazione e l'invio del nuovo record al database.
  4. Nel campo Pagina immettere /error_create.jsp. La pagina non esiste, ma per lo scopo di questa esercitazione è sufficiente immaginare che esista.
  5. Fare clic sul pulsante di opzione L'outcome con come.
  6. Immettere ERROR_CREATE nel campo di testo dopo il pulsante di opzione L'outcome con come.
  7. Fare clic sul pulsante di opzione Solo questa pagina, poiché non vi sono altre pagine del sito in cui l'utente possa provocare questo particolare errore immettendo un numero ID duplicato. Scegliere OK. La regola successiva consentirà di passare ad all_records.jsp se l'utente immette un numero ID valido.
  8. Fare clic sul pulsante Aggiungi regola per aprire nuovamente la finestra Aggiungi regola di navigazione.
  9. Utilizzare la casella con elenco a discesa Pagina per selezionare all_records.jsp.
  10. Fare clic sulla casella di controllo L'outcome con come e quindi immettere MAIN nel campo di testo.
  11. Se si desidera riutilizzare questa regola in un'altra pagina (ad esempio nella pagina update_record.jsp), fare clic sul pulsante di opzione Tutte le pagine in Questa regola è utilizzata per. Scegliere OK. A questo punto, le due regole vengono visualizzate nella vista Proprietà.

Restituzione degli alias tramite l'attivazione del pulsante

A questo punto, è necessario attivare le nuove regole di navigazione. Verranno aggiunte due istruzioni return nel codice per il pulsante Pubblica nuovo elenco. Tali istruzioni return richiamano l'alias appropriato affinché l'utente venga inviato alla pagina appropriata impostata nella regola di navigazione.
  1. Fare clic sul pulsante Pubblica nuovo elenco.
  2. Aprire la vista Modifica rapida.
  3. Nella vista Modifica rapida cercare la riga contenente } catch (Throwable e) {. Questa funzione catch viene eseguita se l'utente immette un numero ID duplicato.
  4. Rimuovere tutto il codice tra le parentesi graffe aperte { alla fine di questa riga e la successiva parentesi graffa chiusa } poche righe più in basso. Non rimuovere le parentesi graffe.
  5. Al posto del codice tra parentesi, immettere il seguente testo: return "ERROR_CREATE";
  6. Rimuovere quindi tutto il codice al di sotto dell'ultima parentesi graffa chiusa } e sostituirlo con il testo seguente: return "MAIN";

    Questa operazione elimina l'azione gotoPage aggiunta nell'esercizio 1.4. Il codice non occorre più perché le regole di navigazione assolvono alla stessa funzione.

    Il codice del pulsante appare simile al seguente:

    Vista Modifica rapida.

  7. Salvare la pagina e verificarla, se necessario.
Se si desidera, è possibile creare una pagina di errore di esempio denominata create_error.jsp che spiega agli utenti che si è verificato un errore durante la creazione dell'elenco ed è possibile riprovare con un valore ID differente. È possibile quindi verificare queste regole di navigazione tentando di aggiungere un nuovo elenco con un valore ID esistente (ad es. 1).

Riepilogo di controllo della lezione

La lezione 2.3 è terminata. In questa lezione si è appreso come utilizzare regole di navigazione per restituire un errore se gli utenti tentano di immettere un valore ID non valido, oppure indirizzarlo ad all_recordlist.jsp se immette un ID valido.

< Indietro | Avanti >