TUTORIAL: ECLIPSE UMA IDE PARA JAVA

Prof. Ricardo A. de M. Valentim (CEFET-RN)

NATAL RN NOVEMBRO DE 2005

Eclipse Guia do Usurio

SUMRIO
1. INTRODUO 2. PERSPECTIVA 3. PLUGINS 4. WORKSPACE 1. Adicionando views para uma perspectiva 2. Arrumando o workbench 3. Manipulando recursos com ferramentas externas 5. INSTALAO 6. CONFIGURAO BSICA 1. Estrutura das pastas nos projetos Java 2. Use JDK ao invs de JRE (ou instale um novo JRE/JDK) 7. CONFIGURANDO CLASSPATH VARIABLES 8. O PRIMEIRO PROJETO JAVA 1. A primeira classe Java 9. CONFIGURANDO O LAUNCHER - EXECUTANDO UM PROGRAMA 10. IMPORTANDO UM PROJETO EXISTENTE 11. CONFIGURANDO O JAVA BUILDPATH 12. RODANDO EM MODO DEBUG 1. Debugger 1. Breakpoints 2. Remote Debugging 3. Connection 2. Debug View 3. Realizando debugging nos programas

13. PLUGIN'S 1. Lomboz 1. Configurao 2. Ativao 2. Easy Struts 1. Instalao 2. Configurao 3. Ativao 3. XML Buddy 1. Instalao 2. Ativao 4. DBEdit 1. Instalao 2. Configurao 3. Ativao 5. CONTROLE DE VERSO 1. Eclipse e CVS - Alguns passos a serem seguidos 1. Criando um novo repositrio 2. Compartilhando um projeto 3. Criando uma verso 4. Gerenciando as verses de um recurso 5. Substituindo a verso corrente por outra 6. Versionando um projeto 7. Adicionando a verso ao workspace 2. Eclipse e CVS 1. Compartilhando um projeto 1. Verses CVS 1. Criando uma verso: 2. Gerenciando as verses de um recurso: 3. Substituindo a verso corrente por outra:

4. Versionando um projeto 5. Adicionando a verso ao workspace: 6. Eclipse e Junit 1. Configurando o projeto 2. O primeiro teste 3. Executando o primeiro teste: 7. Eclipse e Ant 1. Executando Ant 2. Clear Output

Sobre esse Tutorial

Crditos:

Nki Technologies. Agradecimentos ao Nki Team!

Formatao e reviso:
Prof. Ricardo Alexsandro de Medeiros Valentim (CEFET-RN). {valentim@cefetrn.br}

Introduo
O Eclipse um framework para integrar diferentes tipos de aplicaes. Uma de suas aplicaes a JDT(Java Development Tooling), a qual j vem com o Eclipse. Essas aplicaes so oferecidas em forma de plugins e automaticamente reconhecidas e integradas pela plataforma. Tendo seus prprios recursos para gerenciamento de mecanismo, que so geralmente arquivos no seu Hard Disk. Eles residem no seu workspace, uma pasta especial localizada no seu sistema de arquivos. As aplicaes instaladas comunicam-se entre si, com isso, se uma aplicao altera um recurso qualquer, todas as outras aplicaes instaladas sero notificadas sobre essa mudana, garantindo uma consistncia e integrao em todo o seu ambiente de desenvolvimento. Um usurio sempre trabalha no workbench, a parte "visvel" da plataforma(GUI). A perspectiva escolhida determina a aparncia atual do workbench. A perspectiva uma coleo conhecida como "views e editores" que contribuem com aes especiais para o menu e a toolbar. A maioria das views mostra informaes especiais sobre os recursos. Dependendo da view somente partes ou relacionamentos internos dos recursos podero ser mostrados. Como no caso de arquivos do tipo XML. Um editor trabalha diretamente sobre um recurso(classes Java como exemplo). O Eclipse segue um ciclo de carrega-altera-salva que somente se um editor salvar suas alteraes, a plataforma ser capaz de notificar as outras aplicaes. Views especiais podem ser conectadas diretamente a um editor, adicionando recursos complementares ao manuseamento dos recursos. Por exemplo a Outline View da perspectiva Java conectada diretamente ao Editor Java. O que torna o Eclipse uma IDE especial, a extrema flexibilidade na qual podem ser combinadas views e editores. Dessa forma o workbench pode ser arrumado de uma forma livre e que melhor adapte o desenvolvedor. As views e editores podem ser adicionados em uma perspectiva aberta (mesmo se eles foram definidos em um plugin totalmente diferente). Portanto possvel ter a total liberdade para criar o ambiente de desenvolvimento que melhor agrade ao desenvolvedor, de uma forma agradvel e customizada.

Perspectiva
Para abrir uma nova perspectiva no seu worbench faa: 1. Escolha 'Window -> Open Perspective' no menu principal:

2. Escolha 'Other' para ver todas as perspectivas instaladas:

Plugins
Para instalar novas aplicaes, simplesmente copie os plugins para dentro da pasta $ECLIPSE_HOME/plugins como mostrado com o Tomcat plugin. Ser preciso reiniciar o

Eclipse para tornar a nova aplicao "ativa". Dependendo plugin uma nova perspectiva poder ser escolhida, sendo encontradas novas opes no menu e toolbar.

Workspace
Como default a pasta root do workspace $ECLIPSE_HOME/workspace. Caso seja necessrio atuar com em vrios projetos, ou mesmo compartilhar uma maquina para armazenamento dos projetos, faz mais sentido separar o workspace. Pode ser escolhido um diretrio arbitrrio para o wokspace, para ter uma pasta especifica como root basta usar a opo -data na inicializao do Eclipse. Por exemplo "eclipse -data

