Installing vraptor2

  1. Download and unzip the zip file in the download section
  2. Put the jar files in your WEB-INF/lib directory.
  3. Add both files to your project's class path.
  4. Configure the web.xml file by setting up the servlet
    <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. (optional) Create a vraptor.xml file in your classpath (a java source directory for example):
    <vraptor>
    </vraptor>
  6. (optional for overriding views) Create an empty views.properties file in your classpath (a java source directory for example):

The log4j.xml file

Even thought this is an optional step we highly recommend you to configure log4j as it might end up not showing your exceptions in ANY log file if you don't. (This is true for most log4j based libraries).

  1. Create a log4j.xml file in your classpath (some people put it in your source or resources folder)
  2. Configure log4j to show vraptors log in the Console
    <?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="ERROR" />
                    <appender-ref ref="stdout" />
            </category>
    
    </log4j:configuration>

Fast mode

Download the blank-project which comes preconfigured.