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. No menu de contexto dela, pode-se escolher JUnit test case no menu

New.

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