Criando, importando e configurando projetos Java
Este guia fornece uma visão geral dos principais recursos do NetBeans IDE para instalar e configurar projetos Java. Além disso, ele fornece informações sobre como efetuar a configuração personalizada de scripts de construção gerados pelo IDE.
Conteúdo
Para concluir este tutorial, você precisa dos seguintes recursos e softwares.
Conceitos básicos do projeto
Esta seção fornece uma visão geral de algumas informações detalhadas sobre o sistema de projeto do IDE.
Projetos
No IDE, você sempre trabalha dentro de um projeto. Além dos arquivos de código-fonte, um projeto do IDE contém metadados que pertencem no classpath, como construir e executar o projeto e assim por diante. O IDE armazena as informações do projeto em uma pasta do projeto que inclui um script de construção do ANT e um arquivo de propriedades que controla a construção e as configurações de execução e um arquivo project.xml que mapeia os alvos do Ant com comandos do IDE.
Nota: embora o IDE coloque diretórios de código-fonte na pasta de projeto por padrão, seus diretórios de código-fonte não necessariamente precisam estar localizados na pasta do projeto.
Ant
O Apache Ant é uma ferramenta de compilação utilizada para padronizar e automatizar a compilação, além de executar ambientes para desenvolvimento. O sistema do projeto do IDE tem base direta no Ant. Todos os comandos do projeto, como Limpar e construir o projeto e Depurar, chamam alvos no script do Ant do projeto. Portanto, é possível construir e executar um projeto fora do IDE, exatamente como é construído e executado dentro do IDE.
Não é necessário saber como trabalhar no Ant com o IDE. É possível definir todas as opções básicas de compilação e tempo de execução na caixa de diálogo Propriedades do projeto no projeto e o IDE atualiza automaticamente o script do Ant do projeto. Se você está familiarizado com o Ant, poderá personalizar um script padrão do Ant do projeto ou escrever seu próprio script do Ant para um projeto.
Criando um projeto
Para criar um novo projeto:
- Escolha Arquivo > Novo projeto (Ctrl-Shift-N no Windows, Cmd-Shift-N no Mac OS X).
Quando o assistente para Novo projeto aparecer, selecione o modelo correto para seu projeto e complete as etapas restantes do assistente. O ícone do modelo do projeto pode ser exibido em cinza, o que significa que este tipo de projeto não foi ativado. Prossiga com a criação do projeto e esta funcionalidade será ativada no IDE.
O IDE contém os seguintes modelos de projeto padrão para aplicativos Java e Java Web:
Além disso, o IDE também contém modelos para módulos EJB, aplicativos corporativos, aplicativos Java ME e mais.
As categorias de projetos Java e Web também têm modelos de projeto de formato livre. Os modelos de formato livre permitem o uso de um script do Ant existente para um projeto, mas requerem a configuração manual. Consulte Projetos de formato livre abaixo.
Quando você termina de criar um projeto, ele é aberto no IDE com sua estrutura lógica exibida na janela Projetos e sua estrutura de arquivo exibida na janela Arquivos:
-
A janela Projetos é o ponto de entrada principal para as fontes do projeto. Ela mostra uma visualização lógica do conteúdo importante do projeto como pacotes Java e páginas da Web. É possível clicar com o botão direito do mouse em qualquer nó do projeto para acessar um menu suspenso de comandos para construir, executar e depurar o projeto, bem como abrir a caixa de diálogo Propriedades do projeto. A janela Projetos pode ser aberta ao escolher Janela > Projetos (Ctrl-1 no Windows/Cmd-1 no Mac OS X).
-
A janela Arquivos mostra uma visualização de seus projetos com base em diretório, incluindo arquivos e pastas que não são exibidos na janela Projetos. A partir da janela Arquivos, é possível abrir e editar os arquivos de configuração do projeto, como o script de construção do projeto e o arquivo de propriedades. Também é possível visualizar a saída da construção como classes compiladas, arquivos JAR, arquivos WAR e documentação Javadoc gerada. A janela Arquivos pode ser aberta ao escolher Janela > Arquivos (Ctrl-2 no Windows/Cmd-2 no Mac OS X).
Nota: se for necessário acessar os arquivos e diretórios que estejam fora dos diretórios do projeto, é possível utilizar a janela Favoritos. Para abrir a janela Favoritos, escolha Janela > Favoritos (Ctrl-3 no Windows/Cmd-3 no Mac OS X). É possível adicionar qualquer pasta ou arquivo à janela Favoritos clicando com o botão direito do mouse na janela Favoritos e escolhendo Adicionar aos favoritos.
Importando um projeto
Esta seção mostra como manipular a importação inicial de projetos para o IDE.
Importando um espaço de trabalho Eclipse
Para projetos Eclipse, é possível utilizar o assistente Importar projeto Eclipse para ajudá-lo a criar projetos NetBeans a partir de projetos em um espaço de trabalho Eclipse e para importar classpaths do projeto e outras configurações. Quando o assistente Importar projeto Eclipse é utilizado, não é necessário utilizar manualmente criar e configurar o projeto NetBeans. Abra o assistente selecionando Arquivo > Importar projeto > Projeto Eclipse. Consulte Importando projetos Eclipse no NetBeans IDE para obter informações sobre como funciona o assistente e como você pode trabalhar simultaneamente em projetos Eclipse e NetBeans.
Configurando um projeto Java com base em código-fonte existente
Para outros projetos Java desenvolvidos fora do NetBeans, é possível utilizar o modelo "Código-fonte existente" no assistente Novo projeto para criar um projeto NetBeans. No assistente, você identifica a localização do código-fonte e especifica a localização para os metadados do projeto NetBeans. Então a caixa de diálogo Propriedades do projeto é utilizada para configurar o projeto.
Para configurar um projeto NetBeans para um aplicativo Java existente:
- Escolha Arquivo > Novo projeto (Ctrl-Shift-N no Windows, Cmd-Shift-N no Mac OS X).
- Escolha Java > Projeto Java com código-fonte existente. Clique em Próximo.
- Na página Nome e localização do assistente, siga as etapas seguir:
- Digite um nome de projeto.
- (Opcional) Altere a localização da pasta do projeto.
- (Opcional) Altere o nome do script de construção utilizado pelo IDE. Isso pode ser desejável se já houver um script denominado como
build.xml que é utilizado para construir o código-fonte.
- (Opcional) Marque a caixa de verificação Utilizar pasta dedicada para armazenamento de bibliotecas e especifique o local da pasta de bibliotecas. Consulte Compartilhando bibliotecas do projeto para obter mais informações sobre esta opção.
- (Opcional) Marque a caixa de verificação Definir como projeto principal. Quando esta opção é selecionada, os atalhos de teclado para os comandos como Limpar e construir o projeto principal (Shift-F11) se aplicam à este projeto.
- Clique em Próximo para avançar para a página Códigos-fonte existentes do assistente.
- No painel Pasta de pacotes de código-fonte e clique em Adicionar pasta. A seguir, navegue para seu código-fonte, selecione as raízes do código-fonte e clique em Abrir.
Quando uma pasta contendo o código-fonte é adicionada, é necessário adicionar a pasta que contém a pasta mais alta em sua árvore do pacote. Por exemplo, para o pacote com.mycompany.myapp.ui, você adiciona a pasta que contém a pasta com.
- (Opcional) No painel Pastas de pacote de teste, clique em Adicionar pasta para selecionar a pasta contendo as pastas do pacote JUnit.
- Clique em Próximo para avançar para a página Inclusões e Exclusões do assistente.
- (Opcional) Na página Inclui e exclui do assistente, insira os padrões do nome do arquivo somente para os arquivos que deveriam ser incluídos ou excluídos do projeto. Todos os arquivos em suas raízes de código-fonte são incluídos por padrão.
- Clique em Terminar.
Configurando um projeto Web com base em código-fonte existente
Para projetos Web desenvolvidos fora do NetBeans, é possível utilizar o modelo "Código-fonte existente" no assistente Novo projeto para criar um projeto NetBeans. No assistente, você identifica a localização do código-fonte e especifica a localização para os metadados do projeto NetBeans. Então a caixa de diálogo Propriedades do projeto é utilizada para configurar o projeto.
Nota: se o projeto foi originalmente desenvolvido no Eclipse, é possível economizar tempo ao utilizar o assistente Importar projeto Eclipse ao invés do assistente Novo projeto. O assistente Importar projeto Eclipse permite importar simultaneamente múltiplos projetos, incluindo suas configurações. Consulte Importando projetos Eclipse no NetBeans IDE.
Para configurar um projeto NetBeans para um aplicativo Web existente:
- Escolha Arquivo > Novo projeto (Ctrl-Shift-N no Windows, Cmd-Shift-N no Mac OS X).
- Escolha Java Web > Aplicativo Web com código-fonte existente. Clique em Próximo.
- Na página Nome e localização do assistente, siga as etapas a seguir:
- No campo Localização, insira a pasta que contém as pastas raízes do código-fonte do aplicativo Web e as pastas da página Web.
- Digite um nome de projeto.
- (Opcional) Altere a localização da pasta do projeto.
- (Opcional) Marque a caixa de verificação Utilizar pasta dedicada para armazenamento de bibliotecas e especifique o local da pasta de bibliotecas. Consulte Compartilhando bibliotecas do projeto no NetBeans IDE para obter mais informações sobre essa opção.
- (Opcional) Marque a caixa de verificação Definir como projeto principal. Quando essa opção é selecionada, os atalhos de teclado para os comandos como Limpar e construir o projeto principal (Shift-F11) se aplicam à este projeto.
- Clique em Próximo para avançar para a página Servidor e configurações do assistente.
- (Opcional) Adicione o projeto em um aplicativo corporativo existente.
- Selecione um servidor no qual implantar. Se o servidor que você deseja não aparece, clique em Adicionar para registrar o servidor no IDE.
- Defina o nível do código-fonte para a versão Java na qual deseja que o aplicativo seja executado.
- (Opcional) Ajuste o caminho do contexto. O caminho do contexto tem base no nome do projeto por padrão.
- Clique em Próximo para avançar para a página Códigos-fonte existentes e bibliotecas do assistente.
- Verifique todos os campos na página, como os valores para a Pasta de páginas Web e Pastas do pacote do código-fonte.
- Clique em Terminar.
Projetos de forma livre
Também há modelos de projeto disponíveis para projetos de formato livre. Em projetos de formato livre, o IDE utiliza alvos em um script do Ant existente para construir, executar, limpar, testar e depurar o aplicativo. Se um script do Ant não contém alvos para algumas destas funções, as funções estão indisponíveis para o projeto. Para implementar essas funções, você escreve alvos em seu script do Ant ou em um script secundário do Ant.
Em geral, é melhor utilizar modelos padrão de projeto "com códigos-fonte existentes" para importar projetos. Para projetos Eclipse, é melhor utilizar o recurso Importar projeto, que cria e configura um projeto padrão por você. Os projetos padrão são mais fáceis de manter a longo prazo. No entanto, os modelos de projeto de formato livre são úteis se você possuir um projeto existente com base no Ant com uma configuração complexa ou idiossincrática, que não pode ser duplicado dentro de um projeto padrão. Por exemplo, se um projeto com múltiplas raízes de código-fonte estiver sendo importado, cada um tendo um classpath diferente e se não puder dividir as raízes de código-fonte em diferentes projetos, pode ser necessário utilizar um modelo de projeto de formato livre.
Este guia foca em projetos padrão. Para obter mais informações sobre como configurar projetos de formato livre, consulte Configuração avançada de projeto de formato livre.
Configurando o classpath e outras definições do projeto
Esta seção cobre as tarefas mais comuns para configurar um projeto, como a configuração do JDL alvo do projeto, a configuração do classpath, a criação de dependências entre projetos e o compartilhamento de bibliotecas entre projetos e usuários.
Definindo o projeto principal
Quando é desenvolvido um aplicativo grande que consiste em diversas pastas de código-fonte, é comum dividir o seu código em projetos separados. Normalmente, um destes projetos serve como o ponto de entrada para seu aplicativo. Para informar ao IDE qual projeto é o ponto de entrada principal do aplicativo, defina um projeto como o projeto principal. O IDE fornece comandos que agem no projeto principal. Por exemplo, a execução do comando Limpar e construir o projeto principal constroi o projeto principal e todos os seus projetos necessários.
Para definir um projeto como o projeto principal:
- clique com o botão direito do mouse no nó do projeto na janela Projetos e escolha Definir como o projeto principal.
Somente um projeto por vez pode ser o projeto principal.
Configurando o JDK de destino de um projeto
No IDE, é possível registrar várias plataformas Java e anexar Javadoc e código-fonte a cada plataforma. Alternar o JDK de destino de um projeto padrão faz o seguinte:
- Oferece as novas classes do JDK de destino para o autocompletar de código.
- Se disponível, exibe o código-fonte do JDK de destino e a documentação do Javadoc.
- Utiliza os executáveis do JDK de destino (
javac e java ) para compilar e executar a aplicação.
- Compila o código-fonte nas bibliotecas do JDK de destino.
O IDE utiliza a versão da plataforma Java SE (JDK), na qual o IDE é executado como a plataforma Java padrão para projetos IDE por padrão. Você pode visualizar a versão do JDK do IDE escolhendo Ajuda > Sobre. A versão do JDK é listada no campo Java.
Para executar o IDE com uma versão diferente do JDK:
Para registrar uma nova plataforma Java:
- Escolha Ferramentas > Plataformas Java no menu principal.
- Especifique a pasta que contém a plataforma Java, assim como o código-fonte e o Javadoc necessário para a depuração.
Para alternar o JDK de destino de um projeto padrão:
- Clique com o botão direito do mouse no nó do projeto e escolha Propriedades.
- Selecione o painel Bibliotecas.
- Altere a propriedade Plataforma Java.
Gerenciando o classpath do projeto
A adição de um grupo de arquivos de classe a um classpath de projeto informa o IDE das classes a que o projeto deve ter acesso durante a compilação e a execução. O IDE também utiliza configurações de classpath para ativar o autocompletar de código, o realce automático de erros de compilação e a refatoração. É possível editar todas as instruções do classpath de um projeto existente na caixa de diálogo Propriedades do projeto.
Em projetos padrão Java, o IDE mantém classpaths separados para compilar e executar seu projeto, assim como para compilar e executar testes JUnit (para aplicativos Java SE). O IDE adiciona automaticamente tudo no classpath de compilação do projeto ao classpath do tempo de execução do projeto.
É possível modificar o classpath do projeto de uma das formas a seguir:
- clique com o botão direito do mouse no nó do projeto, selecione a categoria Bibliotecas e modifique as entradas de classpath listadas.
- Clique com o botão direito do mouse no nó Bibliotecas na janela Projetos e escolha Adicionar projeto, Adicionar biblioteca ou Adicionar JAR/Pasta.
Se houver arquivos de Javadoc e arquivos de código-fonte anexados a um arquivo JAR no Gerenciador de bibliotecas, o IDE adicionará automaticamente os arquivos de Javadoc e os arquivos de código-fonte ao projeto quando o arquivo JAR for registrado em um classpath do projeto. É possível entrar nas classes e procurar as páginas de Javadoc das classes sem configurar nada mais.
Gerenciando dependências entre projetos
Se seu aplicativo consiste em múltiplos projetos, terá que configurar as dependências de classpath entre os projetos. Normalmente, você configura um projeto principal contendo a classe do projeto principal (em projetos Java SE) e diversos projetos necessários. Um projeto requerido é um projeto que foi adicionado a outro classpath de projeto. Toda vez que limpa e constrói um projeto, o IDE também limpa e constrói os projetos necessários. O projeto do Javadoc necessário e o código-fonte também são disponibilizados para o projeto recebedor.
É possível adicionar quaisquer projetos necessários para o projeto ao clicar com o botão direito do mouse no nó Bibliotecas ou adicioná-los ao especificá-los na aba Bibliotecas na caixa de diálogo Propriedades do projeto. Quando quiser adicionar um projeto necessário, selecione a pasta do projeto cujos arquivos JAR você deseja adicionar ao classpath (o seletor de arquivos exibe o ícone para as pastas do projeto IDE (
). Ao adicionar projetos na caixa de diálogo Propriedades do projeto, assegure que a caixa de verificação Construir projetos no classpath esteja marcada.
Se quiser adicionar um projeto de formato livre para o classpath de um projeto padrão, terá que adicionar o arquivo JAR do projeto de formato livre para o classpath do projeto padrão. Para fazer isso, é preciso primeiro declarar todos os arquivos de saída do projeto de formato livre no painel Saída da caixa de diálogo Propriedades do projeto do projeto de formato livre.
Compartilhando bibliotecas do projeto
Como o sistema do projeto NetBeans IDE possui base em Ant, os projetos do NetBeans já são geralmente transferíveis entre usuários diferentes, independentemente de eles utilizarem o IDE ou não. Entretanto, por padrão, a forma pela qual o script de construção do projeto se refere às bibliotecas depende de vários fatores específicos para cada usuário, particularmente no caso de bibliotecas definidas na caixa de diálogo Gerenciador de bibliotecas.
Por exemplo, normalmente é possível colocar um projeto em um arquivo zip e dar o mesmo para que outro usuário o desempacote e o execute. Mas se o projeto depende de uma biblioteca personalizada especificada na caixa de diálogo Gerenciador de bibliotecas, outros podem inicialmente ter problemas para construir o projeto por causa das referências não solucionadas para a biblioteca personalizada.
Outra inconveniência potencial é que as bibliotecas são armazenadas em uma variedade de locais, com base em sua origem. As bibliotecas que vêm com o IDE são armazenadas em várias pastas diferentes na instalação do IDE. Os exemplos disso incluem as bibliotecas das extensões de layout do Swing, vinculação de beans e drivers de banco de dados.
Para solucionar esses problemas, é possível especificar uma pasta dedicada para bibliotecas do projeto. Além disso, você decide entre utilizar um caminho relativo ou caminho absoluto ao se referir a essas bibliotecas.
Essa flexibilidade torna mais fácil manipular as situações a seguir:
- Ao criar um projeto é necessário torná-lo disponibilizável e construível para outros usuários, independentemente de eles utilizarem o IDE ou não. Eles precisam ser capazes de acessar o projeto através de um check-out de controle de versão ou descompactando um arquivo zip que você forneceu para eles. Eles devem ser capazes de construir o aplicativo sem configuração extra.
- Você deve começar trabalhando em um projeto existente e aderir a um conjunto estrito de convenções relacionadas ao lugar onde as bibliotecas do projeto são armazenadas (e se os seus scripts de construção os acessam com uma referência relativa ou referência absoluta).
É possível definir uma pasta de bibliotecas dedicadas para projetos padrão Java SE, Web e Corporativo. É possível definir a pasta de bibliotecas ao criar o projeto (no assistente para Novo projeto) ou depois na aba Bibliotecas da caixa de diálogo Propriedades do projeto.
Para tornar as bibliotecas gerais do projeto Java compartilháveis durante a criação do projeto:
- Selecione Arquivo > Novo projeto.
- Na categoria Java do assistente, selecione um dos modelos padrão. Em seguida, clique em Próximo.
- Na página Nome e localização do assistente, marque a caixa de verificação Utilizar pasta dedicada para armazenar bibliotecas.
- No campo Pasta de bibliotecas, selecione o local onde as bibliotecas serão armazenadas.
Se as bibliotecas já estiverem incluídas no IDE, elas serão copiadas para a pasta designada.
Para tornar as bibliotecas do projeto Java EE ou da Web compartilháveis durante a criação do projeto:
- Selecione Arquivo > Novo projeto.
- Na categoria Web do assistente, selecione um dos modelos padrão. Em seguida, clique em Próximo.
- Na página Nome e localização do assistente, marque a caixa de verificação Utilizar pasta dedicada para armazenar bibliotecas.
- No campo Pasta de bibliotecas, selecione o local onde as bibliotecas serão armazenadas.
Se as bibliotecas já estiverem incluídas no IDE, elas serão copiadas para a pasta designada.
Para tornar as bibliotecas de um projeto existente compartilháveis:
- clique com o botão direito do mouse no nó do projeto e escolha Propriedades.
- Na caixa de diálogo Propriedades do projeto, marque o nó Bibliotecas.
- No painel Bibliotecas, clique em Procurar para abrir o assistente pasta Novas bibliotecas.
- Na página Pasta biblioteca do assistente, insira uma localização para as bibliotecas e clique em Próximo.
É possível inserir a localização como uma referência relativa ou uma referência absoluta.
- No painel Ações do assistente, verifique a ação selecionada para cada biblioteca listada. Na maioria dos casos, o IDE detecta a ação mais apropriada para essa biblioteca.
As ações a seguir estão disponíveis:
- Copiar arquivos JAR da biblioteca para a pasta Novas bibliotecas. Utilize essa opção se a biblioteca não estiver na pasta que foi selecionada e se você desejar colocar os arquivos JAR aí.
- Utilizar caminho relativo para arquivos JAR da biblioteca. Utilize essa opção se a biblioteca não estiver na pasta de bibliotecas e for necessário acessar a biblioteca em sua localização existente utilizando um caminho relativo. Uma entrada com uma referência relativa é adicionada para a biblioteca no arquivo nblibraries.properties da pasta de bibliotecas.
- Utilizar o caminho absoluto para arquivos JAR da biblioteca. Utilize essa opção se a biblioteca não estiver na pasta de bibliotecas e você precisar acessar a biblioteca em sua localização existente utilizando um caminho absoluto. Uma entrada com uma referência absoluta é adicionada para a biblioteca no arquivo nblibraries.properties da pasta das bibliotecas.
- Utilizar biblioteca existente na pasta de bibliotecas. Utilize essa opção se já houver uma cópia da biblioteca na pasta de bibliotecas e desejar utilizar essa cópia da biblioteca.
- Clique em Terminar para sair do assistente Tornar projeto compartilhável.
- Clique em OK para sair da caixa de diálogo Propriedades do projeto.
Nota: também é possível utilizar o nó Bibliotecas da caixa de diálogo Propriedades do projeto para alterar a localização da pasta Bibliotecas. Caso você já tenha especificado uma pasta Bibliotecas, clicar em Procurar abre um seletor de arquivos em vez do assistente para pasta Nova biblioteca.
Tornando o Javadoc disponível no IDE
Para visualizar a documentação da API JavaSE no NetBeans IDE, utilize o comando Código-fonte > Exibir documentação ou escolha Janela > Outro > Javadoc no menu principal para visualizar a documentação da API em outra janela.
No entanto, em algumas bibliotecas de terceiros, a documentação da API não está disponível. Nesses casos, os recursos do Javadoc devem ser associados manualmente ao IDE.
Para tornar a documentação da API Javadoc disponível para o comando Mostrar Javadoc:
- baixe o código-fonte da documentação da API Javadoc.
- Escolha Ferramentas > Bibliotecas.
- Na lista Bibliotecas, selecione a biblioteca que seu projeto está utilizando.
- Clique na aba Javadoc.
- Clique no botão Adicionar ZIP/pasta e navegue até o arquivo zip ou a pasta que contém a documentação da API Javadoc em seu sistema. Selecione o arquivo zip ou a pasta e clique no botão Adicionar ZIP/pasta.
- Clique em OK.
Habilitando o Java Web Start para o aplicativo
É possível configurar seu aplicativo para ser executado através do Java Web Start no IDE. Para isso, utilize a categoria Java Web Start na janela Propriedades do projeto. Para obter informações detalhadas sobre como habilitar o Java Web Start, consulte o tutorial Habilitando o Java Web Start no NetBeans IDE.
Para configurar o Java Web Start para o aplicativo:
- clique com o botão direito do mouse no nó do projeto e escolha Propriedades.
- Na caixa de diálogo Propriedades do projeto, selecione o nó Aplicativo > Web Start.
- Marque a caixa de verificação Habilitar Enable Web Start e configure as definições do Java Web Start como explicado em Habilitando o Java Web Start no NetBeans IDE.
Construindo aplicativos
Esta seção explica como construir os projetos padrão no IDE, como efetuar personalizações básicas para o processo de construção e como tratar os erros de compilação.
Construindo projetos, pacotes e arquivos
A compilação no IDE é simples. Assumindo que seu classpath de compilação do projeto está corretamente definido, será necessário somente selecionar o projeto ou o arquivo que deseja compilar e escolher o comando Construir ou Compilar apropriado no menu Executar. O IDE então compila os arquivos.
Se o recurso Compilar ao salvar estiver habilitado para um projeto Java (ou o recurso Implantar ao salvar está habilitado para um projeto Java WEB ou corporativo), o IDE compila automaticamente os arquivos quando estes são salvos. Consulte Compilar ao salvar abaixo, para mais informações.
Para construir seu aplicativo para deployment:
Sempre que comandos de compilação são invocados, o IDE exibe a saída incluindo quaisquer erros de compilação encontrados na janela Saída, como descrito em Corrigindo erros de compilação abaixo.
Compilar ao salvar
O recurso Compilar ao salvar do IDE permite economizar tempo quando você estiver executando e depurando projetos no IDE. Quando o recurso Compilar ao salvar estiver habilitado para um projeto, os arquivos são compilados ao serem salvos. Os arquivos compilados são armazenados em um cache que o IDE utiliza quando o projeto no IDE é executado, testado, depurado e perfilado. Isso permite testar e depurar o aplicativo sem ter que esperar que o aplicativo seja construído primeiro.
Quando habilitado, o recurso Compilar ao salvar tem os seguintes efeitos:
- o IDE compila seus arquivos quando estes são salvos para que seu projeto sempre esteja pronto para ser executado ou depurado no IDE.
- O comando Construir é desabilitado. É necessário desabilitar o recursos Salvar ao compilar se você quiser reconstruir o arquivo JAR sem ter que utilizar o comando Limpar e construir.
- O script do Ant do projeto não é utilizado quando os comandos Executar, Depurar, Perfilar ou Testar são utilizados. Se o script de construção foi personalizado para quaisquer destes comandos, estas personalizações serão desconsideradas.
- O arquivo JAR que é construído a partir do projeto não é mantido atualizado quando você salva alterações em seus arquivos. Se desejar construir ou reconstruir o arquivo JAR, é preciso utilizar o comando Limpar e construir. O comando Limpar e construir sempre utiliza o script do Ant de seu projeto, mesmo se Compilar ao salvar está habilitado ou não.
Compilar ao salvar é habilitado por padrão para novos projetos que você cria. Para projetos existentes, Compilar ao salvar é desabilitado.
Para habilitar ou desabilitar Compilar ao salvar para um projeto Java:
- clique com o botão direito do mouse no nó do projeto e escolha Propriedades.
- Selecione o nó Compilando e defina a propriedade Compilar ao salvar.
De forma similar, o IDE tem um recurso Implantar ao salvar para os aplicativos Java Web e corporativo. Quando o recurso Implantar ao salvar é habilitado para um projeto, e um projeto foi implantado através do IDE, os arquivos alterados são reimplantados imediatamente no servidor. Para que Implantar ao salvar funcione no GlassFish V2, a instância Glassfish precisa ter a opção Deployment de diretório habilitado selecionado.
Para habilitar ou desabilitar Implantar ao salvar para um projeto Java Web ou corporativo:
- clique com o botão direito do mouse no nó do projeto e escolha Propriedades.
- Selecione o nó Executar e defina a propriedade Implantar ao salvar.
Para habilitar deployment do diretório Glassfish V2:
- Escolha Ferramentas > Servidores.
- Selecione o servidor.
- Selecione a aba Opções.
- Selecione opção Deployment de diretório habilitado.
Corrigindo erros de compilação
O IDE exibe mensagens de saída e quaisquer erros de compilação na janela Saída. Essa janela com múltiplas abas é exibida automaticamente quando você encontra erros de compilação, depura o programa, gera documentação Javadoc, e assim por diante. Também é possível abrir manualmente essa janela escolhendo Janela > Saída (Ctrl-4 no Windows/Cmd-4 no Mac OS X).
Além disso, os erros de compilação são mostrados na janela Tarefas e marcados no Editor de código-fonte.
Uma função importante da janela Saída é notificar erros encontrados enquanto compila o programa. A mensagem de erro é exibida em texto sublinhado azul e está vinculada à linha no código-fonte que causou o erro, como ilustrado na imagem abaixo. A janela Saída também fornece links para erros encontrados ao executar scripts de construção do Ant. Sempre que você clica em um link de erro na janela Saída, o Editor do código-fonte salta automaticamente para a linha que contém o erro.
Cada ação realizada por um script Ant, como compilar, executar e depurar arquivos, envia a saída para a mesma aba da janela Saída. Se for necessário salvar as mensagens exibidas na janela Saída, é possível copiar e colar as mensagens em um arquivo separado. Também é possível definir que o Ant imprima a saída do comando para cada novo destino em uma nova aba da janela Saída ao escolher Ferramentas > Opções, selecionando a categoria Miscelâneos, clicando na aba Ant e desmarcando a caixa de verificação para Reutilizar abas de saída da propriedade Processos concluídos.
Filtrando arquivos de saída
Ao criar um arquivo JAR ou WAR, normalmente é desejado incluir apenas os arquivos .class compilados e quaisquer outros arquivos de recursos localizados no diretório de código-fonte, como pacotes de recursos ou documentos XML. O filtro padrão faz isso ao excluir todos os arquivos .java, .nbattrs e .form de seu arquivo de saída.
É possível criar filtros adicionais utilizando expressões regulares para controlar os arquivos de saída. Para especificar quais arquivos devem ser excluídos, clique com o botão direito do mouse em seu projeto na janela Projetos e escolha Propriedades para abrir a caixa de diálogo Propriedades do projeto. No painel esquerdo clique em Empacotamento. No painel direito, insira expressões regulares na caixa de texto para especificar os arquivos a serem excluídos ao empacotar os arquivos JAR ou WAR. Além das expressões padrão, aqui estão algumas expressões regulares adicionais que podem ser utilizadas:
\.html$ |
Exclui todos os arquivos HTML |
\.java$ |
Exclui todos os arquivos Java |
(\.html$)|(\.java$) |
Exclui todos os arquivos HTML e Java |
(Key)|(\.gif$) |
Exclui todos os arquivos GIF e quaisquer arquivos com Key em seu nome |
Para obter um guia para a sintaxe de expressões regulares consulte jakarta.apache.org.
Executando aplicativos
Esta seção mostra como executar projetos no IDE e como configurar a classe principal do projeto, os argumentos de tempo de execução, os argumentos VM e o diretório de trabalho.
Executando projetos e arquivos
Para projetos Java, você normalmente define o projeto que contém a classe principal do programa como o projeto principal. Para projetos Web, o projeto principal é o projeto que foi implantado primeiro. Para executar um projeto, pacote ou arquivo, escolha um dos seguintes:
- No menu principal, escolha Executar > Executar projeto principal (F6) para executar o projeto principal. Alternativamente, é possível utilizar o botão Executar o projeto principal na barra de ferramentas.
- Na janela Projetos, clique com o botão direito do mouse no projeto e escolha Executar para executar um projeto. Observe que para projetos Java, o projeto precisa ter uma classe principal.
- Na janela Projetos, clique com o botão direito do mouse no arquivo e escolha Executar o arquivo (F6) para executar um arquivo. Alternativamente, escolha Executar > Executar o arquivo > Executar nome do arquivo (Shift+F6) no menu principal para executar uma classe executável.
Ao executar o projeto, o IDE exibe quaisquer erros de compilação e a saída na janela Saída. Para saber mais, consulte Corrigindo erros de compilação.
Nota: se Compilar ao salvar estiver habilitado para um projeto, o comando Executar o projeto opera em arquivos de classe que foram criados quando estes arquivos foram salvos. O script do Ant não é utilizado. Se etapas personalizadas foram definidas no script de construção, estas etapas não são seguidas. Se desejar que o processo de construção completo ocorra ao utilizar Executar o projeto, Depurar o projeto e Perfilar o projeto, desabilite Compilar ao salvar.
Personalizando as opções de tempo de execução
Como padrão, o IDE não especifica uma classe principal, argumentos do tempo de execução ou argumentos JVM. O classpath do tempo de execução de cada projeto padrão contém as classes compiladas do projeto e tudo o que houver no classpath de compilação do projeto. É possível visualizar o classpath de compilação do projeto ao abrir a caixa de diálogo Propriedades do projeto, selecionar o nó Bibliotecas no painel Categorias e, em seguida, clicar na aba Compilar no painel direito.
Para alterar as opções do tempo de execução, abra a caixa de diálogo Propriedades do projeto ao clicar com o botão direito do mouse no nó do projeto na janela Projetos e escolher Propriedades. Em seguida, selecione o nó Bibliotecas no painel Categorias e clique na aba Executar no painel direito da caixa de diálogo. Note que para acessar as configurações para a classe principal, argumentos do programa, diretório de trabalho para a execução do programa e as opções VM, é preciso selecionar o nó Executar. Na próxima seção, iremos examinar mais de perto sobre como configurar o classpath de tempo de execução.
Definindo o classpath de tempo de execução
Para adicionar projetos, bibliotecas, arquivos JAR e pastas para o classpath de tempo de execução, utilize os botões no lado direito da lista Bibliotecas de tempo de execução na caixa de diálogo Propriedades do projeto.
Se o projeto utilizar dinamicamente bibliotecas especiais no tempo de execução através de uma interface indireta ou reflexão (como drivers JDBC ou implementações JAXP), será necessário adicionar essas bibliotecas ao classpath de tempo de execução. Também será necessário ajustar o classpath de tempo de execução se as dependências de tempo de execução entre os projetos não corresponderem às dependências de compilação dos projetos. Por exemplo, imagine que o projeto A é compilado no projeto B e o projeto B é compilado no projeto C, mas o projeto A não é compilado no projeto C. Isso significa que o projeto A possui somente o projeto B no classpath de tempo de execução. Se o projeto A necessitar do projeto B e do projeto C durante a execução, será preciso adicionar o projeto C ao classpath de tempo de execução do projeto A.
Definindo a classe principal e os argumentos de tempo de execução
Para definir a classe principal do projeto, selecione o nó Executar no painel Categorias da caixa de diálogo Propriedades do projeto e digite um nome completamente qualificado no campo Classe principal (por exemplo, org.myCompany.myLib.MyLibClass). A classe principal precisa existir no projeto ou em um dos arquivos ou bibliotecas JAR no classpath de tempo de execução do projeto. Após isso, digite quaisquer argumentos de tempo de execução necessários no campo Argumento.
Se você utiliza o botão Procurar para escolher a classe principal do projeto, o seletor de arquivos só mostrará classes no diretório de código-fonte do projeto. Se desejar especificar uma classe em uma das bibliotecas no classpath, precisará digitar o nome totalmente qualificado da classe no campo Classe principal.
Definindo os argumentos JVM
É possível especificar os argumentos JVM para o projeto na caixa de diálogo Propriedades do projeto. Abra a caixa de diálogo Propriedades do projeto, clique em Executar no painel Categorias e, em seguida, digite uma lista de argumentos JVM separada por espaço no campo Opções VM.
É possível definir as propriedades do sistema digitando o seguinte no campo Opções da VM:
-Dname=value
Personalizando o script de construção
Em projetos padrão o IDE gera o script de construção com base nas opções inseridas no assistente Novo projeto e na caixa de diálogo Propriedades do projeto. É possível definir todas as opções básicas de compilação e tempo de execução na caixa de diálogo Propriedades do projeto do projeto e o IDE atualiza automaticamente o script do Ant do projeto. Se você possuir requisitos adicionais para o processo de construção, que não podem ser manipulados na caixa de diálogo Propriedades do projeto, poderá modificar diretamente o script de construção.
O script principal do Ant para projetos padrão é o build.xml. O IDE chama os destinos em build.xml sempre que os comandos do IDE são executados. Esse arquivo possui uma instrução de importação que importa o nbproject/build-impl.xml, que contém destinos de construção que são gerados pelo IDE. No build.xml, é possível sobrepor qualquer destino de nbprojetc/build-impl.xml ou gravar novos destinos. Não edite diretamente o nbproject/build-impl.xml, porque aquele arquivo é gerado novamente com base nas alterações feitas na caixa de diálogo Propriedades do projeto.
Além disso, o script de construção utiliza o nbproject/project.properties que pode ser manualmente editado.
Com projetos padrão, é possível personalizar o processo de construção adotando um dos procedimentos a seguir:
- inserindo opções básicas, como as configurações do classpath e filtros JAR no assistente Novo projeto quando você cria um projeto ou posteriormente na caixa de diálogo Propriedades do projeto.
- Editando propriedades no
nbproject/project.properties. Esse arquivo armazena propriedades do Ant com informações importantes sobre seu projeto, como a localização de seu código-fonte e as pastas de saída. É possível substituir as propriedades nesse arquivo. Tenha cuidado ao editar este arquivo. Por exemplo, a pasta de saída é excluída sempre que você limpa seu projeto. Portanto, nunca defina a pasta de saída para o mesmo local da pasta de código-fonte sem primeiro configurar o destino limpo para não excluir a pasta de saída.
- Personalizar alvos Ant existentes ou criar novos ao executar quaisquer um dos seguintes:
- adicione instruções a serem processadas antes ou depois de um alvo do Ant ser executado. Cada um dos destinos principais no
nbproject/build-impl.xml também possui um destino -pre e -post que você sobrepõe no build.xml. Por exemplo, para que o RMI funcione com projetos regulares, digite o seguinte no build.xml:
<target name="-post-compile">
<rmic base="${build.classes.dir}" includes="**/Remote*.class"/>
</target>
- Altere as instruções em um destino do Ant. Copie o destino de
nbproject/build-impl.xml para o build.xml e faça quaisquer alterações no destino.
- Crie novos destinos no
build.xml. Também é possível adicionar o novo destino nas dependências dos destinos existentes do IDE. Substitua o destino existente em build.xml e, em seguida, adicione o novo destino na propriedade depends do destino existente. Por exemplo, a instrução a seguir adiciona o destino new-target nas dependências do destino de execução:
<target name="new-target">
<!-- target body... -->
</new-target>
<target name="run" depends="new-target,myprojname-impl.run"/>
Não é preciso copiar o corpo do destino de execução no build.xml.
A tabela a seguir lista algumas tarefas comuns que você pode considerar útil para redefinir um arquivo JAR:
| Especifique quais arquivos são adicionados ao arquivo JAR. |
Clique com o botão direito do mouse no nó do projeto na janela Projetos e escolha Propriedades. Clique no subnó Empacotamento (em Construção) e configure as definições do filtro e compressão utilizando o campo Excluir do arquivo JAR. Para mais informações, consulte Filtrando os arquivos de saída |
| Altere o nome e a localização do arquivo JAR. |
Na janela Arquivos, clique duas vezes no arquivo nbproject/project.properties do projeto no Editor de código-fonte. Insira o caminho completo para o arquivo JAR na propriedade dist.jar .
|
| Especifique o arquivo manifesto para o arquivo JAR. |
Em project.properties, digite o nome do arquivo manifesto na propriedade manifest.file. O nome do arquivo deve ser especificado em relação ao arquivo build.xml do projeto. Note que se você estiver utilizando o modelo de aplicativo Java, o IDE cria um arquivo manifest.
|
| Desabilite a geração de um arquivo JAR para um projeto. |
Na janela Arquivos, abra a pasta do projeto e, em seguida, abra build.xml. Substitua o destino jar para ter conteúdo e não dependências. Por exemplo, adicione o seguinte a build.xml:
<target name="jar" />
|
Se você estiver procurando por recursos de aprendizado do Ant, visite http://ant.apache.org/resources.html. Também é possível instalar o manual do Ant no sistema de ajuda do IDE ao utilizar o Gerenciador de plug-in. Escolha Ferramentas > Plug-ins e instale o módulo Documentação do Ant.
Editando e executando scripts do Ant
O IDE reconhece automaticamente os scripts do Ant e os exibe como nós do Ant (
) em vez de arquivos XML normais. Para acessar um menu suspenso de comandos é possível clicar com o botão direito do mouse nos scripts do Ant na janela Projetos, janela Arquivos ou na janela Favoritos. Também é possível expandir o nó do script do Ant para visualizar uma lista alfabética de subnós representando os alvos do script do Ant. Cada um desses subnós também possuem um menu suspenso de comandos.
Nas janelas Projetos, Arquivos e Favoritos, os subnós do script do Ant são marcados nas seguintes formas:
|
Alvo enfatizado do Ant. Estes alvos incluem um atributo de descrição, que é exibido como uma dica de ferramenta. Você define o atributo de descrição do alvo no Editor de código-fonte.
|
|
Alvo normal do Ant. Um alvo sem um atributo de descrição.
|
Clique duas vezes nos subnós do script do Ant para ir direto para o local do alvo no Editor de código-fonte. Todas as ferramentas normais de pesquisa XML, ferramentas de seleção e atalhos de teclado estão disponíveis para editar scripts do Ant e o IDE fornece o autocompletar de código para todas as tarefas padrão do Ant.
Ao criar um alvo que deseja executar a partir da linha de comando, forneça um atributo de descrição para o alvo. Então, se você se esquecer dos nomes dos alvos ou o que eles fazem, poderá executar o comando -projecthelp <script> do Ant na linha de comando. Com este comando, o Ant lista somente os alvos que tenham um atributo de descrição, junto com suas descrições. Especialmente quando há muitos alvos em seu script de construção do Ant, enfatizar alguns e não enfatizar outros pode ser uma forma útil de distinguir entre os que são muito utilizados e os que são utilizados com menor frequência.
O estilo da fonte do rótulo do subnó nas janelas Projetos, Arquivos e Favoritos indicam o seguinte:
- Normal. Um alvo que é definido dentro do script do Ant atual.
- Itálico. Um alvo que é importado de outro script do Ant.
- Acinzentado. Um alvo interno que não pode ser diretamente executado. Os alvos internos possuem nomes começando por '-'.
- Negrito. O alvo padrão para o script, caso haja algum. O alvo padrão é declarado como um atributo para o projeto, junto com outros atributos do projeto, como seu nome. Você define o atributo padrão do projeto no Editor de código-fonte.
Os alvos que são importados de outro script mas que são sobrescritos no script de importação não são listados. Somente o alvo sobescrito é listado.
É possível executar alvos em um script do Ant a partir do nó do script do Ant na janela Projetos, Arquivos ou Favoritos. Para fazer isso, clique com o botão direito do mouse no nó do script do Ant e escolha um alvo a partir do submenu Executar alvo. Os alvos são ordenados alfabeticamente. Somente os alvos enfatizados são listados. Escolha Outros alvos para executar um alvo que não foi enfatizado com um atributo de descrição. Os alvos internos são excluídos dessas listas porque eles não podem ser executados independentemente.
Em vez de executar um alvo utilizando o menu suspenso do nó do script do Ant, basta clicar com o botão direito do mouse no nó do alvo e escolher Executar alvo.
Escrevendo tarefas personalizadas do Ant
É possível utilizar tarefas personalizadas do Ant para expandir a funcionalidade fornecida por tarefas embutidas do Ant. As tarefas personalizadas são utilizadas com frequência para definir propriedades, para criar elementos aninhados ou para escrever texto diretamente entre marcadores utilizando o método addText.
Para criar uma tarefa personalizada do Ant no IDE:
- Clique com o botão direito do mouse no pacote onde gostaria de colocar a tarefa e escolha Novo > Outro.
- Selecione a categoria Outro e o tipo de arquivo da tarefa personalizada do Ant.
- Conclua o assistente.
Quando você cria o arquivo da tarefa personalizada do Ant, o modelo é aberto no Editor de código-fonte. O modelo contém código de amostra para muitas das operações comuns executadas por tarefas do Ant. Após cada seção do código, o modelo também mostra como utilizar a tarefa em um script do Ant.
