Ambiente de Desenvolvimento de Relatrios

Ferramentas Necessrias: JDK 1.6.* iReport 3.0.0 Eclipse 3.4 (+ plugins) Tomcat 6.0.18 (+ bibliotecas especificas) Ant 1.7.1 (ou superior)

1 Instalando JDK 1.6

Linux
sudo apt-get update sudo apt-get install sun-java6-jdk java -version (para verificar a verso. Deve ser 1.6.*)

Depois de instalado, preciso exportar uma variavel de ambiente com a localizacao de onde o java foi instalado. vim /etc/profile Insira uma linha com o comando: export JAVA_HOME = DIRETORIO (Ex.: /usr/lib/jvm/java...) necessrio Reiniciar. Para mais detalhes, sugiro verificar nesse site: http://www.vivaolinux.com.br/dica/Java-no-Ubuntu-Linux-Instalando-JDK(parte-1)

Windows:
site: http://java.sun.com/javase/downloads/index.jsp Pegue o arquivo jdk-6u12-windows-i586-p.exe em: F:\instala\ambiente_relatorios\ Execute-o. Abrir uma tela para instalar o JDK. No h mistrios aqui, Next, Next, Finish. Depois de instalado, necessrio definir numa varivel de ambiente o diretrio onde o JDK foi instalado: Iniciar Painel de Controle Sistema Na aba Avanado, clicar em Variveis de Ambiente. Em Variveis do Sistema, cria uma Nova Varivel: Nome: JAVA_HOME Valor: Diretorio do JAVA (Ex.: C:\Arquivos de programas\Java\jdk1.6.0_12)

2 Instalando iReport 3.0.0

Site Oficial: http://jasperforge.org/plugins/project/project_home.php?group_id=83 A verso mais recente a 3.1.4, porm utilizaremos a verso 3.0 (modificada*) O Pacote iReport-3.0.0.zip com o iReports est em: F:\instala\ambiente_relatorios\ Copie e extraia onde preferir. Para iniciar o iReport, basta executar o arquivo: iReport.bat (windows) iReport.sh (linux) *modificada: Fiz alteraes do cdigo fonte do iReport, para possibilitar a gerao de relatrios do tipo Radar. Porm em breve sair essa funcionalidade oficialmente. Quando isso acontecer, podemos ir para a verso mais nova, que, a partir da 3.1.4 j tem uma srie de novos recursos em relao a 3.0.0.

3 Instalando Eclipse 3.4 (Ganymede)

Site Oficial: http://www.eclipse.org/ Verso utilizada: Eclipse IDE for Java EE Developers Plugins: Subclipse e PyDev

Instalao Rpida (Somente para usurios do Windows):

Basta apenas pegar o pacote eclipse_gany.zip j configurado na pasta: F:\instala\ambiente_relatorios\ Extrair o pacote no C:, ficando assim: C:\eclipse_gany Para executar o Eclipse, execute o arquivo eclipse.exe Ao tentar abrir o eclipse, aparecer uma janela para que voc defina onde seus projetos sero guardados, crie uma pasta no C: C:\eclipse_work (ou o nome que voc quiser)

Marque o checkbox para que esta tela no aparea toda vez que voc abrir o Eclipse. Com isso o Eclipse j est devidamente instalado, no necessario fazer os passos abaixo, onde mostra como instalar os plugins...

Instalao detalhada (do Zero):

Aps feito o download, basta descompactar o pacote no lugar desejado. No Windows prefervel descompactar no C:, pois os subdiretorios do Eclipse so extremamente compridos e isso pode causar erros no funcionamento dele, pois o Windows pode no conseguir alcanar os diretorios mais profundos devido a capacidade de caracteres para caminhos de diretrios dele. Aps descompactado, basta executar. Ao tentar abrir o eclipse, aparecer uma janela para que voc defina onde seus projetos sero guardados, crie uma pasta onde desejar. Marque o checkbox para que esta tela no aparea toda vez que voc abrir o Eclipse.

Instalando Subclipse 1.2.4: Com o Eclipse aberto, v em: Help Software Updates Na aba Available Sofware, clique em Add Site: No campo, coloque o endereo: http://subclipse.tigris.org/update_1.2.x e d um OK. O site ser includo na listagem.

Clique na imagem + na frente do site. Marque o checkbox Subclipse Plugin.

Clique em Install... para iniciar a instalao. Pode ser que precise dar uns Ok durante o processo. Instalando PyDev: O procedimento basicamente o mesmo do subclipse. Insira o endereo: http://pydev.sourceforge.net/updates/ Clique na imagem + na frente do site. Selecione o checkbox. E d um Install.

O Processo de instalao iniciado. Pode ser que precise dar uns Ok durante o processo.

4 Instalando Tomcat 6.0.18

