Lição 1.6: Criar uma Página de Atualização

Criar o Registro Relacional de Atualização

Abra o arquivo update_record.jsp dando um clique duplo nele na visualização Explorador Corporativo (Enterprise Explorer).
Exclua o texto padrão Insira o conteúdo aqui (Insert content here).
Na visualização Paleta (Palette), clique na gaveta Dados e Serviços (Data and Services) para expandi-la.
Arraste o componente Registro Relacional SDO (SDO Relational Record) da Paleta para a área de conteúdo em branco. A janela Incluir Registro Relacional (Add Relational Record) é exibida.
No campo Nome, digite update_record.
Em Criar controles para (Create controls for), clique em Atualizando um registro existente (Updating an existing record).
Certifique-se de que a opção Incluir controles de entrada/saída para exibir o Registro Relacional na página da Web (Add input/output controls to display the Relational Record on the web page) esteja selecionada.
Clique em Avançar (Next).
Na caixa Tabela, expanda W5SAMPLE e selecione ADS.
Clique em Avançar (Next). A página Incluir Registro Relacional (Add Relational Record) é exibida.

Filtrar os Resultados

Um registro relacional pode mostrar somente um registro do banco de dados. Portanto, é preciso filtrar a tabela do banco de dados para que somente um registro apareça para que o usuário o edite. (Não foi necessário filtrar o banco de dados no exercício anterior porque você criou um novo registro e, portanto, não havia resultados do banco de dados para serem filtrados.) Como cada registro no banco de dados tem um número de ID exclusivo, você filtrará os resultados para aquele com um número de ID específico.

A página Incluir Registro Relacional (Add Relational Record) possui uma lista de links de tarefas. Em Tarefas (Tasks), clique em Filtrar Resultados. A janela Filtros é exibida e insere a condição de filtro padrão ID = #{param.ID} na coluna Filtro (Filter). A janela Filtros é semelhante a esta:
Esse código filtra os registros no banco de dados para que somente o registro com o número do ID especificado apareça no registro relacional. Você aprenderá mais sobre esta condição na seção de ação Incluir uma Linha neste exercício. Clique em Fechar (Close).
Clique em Avançar (Next). A página Configurar Controles de Dados é exibida.
Na seção Campos a serem exibidos (Fields to display), limpe a caixa de opções próxima a todos os nomes de campos exceto os que desejar exibir em seu formulário de entrada:
- ID
- CATEGORIA PRINCIPAL
- TÍTULO
- DESCRIÇÃO
- PREÇO
- FONE
Clicando em Para Cima (Up) ou Para Baixo (Down), reordene os nomes dos campos de cima para baixo, da seguinte maneira:
- ID
- TÍTULO
- DESCRIÇÃO
- CATEGORIA PRINCIPAL
- PREÇO
- FONE
No campo ID, selecione Exibir número (Display number) na lista drop-down da coluna Tipo de Controle (Control Type). Embora você queira que os usuários possam visualizar o número de ID de um registro, você não deseja que eles possam atualizá-lo. Tornar o campo ID um campo de saída ajudará a evitar o problema de IDs duplicados.
Clique em Opções (Options). A janela Options é exibida. Certifique-se de que a opção Botão Submeter (Submit button) esteja selecionada. Digite Update no campo Etiqueta (Label). Clique em OK. A janela Incluir Registro Relacional (Add Relational Record) deve ser semelhante a esta:
Clique em Concluir (Finish) para gerar seu formulário de atualização na página, conforme mostrado a seguir:

Programando os Botões Atualizar e Excluir

Novamente, incluiremos código para encaminhar o usuário à página all_records.jsp para exibir o registro alterado com todos os outros registros.

