Raible's Wiki: AppFuseQuickStart

At line 1 changed 1 line.

[AppFuse]'s main purpose is to help you quickly accelerate the start of your webapp. Here are the basic steps to creating a new project with it.

__AppFuse - guia rápido para começar__

At line 3 changed 9 lines.

# Install J2SE 1.4.2+ and set a JAVA_HOME environment variable pointing to your installation directory.

# [Download|https://appfuse.dev.java.net/servlets/ProjectDocumentList] the source version or checkout the ''appfuse'' module from CVS (cvs -d :pserver:[email protected]:/cvs co appfuse). <div class="note" style="margin: 10px"> __NOTE:__ You can download AppFuse 1.8, Ant 1.6.2, Tomcat 5.0.28 and MySQL 4.1.11 (for Windows) using [the all-in-one installer|https://appfuse.dev.java.net/files/documents/1397/13863/appfuse-installer-1.8.zip]. View this package's [README.txt|https://appfuse.dev.java.net/source/browse/*checkout*/appfuse/extras/myjavapack/README-dist.txt] for more information.</div>

# Install Ant 1.6.2+ and set an ANT_HOME environment variable. Install Tomcat 4.1.x+ (recommend 5.0.28) and set a CATALINA_HOME environment variable to point to your Tomcat installation. Checkout my [development environment setup|DevelopmentEnvironment] to get links for these packages and to see where I usually install them.

# Install MySQL 3.23.x+ (recommend 4.1.7). <div class="note" style="margin: 10px"> __NOTE:__ If you're using MySQL 4.1.7, make sure to use a UTF-8 character set and an InnoDB table type. [Here's how|http://raibledesigns.com/wiki/Wiki.jsp?page=AppFuseSupport#ref-AppFuseSupport-5].

# [Setup a local SMTP server|AppFuseSMTP] or change mail.properties (in the web/WEB-INF/classes directory) and build.properties (in the root -- for log4j messages) to point to an existing one - they default to ''localhost''.

# Copy lib/junit3.8.1/junit.jar to $ANT_HOME/lib.<div class="note" style="margin: 10px">__NOTE:__ You may see an ant-junit.jar file already in $ANT_HOME/lib. This jar is not the JUnit library, rather it is for the Ant junit task which will use the junit.jar that you place here.</div>

# From the appfuse directory, run __ant new__. You will be prompted for an application name, database name and package name. After entering these, a directory containing your new application will be created in the same directory as appfuse. <div class="note" style="margin: 10px; background-color: #fcc"> __WARNING:__ Some application values will not work - don't use "test", anything with "appfuse" in it or anything that starts with numbers. Also, two dashes (-) in a name will mess things up.</div>

# Navigate to the new directory and run __ant setup__ (or __ant setup-db setup-tomcat deploy__) to create the database, configure Tomcat and deploy your application. The database setup will only work if your root user has no password. You can change this in build.properties if necessary. Need [assistance with ant setup]?

# If you want to test and make sure everything works, run __ant test-all__ - make sure Tomcat is stopped when you do this. Next, run __ant test-reports__ - there will be a message after it runs telling you how you can view the generated reports.

