ndice

ndice ________________________________________________________ 2
Download do Eclipse _____________________________________________ 3
Instalao do Eclipse ____________________________________________ 4
Primeira execuo do Eclipse ______________________________________ 5
Instalao de plugins ____________________________________________ 6
Criao de projeto ______________________________________________ 7
Criao de um pacote ___________________________________________ 11
Criao de uma classe. __________________________________________ 12
Execuo de uma aplicao Java dentro do Eclipse____________________ 14
Javadoc no code completion______________________________________ 17
Debug _______________________________________________________ 20
Export _______________________________________________________ 23
Importando biblioteca___________________________________________ 26
Criando e executando teste JUnit __________________________________ 29
Executando um Ant build ________________________________________ 34
Utilizando o CVS _______________________________________________ 36
Dicas de configuraes personalizadas e outras funcionalidades _________ 46

Peter P. Lupo
Cristina T. Cerdeiral

Pgina 2 de 48

Download do Eclipse
O Eclipse pode ser baixado em: http://download.eclipse.org/
Atualmente, a ltima verso estvel do Eclipse a 3.1.2 e pode ser
encontrada
em:
http://download.eclipse.org/eclipse/downloads/drops/R3.1.2-200601181600/index.php
Nota: Para desenvolvimento JEE, recomenda-se o download do Web Tools Project (WTP):
http://download.eclipse.org/webtools/downloads/
recomendado, neste caso, o download do Eclipse j com WTP integrado (chamada all-in-one).
Atualmente, a verso mais nova do Eclipse com WTP a 1.01:
http://download.eclipse.org/webtools/downloads/drops/R-1.0.1-200602171228/
O Eclipse tem cerca de 100Mb e com o WTP passa a ter cerca de 180Mb.

Peter P. Lupo
Cristina T. Cerdeiral

Pgina 3 de 48

