Roteiro para criação de JavaBeans
O código em azul especializa o roteiro para criar o bean
PainelControle
PREPARANDO O PROJETO
- Crie um projeto no JBuilder e lembre-se de configurar as propriedades do mesmo.
- Adicione esse arquivo html no projeto para facilitar sua visualização.
- Selecione a opção New no menu File e em seguida escolha a opção Panel, na pasta General,
para criar um novo painel (PainelControle).
- Selecione a pasta Design para editar sua classe e
- modifique o layout para null;
- adicione os componentes desejados (três botões e um
rótulo/label) do bean e coloque o nome dos mesmos;
- implemente os eventos que os componentes adicionados devem gerar (actionPerformed dos botões);
- compile o projeto.
PROPRIEDADES
- Agora vá para a pasta Bean -> Properties e adicione as propriedades desejadas
(Com seus métodos get/is e set).
- botaoInserirHabilitado do tipo boolean;
- botaoConsultarHabilitado do tipo boolean;
- botaoLimparHabilitado do tipo boolean;
- mensagem do tipo String.
- De volta a pasta Source,
vamos ligar as propriedades, modificando os metodos get/is e set para utilizarem os
botoes e a mensagem de acordo com os exemplos abaixo
- Corpo do metodo isBotaoInserirHabilitado()
- return btInserir.isEnabled()
- Corpo do metodo setBotaoInserirHabilitado(valor)
- btInserir.setEnabled(valor)
- Corpo do metodo getMensagem()
- return lbMensagem.getText()
- Corpo do metodo setMensagem(valor)
- lbMensagem.setText(valor)
- Remova os atributos
botaoInserirHabilitado,
botaoConsultarHabilitado,
botaoLimparHabilitado, e
mensagem. Compile o projeto.
EVENTOS
- Vá para a pasta Bean e
- Na pasta General, selecione a opção Support Serialization;
- Na pasta BeanInfo, certifique-se que somente as propriedades estão selecionadas
e clique no botão Generate BeanInfo;
- Na pasta Events, clique o botão Create Custom Event;
- Preencha o nome do Event Set com o nome do painel (PainelControle);
- Remova o evento dataChanged e adicione os eventos
botaoInserirPressionado,
botaoConsultarPressionado e
botaoLimparPressionado, clique o botão OK;
- Na parte de eventos levantados (coluna esquerda), selecione o Event set que acabamos de criar;
- Compile o projeto.
- Por fim temos de indicar em que situações os eventos devem ser disparados.
No item 4 deste roteiro você implementou os eventos que os componentes do bean
devem gerar (actionPerformed dos botões).
Agora você deve implementar a notificação do evento através da chamada ao
método fire correspondente conforme o exemplo a seguir.
void bt_inserir_actionPerformed(ActionEvent e) {
this.fireBotaoInserirPressionado(new PainelControleEvent(this));
}
- Note que não implementamos Introspecção e
Customização específicos para o nosso bean. Dessa forma a IDE
automaticamente irá detectar as propriedades do bean e implementará editores
default para as mesmas.
GERANDO UM ARQUIVO PARA DISTRIBUIÇÃO
- Pronto o seu bean está pronto. Agora temos de gerar um arquivo de
distribuição para permitir instalá-lo em uma IDE e distribuí-lo para outras
pessoas/projetos, permitindo assim seu reuso.
- Chame o menu Wizards -> Archive Builder ...;
- Clique no botão Next e marque a opção Compress the contents of the archive;
- Clique no botão Finish;
- Compile o projeto.
INSTALANDO O BEAN NO JBUILDER
- Feche o projeto com o seu bean.
- Para instalar o bean no JBuilder escolha a opção Configure Palette
no menu Tools. Escolha a pasta Add components e clique em Select library.
Vamos criar uma biblioteca selecionando User home e clicando em
New ... e escolhendo um nome para a mesma. Em seguida clique em
Add ... e selecione o arquivo .jar que foi gerado. Clique em
OK e em seguida em OK novamente. Agora escolha o local onde o
bean será instalado, recomendamos que seja em Other. Selecione a opção No Filtering.
Em seguida clique em Add from Selected Library e escolha a classe do seu painel. Como resultado
você deve ter uma tela mostrando uma mensagem de que o seu bean foi instalado
(Added javabeans.PainelControle).
- Agora você poderá utilizar o componente (na paletta Other) em qualquer projeto, da mesma forma
que se manipula os demais componentes gráficos (button, label, list,...).
- Crie uma aplicação como exemplo e tente utilizar seu bean na mesma.
© Sérgio Soares/Leonardo Cole 2003