Documenti di Didattica
Documenti di Professioni
Documenti di Cultura
O Hibernate o framework que fornece ferramentas para o mapeamento relacional de objeto (ORM). O tutorial demonstra o
suporte para o framework do Hibernate no IDE e como usar os assistentes para criar os arquivos necessrios do Hibernate.
Depois de criar objetos Java e configurar a aplicao usar o Hibernate, voc cria uma interface GUI para a pesquisa e exibio
dos dados.
Neste tutorial, voc constri uma aplicao de administrao corporativa para a aplicao Web de Loja de DVDs. Este tutorial
abrange como criar uma aplicao que permita a consulta do perfil de um ator com base na correspondncia com o primeiro ou
ltimo nome. Se voc desejar, poder ampliar a aplicao para consultar os detalhes de um filme e adicionar/atualizar/deletar
itens. Este tutorial usa o MySQL e o banco de dados Sakila, mas voc pode usar qualquer servidor de banco de dados compatvel
com aplicaes Hibernate. O banco de dados Sakila um banco de dados de amostra que pode ser obtido por download no site
MySQL. As informaes para a definio do banco de dados Sakila so fornecidas nas sees a seguir.
Antes de comear este tutorial, talvez voc queira se familiarizar com a documentao a seguir.
Para construir esta aplicao usando o Maven, consulte Criando uma Aplicao Maven Swing usando o Hibernate.
Contedo
https://netbeans.org/kb/docs/java/hibernate-java-se_pt_BR.html?print=yes 1/15
2017-6-4 Usando o Hibernate em uma Aplicao Java Swing - Tutorial do NetBeans IDE
O banco de dados Sakila uma amostra gratuita do banco de dados MySQL, disponvel no site MySQL. Para criar o banco de
dados sakila, voc pode fazer o download e instalar o plug-in Banco de Dados de Amostra do Sakila usando o Gerenciador de
plug-ins. Depois de instalar o plug-in, voc pode criar o banco de dados sakila da janela Servios. O banco de dados sakila
adicionado lista de bancos de dados na caixa de dilogo Criar banco de dados MySQL.
Para obter mais informaes sobre a configurao do IDE para trabalhar com o MySQL, consulte o tutorial Estabelecendo
Conexo com um Banco de Dados MySQL.
2. Depois de instalar o plug-in, inicie o servidor do banco de dados MySQL ampliando o n Banco de dados na janela
Servios, clicando com o boto direito do mouse no n Servidor MySQL e escolhendo Iniciar.
3. Clique com o boto direito do mouse no n Servidor MySQL e escolha Criar Banco de Dados.
4. Selecione o banco de dados Sakila na lista drop-down Novo Nome de Banco de Dados, na caixa de dilogo Criar Banco
de Dados MySQL. Clique em OK.
Quando voc clicar em OK, um n do Salkila ser exibido sob o n Servidor MySQL.
Quando voc clicar em Conectar, um n de conexo do banco de dados do banco de dados Sakila
(jdbc:mysql://localhost:3306/sakila [nome de usurio em Default]) ser apresentado no n Bancos de
Dados. Quando uma conexo for aberta, voc poder exibir os dados no banco de dados ampliando o n de conexo.
1. Selecione Arquivo > Novo Projeto (Ctrl-Shift-N). Selecione Aplicao Java na categoria Java e clique em Prximo.
Quando voc clicar em Finalizar, o IDE criar o projeto da aplicao Java. O projeto no tem uma classe principal. Voc criar um
form e o definir como classe principal.
O IDE inclui assistentes para ajud-lo a criar os arquivos Hibernate necessrios em seu projeto. possvel usar os assistentes no
IDE para criar um arquivo de configurao Hibernate e uma classe de ajuda do utilitrio. Se voc criar o arquivo de configurao
Hibernate usando um assistente, o IDE adicionar automaticamente as bibliotecas Hibernate ao projeto.
https://netbeans.org/kb/docs/java/hibernate-java-se_pt_BR.html?print=yes 2/15
2017-6-4 Usando o Hibernate em uma Aplicao Java Swing - Tutorial do NetBeans IDE
1. Clique com o boto direito do mouse no n Pacotes de Cdigo-fonte na janela Projetos e escolha Novo > Outro para
abrir o assistente para Novo Arquivo.
3. Mantenha as definies default no painel Nome e Localizao (se desejar criar o arquivo no diretrio src). Clique em
Prximo.
4. Selecione a conexo sakila na lista drop-down Conexo do Banco de Dados. Clique em Finalizar.
Quando voc clicar em Finalizar, o IDE abrir o hibernate.cfg.xml no editor de cdigo-fonte. O IDE cria o arquivo de
configurao na raiz do classpatch contextual da aplicao (na janela Arquivos, WEB-INF/classes). Na janela Projetos, o
arquivo est localizado no pacote de cdigo-fonte <pacote default>. O arquivo de configurao contm informaes
sobre um nico banco de dados. Se planeja conectar a vrios bancos de dados, voc pode criar vrios arquivos de
configurao no projeto, um para cada servidor de banco de dados; porm, por default, a classe utilitrio de ajuda usar o
arquivo hibernate.cfg.xml que est na localizao-raiz.
Se voc expandir o n Bibliotecas na janela Projetos, observar que o IDE acrescentou os arquivos JAR do Hibernate
obrigatrios e o JAR do conector MySQL.
https://netbeans.org/kb/docs/java/hibernate-java-se_pt_BR.html?print=yes 3/15
2017-6-4 Usando o Hibernate em uma Aplicao Java Swing - Tutorial do NetBeans IDE
Observao. O NetBeans IDE 8.0 vem com as bibliotecas do Hibernate 4. As verses mais antigas do IDE vinham com
o Hibernate 3.
1. Abra hibernate.cfg.xml na guia Desenho. Voc pode abrir o arquivo expandindo o n Arquivos de Configurao
na janela Projetos e clicando duas vezes em hibernate.cfg.xml.
4. Na caixa de dilogo, selecione a propriedade hibernate.show_sql e defina o valor para true. Clique em OK.
Isso ativa o log de depurao das instrues SQL.
https://netbeans.org/kb/docs/java/hibernate-java-se_pt_BR.html?print=yes 4/15
2017-6-4 Usando o Hibernate em uma Aplicao Java Swing - Tutorial do NetBeans IDE
Se clicar na guia XML no editor, voc pode ver o arquivo na view XML. O arquivo deve ter uma aparncia semelhante
a esta:
<hibernate-configuration>
<session-factory name="session1">
<property
name="hibernate.dialect">org.hibernate.dialect.MySQLDialect</property>
<property
name="hibernate.connection.driver_class">com.mysql.jdbc.Driver</property>
<property
name="hibernate.connection.url">jdbc:mysql://localhost:3306/sakila</property>
<property name="hibernate.connection.username">root</property>
<property name="hibernate.connection.password">######</property>
<property name="hibernate.show_sql">true</property>
<property
name="hibernate.query.factory_class">org.hibernate.hql.internal.classic.ClassicQueryTra
nslatorFactory</property>
</session-factory>
</hibernate-configuration>
Aps voc criar o form e defini-lo como a classe principal voc poder ver a consulta SQL impressa na janela de Sada do IDE
quando voc executar o projeto.
Nesta seo, voc usa o assistente para Novo Arquivo a fim de criar a classe helper HibernateUtil.java.
1. Clique com o boto direito do mouse no n dos Pacote de Cdigos-fonte e selecione Novo > Outro para abrir o
assistente para Novo Arquivo.
https://netbeans.org/kb/docs/java/hibernate-java-se_pt_BR.html?print=yes 5/15
2017-6-4 Usando o Hibernate em uma Aplicao Java Swing - Tutorial do NetBeans IDE
2. Selecione Hibernate na lista Categorias e HibernateUtil.java na lista Tipos de Arquivo. Clique em Prximo.
3. Insira HibernateUtil como nome da classe e sakila.util como nome do pacote. Clique em Finalizar.
Quando voc clicar em Finalizar, o HibernateUtil.java ser aberto no editor. Voc pode fechar o arquivo porque no
precisa edit-lo.
Voc pode usar o assistente Engenharia Reversa e os Arquivos de Mapeamento do Hibernate e POJOs obtidos de um assistente
de banco de dados para criar mltiplos POJOs e arquivos de mapeamento com base nas tabelas selecionadas do banco de
dados. Como alternativa, voc pode usar assistentes no IDE para ajudar a criar POJOs individuais e arquivos de mapeamento a
partir do rascunho.
Observaes.
Ao criar arquivos para mltiplas tabelas, voc provavelmente desejar usar os assistentes. Neste tutorial, voc s
precisa criar um POJO e um arquivo de mapeamento, portanto, muito mais fcil criar os arquivos individualmente.
Voc pode consultar as etapas para a criao dos POJOs e arquivos de mapeamento individualmente no final deste
tutorial.
1. Clique com o boto direito do mouse no n dos Pacote de Cdigos-fonte e selecione Novo > Outro para abrir o
assistente para Novo Arquivo.
2. Selecione Hibernate na lista Categorias e o assistente Engenharia Reversa do Hibernate a partir da lista Tipos de
Arquivos. Clique em Prximo.
O assistente gera um arquivo de engenharia reversa hibernate.reveng.xml. Voc pode fechar o arquivo de engenharia
reversa porque no precisar editar o arquivo.
https://netbeans.org/kb/docs/java/hibernate-java-se_pt_BR.html?print=yes 6/15
2017-6-4 Usando o Hibernate em uma Aplicao Java Swing - Tutorial do NetBeans IDE
1. Clique com o boto direito do mouse no n Pacotes de Cdigo-fonte na janela Projetos e escolha Novo > Outro para
abrir o assistente para Novo Arquivo.
4. Selecione hibernate.reveng.xml na lista drop-down Arquivo de Engenharia Reversa Hibernate, caso no esteja
selecionado.
5. Certifique-se de que as opes Cdigo do Domnio e Mapeamentos XML do Hibernate estejam selecionadas.
Quando voc clica em Finalizar, o IDE gera o POJO Actor.java com todos os campos necessrios, gerando tambm um
arquivo de mapeamento Hibernate e adicionando a entrada de mapeamento ao hibernate.cfg.xml.
Agora que voc tem o POJO e os arquivos necessrios relacionados ao Hibernate, poder criar um front-end simples de GUI Java
para a aplicao. Voc tambm poder criar e adicionar uma consulta HQL que pesquise o banco de dados para recuperar os
dados. Nesse processo, tambm usamos o editor HQL para construir e testar a consulta.
Se voc no estiver familiarizado com o uso do GUI Builder para criar forms, talvez queira examinar o tutorial Introduo
Construo de GUIs.
https://netbeans.org/kb/docs/java/hibernate-java-se_pt_BR.html?print=yes 7/15
2017-6-4 Usando o Hibernate em uma Aplicao Java Swing - Tutorial do NetBeans IDE
1. Clique com o boto direito do mouse no n do projeto na janela Projetos e escolha Novo > Outro para abrir o
assistente para Novo Arquivo.
3. Digite DVDStoreAdmin como Nome da Classe e insira sakila.ui como Pacote. Clique em Finalizar.
Quando voc clicar em Finalizar, o IDE criar a classe e abrir o Form JFrame na view Design do editor.
3. Arraste um elemento Campo de Texto perto do label Nome e delete o texto default.
5. Arraste um elemento Campo de texto para perto do label Sobrenome e delete o texto default.
8. Modifique os valores do Nome da Varivel dos seguintes elementos da UI de acordo com os valores na tabela a seguir.
Voc pode modificar o valor do Nome da Varivel de um elemento clicando com o boto direito do mouse no elemento
na view Design e, em seguida, escolhendo Alterar Nome da Varivel. De modo alternativo, voc pode alterar o Nome
da Varivel diretamente na janela Inspetor.
Voc no precisa designar os valores do Nome da Varivel aos elementos do Label.
Tabela resultTable
9. Salve as alteraes.
https://netbeans.org/kb/docs/java/hibernate-java-se_pt_BR.html?print=yes 8/15
2017-6-4 Usando o Hibernate em uma Aplicao Java Swing - Tutorial do NetBeans IDE
Agora que voc tem um form, precisa criar o cdigo para designar eventos aos elementos do form. No prximo exerccio, voc
construir consultas com base na Linguagem de Consulta Hibernate para recuperar dados. Depois de construir as consultas,
voc adicionar mtodos ao form para chamar a consulta apropriada quando o boto Consulta for pressionado.
Neste exerccio, o Editor HQL utilizado para construir consultas HQL simples que recuperam uma lista de detalhes de atores
com base na correspondncia do nome ou sobrenome. Antes de adicionar a consulta classe, voc utilizar o Editor de Consulta
HQL para testar se a conexo est funcionando corretamente e se a consulta produz os resultados desejados. Antes de executar
a pesquisa, preciso compilar a aplicao.
3. Clique com o boto direito do mouse em hibernate.cfg.xml e escolha Executar Consulta HQL para abrir o Editor
HQL.
4. Teste a conexo inserindo from Actor no Editor de Consultas HQL. Clique no boto Executar Consulta HQL ( ) na
barra de ferramentas.
Quando voc clicar em Executar Consulta HQL, dever visualizar os resultados da consulta no painel inferior do Editor de
Consultas HQL.
https://netbeans.org/kb/docs/java/hibernate-java-se_pt_BR.html?print=yes 9/15
2017-6-4 Usando o Hibernate em uma Aplicao Java Swing - Tutorial do NetBeans IDE
5. Digite a consulta a seguir no Editor de Consultas HQL e clique em Executar consulta HQL para verificar os resultados da
consulta quando a string de pesquisa for "PE".
A consulta retorna uma lista de detalhes de atores para aos atores cujos nomes comeam com "PE".
Ao clicar no boto SQL acima dos resultados, voc dever ver a seguinte consulta SQL equivalente.
6. Abra uma nova guia do Editor de Consulta HQL e insira a consulta a seguir no painel do editor. Clique em Executar
Consulta HQL.
A consulta retorna uma lista de detalhes de atores para os atores cujos sobrenomes comeam com "MO".
Testar as consultas mostra que as elas retornam os resultados desejados. A prxima etapa implementar as consultas na
aplicao de modo que a consulta apropriada seja chamada clicando-se no boto Consulta no form.
public DVDStoreAdmin() {
initComponents();
}
https://netbeans.org/kb/docs/java/hibernate-java-se_pt_BR.html?print=yes 10/15
2017-6-4 Usando o Hibernate em uma Aplicao Java Swing - Tutorial do NetBeans IDE
possvel copiar as consultas das guias do Editor de Consulta HQL para o campo e, em seguida, modificar o
cdigo.
3. Adicione os mtodos a seguir para criar a consulta com base na string de entrada do usurio.
Esses mtodos chamam o mtodo executeHQLQuery() e cria a consulta combinando a string de consulta com o
usurio que inseriu a string de pesquisa.
O mtodo executeHQLQuery() chama o Hibernate para executar a consulta selecionada. Esse mtodo usa a classe
de utilitrio HibernateUtil.java para obter a Sesso Hibernate.
5. Clique com o boto direito do mouse no Editor e escolha Corrigir Importaes (ctrl-shift-i; -shift-i em mac) para gerar
instrues de importao para as bibliotecas de Hibernao (org.hibernate.query, org.hibernate.session)
e java.util.list. Salve as alteraes.
6. Crie um handler de eventos do boto Consulta alternando para a view Design e clicando duas vezes no boto Consulta.
O IDE cria o mtodo queryButtonActionPerformede exibe o mtodo na view Cdigo-fonte.
for(Object o : resultList) {
https://netbeans.org/kb/docs/java/hibernate-java-se_pt_BR.html?print=yes 11/15
2017-6-4 Usando o Hibernate em uma Aplicao Java Swing - Tutorial do NetBeans IDE
Actor actor = (Actor)o;
Vector<Object> oneRow = new Vector<Object>();
oneRow.add(actor.getActorId());
oneRow.add(actor.getFirstName());
oneRow.add(actor.getLastName());
oneRow.add(actor.getLastUpdate());
tableData.add(oneRow);
}
resultTable.setModel(new DefaultTableModel(tableData, tableHeaders));
}
9. Clique com o boto direito do mouse no editor e escolha Corrigir Importaes (Ctrl-Shift-I; -Shift-I no Mac) para gerar
uma instruo de importao para java.util.Vector e java.util.List. Salve as alteraes.
Executando o Projeto
Agora que a codificao foi finalizada, possvel iniciar a aplicao. Antes de executar o projeto, preciso especificar a Classe
Principal da aplicao na caixa de dilogo propriedades do projeto. Se nenhuma Classe Principal tiver sido especificada, ser
solicitado que voc execute a aplicao.
1. Clique com o boto direito do mouse no n do projeto na janela Projetos e escolha Propriedades.
4. Clique em Executar Projeto principal na barra de ferramentas principal para iniciar a aplicao.
Insira uma string de pesquisa no campo de texto Nome ou Sobrenome e clique em Consulta para pesquisar um ator e exibir os
detalhes.
https://netbeans.org/kb/docs/java/hibernate-java-se_pt_BR.html?print=yes 12/15
2017-6-4 Usando o Hibernate em uma Aplicao Java Swing - Tutorial do NetBeans IDE
Se voc observar a janela de Sada do IDE, poder visualizar a consulta SQL que recuperou os resultados exibidos.
Faa o check-out do cdigo-fonte do projeto das Amostras do NetBeans ao executar as etapas a seguir:
Escolha Equipe > Subversion > Efetuar check-out no menu principal.
Clique em Procurar para abrir a caixa de dilogo Procurar nas Pastas do Repositrio:
Especifique a Pasta Local para o cdigos-fonte (a pasta local precisa estar vazia).
Clique em Finalizar.
Quando voc clica em Finalizar, o IDE inicializa a pasta local como um repositrio Subversion e verifica os
cdigos-fonte do projeto.
Clique em Abrir Projeto na caixa de dilogo exibida quando o check-out for concludo.
Observao. necessrio um cliente Subversion para verificar os cdigos-fonte. Para saber mais sobre a
instalao do Subversion, consulte a seo Configurando o Subversion no Guia do Subversion no NetBeans
IDE.
Observao. Esse exerccio opcional e descreve como criar o arquivo de mapeamento e POJO que voc criou com o
assistente Hibernar Arquivos de Mapeamento e POJOs do Banco de Dados.
1. Clique com o boto direito do mouse no n Pacotes de Cdigos-fonte na janela Projetos e escolha Novo > Classe Java
para abrir o assistente Nova Classe Java.
https://netbeans.org/kb/docs/java/hibernate-java-se_pt_BR.html?print=yes 13/15
2017-6-4 Usando o Hibernate em uma Aplicao Java Swing - Tutorial do NetBeans IDE
2. No assistente, insira Ator para o nome da classe e sakila.entity para o pacote. Clique em Finalizar.
3. Faa as seguintes alteraes (exibidas em negrito) nas classes para implementar a interface serializvel e adicionar
campos nas colunas da tabela.
4. Clique com o boto direito do mouse no Editor e escolha Inserir Cdigo (Alt-Insert; Ctrl-I em Mac) e selecione getter e
setter no menu pop-up para gerar getters e setters para os campos.
5. Na caixa de dilogo Gerar Getters e Setters, selecione todos os campos e clique em Gerar.
Na caixa de dilogo Gerar Getters e Setters, voc pode usar a seta para cima no teclado para mover o item
selecionado para o n Ator e pressionar a barra de espaos para selecionar todos os campos em Ator.
Depois de criar o POJO para a tabela, voc desejar criar um arquivo de mapeamento do Hibernate para Actor.java.
1. Clique com o boto direito do mouse no n de pacotes de cdigo-fonte sakila.entity, na janela Projetos, e escolha
Novo > Outro para abrir o assistente Novo Arquivo.
3. Insira Actor.hbm como Nome do Arquivo e verifique se a Pasta src/sakila/entity. Clique em Prximo.
4. Insira sakila.entity.Actor para Classe a Mapear e selecione actor na lista drop-down Tabela do Banco de Dados. Clique
em Finalizar.
Quando voc clicar em Finalizar, o arquivo de mapeamento do Hibernate Actor.hbm.xml ser aberto no editor de
cdigo-fonte. O IDE tambm adiciona automaticamente uma entrada para o recurso de mapeamento para
https://netbeans.org/kb/docs/java/hibernate-java-se_pt_BR.html?print=yes 14/15
2017-6-4 Usando o Hibernate em uma Aplicao Java Swing - Tutorial do NetBeans IDE
hibernate.cfg.xml. Voc pode exibir os detalhes da entrada ampliando o n Mapeamento, na view Design do
hibernate.cfg.xml ou na view XML. A entrada mapeamento na view XML ser semelhante a:
<mapping resource="sakila/entity/Actor.hbm.xml"/>
</session-factory>
</hibernate-configuration>
5. Associe os campos Actor.java s colunas na tabela ACTOR fazendo as seguintes alteraes (em negrito) no
Actor.hbm.xml.
<hibernate-mapping>
<class name="sakila.entity.Actor" table="actor">
<id name="actorId" type="java.lang.Short">
<column name="actor_id"/>
<generator class="identity"/>
</id>
<property name="firstName" type="string">
<column length="45" name="first_name" not-null="true"/>
</property>
<property name="lastName" type="string">
<column length="45" name="last_name" not-null="true"/>
</property>
<property name="lastUpdate" type="timestamp">
<column length="19" name="last_update" not-null="true"/>
</property>
</class>
</hibernate-mapping>
Voc pode usar a funcionalidade autocompletar cdigo no editor para completar os valores ao modificar o arquivo
de mapeamento.
Observao: Por default, o elemento class gerado tem uma tag de fechamento. Como voc precisa adicionar
elementos de propriedade entre as tags de abertura e fechamento do elemento class, necessrio fazer as
alteraes a seguir (exibidas em negrito). Depois de fazer as alteraes, voc poder usar a funcionalidade
autocompletar cdigo entre as tags class.
<hibernate-mapping>
<class name="sakila.entity.Actor" table="actor">
</class>
</hibernate-mapping>
A criao de POJOs individuais e arquivos de mapeamento do Hibernate pode ser um modo conveniente de personalizar ainda
mais sua aplicao.
Consulte Tambm
Para obter informaes adicionais sobre a criao de aplicaes GUI do Swing, consulte os tutoriais a seguir.
https://netbeans.org/kb/docs/java/hibernate-java-se_pt_BR.html?print=yes 15/15