c:\MeuWorkspace".

Adicionando views para uma perspectiva

1. Abra a perspectiva, ex. perspectiva Java.

2. Escolha 'Show View -> Navigator' no menu:

A navigator view ser adicionada na perspectiva Java.

Arrumando o workbench
1. Clique na barra de titulo da view ou do editor e arraste para outra posio dentro

do workbench

2. A aparncia do workbench ser ajustada automaticamente:

Para adicionar uma view ou um editor como uma tab faa: 3. Clique na barra de titulo da view ou do editor e arraste at o cursor mudar dentro do smbolo da tab.

4. A aparncia do workbench ser ajustada automaticamente:

Manipulando recursos com ferramentas externas

Se um recurso existente no workspce for alterado por uma ferramenta externa, a notificao no chegara ao Eclipse automaticamente. Mas se o recurso alterado externamente estiver aberto em um editor no Eclipse, ser recebida uma notificao perguntando se desejado carregar as alteraes ocorridas.

Caso sejam criados arquivos ou pastas para os seus projetos externamente, ser preciso notificar ao Eclipse: 1. Selecione a pasta na qual foram criados novos arquivos / pastas na view (ex. Navigator)
2. Escolha 'File -> Refresh'

Instalao

Sistema operacional:
o o o o o

Windows Linux Solaris QNX Mac OS/X

Recomendvel 256 MB RAM. Java 2 runtime environment (JRE) ou Java 2 Software Development Kit (J2SDK). Eclipse necessita da verso 1.3 ou superior. Eclipse 2.0.2-archive ou superior.
1. Instale o respectivo JRE. 2. Descompacte o Eclipse-archive para uma pasta arbitrria. No Windows o

Eclipse acha a instalao do JRE/SQK automaticamente, atravs do registry.

3. Inicialize o Eclipse executando eclipse.exe(Windows) ou eclipse.sh(Linux)

localizado no diretrio de instalao. Aps isso, o workbench aparecer:

Configurao Bsica
Aps a inicializao do Eclipse, sero necessrias algumas configuraes da ferramenta.

Estrutura das pastas nos projetos Java

Por padro os arquivos fonte e compilados sero salvos diretamente na pasta do projeto. melhor separar o cdigo fonte do cdigo compilado (arquivos .class). Com isso devemos ter uma pasta especial (source) que contem somente o cdigo fonte. Um projeto pode crescer consideravelmente atravs da adio de novas pastas de cdigo fonte. 1. Escolha 'Window -> Preferences' no menu. 2. Expanda o n 'Java' e escolha 'New Project'.

3. Escolha o radio-button 'Folders'.

4. Prescione 'Apply'.
5. Prescione 'OK'.

Selecionar compilador e editor para o JDK

O compilador Java e editor do Eclipse podem ser configurados para trabalhar com diferentes verses de JDK. 1. Escolha 'Window -> Preferences' no menu. 2. Expanda o n 'Java' e escolha 'Compiler'. 3. Escolha 'JDK Compliance'. 4. Escolha '1.4' na lista de seleo 'Compile compliance level'.

5. Pressione 'Apply'. 6. Pressione 'OK'.

Use JDK ao invs de JRE (ou instale um novo JRE/JDK)

Para ver o cdigo fonte das classes padro do Java, precisa ser "avisado" ao Eclipse para usar o JDK correspondente. Por padro o Eclipse utiliza o JRE, o qual no possui cdigo fonte (o arquivo src.zip). Ao usar o JDK, ajudas adicionais sero oferecidas: Code Assist pode mostrar nomes e retornos dos mtodos existentes no JavaDoc e comentrios atravs de um hover help. Pr-requisito: O JDK precisa estar instalado no Sistema Operacional 1. Escolha 'Window -> Preferences' no menu. 2. Expanda o n 'Java' e escolha 'Installed JREs'. 3. Escolha a primeira linha. (Standard VM).

4. Pressione o boto 'Edit' (ou 'Add'). O dialogo 'Edit JRE' (ou 'Add JRE') aparecer:

5. Pressione o boto 'Browse' na linha 'JRE home directory'.

6. Escolha a pasta no diretrio de instalao no dialogo de seleo. No Windows deve ser C:\j2sdk1.4.1. 7. Prescione 'OK' para a pasta selecionada. 8. Prescione 'OK' para o dialogo 'Edit JRE'. 9. Prescione 'OK' para o dialogo 'Preferences'.

Configurando classpath variables

Classpath variables so definidas a nvel do workbench. Pastas e arquivos .jar ou .zip podem receber nomes, fazendo com que seja fcil inclui-los no buildpath. 1. Escolha 'Window -> Preferences'. 2. Expanda o n 'Java' e escolha 'Classpath Variables'. O seguinte dialogo aparecera:

3. Pressione o boto 'New'. O dialogo 'New Variable Entry' aparecer:

4. Especifique o nome da varivel no textfield 'Name'.

10

a) Se a varivel apontar para um arquivo (.zip ou .jar), pressione o boto 'File'.

b) Se a varivel apontar para uma pasta, pressione o boto 'Folder'. Variveis apontam para uma pasta que deve complementar o path para dentro do projeto que ira utiliza-la. Isto significa que tanto pastas, .zip ou .jar sero adicionados ao buildpath do projeto.

