Grupo de Usurios Java

http://www.guj.com.br

Eclipse com Tomcat e Struts

Filipe Gaspar Guimares
Este Tutorial visa usurios iniciantes no uso do Tomcat e do Struts dentro do Eclipse.

ndice
- Introduo Publico Alvo Breve comentrio do Tutorial - Pr-condies para iniciar o Tutorial Downloads de Arquivos necessrios para o Tutorial - Instalando o Ambiente Instalao dos recursos necessrios para o Tutorial. (Passo a Passo) - Configurao do Eclipse Configurao dos recursos instalados dentro do Eclipse. (Passo a Passo) - Trabalhando sobre as perspectivas do Eclipse Perspectiva Java, com a criao de novos projetos e recursos. Perspectiva Debug, com a criao de breakpoint e criao de expresses de teste. - Acrescentando Struts a nossa Aplicao Seguindo a idia da Perspectiva Java com a importao de recursos do Struts (Struts Blank e Struts Validator). - Sugesto de tutorial para complementao de contedo Sugesto de um tutorial complementar - Concluso

Introduo
Este Tutorial visa usurios iniciantes no uso do Tomcat e do Struts dentro do Eclipse, para isso, uma das caractersticas que buscamos durante a produo do mesmo, foi detalhar ao maximo, para permitir o completo entendimento do usurio alvo, alem disso buscamos demonstrar todos os procedimentos com a dinmica do passa a passo, com dicas e detalhes fundamentais. Alem disso o tutorial permitir a criao de um ambiente altamente produtivo para o desenvolvimento de aplicaes para WEB, com a utilizao do Eclipse, Tomcat e Struts, estaremos tambm fazendo referencia a outros tutoriais e artigos para melhor entendimento do leitor, no podemos esquecer de dizer que todas as tecnologias que estaro sendo utilizado so totalmente free, ainda com a vantagem de serem muito fcil de serem instaladas e usadas.

Pr-condies para iniciar o Tutorial

Afim de no termos parada durante o tutorial para realizao de downloads, vo abaixo todos os arquivos necessrios para o tutorial. JDK - Kit de Desenvolvimento de Software (SDK) Java 2 Platform Standard Edition (J2SE) necessrio para desenvolvimento de nossas aplicaes. Podero ser encontrados no seguinte endereo: http://java.sun.com/ Eclipse - Ambiente que utilizaremos para o desenvolvimento das nossas aplicaes. interessante que seja utilizado a verso 3 ou suas derivaes, j que a verso mais atual, pode ser encontrado no seguinte endereo: http://www.eclipse.org/downloads/index.php

Dicas e mirror Brasileiro

- Caso voc j tenha uma verso que no a 3, ser necessrio adaptao nas verses dos plugins - Dica de Mirror Brasileiro: http://web.teccomm.les.inf.puc-rio.br/eclipse/eclipseDownloadIndex.html - Dica para quem quer revirar o eclipse, mas no muito bom em ingls, neste site voc pode baixar a traduo do Eclipse 2.x

Grupo de Usurios Java http://www.guj.com.br Pgina 1

Grupo de Usurios Java

http://www.guj.com.br

Tomcat - E o conteiner que utilizaremos para as nossas aplicaes WEB. interessante que seja utilizado a verso 5 ou superior, j que da 4 para a 5 houve algumas mudanas interessantes no gerenciamento do arquivo de configurao, ele pode ser encontrado no seguinte endereo: http://jakarta.apache.org/site/binindex.cgi

Dicas e mirror Brasileiro

- Dica de Mirror Brasileiro: http://apache.usp.br/jakarta/tomcat-5/ Escolha uma verso derivada da 5 e dentro da pasta bin, baixe o arquivo executvel do Tomcat (jakarta-tomcat-5.X.XX.exe)
Struts - E o framework que aborda conceitos de MVC (Model-View-Controller) e Designer Patterns. O nosso tutorial aplicado apenas para a verso 1.1 ou superior, ele pode ser encontrado no seguinte endereo: http://struts.apache.org/download.cgi

Dica e mirror Brasileiro