Instalao do Eclipse
O Eclipse distribudo em um arquivo compactado, em zip ou tar.gz. Para ser
utilizado, ele deve ser descompactado, utilizando qualquer descompactador que
suporte estes formatos, como o 7-Zip (http://www.7-zip.org/).
O Eclipse no necessita de instalao. Depois de descompactado, mova os
arquivos para o diretrio em que desejar manter o Eclipse.

Peter P. Lupo
Cristina T. Cerdeiral

Pgina 4 de 48

Primeira execuo do Eclipse

O Eclipse deve ser executado a partir do diretrio onde foi instalado, atravs
do arquivo eclipse.exe no Windows ou eclipse no caso de ter sido baixada a
verso para Linux ou atravs de algum link para estes arquivos. No caso do Linux, o
arquivo eclipse deve ter permisso de execuo (utilize o comando chmod +x
eclipse).
Na primeira execuo do Eclipse, este pedir o caminho para um diretrio
Workspace. neste diretrio que o Eclipse salvar as preferncias de utilizao e
tambm ser o lugar padro para os projetos. Uma mesma instalao do Eclipse
pode utilizar diferentes workspaces, com configuraes diferentes, por exemplo, para
cada usurio.

Este diretrio precisa necessariamente de permisso de escrita, ao contrrio

do diretrio onde o Eclipse foi instalado. Porm, para que o Eclipse possa recuperar a
informao da localizao do ltimo workspace utilizado e no perguntar esta
informao na prxima instalao necessrio que o diretrio de instalao do
Eclipse tambm tenha permisso de escrita. Caso contrrio o Eclipse perguntar a
localizao do workspace toda vez que for iniciado, embora tenha sido definido um
Workspace default. Apesar disto, o Eclipse funciona corretamente.
A localizao do workspace do Eclipse pode ser alterada posteriormente,
atravs do prprio Eclipse.

Peter P. Lupo
Cristina T. Cerdeiral

Pgina 5 de 48

Instalao de plugins
O Eclipse conhecido pela vasta variedade de plugins que estendem sua
funcionalidade. Os plugins para o Eclipse podem ir desde examinadores de aspectos
de qualidade de cdigo, refactoring, UML, construtores de interface grfica WYSIWYG
at tocadores de MP3 e instant messengers.
O
Eclipse
por
padro
j
traz
instalados
plugins
para
Ant
(http://ant.apache.org/), JUnit (http://www.junit.org) e outros, mas muitos outros
plugins
podem
ser
encontrados
nos
sites
Eclipse
Plugin
Central
(http://www.eclipseplugincentral.com/),
EclipsePlugins
(http://www.eclipseplugins.info/), SourceForge.net (http://sourceforge.net/) alm de sites dos
desenvolvedores de outros plugins.
importante, antes de qualquer coisa, observar no site do plugin, sua
compatibilidade com a verso do Eclipse que voc esteja usando. Como tanto o site
Eclipse Plugin Central quanto o EclipsePlugins apenas centralizam informaes sobre
plugins desenvolvidos por terceiros, possvel que as informaes sobre alguns
plugins possam estar desatualizadas e portanto sempre convm olhar o site do
desenvolvedor do plugin desejado, encontrado na mesma pgina que fala sobre o
plugin.
A instalao dos plugins costuma ser, em geral, bastante simples, bastando
que o Eclipse seja fechado e o plugin copiado para o diretrio plugins dentro do
diretrio onde o Eclipse foi instalado. Alguns plugins pedem ainda que alguns
diretrios sejam copiados para o diretrio features tambm dentro do diretrio
onde o Eclipse foi instalado.
Alguns poucos plugins acompanham instalador e diferentes formas de
instalao. As instrues de instalao devem vir com o plugin ou estar presentes no
site do desenvolvedor.

Peter P. Lupo
Cristina T. Cerdeiral

Pgina 6 de 48

Criao de projeto
Para iniciar o desenvolvimento no Eclipse, primeiro necessrio criar e
configurar um projeto.
Um projeto , essencialmente, um conjunto de classes, separadas em pacotes
e as bibliotecas necessrias para seu desenvolvimento.
As telas seguintes podem se apresentar ligeiramente diferentes em
instalaes diferentes do Eclipse, por possurem outros plugins. Estas telas foram
capturadas da verso 3.1.2 do Eclipse com Web Tools Project 1.0.1 integrado.
Para criar um projeto, deve-se selecionar no menu File a opo New e em
seguida Project.

Nota: O menu de contexto traz muitas opes interessantes e mais acessvel que os
menus.
Como alternativa, o menu de contexto do painel Package Explorer fornece esta
opo.

Selecione Java Project e clique em Next.

Peter P. Lupo
Cristina T. Cerdeiral

Pgina 7 de 48

Na tela que se segue h muitas informaes teis a serem fornecidas, mas o

mnimo exigido o preenchimento do nome do projeto, circulado em vermelho
(neste exemplo, o nome Teste).

Peter P. Lupo
Cristina T. Cerdeiral

Pgina 8 de 48

Em azul, dentro do painel Contents, temos Create new project in

workspace, que criar um diretrio com o nome do projeto dentro do workspace.
neste diretrio que ficaro os arquivos do projeto.
Nota: caso haja um projeto do eclipse com o mesmo nome, ele aproveitar as
informaes e criar um projeto a partir daqueles arquivos. Isto pode acontecer
caso um projeto tenha sido copiado de outro workspace. uma forma simples e
eficiente de copiar um projeto para outro workspace, mantendo todas as suas
configuraes. Caso o projeto tenha configuraes default do workspace, essas
configuraes no sero mantidas, sendo substitudas pelas configuraes
default do workspace atual.
Selecionando Create project from existing source pode-se informar o
caminho de um projeto at mesmo fora de um workspace.
No painel JDK Compliance temos Use default compiler compliance
(Currently 1.4) que far com que o projeto seja compilado para a verso
configurada como sendo a verso padro para compilao neste workspace. Para
modificar o default, clique em Configure default.... Esta alterao se refletir em
todos os outros projetos neste workspace que estiverem usando a configurao
default. Em Use a project specific compliance: pode ser selecionada uma
configurao especfica para este projeto, igual ou diferente da default.
Nota: a configurao default tambm pode ser modificada no menu Window,
selecionando Properties....
Em seguida, no n Java selecionando Compiler, a opo correspondente
Compiler compliance level:.

No painel Project Layout, podemos modificar a estrutura do projeto.

recomendado que se separe o cdigo fonte dos binrios gerados, selecionado Create
separate source and output folders, ao invs da opo padro, que colocar os dois
Peter P. Lupo
Cristina T. Cerdeiral

Pgina 9 de 48

tipos de arquivos na raiz do projeto, juntos na mesma estrutura de pastas. Esta

recomendao se deve ao fato de que o processo de gerao de releases fica mais
simplificado, especialmente quando se utilizar algum tipo de ferramenta para
automatiz-lo.
Tambm se pode modificar a estrutura de pastas de cdigo-fonte e binrios
(clicando em Configure default...), mas recomendado manter a estrutura padro,
pois esta a mais usada pelos desenvolvedores. Esta estrutura se trata de um
diretrio src onde ficar o cdigo-fonte da sua aplicao e um diretrio bin, onde
ficaro os arquivos binrios gerados a partir do cdigo-fonte presente em src,
ambas na raiz do diretrio do projeto. O Eclipse cuidar automaticamente da
compilao e de manter o diretrio bin em sincronia com o src, de forma
totalmente transparente para o desenvolvedor.
Clique em Finish para criar seu projeto.

Peter P. Lupo
Cristina T. Cerdeiral

Pgina 10 de 48

Criao de um pacote
Para criar um pacote, deve-se clicar com o boto direito na pasta src,
selecionar New e em seguida Package. (Isto pode ser feito tambm selecionando
a pasta src e selecionando no menu File a opo New e Package).

Na tela que se segue, deve ser preenchido o nome do pacote, que pode ter
quantos tokens forem necessrios.

Em seguida, apertando o boto Finish ser concluda a criao do pacote,

que dever se apresentar assim:

Peter P. Lupo
Cristina T. Cerdeiral

Pgina 11 de 48

Criao de uma classe.

Clicando com o boto direito sobre o pacote onde deseja criar a classe (neste
caso foi escolhido br.org.teste, que foi o pacote criado no tpico anterior),
selecionando New e em seguida Class. Novamente, de forma anloga, no menu
File encontra-se New e Class.

Na tela que se abrir, deve ser preenchido o nome da classe no campo

identificado com Name. O campo Package j vem preenchido com o nome do
pacote que foi clicado para se criar essa classe. Este campo pode ser modificado
livremente e caso o pacote no exista, ser criado no momento em que a classe for
criada.

Em azul pode-se selecionar os Modifiers (modificadores da classe).

Peter P. Lupo
Cristina T. Cerdeiral

Pgina 12 de 48

Superclass a classe da qual a classe que estamos criando herdar. Por

padro este campo vem preenchido com Object. Clicando em Browse, se pode
escolher qualquer uma classe da API do Java, de bibliotecas utilizadas no
desenvolvimento deste projeto e de classes do projeto em si.
Interfaces tm a mesma finalidade de Superclass, mas desta vez para
adicionar interfaces ao invs de classes. Add tem a mesma funcionalidade que
browse, mas neste caso, Add acrescenta uma interface, diferente do Browse, que
altera a classe que ser estendida. Add acrescenta mais uma interface lista de
interfaces. Para remover uma interface, esta deve ser selecionada e em seguida
deve ser clicado o boto Remove.
Which method stubs would you like to create? Ajuda na declarao de
mtodos. Neste caso, est sendo selecionado o mtodo principal public static void
main(String[] args), para que se possa, em um prximo tpico, executar esta
classe.
Clicando em Finish. O resultado dever ser como este:

A criao de interfaces e enums muito semelhante e por isso no ser

mostrada aqui.

Peter P. Lupo
Cristina T. Cerdeiral

Pgina 13 de 48

Execuo de uma aplicao Java dentro do Eclipse

Antes de executar a classe que foi criada no item anterior, um cdigo deve
ser inserido no mtodo principal para que algum resultado da execuo possa ser
mostrado.
Um cdigo de exemplo segue aqui:
if (args.length==0){
System.out.println("Hello Eclipse!");
} else {
System.out.println("Hello " + args[0] + " " + args[1]);
}
E a classe deve ficar como esta:

Clicando com o boto direito sobre a classe, selecionando Run As, pode-se
ver Java Application, assim como seu atalho Alt+Shift+X, seguido da letra J.

Este menu tambm pode ser acessado em Run, Run As e Java

Application.

Peter P. Lupo
Cristina T. Cerdeiral

Pgina 14 de 48

Assim como o boto Run:

O resultado da execuo mostrado na Console:

Para executar novamente a aplicao, basta pressionar o boto Run, que

executa a ltima aplicao que foi executada.

Nota: Para executar uma aplicao que foi executada anteriormente

ltima, basta selecion-la no histrico de execues, no boto Run:

Clicando com o boto direito sobre a classe e selecionando Run As, tambm
podemos selecionar a opo Run... para mais opes na execuo da aplicao.
Analogamente, uma tela como a que se apresentar tambm pode ser
alcanada atravs do menu Run ou do boto Run, selecionando-se a opo
equivalente.

Peter P. Lupo
Cristina T. Cerdeiral

Pgina 15 de 48

Na aba Arguments, por exemplo, argumentos podem ser passados para a

aplicao que ser executada, digitando a linha de argumentos na caixa de texto
logo abaixo de Program arguments:.
Clicando no boto Run desta janela, a aplicao ser executada os
argumentos sero passados, como se fossem em linha de comando. O resultado
ser:

Nota: Caso a aplicao leia dados da entrada padro (teclado), os dados podero
ser digitados pelo desenvolvedor diretamente na console.

Peter P. Lupo
Cristina T. Cerdeiral

Pgina 16 de 48

Javadoc no code completion

O code completion do Eclipse uma funcionalidade bastante til. Ao
pressionar . (ponto) depois de um nome de classe ou referncia para um objeto,
uma janela aparece para que seja selecionado um atributo ou mtodo da classe ou
objeto referenciado antes do . (ponto).
Esta janela tambm pode ser invocada atravs do atalho ctrl + barra de
espao, permitindo a seleo at mesmo de um atributo ou mtodo da mesma
classe que est sendo codificada.

Selecionando-se um mtodo ou atributo, o Eclipse automaticamente o

escreve na posio do cursor.
Mas o mtodo que se deve usar para obter uma funcionalidade desejada
uma informao contida no Javadoc.
Se o cdigo fonte da classe est disponvel para o Eclipse, uma descrio do
que estiver selecionado na janela de completion ser mostrada, desde que o cdigo
fonte contenha o Javadoc para o que estiver selecionado.
Por padro, o Eclipse necessita apenas da JRE para ser utilizado, ento a
esta que ele se associa na sua primeira execuo.
A JRE no traz o cdigo fonte da API do Java e, portanto, o code completion
no disponibilizar o Javadoc.
Para associar o Eclipse JDK (supondo que esta est instalada), deve-se ir ao
menu Window e selecionar Preferences.

Na tela de preferncias, no n Java a funcionalidade desejada fica em

Installed JREs.
Em seguida, aps selecionar a JRE encontrada pelo Eclipse deve-se clicar em
Edit....

Peter P. Lupo
Cristina T. Cerdeiral

Pgina 17 de 48

Nota: Em Add... pode-se adicionar outras JREs, de forma que os

projetos podero utiliz-las alternativamente.
Na janela que segue, possvel alterar o nome da JRE para JDK no campo
identificado por JRE name:.
Alterando o caminho da JRE no campo identificado por JRE home directory
para o caminho da JDK instalada e clicando em OK, o Eclipse passar a usar a nova
biblioteca, contendo o cdigo fonte.

Aps esta modificao e um curto perodo de espera para que o Eclipse

recompile os projetos associados ao compilador default do workspace, o Javadoc
ficar disponvel para estes projetos.
Peter P. Lupo
Cristina T. Cerdeiral

Pgina 18 de 48

Agora, ao pressionar ctrl + barra de espao ou . (ponto) e selecionar um

mtodo ou atributo, uma explicao este ele estar disponvel, ao lado da janela de
code completion.

Peter P. Lupo
Cristina T. Cerdeiral

Pgina 19 de 48

Debug
O Eclipse, como outras IDEs tem um debugger que auxilia o desenvolvedor a
encontrar erros que podem acontecer em tempo de execuo.
Para executar uma aplicao em modo debug, o processo exatamente igual
ao de executar uma aplicao normalmente, exceto que a opo selecionada deve
ser Debug As ao invs de Run As.
Esta opo est acessvel em um boto Debug ao lado do boto Run, no
menu de contexto da classe e no menu Run e o comportamento exatamente o
mesmo de Run.

Porm, executar em modo debug apenas no traz nenhuma vantagem se no

for definido um ponto de parada da execuo (breakpoint), a partir do qual a
mquina virtual passar a executar cada linha de cdigo ao comando do
desenvolvedor, que poder ento analisar o comportamento e o contedo das
variveis no cdigo.
Para definir o breakpoint, um clique duplo do mouse deve ser dado na barra
lateral esquerda do cdigo, na linha em que se deseja a parada.

Peter P. Lupo
Cristina T. Cerdeiral

Pgina 20 de 48

Agora, executando a aplicao em modo debug, na perspectiva de debug

pode-se controlar a execuo da aplicao.
Parando o mouse sobre referncias, pode-se ver seus valores.

Na aba Variables pode-se acessar o estado interno de objetos e ver a lista

de valores de variveis, alm de uma representao textual do objeto ou varivel
selecionado.

A execuo pode prosseguir de formas diferentes:

A primeira, pressionando F8 a execuo segue at o fim, sem interrupes,
a no ser que encontre outro breakpoint.
A tecla F5 faz com que o ponto de execuo a ser examinado seja a
primeira linha do prximo mtodo a ser avaliado na linha atual da execuo. Ou
seja, descemos ou entramos um nvel na execuo da aplicao, mudando de
escopo.
A tecla F6 passa para a prxima linha da execuo da aplicao.
Estas e outras teclas de atalho esto acessveis no menu Run.

Peter P. Lupo
Cristina T. Cerdeiral

Pgina 21 de 48

Nota: Durante a execuo normal, um programa pode lanar uma exceo. Se o

mtodo printStackTrace da exceo for chamado ou se esta no for capturada,
o Stack Trace ser impresso na console do Eclipse.

Um clique duplo em uma linha do Stack Trace far com que o eclipse selecione a
linha correspondente no cdigo fonte da classe em questo, porm isto s
ocorrer se o cdigo estiver disponvel para o projeto.

Nota: lanar uma exceo Runtime uma prtica de programao que deve
ser evitada e est aqui apenas para efeito ilustrativo.

Peter P. Lupo
Cristina T. Cerdeiral

Pgina 22 de 48

Export
Muitas vezes necessrio exportar um ou mais arquivos do projeto ou o
projeto inteiro, para enviar a outra pessoa ou colocar em outro workspace do
Eclipse.
Esta funcionalidade pode ser acessada pelo menu de contexto do arquivo,
diretrio ou projeto a ser exportado e selecionando a opo Export....

Na tela seguinte, selecionando Archive file e clicando em Next pode-se

criar um arquivo compactado (zip ou tar) contendo o contedo que est sendo
exportado.
Nesta tela, h vrias possibilidades de tipos de arquivos para exportao:
EAR file: O Enterprise Web Archive pode ser exportado atravs de um wizard,
desde que se tenha um Eclipse com WTP integrado.
File system: Apenas uma cpia do diretrio, projeto ou arquivo selecionado.
JAR file: Um Java Archive, criado a partir de um wizard.
RAR file: Um arquivo compactado RAR.
WAR file: O Web Archive pode ser exportado atravs de um wizard, desde
que se tenha um Eclipse com WTP integrado.

Peter P. Lupo
Cristina T. Cerdeiral

Pgina 23 de 48

Na tela seguinte possvel refinar a seleo, adicionando ou retirando

arquivos da estrutura de diretrios a ser exportada.
necessrio tambm preencher o nome do arquivo que ser criado e clicar
em Finish para completar o processo.
Em azul h a possibilidade de escolher o formato do arquivo de exportao.

Peter P. Lupo
Cristina T. Cerdeiral

Pgina 24 de 48

Peter P. Lupo
Cristina T. Cerdeiral

Pgina 25 de 48

Importando biblioteca
No menu de contexto do projeto possvel adicionar uma biblioteca para
utiliz-la no desenvolvimento da aplicao, selecionando Build Path e em seguida
Configure Build Path....

O boto Add External JARs... permite que se escolha uma biblioteca JAR em
qualquer diretrio.
Caso a biblioteca esteja dentro da estrutura de diretrios do projeto, tambm
possvel escolher a opo Add JARs....

Peter P. Lupo
Cristina T. Cerdeiral

Pgina 26 de 48

Nota: Ao adicionar uma biblioteca externa, o caminho guardado no projeto

o caminho absoluto para o arquivo JAR. Desta forma, caso o projeto seja
copiado para outro computador, pode deixar de funcionar caso a biblioteca
no esteja disponvel exatamente no mesmo lugar.
Assim, sempre recomendvel adicionar uma biblioteca que esteja presente
dentro da estrutura de diretrios do projeto, pois desta forma o caminho
armazenado ficar relativo raiz do projeto e este se manter funcionando
ainda que o projeto esteja sendo executado em outro computador.
Na tela seguinte, deve ser selecionada a biblioteca que se deseja instalar. A
ttulo de exemplo, est sendo selecionada a biblioteca JUnit, presente no diretrio
org.junit_3.8.1 dentro do diretrio plugins no diretrio de instalao do Eclipse.
Por no estar dentro do projeto, o boto Add external JARs... o que
permitir a adio desta biblioteca.

Peter P. Lupo
Cristina T. Cerdeiral

Pgina 27 de 48

Clicando em Open a biblioteca ser adicionada ao projeto, podendo ser

utilizada por suas classes.

Peter P. Lupo
Cristina T. Cerdeiral

Pgina 28 de 48

Criando e executando teste JUnit

Para executar o JUnit, primeiro precisa-se de uma classe com um mtodo a
ser testado. classe TesteEclipse foi adicionado o seguinte mtodo:
public int metodoParaTestar(int x) {
if (x < 0) return 1;
if (x == 0) throw new RuntimeException();
return 0;
}
A classe ento ficou:

Nota: lanar uma exceo Runtime uma prtica de programao que

deve ser evitada e est aqui apenas para efeito ilustrativo.

New.

No menu de contexto dela, pode-se escolher JUnit test case no menu

Na tela seguinte h vrias opes para a classe de teste que ser gerada.

Peter P. Lupo
Cristina T. Cerdeiral

Pgina 29 de 48

Clicando em Next > pode-se selecionar o mtodo a ser testado de forma

que o Eclipse criar o mtodo de teste correspondente.

Selecionando o mtodo e clicando em Finish, a classe de teste ter sido

criada.

Peter P. Lupo
Cristina T. Cerdeiral

Pgina 30 de 48

teste.

No corpo do mtodo testMetodoParaTestar() pode-se inserir um cdigo de

Para fins de exemplo, ser inserido o seguinte cdigo:
TesteEclipse testeEclipse = new TesteEclipse();
assertEquals("Este teste passa", testeEclipse.metodoParaTestar(-1), 1);
assertEquals("Este teste d failure", testeEclipse.metodoParaTestar(2), 5);
assertEquals("Este teste d error", testeEclipse.metodoParaTestar(0), 5);
E a classe ficar assim:

Este teste passar no primeiro assert, no segundo dar uma failure e no

terceiro um error.
No menu de contexto da classe de teste, da mesma forma que se executa
uma aplicao, o teste pode ser executado.

Peter P. Lupo
Cristina T. Cerdeiral

Pgina 31 de 48

O resultado ser mostrado na aba JUnit.

De cima para baixo e da esquerda para a direita, o primeiro boto circulado
executa novamente o ltimo teste e o da direita executa novamente o ltimo teste
executando primeiro os que tiveram resultado failure.
Em Runs apresentado o nmero de mtodos de teste executados e o total
de mtodos de teste.
Em Errors a quantidade de erros obtidos e em Failures a quantidade de
falhas obtidas.
A barra vermelha uma barra de progresso e ao mesmo tempo de sucesso,
pois se mantm verde enquanto nenhum teste der erro ou falhar.
Em Failures esto relatadas as falhas. Um clique duplo seleciona a classe e
o mtodo de teste que gerou a falha.
Em Failure Trace h informaes detalhadas sobre a falha selecionada em
Failures (acima). A primeira linha retorna informaes a respeito da falha.
Na segunda linha mostrado o ponto em que ocorreu a falha e um clique
duplo sobre ela seleciona exatamente a linha no cdigo de teste que gerou a falha.

Dando um clique duplo nesta linha e comentando esta linha de cdigo, podese executar novamente o teste e o resultado no mais relatar esta falha.
Peter P. Lupo
Cristina T. Cerdeiral

Pgina 32 de 48

Nota: Obviamente esta no uma soluo. Se o teste falha, o cdigo

deve ser corrigido. No entanto o objetivo deste documento no explicar
como se trata erros e testes. Comentar esta linha no resolve o
problema, mas permite que o restante desta funcionalidade do Eclipse
possa ser mostrado mais rapidamente.
O novo resultado agora ser o relato de um erro.

Um erro o resultado de um erro de programao e no um teste que falhou.

Sendo assim, uma exceo relatada.
No Eclipse, um clique duplo em uma determinada linha da pilha de execuo
trazida pela exceo leva linha que a originou, no cdigo fonte de uma
determinada classe (caso esteja disponvel).
Sendo assim, um clique duplo sobre a terceira linha em Failure Trace leva
linha de cdigo que, quando comentada, far o teste passar com sucesso. Quando
executado com sucesso, a barra de progresso apresentada na cor verde, desta
forma:

Nota: Obviamente esta no uma soluo. Se o teste d um erro, o

cdigo deve ser corrigido. No entanto o objetivo deste documento no
explicar como se trata erros e testes. Comentar esta linha no resolve o
problema, mas permite que o restante desta funcionalidade do eclipse
possa ser mostrado mais rapidamente.
Nota: Informaes sobre o JUnit, incluindo tutorial para seu aprendizado
pode ser obtido em http://www.junit.org/.

Peter P. Lupo
Cristina T. Cerdeiral

Pgina 33 de 48

Executando um Ant build

Um Ant build um arquivo XML que pode ser executado atravs do
framework de autmao Ant, desenvolvido e mantido pela Fundao Apache.
O arquivo deve se chamar build.xml para que o Eclipse o reconhea como um
script de Ant e fornea toda a funcionalidade de code completion e validao para
este XML.
Para este exemplo, um script ant foi escrito:
<?xml version="1.0"?>
<project name="Teste" default="Nada" basedir=".">
<target name="Nada" description="Este ser o target padro, mas
nada ser feito nele alm de imprimir uma mensagem.">
<echo message="Mensagem impressa ao executar o target
Nada (padro)."/>
</target>
<target name="Nada2" description="Este NO ser o target padro,
mas tambm no far nada alm de imprimir uma mensagem.">
<echo message="Mensagem impressa ao executar o target
Nada2."/>
</target>
</project>
Ficando assim:

O procedimento para execuo o mesmo para uma aplicao Java, exceto

que a opo selecionada em Run As deve ser Ant Build.

E o resultado ser mostrado na console do Eclipse:

Peter P. Lupo
Cristina T. Cerdeiral

Pgina 34 de 48

Caso se deseje selecionar um target diferente do padro descrito no script

Ant, a opo abaixo, Ant Build... (marcada em azul), deve ser selecionada e uma
tela como esta, ser apresentada:

Nesta tela podem ser selecionados os targets que se quiser executar (em
Check targets to execute:) e a ordem de execuo (em Target execution order:).
Clicando em Run, a seleo de targets ser executada na ordem estabelecida.
Nota: Nesta tela, outras opes de configurao para execuo deste
script ant podem ser configuradas, como variveis de ambiente,
classpath e outras.
O resultado desta execuo ser:

Nota: Mais informaes sobre o Ant como manual de utilizao,

atualizaes e API no site do Ant: http://ant.apache.org/.

Peter P. Lupo
Cristina T. Cerdeiral

Pgina 35 de 48

Utilizando o CVS
O plugin para utilizao do CVS no Eclipse fornece toda a funcionalidade de
um cliente de CVS convencional agregado s vantagens de estar integrado a IDE de
desenvolvimento.
Para comear a utilizao do CVS, primeiro deve ser configurado um
repositrio, o que pode ser feito em Window, Show View e Other....

A opo a ser selecionada na janela que ser aberta CVS Repositories e

em seguida, OK.

Para criar um repositrio, a opo a ser acessada Repository Location em

New no menu de contexto da rea da aba CVS Repositories.

Nesta opo, uma tela para configurar um repositrio aparecer.

Peter P. Lupo
Cristina T. Cerdeiral

Pgina 36 de 48

Nela, os campos Host, Repository path, User e Password devem ser

preenchidos.
Tambm pode ser selecionado o protocolo utilizado e a porta do servidor.
Em Finish, o Eclipse tentar conectar no repositrio usando o nome e a
senha fornecidos, para validar as informaes.
Se estiver tudo correto e o servidor funcionando, logo aps a validao, ser
criado um repositrio na aba CVS Repositories.

Para fazer o check out de um mdulo, a opo Check Out As... deve ser
selecionada no menu de contexto do mdulo desejado.

Nota: A opo Check Out automaticamente cria um projeto com o nome

do mdulo.
Em Project Name pode ser escolhido o nome para um projeto que ser
criado a partir do mdulo do repositrio.
Peter P. Lupo
Cristina T. Cerdeiral

Pgina 37 de 48

Clicando em Finish, o projeto ser criado no worskpace padro com o

contedo da ltima verso do mdulo.
Em Next h a possibilidade de selecionar outro workspace para o projeto
que ser criado.

Na tela seguinte, desmarcando a opo Use default workspace location pode

ser selecionado outro workspace onde o projeto ser criado.
Em Finish o projeto ser criado no workspace selecionado com a ltima
verso do mdulo.
Next permitir selecionar uma determinada tag ou verso do mdulo a
partir da qual o projeto dever ser criado com o nome escolhido na primeira tela do
deste wizard e no lugar escolhido na tela anterior.

Na ltima tela, pode ser selecionada a tag, verso e/ou branch preenchendo
os campo Select a tag e/ou navegando nas opes do campo Matching tags:.
Clicando em Finish o projeto ser criado.
Peter P. Lupo
Cristina T. Cerdeiral

Pgina 38 de 48

O projeto compartilhado atravs do plugin de CVS do Eclipse tem a vantagem

de estar dentro da IDE e portanto a IDE pode fornecer informaes que um cliente
de CVS no poderia.
Quando o projeto est compartilhado, o smbolo marcado em vermelho
aparece nas suas pastas, arquivos e no prprio projeto.

Ao se modificar algum arquivo no projeto, o Eclipse automaticamente marca

este arquivo com um sinal de maior (>) antes do nome. Como uma modificao no
arquivo tambm uma modificao no diretrio onde ele est, o Eclipse coloca o
mesmo sinal identificador de modificao antes do nome do diretrio e assim faz
com toda a hierarquia acima, at o projeto. Desta forma, facilmente se encontra as
modificaes em um projeto.
Para fazer um commit de uma modificao, no menu de contexto do elemento
a ser enviado para o repositrio (no caso deste exemplo, um arquivo), existe a
opo Team (onde ficam as opes do CVS) e Commit....

Peter P. Lupo
Cristina T. Cerdeiral

Pgina 39 de 48

Nota: No menu Team so encontradas vrias opes para

trabalhar com o CVS.

Na tela de commit um comentrio relacionado com a mudana que est

sendo introduzida no repositrio deve ser digitado ou um comentrio que j tenha
sido escrito anteriormente deve ser selcionado.
Finish efetuar o commit.

Peter P. Lupo
Cristina T. Cerdeiral

Pgina 40 de 48

Para o update, a opo no menu Team do menu de contexto do elemento a

ser atualizado Update.

Selecionando esta opo o update ser efetuado.

O Eclipse tambm fornece uma opo para sincronizar um projeto, diretrio
etc. com o repositrio, na opo Syncronize with Repository no menu Team.

A perspectiva de comparao do Eclipse mostrar ento uma rvore com as

diferenas entre o que foi selecionado e seu equivalente no repositrio. No caso
deste exemplo, todo o projeto est sendo sincronizado (clicando com o boto direito
do mouse no projeto e selecionando Team e Synchronize with Repository).

Peter P. Lupo
Cristina T. Cerdeiral

Pgina 41 de 48

No topo da imagem, os quatro botes marcados com azul so filtros, que da

esquerda para a direita mostram apenas o que existe de diferente no repositrio,
apenas o que existe de diferente no projeto, o que existe de diferente nos dois e
modificaes conflitantes.
A opo Open In Compare Editor no menu de contexto, abre uma tela de
comparao.

Peter P. Lupo
Cristina T. Cerdeiral

Pgina 42 de 48

Nesta tela, as alteraes podem ser copiadas de uma verso para outra das
classes, pacotes, diretrios, etc.
Comparar diferentes verses uma tarefa bastante comum e no
necessrio fazer o sincronismo para obter esta funcionalidade.
No menu de contexto, na opo Compare tambm est disponvel a
comparao atravs das opes Latest from Head que compara com a ltima
verso no mdulo ou Revision... que permite selecionar a verso com a qual se
quer fazer a comparao.

Peter P. Lupo
Cristina T. Cerdeiral

Pgina 43 de 48

Em Revision... uma tela com as informaes de cada reviso do que foi

selecionado apresentada e um duplo clique sobre uma determianda reviso faz a
comparao da reviso com a verso atual no projeto.

Peter P. Lupo
Cristina T. Cerdeiral

Pgina 44 de 48

Tambm possvel pegar o contedo de uma verso anterior do que foi

selecionado clicando na verso desejada com o boto direito e selecionando Get
Contents no menu de contexto.

Nota: H na internet plugins para integrar o Eclipse com outros servidores de

controle de verso alm do CVS, como o Visual Source Safe (VSS) da
Microsoft, o Subversion (SVN), o StarTeam da Borland, etc.

Peter P. Lupo
Cristina T. Cerdeiral

Pgina 45 de 48

Dicas de configuraes personalizadas e outras

funcionalidades
Para configuraes personalizadas no Eclipse, deve ser utilizada a janela
Preferences, do menu Window.

Outras funcionalidades tambm podem ser encontradas no menu Show

View, tambm em Window.

Para automatizar tarefas como renomear classes mantendo a integridade do

sistema, renomear mtodos, atributos e variveis, criar automaticamente mtodos
acessores para atributos ou criar um mtodo a partir de um trecho de cdigo
selecionado, vale explorar os menus source e refactor no menu de contexto das
classes, projetos e pacotes no Package Explorer.

Peter P. Lupo
Cristina T. Cerdeiral

Pgina 46 de 48

Estes menus tambm esto disponveis no menu de contexto do cdigo fonte

das classes e opes diferentes aparecem ao selecionar um trecho de cdigo.

O Eclipse mantm tambm histrico das classes que esto sendo modificadas,
criando uma entrada no histrico para cada salvamento feito pelo desenvolvedor.
Este histrico pode ser acessado atravs das opes Compare With,
Replace With e Restore from Local History, presentes nos menus de contextos de
diretrios, classes, pacotes, mtodos e atributos.
Peter P. Lupo
Cristina T. Cerdeiral

Pgina 47 de 48

O Compare With tambm traz a opo Each Other quando no package

explorer h duas classes, pacotes, projetos ou diretrios selecionados.

Para selecionar os dois elementos a serem comparados (que podem at ser

de projetos diferentes), basta clicar na segunda segurando a tecla Ctrl.

Peter P. Lupo
Cristina T. Cerdeiral

Pgina 48 de 48