< Anterior | Próximo >

Lição 1.5: Programar o Botão Submeter (Submit)

Quando o formulário de entrada é submetido, a página incluirá automaticamente o novo registro no banco de dados. Nesta lição, você programará o botão Postar Nova Listagem (Post New Listing) para retornar à página all_records.jsp, para que você possa visualizar imediatamente o novo registro no banco de dados.

Para programar o botão Submeter (Submit):

  1. No arquivo new_record.jsp, clique com o botão direito do mouse no botão Postar Nova Listagem (Post New Listing) criado no formulário na página da Web e selecione Propriedades (Properties).
  2. Clique em Incluir Regra (Add Rule). A janela Incluir Regra de Navegação (Add Navigation Rule) é aberta.
  3. No menu drop-down Página (Page), selecione all_records.jsp e, em seguida, clique em OK.
  4. Salve a página. Se você quiser tentar incluir um registro no banco de dados para verificar se você retornará para a página all_records.jsp, execute new_record.jsp no servidor de teste.
Prevenir Chaves Duplicadas
Importante:

Como a coluna de ID é uma chave primária na tabela ADS, não é possível incluir registros com um valor de ID que já exista na tabela. No Módulo 2, você verá como utilizar a geração automática de chaves para criar automaticamente uma nova chave não utilizada para cada registro.

Até lá, você precisará digitar um número de ID não utilizado nessa página para incluir um novo registro. Os registros fornecidos com o banco de dados utilizam números de ID de 1 a 24, portanto, você pode digitar qualquer número acima de 24 como uma chave primária. Certifique-se de não duplicar chaves se você digitar mais que um registro.

Ligar a Entrada ao Registro Relacional (Opcional)

O formulário de entrada na página é um conjunto de campos de entrada JavaServer Faces que foram ligados ao registro relacional que você criou. Lembre-se que você criou o registro relacional para representar um novo registro na tabela ADS do banco de dados. Ligação é um método pelo qual você pode vincular um componente de entrada JavaServer Faces a uma coluna no registro relacional.

Quando você criou o registro relacional, o assistente ligou automaticamente todas as suas colunas aos campos de entrada na página. Se você quiser fazer alterações manualmente, poderá ligar outras colunas a outros campos de entrada. Para ligar uma coluna do registro relacional ao campo de entrada, arraste a coluna da visualização Dados da Página (Page Data) para o campo. Você pode experimentar esse processo excluindo e recriando o campo de entrada Descrição (Description) em seu formulário.

A visualização Dados da Página (Page Data) em geral se encontra no canto inferior esquerdo do workbench. Se você não conseguir localizá-la, vá para a barra de menus e clique em Janela (Window) > Mostrar Visualização (Show View) > Dados da Página (Page Data). Em geral, a visualização Dados da Página (Page Data) somente é utilizada quando páginas da Web dinâmicas estão sendo criadas.

A visualização Dados da Página (Page Data) armazena conexões a origens de dados como bancos de dados na forma de objetos de dados tais como registros relacionais ou listas de registros relacionais. Esses objetos de dados não representam a própria origem de dados ou nenhum componente na página. Em vez disso, esses objetos de dados representam uma conexão entre o projeto e uma origem de dados. Depois que essa conexão é criada, é possível arrastar um objeto de dados de uma visualização Dados da Página (Page Data) para uma página da Web para completar a conexão e exibir informações da origem de dados na página da Web. Por exemplo, segue uma figura da visualização Dados da Página (Page Data) que mostra uma lista de registros relacionais criados durante este tutorial:

Visualização Dados da Página (Page Data).

Nessa figura, você pode ver a lista de registros relacionais all_recordlist (ADS), seguida por todas as colunas nessa lista de registros relacionais. Depois que esse objeto de dados estiver definido e na visualização Dados da Página, você poderá arrastar essas colunas para componentes de entrada em uma página da Web tantas vezes quantas quiser sem reconectar-se ao banco de dados.

Por exemplo, se você quisesse mostrar o valor da coluna DESCRIPTION em uma página da Web, primeiro você arrastaria um campo de saída de texto para a página e depois arrastaria a coluna DESCRIPTION da visualização Dados da Página para esse campo de saída de texto. Isso é chamado ligar uma coluna a um campo de saída.

Alternativamente, se você quisesse deixar o tipo de usuário em um novo valor para a coluna DESCRIPTION no banco de dados, poderia arrastar um campo de entrada de texto para a página. Em seguida, arraste a coluna DESCRIPTION para esse campo de entrada de texto.

As etapas a seguir são fornecidas para ilustrar o conceito do campo de entrada e o processo de ligação; no entanto, seguir essas etapas é opcional neste tutorial. Se você não quiser fazer isso, vá para a próxima lição.

  1. No arquivo new_record.jsp, clique no campo de entrada Descrição (Description). Pressione a tecla Excluir (Delete).
  2. Na visualização Paleta (Palette), clique na gaveta Componentes Faces Avançados (Enhanced Faces Components) para expandi-la.
  3. Arraste um componente Entrada (Input) da Paleta para a célula que continha o campo de entrada Descrição (Description) que você acabou de excluir. Existe agora um campo de entrada nessa célula, mas não existe texto tal como {ID} ou {TÍTULO (TITLE)} dentro dele porque esse campo de entrada não está ligado a nenhuma coluna.
  4. Na visualização Dados da Página (Page Data), clique para expandir Registros Relacionais (Relational Records) > create_record (Service Data Object) > create_record (ADS) e arraste a coluna DESCRIÇÃO (DESCRIPTION) para o componente Entrada (Input) que você acabou de criar. O texto dentro do componente Entrada (Input) muda para indicar que ele agora está ligado à coluna DESCRIÇÃO (DESCRIPTION), como nesta figura:
    Visualização Dados da Página (Page Data).
  5. Salve o arquivo e, em seguida, execute a página no servidor de teste, se desejar.

Ponto de Verificação do Exercício

Você concluiu a Lição 1.5. Nela, você aprendeu a programar um botão de comando e a vincular dados a um campo de entrada, arrastando e soltando um símbolo JSF da paleta em sua página da Web.

< Anterior | Próximo >