5. Pressione 'OK' no dialogo 'New Variable Entry'. 6. Pressione 'OK' no dialogo 'Preferences' Dialog.

O primeiro projeto Java

Como criar um projeto Java simples, onde o cdigo fonte esta separado na sua pasta de "sada'. Criao do projeto Java: No importa se ser criado um novo projeto ou ser importado um projeto existente, necessrio criar um projeto Java no Eclipse antes. No matter if you want to start an all new project or want to import an existing one you need to create an Eclipse Java project first. 1. Abrir a perspectiva Java
2. Abrir o assistente 'New Java Project'.

Existem vrias maneiras de iniciar esse assistente. A mais fcil pressionando o boto na toolbar.

Tambm pode ser escolhido 'File -> New -> Project' para obter um dialogo que deixa escolher 'Java project'.

O dialogo 'New Java Project':

11

3. Escolha um nome para o seu projeto, ex. "MeuProjeto". O padro para a pasta do projeto workspace_home/MeuProjeto . 4. Pressine 'Next'. O dialogo 'New Java Settings' aparecer:

Com esse dialogo ser editado o arquivo .classpath do projeto.

A tab 'Source' serve para especificar pastas que contenham recursos Java (arquivos .java). 5. Selecione o radio button 'Use source folders contained in the project'.

12

6. Pressione o boto 'Create New Folder'. O dialogo 'New Source Folder' aparecer:

7. Digite "src" no textfield.

8. Pressine 'OK'. O dialogo 'Source Folder Added' aparecer:

9. Pressione 'Yes'. A pasta de sada para as classes compiladas ser

especificada como workspace_home/MeuProjeto/bin

O dialogo 'New Java Settings' aparecer:

10. Pressione 'Finish'.

A primeira classe Java

Criao da classe Java:

13

1. Abra a perspectiva Java 2. Abra o assistente 'New Java Class'.

Existem varias formas de iniciar o assistente, a mais fcil pressionando o boto na toolbar.

Tambm pode ser escolhido 'File -> New -> Class' e ser mostrado o dialogo para escolher 'Java project'.

O dialogo 'New Java Class' aparecer:

O primeiro boto chamado 'Browse' serve para selecionar a pasta para os cdigos fontes, no qual as classes sero criadas, nesse caso 'MeuProjeto/src'. 3. Digite "test" como o nome do package Java. (Package) 4. Digite "Test" como o nome da classe. (Name) 5. Marque o checkbox 'public static void main(String[] args)' Podem ser especificadas superclasses e interfaces para implementao. Para o primeiro teste ser criado um simples mtodo main.

O dialogo ser:

14

6. Pressione 'Finish'

A nova classe ser aberta no editor Java:

7. Digite 'System.out.println("Hello world!");' no corpo do mtodo main. 8. Salve as mudanas para a nova classe. (Ctrl+S ou no menu)

Assim que ocorrer o salvamento, o cdigo fonte ser compilado. (Essa ao pode ser alterada em preferences) Para executar a classe, ser necessrio configurar o launcher.

15

Configurando o Launcher Executando um programa

Para executar o mtodo main, ser preciso configurar o launcher: Como atalho pode ser escolhido 'Run As -> Java Application' e no menu dropdown 'Run'. Isso totalmente suficiente para executar um programa simples (sem parmetros etc.) 1. Pressione o boto 'Run' na toolbar:

O dialogo 'Launch Configurations' aparecer:

2. Selecione 'Java Application' e pressione 'New'. A segunda parte do dialogo 'Launch Configurations' aparecer:

16

Vrias configuraes podem ser informadas (parmetros para a VM, classpath, aes do workbench quando inicializado etc.). 3. Pressione 'Run'. A Console view da perspectiva Java aparecer contendo a sada padro:

Pressionando o boto 'Run' a ultima ao ser executada novamente, nesse caso a classe 'Test'.

Ser necessrio criar uma nova configurao: 1. Escolha 'Run' no menu dropdown:

O seguinte dialogo 'Launch Configurations' aparecer para completar a configurao:

17

Selecione 'Java Application':

Pressione 'New'. A nova classe aparecer no dialogo:

Pressione 'Run'.

Importando um projeto existente

Para importar um projeto existente, ser necessrio: 1. Criar um projeto Java. 2. Escolha 'File -> Import'. O dialogo 'Import Select' aparecer.

18

3. Selecione 'File System'.

4. Pressione 'Next'. O dialogo 'Import File System' aparecer 5. Especifique o diretrio que conter o projeto importado com o primeiro boto 'Browse'. Esse diretrio ser o raiz para o seguinte dialogo de seleo. 6. Selecione as pastas e arquivos que devero ser importados para dentro do projeto. 7. Especifique a pasta que na qual sero armazenados os arquivos importados, com o segundo boto 'Browse'.

Podero ser escolhidas pastas de projetos existentes e seus subdiretrios. A opo 'Create complete folder structure' tambm cria pastas hierarquicamente no projeto.

8. Pressionw 'Finish'. As pastas e arquivos selecionados sero adicionados ao projeto.

Configurando o Java Buildpath

19

O buildpath avisa ao compilador onde procurar por vrios arquivos e recursos para realizar o seu trabalho. Isso significa que devem ser compilados o cdigo fonte e as classes definidas atravs das implementaes. Essas informaes so armazenadas no arquivo .classpath do projeto Java. No aconselhvel editar esse arquivo diretamente, mas sim usar um assistente especial. 1. Selecione o projeto no Package Explorer ou Navigator view. 2. Abra o menu para esse projeto (right-click): 3. Escolha 'Properties' no menu:

O dialogo 'Properties for ProjektName' aparecer.

4. Selecione 'Java Build Path'. O dialogo aparecer:

5. Configure o buildpath com a seguinte descrio.

Significado das vrias tabs:

20

Source:

Aqui sero especificadas as pastas nas quais os cdigos fonte sero armazenados. Somente nessas pastas novas classes e packages podero ser criados. Por padro novas classes sero criadas diretamente nessas pastas dos projetos. Para separar o cdigo fonte dos arquivos compilados, precisa ser especificado aqui. Projects:

Aqui projetos existentes podem ser adicionados ao buildpath. O compilador procura por classes definidas nos projetos especificados.

Libraries:

21

Referencias para arquivos .jar e .zip dentro do workspace ou em qualquer lugar do seu HardDisk pode ser especificado aqui. Detalhes:

Add JARs: Arquivos que existem dentro de projetos no workspace sero adicionados aqui.

Add External JARs: Arquivos arbitrrios no seu HardDisk sero adicionados aqui. Add Variable: Adiciona uma classpath variable. Advanced: O dialogo auxilia a criao de pastas para classes. Essas pastas contem definies de classes descompactadas (arquivos .class, no .jar ou .zip).

Edit: Muda entradas existentes. Attach Source: Adiciona o cdigo fonte para uma referncia existente. O cdigo fonte ser mostrado no editor Java, mas no poder ser alterado.

Remove: Seleciona uma entrada e remove do buildpath. Change the order of the entries. O compilador sempre utiliza a definio de classes que encontrar primeiro.

Textfield 'Build output folder': A pasta que recebe as classes compiladas. Essa pasta no deve conter cdigo fonte.

Rodando em modo Debug

O Eclipse permite rodar programas em modo debug, ou seja, habilitar ferramentas como breakpoints e variable tracking.

Debugger

22

O debugger permite detectar e diagnosticar erros em programas sendo executados localmente ou remotamente. Torna-se fcil controlar a execuo dos programas, atravs da adio de breakpoints, os quais suspendem a inicializao, possibilitando analisar o cdigo por "dentro" e examinar o contedo das variveis.

A utiilzao dessa perspectiva atravs de um design cliente/servidor, sendo assim os programas podem rodar remotamente em outros sistemas operacionais na rede, como rodariam localmente na estao de trabalho do desenvolvedor. O servidor para debugger roda na mesmo sistema operacional que o programa a ser analisado, o qual pode estar na maquina do desenvolvedor (local debugging) ou um sistema operacional que esteja acessvel atravs da rede (remote debugging).

BREAKPOINTS

Breakpoints so marcos colocados no programa, que avisam ao debugger onde parar. Quando o workbench esta rodando um programa e encontra um breakpoint, a execuo e suspensa. O thread correspondente suspenso (temporariamente para de rodar) permitindo que seja vista toda a stack para o thread em questo.

A execuo suspensa antes do statement que contm o breakpoint. Os contedos das variveis e a stack podem ser checados nesse momento, alm de realizar step over, step into em mtodos ou classes, a execuo rodar at encontrar o prximos breakpoint ou o fim do programa.

Os brakpoints podem ser desabilitados sem suspender a execuo, e habilitados em outro momento.

REMOTE DEBUGGING

23

Remote debugging permite rodar aplicaes em um sistema operacional e realizar o debug em outro sistema operacional. O sistema local roda o debugger, e o sistema remoto roda o debugging engine e o programa.

CONNECTION

O principal requerimento para remote debugging acessar a maquina remota, na qual os arquivos onde ocorrer o debug devem residir. Ao realizar o remote debugging em um programa, o debug engine daemon inicia escutando a conexo, aps realizada pode ser feito o debug do programa.

Debug View
Esta view permite o gerenciamento para realizar o debugging de um programa no workbench. Ela mostra uma janela com a stack de cada thread suspenso para cada tarefa que esteja realizando o debugging. Cada thread aparece como um n da arvore.

Comandos da Debug View Botes da Comando Toolbar Resume Suspend Este comando executa o thread suspenso. Este comando suspende o thread da tarefa, podendo navegar ou modificar o cdigo, inspecionar os dados, etapas e assim por diante. Terminate Somente no menu Somente no menu Disconnect Terminate & Remove Terminate All Este comando terminar a tarefa do debug selecionado. Este comando termina todas as tarefas de debug selecionadas e remove-as da janela. Este comando termina todas as atividades iniciadas na janela. Este comando fecha todas as conexes das tarefas de debug Descrio

24

selecionadas quando executado remote debugging. Remove All Terminated Launches Step Into Este comando executa um steps into no statement selecionado. Step Over Este comando executa um step over no statement selecionado. A execuo continuar at a prxima linha no caso domesmo mtodo, ou voltar para o mtodo de origem, caso o mtodo corrente tenha sido chamado por outro mtodo.O cursor posicionado no mtodo e seleciona a linha. Run to Return Este comando sai do mtodo corrente. Esta opo para a execuo aps sair do mtodo corrente. Show/Hide Esta opo pode ser selecionada para mostrar ou ocultar Este comando limpa da janela todas as tarefas de debug terminadas.

Qualified Names qualified names. Somente no menu Somente no menu Properties Este comando mostra as propriedades do processo selecionado, tambm permitindo visualizar as linhas de comando do processo selecionado. Relaunch Este comando reinicia a tarefa de debug selecionada.