- Dica de Mirror Brasileiro: http://apache.usp.br/struts/binaries/ Escolha uma verso, baixe o arquivo zip (jakarta-struts-X.X.zip)
Sysdeo (Plugins do Tomcat para o Eclipse) - E o plugins responsvel pela integrao do Tomcat com o Eclipse, ele pode ser encontrado no seguinte endereo: http://www.sysdeo.com/eclipse/tomcatPlugin.html

Dica
- Escolha a verso do plugin conforme a verso do Eclipse descrito no quadro, na coluna do comentrio.

Instalando o Ambiente
1. 2. Instale o JDK Instalao Tpica Configure o Path Muito Importante a. Alguns casos de configurao Windows 2000 ou superior: 1. Acesse "Painel de Controle" / Sistema / aba "Avanado". (Figura 1) 2. Pressione o boto "Variveis de ambiente". No grupo "Variveis do sistema", crie uma nova varivel JAVA_HOME, ou edite se j existente, definindo como valor o caminho da pasta de instalao. Exemplo: C:\j2sdk1.5 (Figura 2) 3. Edite a varivel path e acrescente ao inicio do texto j existe o texto seguinte: %JAVA_HOME%\bin; (no esquecer do ponto e virgula) Windows 9x / NT 1. Edite o arquivo autoexec.bat, para incluir a linha: Exemplo: set JAVA_HOME=C:\j2sdk1.5 Linux / Unix: 1. Edite o profile do usurio (para sh: ~/.profile) ou global do sistema (/etc/profile), para incluir a linha: Exemplo: JAVA_HOME=/usr/j2sdk1.5; export JAVA_HOME

Grupo de Usurios Java http://www.guj.com.br Pgina 2

Grupo de Usurios Java

http://www.guj.com.br

Figura 1.

Figura 2.

Observao
- Caso o item 2 no seja feito, existe a possibilidade que o Tomcat no interprete o Java
3. 4. Instale o Tomcat. Instalao Tpica. Lembre-se do login e do password do administrador do Tomcat, para ser utilizado na configurao do Plugin do Tomcat no Eclipse. Verifique a instalao do Tomcat a. Start o servio do Tomcat b. Abra o browser e digite na barra de endereo o seguinte:
http://localhost:8080

c.

Dever aparecer a seguinte imagem de abertura (Figura 3)

Grupo de Usurios Java http://www.guj.com.br Pgina 3

Grupo de Usurios Java

http://www.guj.com.br

Figura 3. 5. 6. Instalao do Eclipse s descompactar o arquivo de zip e pronto, geralmente descompactado na raiz. Ex: c:\eclipse\, depois crie um atalho para a rea de trabalho Instalao do Plugin a. Descompacte o arquivo zip b. E coloque o diretrio com.sysdeo.eclipse.tomcat_x.x.x no diretrio de plugins do eclipses c:\eclipse\plugins\ c. Pronto reinicie o eclipse

Dica
- Em caso de duvida na instalao do Plugin, existe um Tutorial muito bom de Franklin Samir em flash no seguinte endereo: http://www.portaljava.com/home/modules.php?name=Content&pa=showpage&pid=22
7. Instalao do Struts a. Descompacte o arquivo zip na raiz (c:\jakarta-struts-x.x\) b. Pronto

Configurao do Eclipse
Configurando o JRE O eclipse usa normalmente um JRE - Java Runtime Environment (Ambiente Runtime de Java), e no um JDK cheio, para configurar este JRE no eclipse faa o seguinte: 1. 2. 3. Entre no Eclipse No menu Window/Preferences/Java/Installed (Figura 4) Caso no esteja instalado o JRE com o JDK correto, selecione Add para selecionar o correto. (Figura 4)

Figura 4.

Grupo de Usurios Java http://www.guj.com.br Pgina 4

Grupo de Usurios Java

http://www.guj.com.br

4. 5. 6.

No item JRE home directory, selecione o diretrio que voc instalou o JDK, automaticamente carregara as bibliotecas necessrias para a configurao do JRE. (Figura 5) De um nome para a sua JRE no item JRE name e OK. (Figura 5) Pressione OK para confirmar a criao da nova JRE. (Figura 5)

Figura 5. 7. Selecione a JRE que ser utilizada no Eclipse. (Figura 6)

