< Anterior | Próximo >

Lição 2.3: Utilizar Regras de Navegação

Nessa lição, você aprenderá como configurar as regras de navegação para redirecionar um usuário do site às páginas da Web específicas.

Pela maneira como a página new_record.jsp está configurada, os usuários precisam tomar muito cuidado para não digitar um número de ID que já esteja em uso, porque cada registro no banco de dados precisa ter um ID exclusivo. Isso foi explicado com mais detalhes na nota "Evitar Chaves Duplicadas (Prevent duplicate keys)" na Lição 1.5: Programar o Botão Submeter (Submit). Nesta lição, você verificará se o ID digitado é exclusivo e, se não for, enviará o usuário para uma página de erro que descreve o problema e instrui o usuário sobre como corrigi-lo.

As Regras de Navegação permitem direcionar os usuários para a página de erro ou para a página all_records.jsp depois de verificar se os usuários digitaram, ou não, um número de ID duplicado. Você designará aliases para esses dois resultados possíveis e depois os vinculará com as páginas corretas do destino. Neste exemplo, um erro na página create_record.jsp sinalizará o alias ERROR_CREATE, que enviará os usuários para a página de erro. Se os usuários preencherem a página create_record.jsp corretamente, isso sinalizará o alias MAIN, que será vinculado à página all_records.jsp como de costume.

Configurar as Regras

  1. Dê um clique duplo na página new_record.jsp no Explorador Corporativo (Enterprise Explorer).
  2. Clique no botão Postar Nova Listagem (Post New Listing) na página.
  3. Na visualização Propriedades (Properties), clique em Incluir Regra (Add Rule). A janela Incluir Regra de Navegação (Add Navigation Rule) é aberta. A primeira regra enviará o usuário para uma página de erro denominada create_error.jsp, se algo der errado na criação e confirmação do novo registro no banco de dados.
  4. No campo Página (Page), digite /error_create.jsp. Essa página não existe, mas para a finalidade deste tutorial, você pode simplesmente imaginar que ela existe.
  5. Clique no botão de opção O Resultado Denominado (The outcome named).
  6. Digite ERROR_CREATE no campo de texto após o botão de opção O Resultado Denominado (The outcome named).
  7. Clique no botão de opção Somente esta Página (This page only) porque não existe outra página no site onde o usuário poderia acionar este erro em particular digitando um número de ID duplicado.Clique em OK. A próxima regra navegará para all_records.jsp se o usuário tiver digitado um número de ID válido.
  8. Clique no botão Incluir Regra (Add Rule) para abrir novamente a janela Incluir Regra de Navegação (Add Navigation Rule).
  9. Utilize a caixa drop-down Página (Page) para selecionar all_records.jsp.
  10. Clique na caixa de opções O Resultado Denominado (The outcome named) e, em seguida, digite PRINCIPAL (MAIN) no campo de texto após ela.
  11. Como você pode querer reutilizar essa regra em outra página (por exemplo, a página update_record.jsp), clique no botão de opção Todas as Páginas (All pages) em Esta Regra é Utilizada Para (This rule is used for).Clique em OK.As duas regras são exibidas agora na visualização Propriedades (Properties).

Retornar Aliases da Ação do Botão

Tudo o que resta agora é colocar as novas regras de navegação em funcionamento. Você incluirá duas instruções return no código para o botão Postar Nova Listagem (Post New Listing). Essas instruções return chamam o alias apropriado para que o usuário seja enviado para a página apropriada conforme definido na regra de navegação.
  1. Clique no botão Postar Nova Listagem (Post New Listing).
  2. Abra a visualização Edição Rápida (Quick Edit).
  3. Na visualização Edição Rápida (Quick Edit), localize a linha que contém } catch (Throwable e) {. Essa função catch é executada se o usuário tiver digitado um número de ID duplicado.
  4. Remova todo o código entre a chave de abertura { no final dessa linha e a próxima chave de fechamento } algumas linhas adiante. Não remova nenhuma das chaves.
  5. No lugar do código entre as chaves, digite este texto:retornar "ERROR_CREATE";
  6. Em seguida, remova todo o código depois da última chave de fechamento } e, em seu lugar, digite este texto: retornar "PRINCIPAL (MAIN)";

    Essa etapa remove a ação gotoPage incluída no exercício 1.4. Você não precisa mais desse código porque as regras de navegação fazem a mesma coisa.

    O código de seu botão deve agora ser semelhante a este:

    Visualização Edição Rápida (Quick edit).

  7. Salve a página e teste-a, se quiser.
Opcionalmente, você pode criar uma página de erro simples denominada create_error.jsp que explique aos usuários que um erro ocorreu durante a criação de suas listagens e que devem tentar um valor de ID diferente. Essas regras de navegação podem então seres testadas tentando incluir uma nova listagem que utilize um valor de ID existente (tal como 1).

Ponto de Verificação da Lição

Você concluiu a Lição 2.3. Nela, você aprendeu como utilizar regras de navegação para criar um erro se o usuário tentar digitar um valor de ID inválido ou para enviar o usuário para all_recordlist.jsp se o usuário digitar um ID válido.
< Anterior | Próximo >
Feedback