Realizando debugging nos programas

1. Abra alguma classe na perspectiva Java. 2. Coloque o cursor na barra do lado esquerdo da janela na qual esta aberta a classe e de um duplo clique ao lado do statement desejado, adicionando um breakpoint.

25

Adio de um Breakpoint.

O breakpoint esta em azul porque ainda no foi verificado, significando que a classe que o contm ainda no foi carregada pela Java VM. 3. Clique no boto Debug na toolbar. 4. Selecione a classe na caixa de dialogo e pressione Debug.

5. To

logo

tenha

adicionado

um

breakpoint,

perspectiva

Debug

abre

automaticamente, e a execuo suspensa. Perceba que o processo ainda esta ativo (no foi terminado) na Processes view. Outros threads ainda devem estar rodando.

26

O breakpoint agora esta verde, pois foi verificado pela Java VM. 6. No editor na perspectiva Debug, selecione a linha onde esta o breakpoint e no menu selecione Inspect.

A Variables view mostra os valores das variaveis no stack frame selecionado.

27

7. Pressione Step Over para executar a linha de cdigo selecionada.

Se o programa no terminou totalmente aps o termino do debugging, selecione Terminate no menu para o programa iniciado, na Processes view ou Debug view.

PLUGIN'S
Alm dos plug-ins como o JDT para editar, compilar e debugar aplicaes, outros plug-ins esto disponveis para suportar completamente o processo de desenvolvimento atravs de modelagem, automao de deployment, teste unitrio, teste de performance, controlador de verso e gerencia de configurao.

28

Dica: Adicionando novas aplicaes ao Eclipse

Para instalar novas aplicaes, simplesmente copie os plugins para dentro da pasta $ECLIPSE_HOME/plugins. Ser preciso reiniciar o Eclipse para tornar a nova aplicao "ativa". Dependendo do plugin uma nova perspectiva poder ser escolhida, sendo encontradas novas opes no menu e toolbar.

Lomboz
Esse plugin auxilia aos programadores Java realizarem build, teste e deploy das aplicaes Java nos Servidores de aplicao J2EE. Ele oferece uma srie de funcionalidades, tais como:

Editor de JSP com sintaxe highlighting e code assist Verificador de sintaxe JSP Wizards para gerao de modulos Web e Ejb Wizards para gerao de Ejb test clients Suporte a deployment de WAR e Ejb(Jar) Produtividade usando wizards e geradores de cdigo Desenvolvimento integrado de EJB 1.1 e 2.0 com Xdoclet (Session, Entity and Message Driven Beans)

29

Instalao

Execute o unzip do arquivo lomboz.zip para o diretrio <Eclipse_Home>

Ser criado um novo diretrio chamado com.objectlearn.jdt.j2ee no diretrio plugin Agora inicialize o Eclipse

Configurao

Caixa de dialogo no menu -Preferences e expanda o item Java> New Project. As configuraes devem estar igual a figura.

30

A maioria dos Applications Servers utilizam o compilador Java padro (javac), o mesmo localizado em tools.jar que vem com a distribuio padro do Java

o o

Enable JSP Syntax checking - Permite a compilao dos JSP's Server restart- Toda vez que for feito um novo deploy de um mdulo, o server ser reiniciado

Update server classpath and deployment parameters - O Lomboz verifica o classpath do projeto e as propriedades de deployment.

Use application server classpath - Utiliza o classpath definido na configurao do server para inicia-lo e no o classpath do projeto. Evita problemas de class loaders

31

Definindo o Application Server

Classpath variable name - O nome da varivel que ser usada para referenciar as java libraries

Classpath variable - O caminho que ser usado para armazenar a varivel. As java libraries sero um caminho relativo

Server Home Directory - O caminho para o diretrio de instalao do Application Server

32

Classpath Page

Java libraries que sero utilizadas para iniciar o Application Server Server Classpath utilizado para iniciar o Application Server Client path utilizado por aplicaes cliente (ex.: Ejb Test Clients )

33

Ativao
Adicionar aes, wizards e views para o Eclipse.

Selecione no menu 'Window>Customize Perspective...', expanda 'File>New' e marque todos os itens relacionados ao Lomboz.

Selecione no menu Window>Customize Perspective...', expanda 'Other' e marque 'Lomboz Actions'

Selecione no menu Window>Customize Perspective...', expanda 'Window>Show View' e marque 'Lomboz J2EE View'

34

Aps essas selees, ser adicionado um novo boto a toolbar

Novos wizards estaro disponveis no dialogo New Project e no item de menu New

Easy Struts
Esse plugin auxilia aos programadores Java na utilizao do framework Struts e seus componentes. Ele oferece uma srie de funcionalidades, tais como:

Prov um editor para o struts-config.xml Gerador de XSLT Suporte completo a mdulos Struts 1.1 Prove uma view para auxilio a qualquer Java Project com suporte a Easy Struts Suporte a Xdoclet

35

Instalao

Execute o unzip do arquivo org.easystruts.eclipse.zip para o diretrio <Eclipse_Home>

Ser criado um novo diretrio chamado com.cross.easystruts.eclipse no diretrio plugin

Agora inicialize o Eclipse

Configurao

36

Style

Action form class package - Nome do pacote que armazenar os forms do Struts Action form class suffix - Sufixo que ser acrescentado antes do nome do form quando este for criado

Action class package - Nome do pacote que armazenar as actions do Struts Action class suffix - Sufixo que ser acrescentado antes do nome da Action quando esta for criada