Figura 6. Configurando o Plugin do Tomcat (Sysdeo plug-in) Para que funcione o Tomcat dentro do Elipse necessrio que configuremos o plugin com os dados de localizao dos Tomcat e do JDK, para isso, siga os seguintes passos: 1. 2. 3. Entre no Eclipse No menu Windows/Preferences/Tomcat Selecione a verso do Tomcat instalado e a localizao dos arquivos do mesmo. (Figura 7)

Grupo de Usurios Java http://www.guj.com.br Pgina 5

Grupo de Usurios Java

http://www.guj.com.br

Figura 7. 4. No item Tomcat Manager App, que esta abaixo de Tomcat, necessrio para fim administrativo, que sejam preenchidos os campos do Manager, username e password, cadastrados na instalao do Tomcat. (Figura 8)

Figura 8. 5. No item JVM Settings, abaixo do Tomcat, vamos selecionar a JVM (Java Virtual Machine) que utilizaremos nas nossas aplicaes com o Tomcat. (Figura 9)

Figura 9.

Grupo de Usurios Java http://www.guj.com.br Pgina 6

Grupo de Usurios Java

http://www.guj.com.br

Configurando da Barra de Ferramenta do Tomcat no Eclipse Quando fomos comear a desenvolver sistemas para WEB, teremos que fazer a seguinte escolha, ativar o Tomcat dentro ou fora do eclipse. A diferena entre os dois modos , que se quisermos usar o eclipse eliminar erros de caractersticas em jsp-pginas ou classes de Java, Tomcat dever ser comeado dentro do eclipse. Vantagem esta, torna a escolha acima algo resolvido. Primeiramente estaremos fazendo a configurao da Barra de Ferramenta do Tomcat dentro do elipse, pode ocorre que ela j esteja ativada. 1. Selecione a perspectiva de Java. (Figura 10)

Figura 10. 2. 3. 4. 5. Selecione menu principal Window/Customize Perspective. Selecione a aba commands (Figura 11) Marque o checkbox do item Tomcat na lista de command groups (Figura 11), para comear Tomcat no menu e na barra da ferramenta.

Figura 11.

Grupo de Usurios Java http://www.guj.com.br Pgina 7

Grupo de Usurios Java

http://www.guj.com.br

Figura 12. Se voc comear agora o Tomcat, voc ver a sada das linhas de comando do Tomcat no console do eclipse: (Figura 13)

Figura 13.

Trabalhando sobre as perspectivas do Eclipse

Conhecendo o ambiente Eclipse Perspectiva Java Estaremos fazendo um reconhecimento sobre o ambiente do Eclipse para isso iniciaremos com a criao de um projeto com a utilizao do Tomcat para explicamos alguns recursos. 1. 2. 3. 4. Entre no Eclipse File/New/Project Selecione Java/Tomcat Project. (Figura 14) Selecione next. (Figura 14)

Grupo de Usurios Java http://www.guj.com.br Pgina 8

Grupo de Usurios Java

http://www.guj.com.br

Figura 14. 5. 6. Digite o nome do Projeto Tom_exemplo. (Figura 15) Pressionar a tecla Next . (Figura 15)

Figura 15

Grupo de Usurios Java http://www.guj.com.br Pgina 9

Grupo de Usurios Java

http://www.guj.com.br

Figura 16 Nesta tela configurada a propriedade que permitir a indicao da pasta do nosso projeto para serem referenciados pelo Tomcat. (Figura 16) A seleo "Can update server.xml file" importante. Tomcat usa este arquivo server.xml, arquivo de configurao, para vrias finalidades. Uma delas fazer referencia aos diversos projetos que no esto colocados no diretrio padro webapps de Tomcat, permitindo assim que o seu projeto seja referenciado para a execuo do Tomcat. Deixando este item selecionado far com que seja adicionada uma referencia do diretrio do seu projeto atual, ao arquivo server.xml. Aps termo terminado de criar o projeto Tom_exemplo poderemos conseqentemente encontrar a seguinte referencia no arquivo server.xml. C:\...\Apache Software Foundation\Tomcat 5.0\conf\server.xml
<Context path="/Tom_exemplo" reloadable="true" docBase="C:\eclipse 3\workspace\Tom_exemplo" workDir="C:\eclipse 3\workspace\Tom_exemplo\work" />

7. 8.

