Raible's Wiki: AppFuseEclipse

At line 7 changed 7 lines.

!Table of Contents

* [1] Create New Java Project in Eclipse

* [2] Configuring Ant in Eclipse

* [3] Add build.xml to Ant View

* [4] Run Ant

* [5] Run JUnit Tests in Eclipse

* [6] Tips for Debugging and UI Editing

!Tabela de Conteúdo

* [1] Crie um Novo Projeto Java no Eclipse

* [2] Configure o Ant no Eclipse

* [3] Adicione o arquivo build.xml para o Ant View

* [4] Rode o Ant

* [5] Rode os testes JUnit no Eclipse

* [6] Dicas para Depuração e edição de Interface ao Usuário (UI)

At line 15 changed 2 lines.

!!Create New Java Project in Eclipse [#1]

Open Eclipse (either with an existing or a new workspace) and to go File → New → Project. Then select "Java Project" and hit the Next button. In the Project Name field, enter the name of your project (i.e. appfuse) and the directory that your project lives (i.e. c:\source\appfuse) in the box below. If you're prompted to switch the Java Perspective, choose Yes.

!!Crie um Novo Projeto Java no Eclipse [#1]

Abra o Eclipse (pode ser tanto com uma área de trabalho existente ou com uma nova) e vá para File → New → Project. Então selecione "Java Project" e aperte o botão Next. No campo Project Name, entre com o nome do seu projeto (i.e. appfuse) e o diretório que seu projeto reside (i.e. c:\Source\appfuse) na caixa abaixo. Se aparecer um aviso para mudar para a perspectiva Java (Java Perspective), escolha Yes.

At line 18 changed 1 line.

If you try to build the project at this point, you'll likely get numerous errors. Most of them involve the fact that the {{UserForm}} class can not be found. This is because all of the ActionForms in AppFuse (if you're using the Struts version) are generated from POJOs with XDoclet.

Se você tentar construir o projeto neste ponto, aparecerão muitos erros. A maioria deles involve o fato de que a classe {{UserForm}} não pode ser encontrada. Isto é porque todos os ActionForms no AppFuse (se você está utilizando a versão Struts) são gerados do POJOs com XDoclet.

At line 20 changed 1 line.

All of the tasks for XDoclet are configured in the Ant build.xml file so the easiest thing to do is to run "ant gen-forms" to generate the ActionForms. If you have Ant 1.6.2+ installed and in your path, you can do this from the command line. The next step shows you how configure Eclipse to run your AppFuse build.xml.

Todas as task XDoclet são configuradas no arquivo Ant build.xml então a coisa mais fácil a fazer é rodar "ant gen-forms" para gerar os ActionForms. Se você tiver o Ant 1.6.2+ instalado, você pode fazer isto da linha de comando. O próximo passo mostra como você configura o Eclipse para rodar seu AppFuse build.xml.

At line 22 changed 1 line.

%%note __TIP:__ Here's a way to <a href="http://raibledesigns.com/page/rd?anchor=eclipse_tips">hide the JARs</a> you see in Eclipse's Package Explorer.%%

%%note __DICA:__ Aqui tem uma maneira de <a href="http://raibledesigns.com/page/rd?anchor=eclipse_tips">esconder os JARs</a> que se vêem no Package Explorer do Eclipse.%%

At line 24 changed 1 line.

!!Configuring Ant in Eclipse [#2]

!!Configure o Ant no Eclipse [#2]

At line 26 changed 1 line.

The easiest way to configure Eclipse for AppFuse is to install Ant on your hard drive (i.e. c:\Tools\apache-ant-1.6.2) and then point Eclipse's ANT_HOME to this directory. To do this, go to Window → Preferences → Ant → Runtime. Then click the "Ant Home" button and select the installation folder on your hard drive.

A maneira mais fácil de configurar o Eclipse para o Appfuse é instalar o Ant no seu disco rígido (i.e. c:\Tools\apache-ant-1.6.2) e apontar o ANT_HOME do Eclipse para este directory. Para fazer isto, vá para Window → Preferences → Ant → Runtime. Então clique no botão "Ant Home" e selecione a pasta de instalação no seu disco rígido.

At line 28 changed 1 line.

If you'd rather use Eclipse's built-in Ant, you'll need to add junit.jar to its classpath. To do this, go to Window → Preferences → Ant → Runtime. Then click the "Add JARs" button and select junit.jar from appfuse/lib/junit3.8.1/lib/junit.jar. Click OK until you arrive back at the workbench view.

Se você preferir utilizar o Ant que já vem com o Eclipse, você deve adicionar o junit.jar para o seu classpath. Para fazer isto, vá em Window → Preferences → Ant → Runtime. Então clique no botão "Add JARs" e selecione o junit.jar do appfuse/lib/junit3.8.1/lib/junit.jar. Clique em OK até você voltar para a visão do workbench.

At line 30 changed 1 line.

Next, add the __catalina-ant.jar__ (from $CATALINA_HOME/server/lib) to the ant classpath. Then in the property tab, add __tomcatTasks.properties__ (in lib/ant-contrib) file as a global properties file.

Depois, adicione o __catalina-ant.jar__ (em $CATALINA_HOME/server/lib) para o classpath ant. Então na tab property, adicione o arquivo __tomcatTasks.properties__ (em lib/ant-contrib) como um arquivo de propriedades global.

At line 32 changed 1 line.

Below is a screenshot of what your Ant Runtime classpath should look like after the above modifications:

Abaixo está o screenshot de como o Ant Runtime classpath deve estar após as modificações acima:

At line 36 changed 2 lines.

!!Add build.xml to Ant View [#3]

Now we need to add the build.xml to Eclipse's Ant View. To do this, go to Window → Show View → Ant. Then click on the first icon in this view (screenshot below) to add AppFuse's build file.

!!Adicione o arquivo build.xml para o Ant View [#3]

Agora precisamos adicionar o arquivo build.xml para o Ant View do Eclipse. Para fazê-lo, devemos acessar Window → Show View → Ant. Então devemos clicar no primeiro ícone desta visão (screenshot abaixo) para adicionar o arquivo build do AppFuse.

At line 41 changed 2 lines.

!!Run Ant [#4]

After adding the build.xml, you should be able to expand it in the Ant View and execute any of the targets. I usually do "test-all" to verify all the tests pass in my initial project. For a list of targets I use most often, see [AppFuse Ant Targets|AppFuseAntTasks].

!!Rode o Ant [#4]

Após adicionar o build.xml, você deve ser capaz de expandir ele na Ant View e executar qualquer um de seus alvos (targets). Eu geralmente faço "test-all" para verificar todos os testes passando em meu projeto inicial. Para uma lista de alvos que utilizo regularmente, veja [AppFuse Ant Targets|AppFuseAntTasks].

At line 44 changed 1 line.

Now if you run the "compile" target and then refresh the project (right-click on project → Refresh) you shouldn't see any errors in the "Problems" pane. You should now be able to compile and create classes as you normally would. Sometimes when my imports aren't resolving correctly in Eclipse, I do have to run Project → Clean in Eclipse.

Agora se você rodar o alvo "compile", atualizar o projeto (clique com o botão direito em project → Refresh) e não aparecerá nenhum erro no pane "Problems". Você poderá agora compilar e criar classes como normalmente faria. Algumas vezes quando meus imports não são resolvidos corretamente pelo Eclipse, rodo Project → Clean no Eclipse.

At line 46 changed 1 line.

%%note __NOTE:__ If you're using the internal version of Ant, you may get an error message like the one below:

%%note __NOTA:__ Se você está utilizando a versão interna do Ant, você pode receber uma mensagem de erro como a abaixo:

At line 53 changed 1 line.

This is because there are tasks that require Xerces to be in your Ant classpath [[<a href="http://wiki.apache.org/jakarta-cactus/FrequentlyAskedQuestions">reference</a>]. I added xercesImpl.jar and xml-apis.jar (from my self-installed version of Ant) to Eclipse's Ant classpath to solve this.

Isto é porque existem tasks Ant que necessitam que o Xerces esteja no classpath do Ant [[<a href="http://wiki.apache.org/jakarta-cactus/FrequentlyAskedQuestions">reference</a>]. Adicionei xercesImpl.jar e xml-apis.jar (de minha instalação própria de Ant) para o classpath do Ant do Eclipse para resolver este problema.

At line 55 changed 1 line.

At this point, you should see something similar to the screenshot below.

Neste ponto, você terá algo similar ao screenshot abaixo.

At line 59 changed 2 lines.

!!Run JUnit Tests in Eclipse [#5]

It's also possible to run your JUnit tests in Eclipse. But before running them, you need to run the "war" target. After this target completes, refresh your project.

!!Rode os testes JUnit no Eclipse [#5]

Tmabém é possível você rodar os testes JUnit no Eclipse. Mas antes de rodá-los, você deve rodar o alvo "war". Após o alvo ser completado, atualize seu projeto.

At line 62 changed 1 line.

After you have successfully done so, in Eclipse open a test you'd like to run (i.e. UserDaoTest) and go to Run → Debug As → JUnit Test. Note that you may have to run the "db-load" target before you run your tests every so often. I did have the following method in the Base*TestCase class for each layer, but this caused DBUnit to reload the database before every test in a Test class. Removing it reduces the execution time of "test-all" by more than 30 seconds.

Após você fazê-lo com sucesso, abra o teste que deseja rodar no Eclipse (i.e. UserDaoTest) e vá para Run → Debug As → JUnit Test. Note que você deve rodar o alvo "db-load" antes de rodar cada teste. Eu ainda tenho o seguinte método na classe Base*TestCase para cada camada, mas isto causa um carregamento da base de dados pelo DBUnit antes de cada teste na classe de Teste. Removendo isto reduz o tempo de execução da task "test-all" em mais de 30 segundos.

At line 71 changed 1 line.

// clear table and insert only sample data

// limpa a tabela e insere apenas os dados de amostra

At line 77 changed 1 line.

If the instructions above don't work for running JUnit tests in Eclipse, I suggest just using the command line - i.e. __ant test-dao -Dtestcase=UserDAO__. Running tests from the command line ''always'' works. ;-)

Se as instruções acima não funcionaram para rodar os testes JUnit no Eclipse, sugiro apenas utilizar a linha de comando - i.e. __ant test-dao -Dtestcase=UserDAO__. Rodar testes da linha de comando ''sempre'' funciona. ;-)

At line 79 changed 2 lines.

!!Tips for Debugging and UI Editing [#6]

For debugging, I use the [Tomcat Plugin|http://www.sysdeo.com/eclipse/tomcatPlugin.html] in Eclipse and set breakpoints. To make the breakpoints work you will need to indicate your source-path using the Eclipse menu {{Window->Preferences}}, select {{Tomcat}}, then {{Source Path}}.

!!Dicas para Depuração e edição de Interface ao Usuário (UI) [#6]

Para depuração, utilizo o [Plugin para Tomcat|http://www.sysdeo.com/eclipse/tomcatPlugin.html] no Eclipse e setar breakpoints. Para fazer os breakpoints funcionarem, será preciso indicar o caminho do código fonte utilizando o menu do Eclipse {{Window->Preferences}}, selecione {{Tomcat}}, então {{Source Path}}.

At line 82 changed 1 line.

For little changes, I use "ant deploy-web" which only takes a couple of seconds. For truly minor tweaks, it's sometimes easier to edit the file in Tomcat's webapps folder. For major design changes, I usually run the app, view source on a page and save it to a "sandbox" folder in the same directory as my project. Then I do a find/replace and change all "/appfuse/" references to "../web/". This allows me to change CSS and JS files and just refresh the file in the sandbox.

Para pequenas mudanças, utilizo "ant deploy-web" que demora apenas alguns segundos. Para mudanças verdadeiramente pequenas, algumas vezes é mais fácil editar o arquivo na pasta de aplicações web do Tomcat. Para mudanças maiores de projeto, geralmente eu rodo a aplicação, vejo o código em uma página e salvo ele em uma pasta "sandbox" no mesmo diretório do meu projeto. Então eu faço find/replace e modifico todas as referências "/appfuse/" para "../web/". Isto me permite trocar arquivos CSS e JS e apenas atualizar o arquivo na sandbox.

Raible's Wiki

AppFuse

Other Applications

AppFuseEclipse_pt