Edição de código-fonte no NetBeans IDE 6.0
Este guia demonstra o processo de criar e editar arquivos-fonte Java usando o novo e aprimorado Editor do NetBeans IDE 6.0.
Conteúdo
Observação: clique no botão Seta no centro de cada vídeo para iniciar a reprodução. Cada vídeo contém texto na tela identificando procedimentos e conceitos importantes que pausam automaticamente a reprodução. Para continuar a reprodução dos vídeos, simplesmente clique no texto exibido na tela ou use o controlador abaixo do vídeo.
Software necessário para o tutorial
Antes de começar, você deve baixar ou instalar o seguinte software no seu computador:
- NetBeans IDE 6.0 (download)
- Java Standard Development Kit (JDK), versão 5.0 ou 6.0 (download)
Usando auto-completar de código e geração de código
Nesta seção, analisaremos os novos recursos do editor Java que
permite que você seja mais produtivo ao escrever o código. Esses recursos
incluem geração de código usando Auto-completar de código e a caixa diálogo
Geração de código, mantendo instruções de importação, assim como usando
ferramentas avançadas para manipular linhas e blocos de código selecionados.
Gerando código usando auto-completar de código
Em linhas gerais, Auto-completar de código é útil para preencher itens de código faltando, tais como símbolos e palavras-chave, automaticamente. A partir do NetBeans IDE 6.0
agora você pode usar Auto-completar de código para gerar métodos inteiros. Isso é
útil se você quiser, por exemplo, gerar um construtor, substituir
métodos ou implementar métodos. Mais adiante no tutorial, analisaremos outros novos recursos interessantes
de Auto-completador de código do NetBeans 6.0, tal como gerar
construtores arbitrários usando a caixa de diálogo Geração de código.
A primeira coisa que iremos analisar é a escritura de um JavaBean representando
uma mensagem de email. O esqueleto do bean contendo campos privados necessários para armazenar os
dados já foi preparado para nós, sendo assim, precisamos agora criar
um construtor razoável para ele, como mostrado no procedimento e
na demonstração seguinte.
Para gerar um construtor usando auto-completar de código:
- Coloque o cursor na localização do arquivo em que você deseja
gerar o construtor e pressione Ctrl+Espaço.
- Na janela Auto-completar de código que aparece, selecione o
construtor que inicializará seus campos
(
Mail(String subject, String body) - gerar,
nesse caso). Observe que o IDE lhe dá a opção de gerar o construtor padrão
ou um construtor que inicializará todos os campos não-inicializados.
- Pressione Enter.
O IDE implementa o construtor selecionado na localização especificada.
Observe que o IDE também oferece a possibilidade de substituir ou
implementar métodos de superclasses e
superinterfaces.
Gerando um construtor com auto-completar de código
Gerando código usando as caixas de diálogo Geração de código
O editor Java do IDE é capaz de gerar construções que você
em geral usa automaticamente. Nesta seção,
analisaremos o procedimento.
A próxima coisa que desejamos fazer é gerar o Getter e o Setter
dos campos e verificar se podemos usar a classe nas coleções,
o que requer métodos equals() e hashCode(). O editor Java do IDE é capaz de gerar as construções que você em geral usa automaticamente. Observe que conforme percorremos o procedimento de exemplo
a caixa de diálogo Geração de código do IDE também permite que você faça
muito mais, incluindo a criação de métodos de delegação, a geração de
construtores para inicializar conjuntos arbitrários de campos, etc.
Para gerar getters e setters:
- Pressione Alt+Insert para chamar o menu de geração de código.
- Selecione o elemento que você deseja gerar na lista de itens exibidos (
Getter e Setter..., nesse caso).
- Na caixa de diálogo que aparece, selecione o campo para o qual você deseja
gerar getters e setters, e clique em OK.
O IDE gera o código de getters e setters
automaticamente.
A próxima coisa que precisamos fazer é gerar Equals e Hashcode
usando Alt-Insert.
Para gerar equals e hashcode:
- Pressione Alt+Insert para chamar o menu de geração de código.
- Selecione o elemento que você deseja gerar na lista de itens
exibidos (
equals() e hashCode()...
nesse caso).
- Na caixa de diálogo que aparece, selecione os campos no qual você deseja basear seus métodos equals e hashCode, e clique em OK.
O IDE gera os métodos equals e hashcode necessários.
Gerando Getters, Setters, Equals e Hashcode
Gerenciando a seção Importação
O editor Java do IDE oferece várias formas de adicionar instruções de importação de uma ou mais classes, cada uma oferecendo-lhe uma lista de classes possíveis a serem importadas quando você clica na marca de erro em forma de lâmpada ou pressiona as combinações de teclas apropriadas. Além disso, o editor também exibe dicas de erro que ajudam você a remover importações que não são necessárias em seu código-fonte.
Depois de fazer as alterações necessárias em nosso arquivo na seção anterior, você deve ter percebido que a Faixa de erros do IDE exibiu um aviso na margem direita do editor, indicando que existe uma importação não usada em nosso arquivo. Para corrigir isso, usaremos o novo e útil comando Remover importações não utilizadas do
IDE para que possamos ver como ele funciona.
Para remover importações não usadas:
- Coloque o cursor na linha da classe que não foi
importada e pressione Alt+Enter. Como alternativa, você pode clicar na marca de aviso
na Faixa de anotações (ao longo da borda esquerda do Editor).
- Escolha Remover importação não usada no menu pop-up. Observe que você pode
remover uma ou todas as importações não usadas da seção de importação.
O IDE remove as instruções de importação não usadas
do arquivo.
O editor Java do IDE também oferece alguns outros métodos para gerenciar
importações, tais como pressionar Ctrl-Shift-I para importar vários tipos
de uma vez e pressionar Alt-Shift-I enquanto o cursor está posicionado em um
identificador de tipos, que permite que você importe esse tipo específico.
A faixa de erros e removendo importações não usadas
Usando as ferramentas de linha do editor
Aqui queremos criar dois campos estáticos privados do tipo string
para nosso nome de usuário e senha. Usando o recurso Ferramentas de linha do editor,
podemos duplicar rapidamente a linha em que o cursor está posicionado
e copiar/colar ou movê-lo para uma nova linha imediatamente abaixo da
primeira. Esse recurso é particularmente útil quando se duplica repetidamente ou se move linhas nas quais a maior parte do código é a mesma e somente partes isoladas precisam ser ajustadas, tal como durante a inicialização de uma matriz, por exemplo. Depois de fazer isso, você pode editar os valores do campo, se necessário.
Para duplicar a linha atual ou várias linhas selecionadas:
- Posicione o cursor na linha ou seleção que você deseja duplicar.
- Pressione e mantenha pressionadas as teclas Ctrl-Shift, em seguida, pressione a tecla do cursor Para cima ou Para baixo para copiar e colar o código acima ou abaixo da linha original.
O IDE duplica a linha designada ou seleção
na localização desejada.
Para mover a linha atual ou várias linhas selecionadas:
- Posicione o cursor na linha ou seleção que você deseja mover.
- Pressione e mantenha pressionadas as teclas Alt-Shift, em seguida, pressione as teclas do cursor Para cima ou Para baixo para mover a linha atual ou seleção acima ou abaixo da linha original.
O IDE move a linha designada ou seleção
na localização desejada.
Duplicando e movendo linhas únicas ou várias linhas selecionadas
Auto-completar de código inteligente e modelos ao vivo
Nesta seção, nos moveremos para o arquivo Main.java do nosso projeto para que possamos escrever o código que irá, como um exemplo, verificar novos emails no servidor enquanto analisamos alguns outros recursos comuns que abordamos na primeira parte do tutorial.
Para ilustrar ainda mais o processo simples de uso do novo recurso Auto-completar de código do editor, primeiro precisamos inicializar nossa IU. Usando auto-completar de código podemos fazer isso rapidamente. Também precisamos colocar o valor das preferências em uma string.
O editor do NetBeans IDE 6.0 em ação
Nas próximas etapas, adicionaremos uma classe que nos permitirá acessar o arquivo Main.java do banco de dados. Enquanto realizamos isso,
analisaremos um pouco mais dos recursos úteis do editor.
Auto-completar de código inteligente
Nesta seção, usaremos Auto-completar de código inteligente para adicionar rapidamente um corpo de método ao nosso arquivo.
Talvez você tenha percebido que a caixa de listagem de conclusão padrão é dividida em duas partes separadas por uma linha preta. A primeira seção inclui itens de auto-completar inteligente. Para determinar a lista desses itens, auto-completar usa o contexto atual (ou seja, a posição do cursor) quando a conclusão é chamada.
Veja outros marcadores iniciando com inteligente para obter mais informações e exemplos do recurso auto-completar de código inteligente.
Para adicionar um método usando Auto-completar de código inteligente:
- Coloque o cursor na localização do arquivo em que você deseja gerar o construtor e pressione Ctrl+Espaço.
- Se você não encontrar o símbolo apropriado, pressione Ctrl+Espaço uma
segunda vez para exibir todos os símbolos do classpath do projeto,
independentemente de serem importados ou não.
- Na janela Auto-completar de código que aparece, selecione o item
apropriado (
Mail(String subject, String body) - gerar,
nesse caso) e pressione Enter.
O IDE implementa o construtor selecionado na
localização especificada.
Auto-completar de código inteligente
Modelos ao vivo
O recurso Modelos ao vivo do IDE permite que você indique trechos de código inteiros, simplesmente digitando as primeiras letras do identificador do modelo. Nesta seção, usaremos Modelos ao vivo para adicionar um
For Loop que itera através da lista de emails armazenados no servidor.
Para adicionar um iterados usando um modelo ao vivo:
- Digite as primeiras letras do nome do modelo e chame auto-completar de código, pressionando Ctrl+Espaço.
- Escolha o modelo apropriado. Se houver uma coleção adequada,
ela será preenchida para você com as partes editáveis
do modelo renderizado em azul.
- Pressione Tab para circular entre os campos editáveis azuis e atualizar o código do modelo, se necessário.
- Pressione Enter ou Esc para terminar de editar o modelo.
O IDE adiciona o código do modelo ao arquivo na posição do cursor.
Observação: o modo Editar modelo é mantido até que você faça uma edição fora das caixas azuis (mesmo que você mova o cursor para fora das caixas editáveis azuis). Se isso ocorrer, use a tecla Tab para
retornar ao modelo.
Realce de código
Os realces do editor Java são um recurso fácil de usar que você pode considerar como uma alternativa aprimorada para a pesquisa do editor. Com base na posição atual do cursor, o realce de código renderiza todos os elementos semelhantes no arquivo com uma cor de segundo plano, para que você possa ver rapidamente onde eles se encontram. Além disso, os realces também são mostrados na faixa de erros, apresentando uma visão geral conveniente do arquivo inteiro.
Observe que o IDE exibe um erro na Faixa de anotações, informando-nos que o método de conexão lança uma IOException que ainda não foi detectada e que precisamos detectá-la ou adicioná-la na cláusula de lançamentos do método de fechamento, o que pode ser feito por meio de uma dica que depois pressiona Alt-Enter. Sempre que você colocar o cursor em uma exceção,
o editor realça todas as instruções que lançam a
exceção. Se você colocar o cursor em um tipo de retorno de um método,
todos os pontos de saída do método serão realçados. Se você colocar o cursor
em um elemento como um campo, por exemplo, todos os usos do
campo no arquivo são realçados para fácil identificação e navegação eficaz. Observe também que o editor coloca um marcador na Faixa de erros, indicando a localização do uso no código-fonte.
Para realçar todas as instruções que lançam uma exceção:
- Coloque o cursor em uma exceção em uma cláusula de lançamentos
da declaração do método.
O IDE realça todos os lugares em que essa exceção
pode ser lançada.
Se você colocar o cursor no tipo de retorno da definição do método,
o editor realçará todos os pontos de saída do método (todas as
expressões que lançam a exceção em cada local em que elas são retornadas).
Para realçar os pontos de saída do método:
- Coloque o cursor no tipo de retorno da definição do método.
O editor realça todas as expressões que lançam
a exceção em cada local em que elas são retornadas. Observe que nesse caso,
o colchete de fechamento é realçado porque a execução
pode percorrer até o fim do método.
Variações do realce de código
Renomeação instantânea
Se quiser renomear um membro privado (campo, método, variável,
etc.), você geralmente tem algumas opções. Primeiro, você poderia usar Localizar e substituir, mas poderia terminar substituindo algo que não quisesse caso não fosse cuidadoso. Segundo, você poderia usar o comando Renomear refatoração, entretanto, isso seria um pouco pesado na maioria dos cenários. A terceira opção, e a que vamos analisar nesta seção, seria para
usar o novo recurso Renomeação instantânea do editor, que
pode ser usado simplesmente colocando o cursor no
identificador e pressionando Ctrl+R.
Para renomear instantaneamente:
- Coloque o cursor no identificador e pressione Ctrl+R. O IDE realça todas as ocorrências do identificador em azul para indicar que o modo Renomeação instantânea está ativo.
- Edite o identificador, se necessário, para alterar todas as ocorrências do membro.
- Pressione Enter ou Esc para terminar de editar o identificador e saia do modo Renomeação instantânea.
O IDE atualiza todas as ocorrências do membro no arquivo.
Renomeando instantaneamente um membro
superior
Próximas etapas
superior