Pressionar a tecla Final para concluir a criao do projeto com o Tomcat. (Figura 16) Reinicie o servio do Tomcat, para que seja atualizada as informaes do server.xml. (Figura 17)

Figura 17. Conceitos sobre estruturas e telas do Eclipse. Sobre as estruturas dos arquivos O trajeto (atributo) o nome que voc usa na URL para dirigir-se aplicao. O atributo reloadable escolhe o recarregamento dinmico da aplicao, mas sobre este assunto, discutiremos mais adiante. DocBase diz a Tomcat onde encontrar a aplicao, e o workDir uma posio para que os servlets sejam usados. Na figura 18, mostra um exemplo do projeto Tom_exemplo no eclipse:

Grupo de Usurios Java http://www.guj.com.br Pgina 10

Grupo de Usurios Java

http://www.guj.com.br

Figura 18. Se olharmos no diretrio Workspace do eclipse, veremos a pasta do projeto Tom_exemplo, com suas ramificaes, tais ramificaes constituindo uma estrutura para aplicaes WEB, do qual o eclipse criou automaticamente. (Figura 19)

Figura 19. Os arquivos do projeto Tom_exemplo devem ser colocados nestes diretrios. (Figura 19)

Html e arquivos JSP Arquivos Fontes (Java) Arquivos de Classe (Java) Arquivos .Jar Tabela

Tom_exemplo WEB-INF/src WEB-INF/classes WEB-INF/lib 1.

Cada arquivo tem seu lugar, assim sendo, quando o eclipse compila uma classe de Java sabe que deve ser posto no diretrio das classes e assim respectivamente os demais arquivos. (Tabela 1) Debugando Paginas JSP Perspectiva Java e Debug Estaremos criando um arquivo exemplo em JSP na Perspectiva Java e realizando um Debug sobre a perspectiva Debug. Seguindo o mesmo projeto do item anterior o Tom_Exemplo, criaremos na rea de trabalho do Package Explorer um arquivo JSP, seguindo os seguintes passos: 1. Boto direito do mouse sobre o nome do projeto (Tom_exemplo), New/File (Figura 20)

Grupo de Usurios Java http://www.guj.com.br Pgina 11

Grupo de Usurios Java

http://www.guj.com.br

Figura 20. 2. 3. Coloque o nome do arquivo de hello.jsp (Figura 20) Pressione a tecla Finish. (Figura 20)

Figura 21. 4. Digite no arquivo hello.jsp, o seguinte texto. (Figura 21)

<% String s = "Hello World!"; out.println(s); %>

5. 6.

Salve o arquivo. Abra um Browser e digite a seguinte URL:

http://localhost:8080/Tom_exemplo/hello.jsp

Figura 22. pronto, esta funcionando a sua aplicao JSP rodando no Tomcat do Eclipse (Figura 22). Vamos tentar agora debug este cdigo.
Grupo de Usurios Java http://www.guj.com.br Pgina 12

Grupo de Usurios Java

http://www.guj.com.br

7.

Volte para o Eclipse.

Gostaramos antes de comeamos os procedimentos para dizer: no faremos o debug direto no arquivo JSP, j que este plugin no nos permite tal ao, faremos o debug no arquivo gerado da compilao do servlet Java gerado do JSP, que se encontra na pasta Work de sua aplicao. Parece algo de outro mundo, mas mais simple do que parece. 8. Com o boto direito do mouse sobre a pasta work, selecione em refresh para atualizar os dados da pasta. (Figura 23)

Figura 23. 9. Podemos agora abrir o arquivo gerado do JSP na pasta Work e fazer um Breakpoint sobre a linha out.println(s) , para fazer isso, basta dar um duplo-click do lado esquerdo da linha de comando. (Figura 24)

Figura 24. 10. O circulo azul marca o limite do BreakPoint. Agora volte para o seu browser e atualize-o (arquivo hello.jsp), isto abrir o eclipse na perspectiva de Debug, e processar, s parando no limite do Breakpoint. (Figura 25)

Grupo de Usurios Java http://www.guj.com.br Pgina 13

Grupo de Usurios Java

http://www.guj.com.br