[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.

At line 13 changed 1 line.

After you've confirmed your installation using the above steps - take a look at the [Tutorials|Articles] to see how to develop with AppFuse.

# Instale J2SE 1.4.2+ e ajuste a variável de ambiente JAVA_HOME apontando para seu diretório de instalação.

# [Download|https://appfuse.dev.java.net/servlets/ProjectDocumentList] a versão fonte ou faça o checkout do módulo ''appfuse'' do CVS (cvs -d :pserver:[email protected]:/cvs co appfuse). <div class="note" style="margin: 10px"> __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|https://appfuse.dev.java.net/files/documents/1397/13863/appfuse-installer-1.8.zip]. Visualize este [README.txt|https://appfuse.dev.java.net/source/browse/*checkout*/appfuse/extras/myjavapack/README-dist.txt] do pacote para mais informações.</div>

# 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|DevelopmentEnvironment_pt] para obter links a todos estes pacotes e ver onde Eu costumo instalá-los.

# Instale MySQL 3.23.x+ (recomendo 4.1.7). <div class="note" style="margin: 10px"> __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|http://raibledesigns.com/wiki/Wiki.jsp?page=AppFuseSupport#ref-AppFuseSupport-5].

# [Configure um servidor SMTP local|AppFuseSMTP] 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''.

# Copie lib/junit3.8.1/junit.jar para $ANT_HOME/lib.<div class="note" style="margin: 10px">__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.</div>

# 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. <div class="note" style="margin: 10px; background-color: #fcc"> __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.</div>

# 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|assistance with ant setup]?

# 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.

At line 15 changed 6 lines.

__Optional Installations__

* If you'd like to use [iBATIS|http://ibatis.com] as a persistence framework option, view the README.txt in {{extras/ibatis}}.

* If you'd like to use [Spring|http://www.springframework.org/docs/reference/mvc.html] as the web framework, view the README.txt in {{extras/spring}}.

* If you'd like to use [WebWork|http://www.opensymphony.com/webwork] as the web framework, view the README.txt in {{extras/webwork}}.

* If you'd like to use [JSF|http://myfaces.apache.org/] as the web framework, view the README.txt in {{extras/jsf}}.

* If you'd like to use [Tapestry|http://jakarta.apache.org/tapestry] as the web framework, view the README.txt in {{extras/tapestry}}.

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

At line 22 changed 2 lines.

* If you'd like you can write a script to automate the creation and testing of your project from AppFuse. There are a couple in CVS that I use for testing: [spring+ibatis|https://appfuse.dev.java.net/source/browse/*checkout*/appfuse/Attic/test-spring.sh?content-type=text/plain] and [webwork|https://appfuse.dev.java.net/nonav/source/browse/*checkout*/appfuse/Attic/test-webwork.sh?content-type=text/plain]. Note that using "appfuse" in a real-world project name is a bad idea as it'll find/replace things it shouldn't.

* If you don't want to install iBATIS, Spring MVC, WebWork, JSF or Tapestry - you should delete their installers in the {{extras}} folder before checking your project into source control.

__Instalações Opcionais__

* Se você quiser usar [iBATIS|http://ibatis.com] como opção de framework de persistência, veja o arquivo README.txt no diretório {{extras/ibatis}}.

* Se você quiser usar [Spring|http://www.springframework.org/docs/reference/mvc.html] como framework web, veja o arquivo README.txt no diretório {{extras/spring}}.

* Se você quiser usar [WebWork|http://www.opensymphony.com/webwork] como framework web, veja o arquivo README.txt no diretório {{extras/webwork}}.

* Se você quiser usar [JSF|http://myfaces.apache.org/] como framework web, veja o arquivo README.txt no diretório {{extras/jsf}}.

* Se você quiser usar [Tapestry|http://jakarta.apache.org/tapestry] como framework web, veja o arquivo README.txt no diretório {{extras/tapestry}}.

At line 25 changed 1 line.

<div class="note" style="margin-left: 40px"> __NOTE:__ These installers will modify the Eclipse classpath, but not the IDEA one. You'll need to modify that manually.</div>

* 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|https://appfuse.dev.java.net/source/browse/*checkout*/appfuse/Attic/test-spring.sh?content-type=text/plain] e [webwork|https://appfuse.dev.java.net/nonav/source/browse/*checkout*/appfuse/Attic/test-webwork.sh?content-type=text/plain]. 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.

<div class="note" style="margin-left: 40px"> __NOTA:__ Estes instaladores irão modificar o classpath do Eclipse, mas não do IDEA. Você precisará altera-lo manualmente.</div>

Raible's Wiki

AppFuse

Other Applications

AppFuseQuickStart_pt