Quick Links

• Read me first
• Quick Start
• Overview
• Download

Documentation

• User's Guide
• JavaDocs
  • trails-core
  • trails-hibernate
  • trails-security
  • trails-test
• Tapestry component docs
  • trails-core
• Search Trails on Web (Google co-op)

Project information

• Release history
• Roadmap
• License
• Source repository
  • RSS feed of changes
• Project team
• Dependencies
  • trails-core
  • trails-hibernate
  • trails-security
• Quality
  • Dependency convergence
  • Code coverage
    • trails-core
    • trails-hibernate
    • trails-security
• Sponsors

Community

• Articles
• Contact info
• Trails Success Stories
• Trails gotchas
• Trails @ SourceKibitzer
• Trails @ Ohloh

Tool links

• Fisheye view on SVN
• Confluence Wiki
• JIRA
• Bamboo CI
• Hibernate
• Tapestry
• Spring

Feeds

• Site
• News

Creating the project

First, you'll need to download and install maven2 if you haven't already done so. You *don't* have to use Maven, but it makes things substantially easier by managing all of the dependencies in Trails, and - take my word for it - for you as well. Even if you hit some minor problems with Maven, it saves you a lot of time as your project gets bigger.

If you are not familiar with maven, here are some links that'll help you get the knowledge you need to use it with Trails: Maven: The Definitive Guide Maven Users Centre

Next, issue the following command (on a single line):

mvn archetype:create -DarchetypeGroupId=org.trailsframework \
-DarchetypeArtifactId=trails-archetype \
-DarchetypeVersion=1.2.1 \
-DgroupId=<your package> \
-DartifactId=<your project>

This will download the Trails archetype and any plugins needed. It will then create a working Trails project.

Running the project

Starting up your application is super simple, just go into your new project directory and do:

mvn jetty:run

or

mvn tomcat:run

This will download all dependencies, build your project and start it inside a jetty (or tomcat) container.  Be warned, this can take a long time, especially if you just started using maven.  If any downloads fail, try running this again.  Sometimes the maven repositories get bogged down.  When everything finishes, you will now be able to go to http://localhost:8080/

Import your project

Setting up an Eclipse project is also very simple. First, you will need to tell Eclipse how to find your maven repository. This is a one time step for each Eclipse workspace:

mvn -Declipse.workspace=<path-to-eclipse-workspace> eclipse:add-maven-repo

Now do:

mvn eclipse:eclipse

You should now be able import your project into Eclipse and ready to add your own domain classes!