AppFuseQuickStart_pt

AppFuse - guia rápido para começar

AppFuse tem como principal propósito ajudá-lo rapidamente acelerar o começo de sua aplicação web. Aqui estão os passos básicos na criação de um novo projeto com ele.

1. Instale J2SE 1.4.2+ e ajuste a variável de ambiente JAVA_HOME apontando para seu diretório de instalação.
2. Download a versão fonte ou faça o checkout do módulo appfuse do CVS (cvs -d :pserver:[email protected]:/cvs co appfuse).
   NOTA: Você pode fazer o download AppFuse 1.8, Ant 1.6.2, Tomcat 5.0.28 e MySQL 4.1.11 (para Windows) usando tudo-em-um instalador. Visualize este README.txt do pacote para mais informações.
3. Instale Ant 1.6.2+ e ajuste a variável de ambiente ANT_HOME. Instale Tomcat 4.1.x+ (recomendo 5.0.28) e ajuste a variável de embiente CATALINA_HOME apontando para o diretório de instalação do Tomcat. Cheque meu configuração de ambiente de desenvolvimento para obter links a todos estes pacotes e ver onde Eu costumo instalá-los.
4. Instale MySQL 3.23.x+ (recomendo 4.1.7).
   NOTA: Se você estiver usando MySQL 4.1.7, tenha certeza de usar um character set UTF-8 e um tipo de tabela InnoDB. Veja como.
5. Configure um servidor SMTP local ou altere o arquivo mail.properties (no diretório web/WEB-INF/classes) e build.properties (no raiz -- para mensagens log4j) apontando para um existente - o padrão é para localhost.
6. Copie lib/junit3.8.1/junit.jar para $ANT_HOME/lib.
   NOTA: Você pode ver um arquivo ant-junit.jar existente em $ANT_HOME/lib. Este jar não é a biblioteca JUnit, ao contrário é para a tarefa Ant junit a qual usará o junit.jar que você colocar aqui.
7. Do diretório do appfuse, execute ant new. Você será questionado por um nome de aplicação, nome do banco de dados e nome do pacote(utilizado por sua aplicação). Depois de entrar com estas informações, um diretório contendo sua aplicação será criado no mesmo diretório que o appfuse.
   ATENÇÃO: Alguns valores de aplicação não funcionarão - não use "test", nada que contenha "appfuse" ou qualquer coisa que comece com números. Também, dois traços (-) no nome irá bagunçar as coias.
8. Navegue para o novo diretório e execute ant setup (ou ant setup-db setup-tomcat deploy) para criar o banco de dados, configurar Tomcat e fazer o deploy de sua aplicação. A configuração do banco de dados somente funcionará se seu usuário root não possuir senha. Você pode mudar isto no arquivo build.properties se necessário. Precisa assistência com a configuração do mysql?
9. Se você quiser testar e ter certeza que tudo funciona, execute ant test-all - Tenha certeza que Tomcat esteja parado quando você o fizer. Depois, execute ant test-reports - haverá uma mensagem depois que ele executar dizendo como você pode visualizar o relatório gerado.

Depois que você confirmar sua instalação usando os passos acima - dê uma olhada nos Tutoriais para ver como desenvolver com o AppFuse.

Instalações Opcionais

• Se você quiser usar iBATIS como opção de framework de persistência, veja o arquivo README.txt no diretório extras/ibatis.
• Se você quiser usar Spring como framework web, veja o arquivo README.txt no diretório extras/spring.
• Se você quiser usar WebWork como framework web, veja o arquivo README.txt no diretório extras/webwork.
• Se você quiser usar JSF como framework web, veja o arquivo README.txt no diretório extras/jsf.
• Se você quiser usar Tapestry como framework web, veja o arquivo README.txt no diretório extras/tapestry.

• Se você quiser você pode escrever um script para automatizar a criação e teste de seu projeto a partir do AppFuse. Há uma combinação no CVS que Eu uso para testar: spring+ibatis e webwork. Note que usando "appfuse" no nome de um projeto do mundo real é uma má idéia de forma que ele irá procurar/substituir coisas que ele não deveria.
• Se você não quiser instalar iBATIS, Spring MVC, WebWork, JSF ou Tapestry - você deveria deletar seus instaladores no diretório extras antes de fazer a importação de seu projeto para o controlador de versões.