JSP form location - Todo arquivo JSP que for criado com o auxilio do wizard do Easy Struts sera armazenado nesse local

Struts 1.1

Add JARs - Adicionar as java libraries necessrias para o Struts Add TLDs - Adicionar as tld's necessrias para o Struts Base ActionForm class - Todo form que for criado estender essa classe Validate method - O nome do mtodo para executar validao no form

37

Base Action class - Toda action que for criada estender essa classe Request method - O nome do mtodo a ser acionado pela requisio ActionServlet class - O servlet para gerenciar as chamadas as actions

Validate struts-config.xml content

Valida o contedo do arquivo de configurao do Struts Write default values in struts-config.xml Caso queira adicionar valores padro quando esse arquivo for criado.
o o

Controller Plugin

38

XSLT stylesheet

Layouts utilizados para gerao automtica dos arquivos

o o o o o o

Action - Action class stylesheet ActionForm - ActionForm class stylesheet Exception - Exception class stylesheet Plugin - Plugin class stylesheet JSP JSP file stylesheet

O Easy Struts j prove layouts padro

Alterando o layout para gerao de arquivos JSP

Arquivo JspForm.xsl (fazendo um exemplo)

39

Ativao
Adicionar wizards para o Eclipse.

Selecione no menu 'Window>Customize Perspective...', expanda 'File>New' e marque todos os itens relacionados ao Easy Struts

40

Novos wizards estaro disponveis no item de menu New

XML Buddy
Ele oferece uma srie de funcionalidades, tais como:

Editor de XML Validador para XML Gerador de DTD Code assist Keyboard shortcuts Auxiliador para formatao

41

Instalao

Execute o unzip do arquivo para o diretrio <Eclipse_Home>

Ser criado um novo diretrio chamado com.objfac.xmleditor no diretrio plugin Agora inicialize o Eclipse Definio de cores dos elementos As outras opes podem ser mantidas

42

Ativao

Selecione no menu 'Window>Customize Perspective...', expanda 'File>New' e marque os itens DTD e XML Document

Novos wizards estaro disponveis no item de menu New

DBEdit
Ele oferece uma srie de funcionalidades, tais como:

Visualizador Tabelas Log Facilidade para manipulao de dados Editor SQL

43

Editor de Tabelas Importao/Exportao de dados Wizards para auxiliar na criao de tabelas, colunas, data types, chaves e constraints

Instalao

Execute o unzip do arquivo para o diretrio <Eclipse_Home> Ser criado um novo diretrio chamado dbedit.ui no diretrio plugin

Agora inicialize o Eclipse

Configurao
Manter as configuraes default

44

45

Drivers JDBC para conexo

Para realizar conexes, so necessrios Drivers JDBC que possibilitem o plugin a interagir com os Databases.

Obtenha o Driver JDBC especfico para o seu Database

o

Podem ser adicionados quantos Drivers forem necessrios

Selecione o SQL Driver Path atravs dos botes Add Jar ou Add Folder.
o

No caso do MySql selecione o arquivo mysql-connector-java-3.0.6-stablebin.jar, o qual deve ser obtido no site http://www.mysql.com

Ativao

Selecione no menu Window>Customize Perspective...', expanda 'Window>Open Perspective e marque DbEdit

46

Aps essa seleo, essa perspectiva estar disponvel na opo open Perspective

CONTROLE DE VERSO
O CVS um sistema que permite que grupos de pessoas trabalhem simultaneamente em grupos de arquivos como, por exemplo, manuais, apostilas, cdigos de programas ou dados dos pacotes RPM. utilizado um repositrio central com as verses mais recentes dos arquivos. Sendo possvel, a qualquer momento, criar uma cpia pessoal desses arquivos e, caso no futuro esses arquivos sejam atualizados, o CVS se encarregar de atualizar a sua cpia quando voc desejar faz-lo. Voc pode alterar os seus arquivos a vontade. Se novas verses destes arquivos forem colocadas no CVS nesse perodo de modificao, a atualizao tentar o mximo possvel combinar as alteraes do repositrio com as feitas localmente por voc. Caso haja coincidncia nas alteraes e algum conflito seja criado pelas suas mudanas e as j em efeito no repositrio, o CVS lhe avisar e voc dever resolver este problema na sua cpia. Aps resolvido o problema voc poder, ento, enviar os arquivos para o repositrio. Quando voc tentar enviar um arquivo para o repositrio, o CVS verificar se a verso que voc possui a mais recente. Caso no seja, voc receber uma notificao do CVS, dever atualizar a sua cpia, resolver quaisquer conflitos que venham a surgir e, s ento, enviar os arquivos para o repositrio. Com o CVS cada desenvolvedor trabalha em seu prprio diretrio, com suas prprias verses dos arquivos e o sistema se encarrega de juntar as verses espalhadas numa s, contemplando todas as mudanas feitas pelos diversos desenvolvedores.

47

Alguns conceitos

Um repositrio um diretrio com todos os arquivos e subdiretrios do projeto. Adicionalmente, contm arquivos criados pelo programa CVS para o gerenciamento das verses. Existe tambm o conceito de verso, tag e release, onde todo arquivo tem uma verso que automaticamente definida pelo CVS, a partir do qual podese recuperar o histrico de mudanas. Um tag um nome simblico dado a uma determinada verso do projeto, pode ser usado para delimitar etapas do desenvolvimento de um projeto. Um release uma verso definitiva de todos os arquivos do projeto.