Clique com o botão direito do mouse no botão Atualizar (Update) que você acabou de criar na página da Web e selecione Propriedades (Properties).
Clique em Incluir Regra (Add Rule). A janela Incluir Regra de Navegação (Add Navigation Rule) é aberta.
No menu drop-down Página, selecione all_records.jsp. Na caixa Esta Regra É Utilizada por (This rule is used by), clique em Essa Ação Apenas (This action only). Certifique-se de que o campo contenha: #{pc_Update_record.doUpdate_recordUpdateAction}. Clique em OK.
Repita as etapas 1-3 para editar o código da mesma maneira para o botão Excluir na página da Web. Certifique-se de que o campo Esta Regra É Utilizada por (This rule is used by) contenha: #{pc_Update_record.doUpdate_recordDeleteAction}
Salve a página. Se você quiser tentar atualizar um registro do banco de dados para verificar se você retornará para a página all_records.jsp, execute new_record.jsp no servidor de testes.

Incluir uma Ação de Linha

Agora você incluirá uma ação de linha à tabela em all_records.jsp para que o usuário possa selecionar um registro do banco de dados para atualizar. #{param.ID} representa o número do ID do registro que a página de atualização irá atualizar. Quando o usuário clica em uma linha, o número de ID de registro será enviado à página update_record.jsp como o parâmetro #{param.ID}. Em seguida, o registro relacional filtrado que você acabou de inserir na página update_record.jsp exibirá somente esse registro para atualização.

Na visualização Explorador Corporativo (Enterprise Explorer), dê um clique duplo no arquivo all_records.jsp para abri-lo no Editor. Clique em qualquer lugar dentro da tabela de dados. Abra a visualização Propriedades (Properties).
Na visualização Propriedades (Properties), clique na guia Ações de Linha (Row Actions) em hx:dataTableEx na lista de tags HTML.
Clique em Incluir uma ação executada quando uma linha é clicada (Add an action that's performed when a row is clicked). O diálogo Configurar uma Ação de Linha é exibido. Selecione Clicar na linha envia um pedido ao servidor com informações da linha enviadas como parâmetros (Clicking the row sends a request to the server with row information sent as parameters) em seguida clique em OK. Uma coluna é incluída na tabela de dados.
Na visualização Propriedades (Properties), clique na guia hx:requestRowAction.
Clique em Incluir Regra (Add Rule). O diálogo Incluir Regra de Navegação é exibido.
No drop-down Página, selecione update_record.jsp. Na caixa Esta regra é utilizada por, clique em Esta ação apenas (This action only). O campo Esta Ação Apenas é automaticamente ocupado por #{pc_All_records.doRowAction1Action}, que foi criado ao incluir a ação da linha. Clique em OK. Se o campo não for automaticamente ocupado pelo método acima, digite o método no campo e inclua o seguinte em Recursos ClassifiedsTutorial/Java: src/pagecode/All_records.java:
```
	public String doRowAction1Action() {
				return "";}
```
Na visualização Propriedades (Properties), clique na guia Parâmetro (Parameter) em hx:requestRowAction. Clique em Incluir Parâmetro (Add Parameter) e, em seguida, digite o ID no campo Nome. Você precisa ligar o parâmetro de ID à coluna ID. Ligar a ação de linha à coluna ID da lista de dados significa que quando a linha é clicada, o parâmetro de pedido será o ID do registro na lista.
1. Clique em Valor (Value), em seguida, clique no botão Selecionar Objeto de Dados da Página .
2. Na guia Objeto de Dados (Data Object), expanda all_recordlist (Objeto de Dados do Serviço) > all_recordlist (ADS) e selecione ID (java.lang.Integer).
3. Clique em OK.

Resultados

Agora, quando o usuário clicar em uma linha, o Web site permitirá que o usuário atualize informações sobre o anúncio classificado. Salve o arquivo e teste a página, se desejar. Lembre-se de abrir all_records.jsp primeiro, porque essa é a página que faz o link para update_record.jsp.

Ponto de Verificação do Exercício

Você concluiu a Lição 1.6. Nela, você aprendeu como criar páginas da Web que atualizam registros de um banco de dados.

< Anterior | Próximo >

Feedback