Trabalhando com o banco de dados Java DB (Derby)
Este documento demonstra como configurar uma conexão com o banco de dados Java DB da Sun no NetBeans IDE. Quando uma conexão for estabelecida, você poderá começar a trabalhar com o banco de dados no IDE, podendo criar tabelas, preenchê-las com dados, executar instruções SQL e consultas e mais.
O banco de dados Java DB é uma distribuição da Sun com suporte do Apache Derby. O Java DB é um servidor de banco de dados baseado em padrões, seguro e totalmente transacional, escrito inteiramente em Java, e dá suporte total a SQL, JDBC API e à tecnologia Java EE.
O banco de dados Java DB é empacotado com o servidor de aplicativos GlassFish V2 e agora também está incluído no JDK 6. Para obter mais informações sobre o banco de dados Java DB, consulte a documentação oficial.
Duração esperada: 30 minutos
Conteúdo
Para seguir este tutorial, você precisa dos seguintes recursos e softwares.
Observação: o Java DB está incluído no JDK 6. Se você estiver instalando a versão Web e Java EE (ou a instalação completa) do NetBeans IDE, você pode opcionalmente instalar o servidor de aplicativos GlassFish V2, que também inclui o Java DB. Como alternativa, se você estiver trabalhando com o Servidor de aplicativos Sun Java System, observe que o banco de dados Java DB está incluído.
Configurando o banco de dados
Se o servidor GlassFish estiver registrado na sua instalação do NetBeans IDE, o Java DB já estará registrado para você. Você pode ir direto para Iniciando o servidor e criando um banco de dados. Se você tiver baixado o GlassFish (ou o servidor de aplicativos Sun Java System) separadamente, e precisar de ajuda pra registrá-lo no NetBeans IDE, consulte Registrando um servidor de aplicativos Sun Java System/uma instância do GlassFish no Conteúdo da Ajuda do IDE (F1). Se você tiver apenas baixado o Java DB, faça o seguinte:
- Execute o arquivo de auto-extração. Uma pasta denominada 'javadb' será criada no mesmo local do arquivo. Se você tiver apenas baixado o Java DB e desejar que o servidor de banco de dados fique em um local diferente de onde ele foi extraído, deverá realocá-lo agora.
- No diretório raiz do Java DB (javadb), crie uma nova pasta chamada 'databases'. Você usará esta pasta posteriormente para conter instâncias individuais do servidor de banco de dados. Observe que esta pasta não precisa estar no diretório raiz do banco de dados.
Antes de prosseguir, é importante compreender os componentes encontrados no diretório raiz do Java DB:
- O subdiretório demo contém os programas de demonstração.
- O subdiretório bin contém os scripts para executar utilitários e configurar o ambiente.
- O subdiretório javadoc contém a documentação da API que foi gerada de comentários de código-fonte.
- O subdiretório docs contém a documentação do Java DB.
- O subdiretório lib contém os arquivos jar do Java DB.
- O subdiretório frameworks contém os scripts do estilo anterior para executar utilitários e configurar o ambiente. Eles geralmente são fornecidos para compatibilidade com versões anteriores. Em versões anteriores, eles poderiam ser substituídos pelos scripts no diretório bin.
Registrando o banco de dados no NetBeans IDE
Agora que o banco de dados está configurado, você pode registrá-lo no IDE:
Na janela Serviços, clique com o botão direito do mouse no nó do Banco de dados Java DB e escolha Propriedades.
A caixa de diálogo Configurações de Java DB é aberta.
- No campo de texto Instalação de Java DB, insira o caminho para o diretório raiz de Java DB (javadb) especificado na etapa anterior.
-
Para Local do banco de dados, defina o caminho para a pasta 'databases' recém criada. A captura de tela abaixo exibe configurações de exemplo para o servidor Java DB em um Macintosh. Quando tiver concluído, clique em OK.
Iniciando o servidor e criando um banco de dados
As opções de menu do banco de dados Java DB são exibidas quando você clica com o botão direito do mouse no nó Java DB na janela Serviços. Os itens desse menu contextual permitem que você inicie e interrompa o servidor de banco de dados, crie uma nova instância de banco de dados e registre servidores de bancos de dados no IDE (como demonstrado na etapa anterior). Para iniciar o servidor de banco de dados:
Na janela Serviços, clique com o botão direito do mouse no nó Java DB e escolha Iniciar servidor. Observe a seguinte saída na janela de saída, indicando que o servidor foi iniciado.
Clique com o botão direito do mouse no nó Java DB e escolha Criar banco de dados.
A caixa de diálogo Criar Java DB se abre.-
No campo de texto Nome do banco de dados, digite contact. Defina também o Nome de usuário e a Senha como nbuser. Observe que Local do banco de dados é o local padrão definido durante a instalação do Java DB do GlassFish. Se você tiver instalado o Java DB separadamente, esse local será diferente. Clique em OK.
Conectando ao banco de dados
Até agora, você iniciou com êxito o servidor de banco de dados e criou uma instância de banco de dados denominada contact no IDE. O banco de Dados Explorer do NetBeans IDE, disponível a partir da janela Serviços, fornece funcionalidade para tarefas comuns em estruturas de bancos de dados. Isto inclui:
- criação, exclusão e modificação de tabelas
- preenchimento de tabelas com dados
- exibição de dados tabulares
- execução de consultas e instruções SQL
Para começar a trabalhar com o banco de dados contact, você precisa criar uma conexão com o mesmo. Para se conectar a contact:
Expanda o banco de dados Explorer na janela Serviços (Ctrl-5) e localize o novo banco de dados.
Clique com o botão direito do mouse no nó da conexão do banco de dados (jdbc:derby://localhost:1527/contact [nbuser em NBUSER]) e escolha Conectar.
O ícone do nó da conexão agora aparece por inteiro (
), o que significa que a conexão foi bem sucedida.
Criando tabelas
O banco de dados contact recém-criado está vazio no momento. Ele ainda não contém tabelas ou dados. No NetBeans IDE, você pode adicionar uma tabela de banco de dados usando a caixa de diálogo Criar tabela ou inserindo uma instrução SQL e executando-a diretamente do Editor SQL. Você pode explorar ambos os métodos:
Usando a caixa de diálogo Criar tabela
Expanda o nó da conexão de contact e observe que há três subpastas: Tabelas, Exibições e Procedimentos. Clique com o botão direito do mouse no nó Tabelas e escolha Criar tabela.
A caixa de diálogo Criar tabela é aberta.- No campo de texto Nome da tabela, digite AMIGOS.
- Na primeira linha exibida, marque a caixa de verificação Chave. Você está especificando a chave primária da tabela. Todas as tabelas de bancos de dados relacionais devem conter uma chave primária. Observe que quando você marca a caixa de verificação Chave, as caixas de verificação Índice e Exclusiva são automaticamente marcadas e a caixa de verificação Nulo é desmarcada. Isso ocorre porque as chaves primárias são usadas para identificar uma linha exclusiva no banco de dados e por padrão são usadas como o índice da tabela. Como todas as linhas devem ser identificadas, as chaves primárias não podem conter um valor Nulo.
- Para Nome de coluna, insira id. Para Tipo de dados, selecione INTEIRO da lista suspensa. Clique no botão Adicionar coluna.
Repita este procedimento agora especificando campos conforme mostrado na tabela abaixo:
| [marcada] |
[marcada] |
|
[marcada] |
id |
INTEIRO |
0 |
|
|
[marcada] |
|
firstName |
VARCHAR |
20 |
|
|
[marcada] |
|
lastName |
VARCHAR |
20 |
|
|
[marcada] |
|
nickName |
VARCHAR |
30 |
|
|
[marcada] |
|
friendSince |
DATA |
0 |
|
|
[marcada] |
|
email |
VARCHAR |
60 |
Você está criando uma tabela chamada AMIGOS que contém os seguintes dados para cada registro de contato:
- Nome
- Sobrenome
- Apelido
- Amigo desde
- Endereço de email
Quando você tiver certeza que a caixa de diálogo Criar tabela contém as mesmas especificações que as mostradas acima, clique em OK. O IDE gera a tabela AMIGOS no banco de dados e você pode ver um nó da nova tabela AMIGOS (
) exibido em Tabelas no banco de dados Explorer. Abaixo do nó da tabela, as colunas (campos) são listadas, começando pela chave primária (
).
Usando o editor SQL:
- No banco de dados Explorer, clique com o botão direito do mouse no nó da conexão de contact ou no nó Tabelas abaixo dele e escolha Executar comando. Uma tela em branco é aberta no Editor SQL na janela principal.
- Insira a seguinte consulta no Editor SQL. Esta é uma definição da tabela COLEGAS que você irá criar:
CREATE TABLE "COLEGAS" (
"ID" INTEGER not null primary key,
"NOME" VARCHAR(30),
"SOBRENOME" VARCHAR(30),
"CARGO" VARCHAR(10),
"DEPARTAMENTO" VARCHAR(20),
"EMAIL" VARCHAR(60)
);
Observação: instruções e consultas formadas no Editor SQL são analisadas em SQL. A linguagem SQL utiliza regras de sintaxe estritas com as quais você deve estar familiarizado ao trabalhar no editor do IDE. A sintaxe do SQL também pode diferir dependendo do sistema de gerenciamento de banco de dados. Consulte o Manual de referência do JavaDB para obter diretrizes específicas.
Clique no botão Executar SQL (
) na barra de tarefas na parte superior do editor (Ctrl-Shift-E) para executar a consulta. Na janela de saída (Ctrl-4), uma mensagem é exibida indicando que uma instrução foi executada com êxito.
- Para verificar as alterações, clique com o botão direito do mouse no nó da conexão de contact no banco de dados Explorer e escolha Atualizar. Isso atualiza o componente IU de tempo de execução para o status atual do banco de dados especificado. Esta etapa é necessária ao executar consultas do Editor SQL no NetBeans IDE. Observe que o nó da nova tabela COLEGAS () agora é exibido em Tabelas na janela Serviços.
Adicionando dados de tabela
Agora que você criou uma ou mais tabelas no banco de dados contact, pode começar a preenchê-lo com dados. Para adicionar um registro (linha) completo na tabela AMIGOS, crie uma instrução que forneça um valor para cada campo presente no esquema da tabela. Você pode usar o Editor SQL para formular uma simples instrução que adicione um novo registro:
- Clique com o botão direito do mouse no nó Tabelas no banco de dados Explorer e escolha Executar comando. Uma tela em branco é aberta no Editor SQL na janela principal.
- No Editor SQL, insira a seguinte instrução.
INSERT INTO "NBUSER"."FRIENDS" VALUES (1,'Theodore','Bagwell','T-Bag','2004-12-25','tbag@foxriver.com')
- Clique com o botão direito do mouse no Editor SQL e escolha Executar instrução. A janela de saída exibe uma mensagem indicando que uma instrução foi executada com êxito.
-
Para verificar se o novo registro foi adicionado à tabela AMIGOS, clique com o botão direito do mouse no nó da tabela AMIGOS na janela Serviços e escolha Exibir dados. O Editor SQL é aberto novamente na janela principal. Ao escolher Exibir dados, é gerada automaticamente no painel superior do Editor SQL uma consulta para selecionar todos os dados da tabela.
Os resultados da instrução são exibidos no painel inferior do Editor de SQL. Nesse caso, a tabela AMIGOS é exibida no painel inferior. Observe que uma nova linha foi adicionada com os dados que você acabou de fornecer da instrução SQL.
Excluindo tabelas
Na etapa a seguir, use um script SQL externo para criar uma nova tabela COLEGAS. Entretanto, você acabou de criar uma tabela COLEGAS em Usando o Editor SQL acima. Para deixar claro que o script SQL realmente cria uma nova tabela, você pode excluir a tabela COLEGAS já criada agora. Para excluir uma tabela de banco de dados:
- Clique com o botão direito do mouse no nó da tabela no banco de dados Explorer e escolha Excluir.
- Na caixa de diálogo Confirmar exclusão do objeto, clique em Sim. Observe que o nó da tabela é imediatamente removido do banco de dados Explorer.
Usando um script SQL externo
A emissão de comandos de um script SQL externo é uma forma popular de gerenciar seu banco de dados. Você pode já ter criado um script SQL em outro lugar, e deseja importá-lo para o NetBeans IDE para executá-lo em um banco de dados específico.
Com a finalidade de demonstração, baixe o colleagues.sql e salve-o no seu computador. Esse script cria uma nova tabela chamada COLEGAS e a preenche com dados. Para executar esse script no banco de dados contact:
- Escolha Arquivo > Abrir arquivo no menu principal do IDE. No navegador de arquivos, vá até o local do arquivo colleagues.sql salvo e clique em Abrir. O script se abre automaticamente no Editor SQL.
-
Certifique-se que a conexão com contact esteja selecionada na caixa suspensa Conexão na barra de ferramentas na parte superior do editor.
- Clique no botão Executar SQL () na barra de tarefas do Editor SQL. O script é executado no banco de dados selecionado e qualquer comentário é gerado na janela de saída.
- Para verificar as alterações, clique com o botão direito do mouse no nó da conexão de contact na janela Serviços e escolha Atualizar. Observe que a nova tabela COLEGAS do script SQL agora é exibida como um nó de tabela em contact na janela Serviços.
- Para exibir os dados contidos nas novas tabelas, escolha Exibir dados do menu contextual de uma tabela conforme descrito acima. Dessa maneira, você também pode comparar os dados tabulares com os dados contidos no script SQL para ver se eles coincidem.
Recriando tabelas de um banco de dados diferente
Se você tiver uma tabela de outro banco de dados que deseje recriar no banco de dados em que está trabalhando do NetBeans IDE, o IDE oferece uma ferramenta útil para isso. Você primeiro precisa registrar o segundo banco de dados no IDE, de forma similar à que foi descrita no início deste tutorial. Para a finalidade deste tutorial, use o banco de dados de exemplo incluído com o Java DB ao instalar o servidor de aplicativos GlassFish com o NetBeans IDE. Esse processo é realizado essencialmente em duas partes: primeiro você 'captura' a definição da tabela selecionada, depois pode recriar a tabela no banco de dados escolhido:
- Conecte-se ao banco de dados de exemplo clicando com o botão direito do mouse no nó da conexão no banco de dados Explorer e escolhendo Conectar (a senha é app).
-
Expanda o nó Tabelas. Clique com o botão direito do mouse no nó da tabela CLIENTE e escolha Capturar estrutura.
- Na caixa de diálogo Capturar tabela exibida, especifique um local no computador para salvar o arquivo de captura que será criado. Clique em Salvar. O arquivo de captura registra a definição de tabela da tabela selecionada.
- No banco de dados Explorer, clique com o botão direito do mouse no nó Tabela abaixo da conexão do banco de dados contact e escolha Recriar tabela.
Na caixa de diálogo Recriar tabela que é aberta, navegue para o local onde você salvou o arquivo de captura de CLIENTE e clique em Abrir. A caixa de diálogo Nome da tabela é aberta.
-
Neste ponto, você pode alterar o nome da tabela ou editar a definição da tabela. Do contrário, clique em OK para criar imediatamente a tabela no banco de dados contact. Um nó da nova tabela CLIENTE é exibido abaixo do nó da conexão de contact.
Consulte também
Isto conclui o tutorial Trabalhando com o banco de dados Java DB (Derby). Este tutorial demonstrou como configurar uma conexão com o banco de dados Java DB no NetBeans IDE. Ele depois demonstrou como criar, exibir, modificar e excluir tabelas usando o banco de dados Explorer da janela Serviços do IDE. Ele também mostrou como trabalhar com o Editor SQL para adicionar dados em tabelas e usar a funcionalidade do IDE permitindo que você recriasse tabelas usando definições de outros bancos de dados.
Para tutoriais relacionados e mais avançados, consulte os seguintes recursos:
