Configurando sua aplicação web

  1. Seu primeiro passo é baixar o arquivo vraptor-all. Descompacte esse arquivo.

  2. Crie um projeto na sua IDE preferida.

    Coloque seus arquivos fonte no diretório src e crie os seguintes diretórios para a aplicação web: web, web/WEB-INF, web/WEB-INF/lib e web/WEB-INF/classes.

    Por último, configure a saída para que seus arquivos .class sejam gerados no diretório web/WEB-INF/classes.

  3. Copie os arquivos .jar que foram descompactados do zip do VRaptor para o diretório web/WEB-INF/lib.

  4. Crie o arquivo web.xml no diretório web/WEB-INF. Vamos configurar a servlet controladora do VRaptor:

    <servlet>
            <servlet-name>vraptor2</servlet-name>
            <servlet-class>org.vraptor.VRaptorServlet</servlet-class>
            <load-on-startup>1</load-on-startup>
    </servlet>

    <servlet-mapping>
            <servlet-name>vraptor2</servlet-name>
            <url-pattern>*.logic</url-pattern>
    </servlet-mapping>

  5. Crie o arquivo index.jsp no diretório web. Esse arquivo é uma página html bem simples:

    <html>
    Bem vindo ao meu primeiro teste.
    </html>

  6. Baixe o tomcat e descompacte-o.

  7. Faremos com que o endereço http://localhost:8080/aplicacao-vraptor aponte para sua aplicação web.

    Existem diversas maneiras de se fazer isso, a maneira mais simples é criar um arquivo chamado aplicacao-vraptor.xml dentro do diretório conf/Catalina/localhost do seu Tomcat. O conteúdo do seu arquivo deve ser o seguinte:

    <Context docBase="c:\eclipse\workspace\aplicacao-vraptor"
      path="/aplicacao-vraptor" reloadable="true"/>

    Lembre-se de alterar o c:\eclipse\workspace\aplicacao-vraptor para o diretório correspondente que o seu projeto se encontra.

  8. Inicie o Tomcat através do arquivo bin/startup de dentro do diretório do Tomcat. Se o seu Tomcat já estava rodando, pare e inicie novamente.

    Teste a url http://localhost:8080/aplicacao-vraptor/index.jsp. Caso sua aplicação não funcione, tente tirar suas dúvidas no nosso fórum.

    Pronto. Você já tem tudo necessário para continuar com sua primeira aplicação com o VRaptor.

  9. Opcional: configure o log.

    Crie o arquivo log4j.xml no diretório web/WEB-INF/classes. Se você estiver usando o Eclipse, pode jogar o arquivo dentro da raiz do seu diretório fonte de código java, que ele mesmo vai copiá-lo para o diretório de saída. Segue o arquivo:

    <?xml version="1.0" encoding="UTF-8" ?>
    <!DOCTYPE log4j:configuration SYSTEM "log4j.dtd">
    <log4j:configuration xmlns:log4j="http://jakarta.apache.org/log4j/">
            
            <appender name="stdout" class="org.apache.log4j.ConsoleAppender">
                    <layout class="org.apache.log4j.PatternLayout">
                            <param name="ConversionPattern" 
                                    value="%d{HH:mm:ss,SSS} %5p [%-20c{1}] %m%n"/>
                    </layout>
            </appender>

            <category name="org.vraptor">
                    <priority value="INFO" />
                    <appender-ref ref="stdout" />
            </category>

    </log4j:configuration>