Figura 25. importante que conheamos esta tela de perspectiva de Debug, muito similar a vrios outros ambientes de desenvolvimento, com a tela de variveis, onde mostra a variao dos valores das variveis conforme a seqncia do debug, e a tela do cdigo, onde podemos debugar linha a linha a partir do breakpoint. (Figura 25) A tela de Variveis possui todas as variveis da aplicao em debug, mas podemos alterar isso, podemos mostra apenas as variveis que desejamos ou at mesmo criar expresses de clculos entre outros, na tela de Expresses, para isso vamos fazer o seguinte. 11. Com o boto direto mouse sobre a varivel s de nossa aplicao, selecione Watch (Figura 26)

Figura 26 Ser aberto uma tela de Expresso que uma tela mais limpa e onde podemos criar expresses do nosso debug. (Figura 27)
Grupo de Usurios Java http://www.guj.com.br Pgina 14

Grupo de Usurios Java

http://www.guj.com.br

Figura 27 Criaremos um exemplo de expresso que tenha o seguinte resultado Hello World! Hello World!, para isso vamos fazer o seguinte; 12. Com o boto direto mouse sobre a area do menu Expressions, selecione Add Watch Expression (Figura 27)

Figura 28 13. Para fazer temos o resultado Hello World! (Figura 29) Fcil e Simples. Hello World!, basta fazer a seguinte expresso:

Figura 29 Pronto, temos o seguinte resultado. (Figura 30)

Grupo de Usurios Java http://www.guj.com.br Pgina 15

Grupo de Usurios Java

http://www.guj.com.br

Figura 30

Acrescentando Struts a nossa Aplicao

Quando falamos de Struts estamos falando de um Framework que aborda conceitos de MVC (ModelView-Controller) e design pattern. Poderiamos comear a entrar no mrito de explicar seus conceitos e abordagem, mas vejamos que existe outros tutoriais dedicados a este assunto, por esta razo nos dedicaremos apenas a mostra como poderemos acrescentar struts a nossa aplicao dentro do Eclipse. Caso desejemos um tutorial que aborde tais conceitos poderemos indicar o seguinte (Tutorial muito bom):

Dica de Tutorial
- Tutorial que aborda conceitos de Struts Struts Tutorial - Welington B.Souza http://www.portaljava.com.br/home/modules.php?name=Content&pa=showpage&pid=63
StrutsBlank 1. 2. 3. Crie um novo projeto Tomcat com o nome de StrutsBlank Selecione File/Import (Figura 32) Selecione Zip File e Next (Figura 32)

Figura 32 4. Utilizado o Browse para selecionar o arquivo struts-blank.war que esta localizado no C:\jakartastruts-1.1\webapps\. Caso o seu eclipse no permita que selecione o arquivo por cauda da extenso war, esto ser necessrio forar o caminho, no campo From zip file: digite o caminho C:\jakarta-struts-1.1\webapps\struts-blank.war e click no centro da tela. (Figura 33)

Grupo de Usurios Java http://www.guj.com.br Pgina 16

Grupo de Usurios Java

http://www.guj.com.br

Figura 33 5. Aperte a tecla Finish para concluir o processo de Importao. (Figura 33)

Neste momento foram criados os arquivos e pastas necessrios para darem suporte a aplicao, incluindo diretorios, bibliotecas e arquivos necessrios a configurao. Somente uma coisa necessita ser mudada: diretrio que conter um recurso application.properties chamado arquivo de mensagem. ficar situado em WEB-INF/classes/resources, mas tambm em WEB-INF/src/Java/resources. Desde que o eclipse saiba que os arquivos fontes do Java sero colocados no diretrio WEB-INF/src e as classes em WEB-INF/casses, criar assim um diretrio novo das classes que se chamar Java/resources. Conseqentemente teremos agora application.properties em trs lugares.

Figura 33 Mas para resolver este problema, siga os seguintes passos: 6. Com o boto direito do mouse sobre o nome do projeto, selecione propriedades/Java Build Path/Source. (Figura 34)

Grupo de Usurios Java http://www.guj.com.br Pgina 17

Grupo de Usurios Java

http://www.guj.com.br

Figura 34 7. Edite o Item StrutsBlank/WEB-INF/src para StrutsBlank/WEB-INF/src/java ou adicione o item StrutsBlank/WEB-INF/src/Java e exclua o item StrutsBlank/WEB-INF/src. (Figura 35)

8. 9.

