Vinculando beans e dados em um aplicativo de área de trabalho

Esse guia é uma introdução ao suporte no NetBeans IDE para vinculação de beans e de dados em aplicativos de área de trabalho Java.

Conteúdo

• Introdução: vinculação de beans no NetBeans IDE
• Vinculando propriedades a outras propriedades
• Vinculando beans personalizados
• Propriedades de vinculação avançadas
• Vinculando dados a componentes
• Propriedades de vinculação especiais

Para concluir este tutorial, você precisa dos seguintes recursos e softwares.

Introdução: vinculação de beans no NetBeans IDE

Até o lançamento da biblioteca de vinculações de beans, era incômodo conectar componentes de IU a banco de dados ou manter os valores das propriedades do componente em sincronia. Por exemplo, a exibição de dados em um banco de dados padrão em uma JTable requeria a criação manual de classes do utilitário para manipular a conexão entre o banco de dados e a JTable. E manter valores de propriedades de bean diferentes em sincronia (tal como o valor de um JTextField com a renderização de um bean visual) requeria codificar manualmente os ouvintes e os manipuladores de eventos.

A biblioteca de vinculação de beans simplifica e padroniza tudo isso. Você pode simplesmente escrever algumas linhas de código para estabelecer quais propriedades de quais componentes precisam ser mantidas em sincronia, e a biblioteca de vinculação de beans manipula o resto. No NetBeans IDE, os recursos de vinculação de beans são integrados no Construtor de GUIs, para que você possa ter rapidamente o comportamento do seu aplicativo codificado, depois que tiver estabelecido o design visual.

Este guia é uma visão geral dos aspectos principais da vinculação de beans no IDE. Para obter um exemplo concreto de muitos destes recursos, você pode tentar os tutoriais Construindo um aplicativo de banco de dados de área de trabalho Java.

Vinculando propriedades a outras propriedades

Fundamentalmente, a vinculação de beans é uma forma de conectar as propriedades do bean sem usar audição de eventos e manipulação de código.

Para ilustrar o conceito de vinculação de beans e como o IDE a suporta, faremos um exemplo simples onde um usuário pode ajustar um controle deslizante para alterar um valor numérico em um campo de texto.

Para configurar o exemplo:

1. No IDE, escolha Arquivo > Novo projeto.
2. Selecione a categoria Java e selecione o modelo de aplicativo Java. Clique em Próximo.
3. Na página Nome e localização do assistente, realize as seguintes operações:
   • Digite NumberSlider como o nome do projeto.
   • Deixe desmarcada a caixa de verificação Usar pasta dedicada para armazenar bibliotecas. (Se você estiver usando o NetBeans IDE 6.0, essa opção não está disponível.)
   • Deixe marcada a caixa de verificação Definir como projeto principal.
   • Desmarque a caixa de verificação Criar classe principal.

   

4. Clique em Terminar para sair do assistente e configurar o projeto.
5. Na janela Projetos, clique com o botão direito do mouse no nó do projeto NumberSlider e selecione Novo > Formulário JFrame.

   (Se o formulário JFrame não estiver disponível no menu Novo, escolha Outro. Em seguida, no assistente para Novo arquivo, selecione a categoria Formulários de GUI Swing e selecione o modelo Formulário JFrame.)

6. Na página Nome e localização do assistente, realize as seguintes operações:
   • Digite NumberSliderFrame para o nome da classe.
   • Digite numberslider como o nome do pacote.

   

7. Clique em Terminar para sair do assistente e criar o formulário.

   NumberSliderForm.java deve abrir no modo de design na área de edição.

8. Na seção Controles Swing da Paleta, arraste um componente de controle deslizante para a área de design. (Se a janela Paleta não estiver aberta, escolha Janela > Paleta).
9. Da Paleta, arraste um componente de campo de texto para a área de design.

   O formulário resultante é parecido com a captura de tela abaixo. Entretanto, o posicionamento não é importante para fins deste exemplo.

   

Origem e destino

Agora que precisamos configurar o exemplo, estamos prontos para criar a vinculação. Entretanto, primeiro precisamos determinar qual componente será a origem da vinculação e qual será o destino. O componente da origem da vinculação é de onde um valor da propriedade primeiro se origina.

Ao vincular no Editor de GUI, você inicia uma vinculação no destino e, em seguida, declara a origem na caixa de diálogo Vincular.

Nesse caso, já que o JSlider vem com um intervalo padrão de valores, iremos usá-lo como a origem.

Observação: As vinculações podem ser de duas vias (leitura/gravação), para que as alterações no destino sejam automaticamente refletidas na origem. Entretanto, a direção da vinculação inicial é sempre da origem para o destino. Consulte as informações no Modo de atualização na seção Configuração de vinculação avançada.

Para vincular o controle deslizante ao campo de texto:

1. Clique com o botão direito do mouse no componente de campo de texto e escolha Vincular > texto para abrir a caixa de diálogo Vincular.
2. Na caixa de combinação Origem da vinculação, selecione jSlider1.
3. Na caixa de combinação Expressão de vinculação, selecione value int como mostrado na imagem abaixo.

   

