< Anterior | Próximo >

Lição 2.4: Ligar o Botão Atualizar a um Conector de Ação

O Java visual editor fornece binders de ações para chamar um serviço em uma origem de dados, quando um botão é clicado. Por exemplo, ao clicar no botão Atualizar (Update), o aplicativo deve executar um método modifyEmployee() no serviço da Web com as alterações digitadas nos campos de detalhes. Nessa lição, você ligará o botão Atualizar (Update) a um binder de ação.

Para ligar o botão Atualizar (Update):
  1. Selecione o botão Atualizar (Update) na área de design e clique na guia Ligação (Bind), para abrir a caixa de diálogo Ligações de Ação do Componente (Component Action Bindings).

    Guia Ligação no Botão Atualizar

  2. No campo Tipo de Origem (Source type), selecione Serviço da Web (Web Service).
  3. No campo Origem de Dados (Data source), selecione webServiceDataSource.
  4. Na lista Serviço de Origem (Source service), selecione modifyEmployee(directory.service.FullEmployeeRecord).
  5. O campo Nome (Name) é alterado automaticamente para modifyEmployeeAction. Aceite este padrão.
  6. No campo Argumento (Argument), selecione selectedEmployeeRecord.
  7. Como o método modifyEmployee() toma um registro completo do funcionário como argumento, você deve deixar o campo Propriedade (Property) em branco.
  8. Configure o Estado Inicial (Initial state) do botão como Desativado (Disabled).

    Caixa de Diálogo Ligações de Ação do Componente para o Botão Atualizar

  9. Para definir como o botão altera seu estado, clique em Regras de Ativação (Enablement rules). Especifique se o botão deve ser ativado apenas quando o conteúdo do argumento é alterado e desativado em todos os outros casos. Clique em OK.

    Caixa de Diálogo Regras de Ativação para o Botão Atualizar

    Isto significa que o botão Atualizar (Update) é desativado até que o conteúdo de selectedEmployeeRecord seja alterado. Em outras palavras, assim que você digitar um novo valor em um dos campos de detalhes, ligados a selectedEmployeeRecord, o binder ativa o botão. Se você selecionar um novo registro ou clicar em Atualizar (Update), o botão será desativado novamente.

  10. Clique em OK.
Um novo binder SwingDataServiceAction é incluído para o botão Atualizar (Update). Se você selecionar o botão na área de design, o visual editor traça uma linha que indica que o botão está ligado à origem de dados do serviço da Web. Uma seta pontilhada rosa aponta do objeto selectedEmployeeRecord à linha. Esta seta indica que selectedEmployeeRecord é o argumento para a chamada ao serviço.

Ponto de Verificação da Lição

Agora, ao executar o aplicativo, é possível atualizar um registro de funcionário.

Selecione um funcionário na tabela e altere o sobrenome. Assim que você modificar o sobrenome, o botão Atualizar (Update) será ativado. Ao clicar em Atualizar (Update), o serviço modifyEmployee é chamado e o funcionário é atualizado. O novo sobrenome é refletido na tabela de funcionários.
< Anterior | Próximo >