Um branch (ramo) usado para dividir um projeto. Normalmente existe o ramo mestre e os ramos secundrios. O ideal que seja criado uma ramificao (branch) a cada mudana significativa ou alterao que v ser impactante no processo de desenvolvimento (e.g. migrao de cdigo procedural para cdigo orientado a objetos). Outro bom motivo para a criao de uma ramificao a manuteno de cdigo antigo, ou seja, se o programa est na verso 5.0 e existe usurios com problemas na verso 4.2, ser preciso dar manuteno naquele cdigo antigo e mant-lo sob o controle de verses.

Eclipse e CVS - Alguns passos a serem seguidos

O Eclipse vem com um plug-in padro para trabalhar com o CVS, o open source Concurrent Versions System para controle de fonte. O plug-in Team se conecta ao CVS server, permitindo que os membros da equipe de desenvolvimento trabalhem com um conjunto de arquivos fontes sem passar por cima de alteraes efetuadas por outros da equipe. A capacidade de dar suporte ao desenvolvimento em equipe, no somente para um desenvolvedor sozinho, uma ferramenta importantssima do Eclipse, principalmente quando se trata de integrao. Com esse cliente grfico para o CVS, o que torna fcil o gerenciamento de projetos no repositrio de verses.

48

Criando um novo repositrio

Abra a perspectiva 'CVS Repository Exploring' Escolha 'New -> Repository Location...' na view 'CVS Repositories'. O dialogo 'Add CVS Repository' aparecer.

Digite as informaes para a conexo nos campos relacionados. Host: O host que roda o servidor. Repository Path: O repositrio que ser utilizado no servidor. Authentication: O servidor pode ser configurado para utilizar autenticao dos usurios.

Connection: Protocolo e porta que devem ser utilizados para conectar com o servidor.

Selecione o checkbox 'Validate Connection on Finish'. Pressione Finish. Se todas as informaes foram digitadas corretamente, aparecer o repositrio.

Compartilhando um projeto

Abra a perspectiva que tem a viso geral do projeto (ex.: perspectiva Java). Selecione o projeto a ser compartilhado e escolha 'Team -> Share Project...' no menu. O dialogo 'Share Project' aparecer.

49

Selecione o repositrio que o projeto ser inserido

Pressione 'Next' . Mantenha selecionado o radiobutton 'Use project name as module name'. Pressione 'Next' . Pressione 'Finish'. O projeto mostrado na view 'Synchronize'

Escolha 'Add to Version Control' no menu sobre o projeto. Escolha 'Commit' no menu sobre o projeto. O dialogo para digitar um comentrio aparecer.

Digite um comentrio. Pressione 'OK'. O projeto esta agora no repositrio escolhido.

50

Abra a perspectiva 'CVS Repository Exploring'. Escolha 'Refresh View' no menu na view 'CVS Repositories'. O projeto aparecer nessa view agora.

Criando uma verso

Altere algo em um arquivo '.java', ex.: adicione um comentrio . Salve o arquivo (Ctrl + S). Na view 'Package Explorer' escolha 'Team -> Synchronize with Repository' no menu sobre o projeto.

A view 'Synchronize' aparecer. Escolha 'Commit' no menu sobre o arquivo '.java'. Adicione um comentrio. Pressione 'OK'. Foi apenas criada uma outra verso do arquivo .java'.

Gerenciando as verses de um recurso

Escolha 'Team -> Show in Resource History' no menu sobre o recurso, nesse caso o arquivo '.java'.

A view 'CVS Resource History', aparecer. A lista das verses do recurso escolhido. As verses correntes so marcadas com '*'.

Substituindo a verso corrente por outra

Escolha 'Get Sticky Revision' no menu sobre a verso que deve substituir a verso corrente.

Leia o aviso. Pressione 'OK'. A verso corrente foi alterada.

51

Versionando um projeto

Escolha o projeto a ser versionado na view 'CVS Repositories' view. (perspectiva CVS).

Projetos tambm podem ser versionados a partir do workspace. Escolha 'Tag as Version' no menu sobre o projeto. Digite a informao sobre a verso ex. 'Alpha'.

Pressione 'OK'. A nova verso pode ser vista em 'Versions' no repositrio. No esquea de atualizar!

Adicionando a verso ao workspace

Selecione a verso a ser "carregada" na view 'CVS Repositories'. (perspectiva CVS). Escolha 'Check Out As Project'
o

Para projetos que j foram criados no Eclipse.

'Check Out As'

o

Para projetos que no foram criados nos Eclipse. necessrio criar um novo projeto.

'Check Out Into'

Utilizar uma cpia de um projeto j existente no Workbench.

52

Eclipse e CVS
Uso bsico do CVS com Eclipse.

O Eclipse contm um cliente grfico para o CVS, o que torna fcil o gerenciamento de projetos no repositrio de verses. Pr-requisitos: Um servidor CVS instalado e configurado. Criando um novo repositrio
1. Abra a perspectiva 'CVS Repository Exploring'.

2. Escolha 'New -> Repository Location...' na view 'CVS Repositories'.

O dialogo 'Add CVS Repository' aparecer. 3. Digite as informaes para a conexo nos campos relacionados.

53

The concrete data is dependent on the CVS server ('Server') being used.

Host: O host que roda o servidor.

Repository Path: O repositrio que ser utilizado no servidor.

Authentication: O servidor pode ser configurado para utilizar autenticao dos usurios.

Connection: Protocolo e porta que devem ser utilizados para conectar com o servidor. 4. Selecione o checkbox 'Validate Connection on Finish' :