No necessita de instalao, basta apenas pegar o pacote tomcat6018.zip em: F:\instala\ambiente_relatorios\ Copie e extraia onde desejar... mas prefervel que esteja na raz. (Ex.: C:) O pacote vale tanto para Windows como para Linux. Por fim ainda necessrio criar outra vriavel de ambiente (se no lembra como, veja no capitulo da instalao do JDK 1.6): CATALINA_HOME = Diretrio do tomcat (Ex.: C:\tomcat6018) Para que o Tomcat funcione, necessrio que voc tenha configurado corretamente a varivel de ambiente JAVA_HOME. Para iniciar/parar o tomcat: Na pasta bin, existe os arquivos (em .bat e em .sh): start stop catalina No caso do windows, basta dar dois cliques em start.bat ou stop.bat. Cada um faz exatamente o que o prprio nome diz (Inicar, Parar). No linux: cd TOMCAT/bin ./start.sh ou ./stop.sh J o catalina (bat ou sh) s pode ser executado via console, pois tem parametros (ou vc pode criar um bat ou sh separado, mas no tem necessidade). Esse arquivo faz a mesma coisa que o start e o stop, mas ele tem mais opes, como modo debug. Ex.: cd Tomcat/bin ./catalina.sh start ./catalina.sh stop ./catalina.sh debug ./catalina.sh -help (mostra todas as opes)

5 Instalando Ant
Linux
apt-get install ant Em caso de dificuldades, tente: apt-get install ant-optional

Windows
Baixar ltima verso em: http://ant.apache.org/bindownload.cgi Ou pegar o pacote apache-ant-1.7.1.zip no diretrio: F:\instala\ambiente_relatorios\ Extrair o pacote em C: ficando assim: C:\ apache-ant-1.7.1 necessrio criar uma varivel de ambiente chamada ANT_HOME, apontando para a pasta do Ant:

Para que o comando ant possa ser utilizado a partir de qualquer diretorio no console do windows, deve-se colocar a pasta bin na variavel de ambiente PATH.

Repare que, s acrescentar a string: ;%ANT_HOME%/bin

6 Instalar aplicao do SVN

Depois de tudo devidamente instalado, hora de puxar os cdigos fonte da aplicao de relatrios do SVN. Com o Eclipse aberto, v em: File New Other... ou simplesmente Ctrl + N. Selecione SVN Checkout Projects from SVN e d Next.

Marque a opo Create a new repository location e d Next. Preencha o campo com o endereo do svn do GCAWEB. http://svn/gcaweb/trunk

Clique em Next. Sero exibidas as pastas do GCAWEB no repositrio.

Selecione a pasta ireport e clique em Next. Na prxima tela, solicitado um nome ao projeto, digite: Rpt

Clique em Finish. O Eclipse efetuar o download da aplicao para o seu workspace.

7 Integrando Apache e Tomcat

Por que?
Supondo que estamos neste link, e queremos mandar gerar um relatrio: http://gcaweb.local/gerar_relatorio.pt A aplicao de relatrios est rodando no tomcat neste endereo: http://127.0.0.1:8080/Rpt/servletqualquer Como ficaria o action do formulrio pra mandar gerar o relatrio ? Neste caso, teria que ser colocado o endereo completo no action: <form action=http://127.0.0.1:8080/Rpt/servletqualquer" method="post"> Isso invivel, dado que temos N clientes, no podemos colocar o endereo completo no action. E se precisssemos mudar a mquina que o tomcat est rodando? Teramos que sair alterando todos os fontes com o novo IP. Soluo Integrar o Apache com o Tomcat como se quisssemos enganar o Apache. (+ - ) Definimos num nico arquivo o IP e a porta da mquina onde o tomcat est rodando. Definimos tambm algumas URL Patterns para que ele entenda que, quando elas foram chamadas, ele deve direcionar o processamento para o tomcat. Supondo que j fizemos a integrao (IP 127.0.0.1:8080), e configuramos como URL Pattern a seguinte URL: /Rpt/* Neste caso, o apache vai entender que, quando qualquer uma dessas url forem digitadas: http://gcaweb.local/Rpt/servletX http://clima.local/Rpt/servletY http://pcs.local/Rpt/servletZ O apache vai por traz dos panos, fazer o seguinte (respectivamente): http://127.0.0.1:8080/Rpt/servletX http://127.0.0.1:8080/Rpt/servletY http://127.0.0.1:8080/Rpt/servletZ Com isso, o exemplo anterior funcionaria apenas desta maneira: <form action=/Rpt/servletqualquer" method="post"> Desta forma, no h mais a necessidade de se preocupar com o endereo do tomcat. Mas ainda no acaba a! As requisies esto sendo enviadas todas para o mesmo endereo (127.0.0.1:8080). Para que o Tomcat possa distiguir a pasta da aplicao de cada cliente, necessrio criar nele HOSTS, assim como est configurado no apache. Mas isso no importante no momento...

Como Configurar a Integrao

Copie os seguintes arquivos para as respectivas pastas do Apache: tomcat.conf (conf) worker.properties (conf) mod_jk.so (modules) Estes arquivo esto na pasta: F:\instala\ambiente_relatorios\ Aps copi-los ser necessrio algumas edies: Abra o tomcat.conf: Ajuste os dados abaixo de acordo com a instalao do apache na sua mquina JkWorkersFile c:\Apache2\conf\workers.properties JkLogFile c:\Apache2\logs\mod_jk.log Salve, e feche. Abra o httpd.conf: No final do arquivo, inclua a seguinte linha: Include conf/tomcat.conf Salve, e feche. Reinicie o Apache. Reinicie o Tomcat. Finish!