Figura 35 Caso, aps, termos criado o novo projeto e no tenhamos reiniciado o servio do Tomcat, faamos agora. Abra um Browser e digite a seguinte URL:
http://localhost:8080/StrutsBlank/

Figura 36. No campo da URL voc pode ver que os suportes processaram a ao do Welcome. (Figura 36). Struts-validator Uma aplicao mais complexa do Struts 1. 2. 3. 4. Crie um novo projeto Tomcat com o nome de struts-validator Selecione File/Import. Selecione Zip File e Next. Digite no campo From zip file: C:\jakarta-struts-1.1\webapps\struts-validator.war e click no centro da tela.

Observe que vrios arquivos de biblioteca esto sinalizados com erro. (Figura 37)

Grupo de Usurios Java http://www.guj.com.br Pgina 18

Grupo de Usurios Java

http://www.guj.com.br

Figura 36. Estes erros desaparecero quando adicionarmos os diretrios de suporte ao classpath. Faremos isso agora. 5. 6. Clique com o boto direito do mouse sobre o nome do projeto, selecione propriedades/Java Build Path/Libraries. (Figura 37) Selecione Add JARs

Figura 37. 7. 8. Selecione Todos os arquivos de biblioteca dentro de struts-validator/WEB-INF/lib/*. (Figura 38) OK e em seguida Ok.

Grupo de Usurios Java http://www.guj.com.br Pgina 19

Grupo de Usurios Java

http://www.guj.com.br

Figura 38. 9. Agora reiniciaremos o servio do Tomcat, para atualizar os arquivos de biblioteca. 10. Abra um Browser e digite a seguinte URL:
http://localhost:8080/StrutsValidation/

Na pgina que mostrada, voc pode tentar diversas das caractersticas do Validator disponveis nos suportes. Note, que, este projeto mais "Vida Real" do que os outros usados neste tutorial. Agora, vamos testar seu cdigo, usando um breakpoint. 11. Marque um breakpoint na classe MultiRegistrationAction, conforme a figura 39.

Figura 39. 12. Abra um NOVO Browser e digite a seguinte URL:

http://localhost:8080/StrutsValidation/

13. Click no item Multi-page Registration Form. (Figura 40)

Grupo de Usurios Java http://www.guj.com.br Pgina 20

Grupo de Usurios Java

http://www.guj.com.br

Figura 40. 14. Preencha o Formulrio conforme o modelo abaixo. (Figura 41) 15. Quando voc click no Save, vai disparar o Breakpoint. (Figura 41)

Figura 41. Pode reparar no item info = RegistrationForm, os item do Formulrio digitados no Formulrio. (Figura 42)

Figura 42. Se mudarmos algo na classe MultiRegistrationAction e salva, veremos o Tomcat recarregar diversos arquivos. No caso deste exemplo, o arquivo XML do Validator. Isto no quer dizer que toda vez que houver mudanas far com que haja um reload. Se mudarmos o config, teremos que reiniciar o Tomcat manualmente.

Grupo de Usurios Java http://www.guj.com.br Pgina 21

Grupo de Usurios Java

http://www.guj.com.br

Sugesto de Tutorial para Complementao de Contedo

Este Tutorial tentou mostrar de forma superficial o contedo do Eclipse com Tomcat e Struts, indicamos que sempre h a necessidades de material de comparao, de aprofundamento e at mesmo complementar, com este propsito. Para quem se interessou pelo assunto de Struts, indicaramos como material complementar o seguinte Tutorial: Struts Tutorial - Welington B.Souza http://www.portaljava.com.br/home/modules.php?name=Content&pa=showpage&pid=63

Concluso
Podemos concluir que boas ferramentas agregadas em uma nica, fazem com que a capacidade de produo e qualidade dos nossos sistemas venham ganha um novo status no que diz respeito qualidade e avano. Por fim, desejo que tenham gostado deste Tutorial que possamos sempre esta contribuindo para a agregao do conhecimento dentro das comunidades Virtuais. Filipe Gaspar Guimares (filipegg@yahoo.com.br) Bacharel em Sistemas de Informao e atualmente aluno do Curso de Ps-graduao em Projeto e Desenvolvimento de Sistema WEB.

Grupo de Usurios Java http://www.guj.com.br Pgina 22