Arquivo(s) de agosto 4, 2008

Eclipse - Code Templates

O Eclipse tem umas opções bem interessantes para personalizar seu ambiente da maneira que você desejar, uma delas é o Code Template, Formatter e Save Actions.

Cada desenvolvedor tem seu gosto por indentação, ou cada projeto segue um padrão para indentar o código, padrão de comentários etc. Com essas configurações fica tudo mais simples e pode ser reutilizável.

Vou mostrar aqui o caminho das pedras para configurar de maneira simples e rápida.
Primeiro vamos criar o Code Template para personalizar os comentários.

As vezes você deseja colocar mais informações do JavaDoc da sua aplicação, como nome do projeto, seu nome, data etc. Para não ter que sempre ficar repetindo(copiando e colando) o mesmo texto, basta se utilizar do Code Templates.

Vá em Windows –> Preferences –> Java –> Code Style –> Code Templates.

Selecione uma tag e clique em editar. Aqui você poderá colocar o texto que você quiser, na próxima vez que for utilizar ele irá colocar todo o texto que você criou e definiu automaticamente.

Tem também a opção Insert Variable que você poderá inserir uma variável que irá pegar os dados automaticamente e servirá para outros projetos, vou selecionar o ${projetc_name} que vai pegar o nome do meu projeto e inserir em todos os métodos que eu for utilizar esse comentário.

Neste exemplo fiz somente para o Methods, mas você poderá fazer para todos se desejar.
Vamos ver como utilizar.

Acima do método digite “/**” e dê um ENTER.



Observe que ele colocou o nome do meu projeto no comentário, e foi simples e rápido. Você poderá inserir várias outras tags.



Vou descrever aqui algumas:

Variável Descrição
date insere a data completa no Java doc
dollar insere um símbolo $
enclosing_method insere o nome do método
enclosing_type insere o nome da classe ou tipo do objeto que a classe representa
file_name insere o nome do arquivo.java
package_name insere o nome do pacote em que a classe se encontra
todo insere um TODO no método
user insere o nome do usuário no método
year insere o ano no método

Vamos ver agora como reutilizar esse Code Template.

Depois de ter personalizado tudo, vá em Windows –> Preferences –> Java –> Code Style –> Code Templates –> Export –> e salve seu XML.
Para reutilizar basta ir em Import e selecionar seu arquivo.

Uma dica, para não ter que fazer todo esse caminho manualmente, quando você abrir a tela de preferences clique em type filter text que se localiza no canto superior esquerdo da janela de preferences e digite o que você quer abrir, por exemplo: Code template. O eclipse já vai mostrando todas as opções que tem esse texto, simples não ? ?

Na próxima falaremos sobre o Formatter(Ctrl+Shift + F) e como otimizar esse processo com o Save Action.

Abraços