4. Clique em OK.

Você acabou de vincular a propriedade de bean value do controle deslizante ao valor text do campo de texto.

Na área de design, o campo de texto deve mostrar o valor 50. Esse valor reflete o fato de que o controle deslizante está na posição intermediária e o intervalo padrão de valores do controle deslizante é de 0 a 100.

Agora você pode executar o aplicativo e ver a vinculação em ação.

Para executar o projeto:

1. Escolha Executar > Executar projeto principal.
2. Na caixa de diálogo Executar projeto, clique em OK para aceitar numberslider.NumberSliderForm como a classe principal.

A aplicação deve iniciar em uma janela separada. Ajuste o controle deslizante na aplicação em execução e observe a alteração do valor no campo de texto.

Vinculando beans personalizados

Na seção anterior, você vinculou propriedades de dois componentes Swing padrão adicionados ao formulário da Paleta. Você também pode vincular as propriedades de outros beans. Entretanto, para fazer isso, você precisa realizar algumas etapas para disponibilizar os recursos do IDE para gerar o código de vinculação desse bean. Você pode realizar uma das abordagens a seguir para tornar os recursos de vinculação do IDE disponíveis para um bean:

• Adicione o bean à paleta de forma que possa adicioná-lo a um formulário como adicionaria um componente Swing padrão.
• Adicione a classe bean ao projeto e compile o bean.

Para adicionar um Bean à janela de paleta:

1. Verifique se o bean é compilado.
2. Escolha Ferramentas > Paleta > Componentes Swing/AWT.
3. Se desejar criar uma nova categoria de paleta para o Bean, clique em Nova categoria e insira o nome desejado antes de adicionar o Bean.
4. Clique em Adicionar do JAR, Adicionar da biblioteca ou Adicionar do projeto e conclua o assistente para adicionar o Bean.

Para adicionar um bean a partir do seu projeto:

1. Na janela Projeto, clique com o botão direito do mouse no nó do bean e escolha Compilar arquivo.
2. Arraste o bean para o formulário.

   Você deve ver o bean na janela Inspetor. Você pode chamar a caixa de diálogo Vincular de qualquer uma das propriedades do bean.

Configuração de vinculação avançada

O exemplo na primeira seção deste tutorial mostra uma vinculação direta com alguns comportamentos padrão. Mas às vezes você pode querer ou precisar configurar sua vinculação diferentemente. Se for esse o caso, você pode usar a aba Avançado da caixa de diálogo Vinculação.

A aba Avançado da caixa de diálogo contém os seguintes campos:

• Nome. Permite que você crie um nome para a vinculação, o que lhe dá mais flexibilidade para gerenciar suas vinculações. O nome é adicionado ao construtor da vinculação e pode ser referenciado com o método getName() da vinculação.
• Atualizar modo. Especifica a forma em que as propriedades são mantidas em sincronia. Os valores possíveis são:
  • Sempre sincronizar (leitura/gravação). Sempre que é feita uma alteração na origem ou no destino, o outro é atualizado.
  • Ler somente da origem (somente leitura). O destino só é atualizado na primeira vez em que o valor de origem é definido. As alterações feitas na origem são atualizadas no destino. As alterações feitas no destino são atualizadas na origem.
  • Ler da origem uma vez (ler uma vez). O destino só é atualizado quando está inicialmente vinculado à origem.
• Atualizar origem quando (disponível somente para a propriedade texto dos componentes JTextField e JTextArea). Permite que você selecione a freqüência com que as propriedades são sincronizadas.
• Ignorar ajustando disponível para a propriedade valor de JSlider; para a propriedade selectedElement de JTable e JList; e para a propriedade selectedElements de JTable e JList). Se esta caixa de verificação estiver selecionada, quaisquer alterações feitas na propriedade são propagadas para outra propriedade até que o usuário finalize a alteração. Por exemplo, quando o usuário do aplicativo arrasta um controle deslizante, o valor da propriedade ao qual a propriedade valor do controle deslizante está vinculada só é atualizado quando o usuário libera o botão do mouse.
• Conversor. Se a sua vinculação envolve propriedades com tipos de dados diferentes, você pode especificar o código que converte os valores entre os tipos. A biblioteca de vinculação de beans manipula muitas conversões usadas comumente, mas talvez você precise fornecer seus próprios conversores para outras combinações de tipos de propriedade. Tais conversores precisam estender a classe org.jdesktop.beansbinding.Converter.

  A lista suspensa Conversor é preenchida com quaisquer conversores que foram adicionados como beans ao seu formulário. Você também pode adicionar o código de conversão diretamente, clicando no botão de reticências (...), e selecionando Personalizar código na lista suspensa Selecionar propriedade do conversor usando.

  Abaixo há uma lista de conversões para as quais você não precisa fornecer um conversor:

  • BigDecimal para String, String para BigDecimal
  • BigInteger para String, String para BigInteger
  • Booleano para String, String para Booleano
  • Byte para String, String para Byte
  • Caractere para String, String para Caractere
  • Duplo para String, String para Duplo
  • Flutuante para String, String para Flutuante
  • Int para String, String para Int
  • Longo para String, String para BigDecimal
  • Curto para String, String para Curto
  • Int para Booleano, Booleano para Int
