Atualizar Pessoa da Lista

Artigos anteriores

• Implementando a Seleção ListView
• Utilizando Múltiplas Seleções
• ListView e Ordenação
• Remover Pessoa da Lista
• Adicionar Pessoa na Lista

Preparando-se para Atualizar Pessoa

Atualizar uma entidade Pessoa não é tão simples como as outras operações. Antes de fazermos essa operação, vamos olhar o botão Atualizar o qual é similar aos outros botões:

<Button fx:id=”updateButton” mnemonicParsing=”false”
        onAction=”#updateButtonAction” text=”Update” />

Por padrão, uma lista ordenada não responde a elementos individuais que mudem. Por exemplo, se a Pessoa “Michel Medeiros” mudar para “Michel Ferraz”, a lista não irá reordenar igual quando removemos e adicionamos Pessoa.

Há duas maneiras de fazer isso. O primeiro é remover o item e depois adicionar o novo valor. Essa opção não é a ideal.

A segunda é definir um extrator para o objeto subjacente. Um extrator define propriedades que devem ser observados quando mudanças ocorrem. Normalmente, mudanças individuais não são observadas.

Objetos Observable retornam para o extrator o comando de atualização para a lista ChangeListener. Contudo, para fazer um ListView ordenar a lista depois de uma mudança, você precisa definir um ObservableList com um extrator.

O benefício dos extratores é que você pode incluir propriedades que afetam a ordenação. No nosso exemplo, as propriedades do firstname e lastname afetam a ordenação da lista. Essas propriedades devem ir para o extrator.

Um extrator é um método static callback na classe model. Ele é o extrator para a nossa classe Pessoa:

public static Callback<Person, Observable[]> extractor =
        p-> new Observable[] {
                p.lastnameProperty(), p.firstnameProperty()
        };

Agora a classe controller pode usar esse extrator para declarar um ObservableList chamado personListExtractor:

private final ObservableList<Person> personListExtractor =
        FXCollections.observableArrayList(Person.extractor);

Com o extrator configurado, a lista ordenada detecta mudanças na firstNameProperty e lastNameProperty e reordena se necessário.

A seguir, nós definimos quando o botão Atualizar está habilitado. Na nossa aplicação, o botão Atualizar deve ser desabilitado se não haver itens selecionados ou se nenhum campo do nome e sobrenome estiver vazio.

Atualizando Pessoa

E finalmente, nós desabilitamos o Atualizar se o usuário não fez nenhuma mudança nos componentes do formulário de texto. Nós verificamos essas mudanças com um JavaFX Boolean property chamado modifiedProperty, criado com JavaFX Boolean property helper da classe SimpleBooleanProperty.

Nós iniciamos esse Boolean para falso no controller da classe JavaFX:

Nós resetamos essa Boolean property para falso na seleção de mudança do listener do ListView. O modifiedProperty é configurado para verdadeiro quando uma tecla é pressionada em qualquer um dos três campos: o nome, sobrenome e anotações.

Aqui temo um evento de ativação de tecla, o qual invoca a detecção de pressionamento de tecla nos três controles.

@FXML
private void handleKeyAction(KeyEvent keyEvent) {
    modifiedProperty.set(true);
}

Claro, a marcação FXML precisa ser configurada no atributo onKeyReleased para as três texto controles para invocar a ativação da tecla. Aqui é o FXML para o campo nome, o qual liga com o evento handleKeyAction para o controle da ativação de tecla.

<TextField fx:id=”firstnameTextField” onKeyReleased=”#handleKeyAction”
            GridPane.columnIndex=”1″>

Isso é uma ligação com o botão Atualizar, o qual é desabilitado se o selectedItemProperty for null, o modifiedProperty for false, ou se o campo estiver vazio:

updateButton.disableProperty().bind(
        listPersons.getSelectionModel().selectedItemProperty().isNull()
                .or(modifiedProperty.not())
                .or(firstnameTextField.textProperty().isEmpty()
                        .or(lastnameTextField.textProperty().isEmpty())));

Vamos ver como o botão Atualizar funciona. Essa manipulação é invocada quando o usuário clica no botão Atualizar depois de selecionar um item na ListView e fazer pelo menos uma mudança no campo de texto.

Antes de atualizar o item selecionado o quais os valores vêm do formulário, precisamos remover o listener do selectedItemProperty. Por quê?

Mudar as mudanças das propriedades irã afetar a lista dinamicamente e possivelmente será reordenada. Além disso, essa pode ser uma mudança da ListView com o item atualmente selecionado e invoca o ChangeListener.

Para prevenir isso, removemos o listener durante a atualização e adicionamos novamente quando a atualização termina. Durante a atualização, o item selecionado permanece imutável (mesmo se a lista for reordenada). Contudo, limpamos o modifiedProperty para garantir que o botão Atualizar seja desabilitado:

Baixe aqui o projeto.

Curso Java Para Iniciantes

Fonte: The Definitive Guide to Modern Java Clients with JavaFX