5. Pressione Finish. Se todas as informaes foram digitadas corretamente, aparecer

o repositrio:

54

Compartilhando um projeto
1. Abra a perspectiva que tem a viso geral do projeto (ex.: perspectiva Java). 2. Selecione o projeto a ser compartilhado e escolha 'Team -> Share Project...' no menu:

O dialogo 'Share Project' aparecer.

3. Selecione o repositrio que o projeto ser inserido:

4. Um novo repositrio pode ser criado aqui 'on the fly'. 5. Pressione 'Next'.

55

6. Mantenha selecionado o radiobutton 'Use project name as module name':

7. Pressione 'Next'.

8. Pressione 'Finish'. O projeto mostrado na view 'Synchronize':

56

9. Escolha 'Add to Version Control' no menu sobre o projeto:

10. Escolha 'Commit' no menu sobre o projeto:

O dialogo para digitar um comentrio aparecer. 11. Digite um comentrio:

12. Pressione 'OK'.

O projeto esta agora no repositrio escolhido. 13. Abra a perspectiva 'CVS Repository Exploring'.
14. Escolha 'Refresh View' no menu na view 'CVS Repositories':

57

O projeto aparecer nessa view agora:

Verses CVS - CRIANDO UMA VERSO:

1. Altere algo no arquivo 'Test.java', ex.: adicione um comentrio. 2. Salve o arquivo (Ctrl + S).

58

3. Na view 'Package Explorer' escolha 'Team -> Synchronize with Repository' no menu sobre o projeto:

A view 'Synchronize' aparecer. 4. Escolha 'Commit' no menu sobre o arquivo 'Test.java':

5. Adicione um comentrio:

59

6. Pressione 'OK'.

Foi apenas criada uma outra revision do arquivo 'Test.java'.

GERENCIANDO AS VERSES DE UM RECURSO:

1. Escolha 'Team -> Show in Resource History' no menu sobre o recurso, nesse caso

o arquivo 'Test.java':

A view 'CVS Resource History', aparecer. A lista das verses do recurso escolhido:

60

As verses correntes so marcadas com '*'.

Substituindo a verso corrente por outra:

1. Escolha 'Get Sticky Revision' no menu sobre a verso que deve substituir a verso corrente:

Leia o aviso:

2. Pressione 'OK'.

A verso corrente foi alterada:

61

VERSIONANDO UM PROJETO
1. Escolha o projeto a ser versionado na view 'CVS Repositories' view. (perspectiva CVS)

Projetos tambm podem ser versionados a partir do workspace. 2. Escolha 'Tag as Version' no menu sobre o projeto.

3. Digite a informao sobre a verso ex. 'Alpha':

4. Pressione 'OK'.
5. A nova verso pode ser vista em 'Versions' no repositrio:

No esquea de atualizar!

62

ADICIONANDO A VERSO AO WORKSPACE:

1. Selecione a verso a ser "carregada" na view 'CVS Repositories'. (perspectiva CVS). 2. Escolha 'Check Out As Project' no menu sobre o projeto:

Caso j exista esse projeto no workspace, ser perguntado se deseja sobrescrever os arquivos existentes.

63

Eclipse e Junit
Atravs do uso do Eclipse com o Junit, torna-se fcil desenvolver cdigos de boa qualidade. 1. Download JUnit em www.junit.org. Descompacte src.jar a partir do arquivo .zip. 2. Crie um novo projeto Java Junit. 3. Escolha 'File->Import-> Zip file-> Browse-> src.jar .

4. Selecione a pasta src (Pressione o boto 'Browse'):

5. Pressione Finish.

64

6. Suporte opcional ao JavaDoc: Selecione o caminho para o JavaDoc Path em 'Preferences':

e selecione a documentao em junit3.8.1.zip :

O local no qual o arquivo .zip foi extrado.

Configurando o projeto
1. Adicione o projeto Junit ao 'Java build path' na 'Properties' do projeto:

65

O primeiro teste
O primeiro teste para uma instancia da classe AmpelModell que deve estar no estado vermelho. O estado dessa instancia acessado por trs mtodos getters, getRed(), getYellow() e getGreen() cada um retornando valores do tipo boolean. 1. Criar uma nova classe AmpelModellTest:

66

2. Selecione junit.framework.TestCase as superclass ('Browse'):

3. Pressione Finish. Eclipse cria uma nova classe:

Mtodos que contenham os testes sero adicionados. JUnit procura automaticamente por mtodos que iniciam com 'test': public class AmpelModellTest extends TestCase { public void testNewAmpel() { AmpelModell a = new AmpelModell(); assertTrue(a.getRed()); assertFalse(a.getYellow()); assertFalse(a.getGreen()); } }

67

public class AmpelModell { public boolean getRed() { return false; } public boolean getYellow() { return false; } public boolean getGreen() { return false; } }

Executando o primeiro teste:

1. Escolha 'Run As->Unit Test' no menu:

2. A view Junit aparecer. A barra vermelha indica que algo deu errado:

68

 mostrado o total dos testes executados, as excees lanadas e o testes que falharam. To logo algum teste falhe, a barra de status aparecer vermelha. A rea do meio da view Junit tem duas abas.
o

'Failures' Lista os testes que falharam.

'Hierarchy' Mostra a viso geral de todos os testes que foram executados e extremamente usual quando executando um conjunto de testes(TestSuite).

A view abaixo mostra o 'Failure Trace'. Pode ser visto a call stack da falha do teste. Um

69