• Validador. Permite que você especifique o código para validar uma alteração no valor da propriedade de destino antes de propagar essa atualização de volta para a propriedade de origem. Por exemplo, você pode usar um validador para garantir que um valor de propriedade inteiro esteja em um interface específico.

  Os validadores precisam estender a classe org.jdesktop.beansbinding.Validator.

  A lista suspensa Validador é preenchida com quaisquer validadores que foram adicionados como beans ao seu formulário. Você também pode adicionar o código de validação diretamente, clicando no botão de reticências (...), e selecionando Personalizar código na lista suspensa Selecionar propriedade do validador usando.

• Valor de origem nulo. Permite que você especifique um valor diferente para usar se a propriedade de origem possuir um valor nulo quando a vinculação for tentada. Este campo corresponde ao método setSourceNullValue() da classe org.jdesktop.beansbinding.Binding.
• Valor de origem não-legível. Permite que você especifique um valor diferente para ser usado se a expressão de vinculação não puder ser resolvida quando a vinculação é tentada. Este campo corresponde ao método setSourceUnreadableValue() da classe org.jdesktop.beansbinding.Binding.

Observação: Para entender melhor as classes e os métodos mencionados acima, você pode acessar a documentação de Javadoc da vinculação de beans diretamente no IDE. Escolha Ajuda > Referências de Javadoc > Vinculação de beans. Na janela do navegador que se abre, clique no link org.jdesktop.beansbinding para a documentação dessas classes.

Vinculando dados a componentes

Além de sincronizar propriedades de componentes Swing visuais e outros beans personalizados, você pode usar a vinculação de beans para ajudar no uso de componentes visuais para interagir com um banco de dados. Quando tiver criado um novo formulário Java e adicionado componentes ao formulário, você pode gerar código para vincular esses componentes aos dados. Esta seção mostra como vincular dados a componentes JTable, JList e JComboBox Swing.

Antes de vincular um componente a dados de um banco de dados, você precisa ter concluído as seguintes coisas:

• Conectado a um banco de dados no IDE.
• Criado classes que representam as tabelas de banco de dados às quais você deseja se vincular. Os passos para criar as classes de entidade para vincular dados a um componente são fornecidos a seguir.

Observação: você também pode usar o assistente para Novo aplicativo de área de trabalho Java para criar rapidamente um aplicativo inteiro de trabalho que tenha recursos de CRUD (criar, ler, atualizar e excluir) em um modo de exibição mestre/ de detalhe. Consulte Construindo um aplicativo de banco de dados de área de trabalho Java para obter mais informações.

jComboBox1.setRenderer(new DefaultListCellRenderer() {
           @Override
           public Component getListCellRendererComponent(
                   JList list, Object value, int index, boolean isSelected, boolean cellHasFocus) {
               super.getListCellRendererComponent(list, value, index, isSelected, cellHasFocus);
               if (value instanceof MyEntityClass) {
                   MyEntityClass mec = (MyEntityClass)value;
                   setText(mec.getPropertyFromMyEntityClass());
               }
               return this;
           }
            })

Propriedades de vinculação especiais

Onde necessário, a biblioteca de vinculação de beans fornece propriedades sintéticas especiais para alguns componentes Swing que estão faltando nos próprios componentes. Essas propriedades representam coisas, tais como uma linha selecionada da tabela, que são úteis para vincular a outras propriedades.

Abaixo há uma lista de propriedades sintéticas adicionadas pelas bibliotecas de vinculação de beans:

Consulte também

Para obter mais informações sobre como usar a Vinculação de beans no IDE, consulte Melhores práticas com JPA e Vinculação de beans.

Para uma introdução mais geral do uso do construtor de GUIs do IDE, consulte Introdução à construção de GUIs.

Para obter exemplos concretos sobre o uso dos recursos de vinculação de beans no IDE, consulte os tutoriais Construindo um aplicativo de banco de dados de área de trabalho Java.

Para ver como você pode usar o modelo de projeto Aplicativo de área de trabalho Java para construir um aplicativo de banco de dados com uma visualização Mestre/Detalhe, consulte Construindo um aplicativo de área de trabalho Java.

Para obter mais informações sobre a vinculação de beans, consulte a página do projeto Vinculação de beans em java.net.

Para obter informações gerais sobre componentes JavaBeans, consulte Trilha de beans do tutorial Java.

Para obter dicas e truques gerais sobre o uso do Construtor de GUIs no NetBeans IDE, consulte Perguntas freqüentes do Editor de GUIs e Log da Web de Patrick Keegan.