Project Documentation

This section describes how to build Tobago and run the example applications from the sources.

Checking Out

Check out the 2.0.x sources by running the following:

  svn checkout http://svn.apache.org/repos/asf/myfaces/tobago/trunk tobago

Check out the 1.5.x sources by running the following:

  svn checkout http://svn.apache.org/repos/asf/myfaces/tobago/branches/tobago-1.5.x tobago-1.5.x

Check out the 1.0.x sources by running the following:

  svn checkout http://svn.apache.org/repos/asf/myfaces/tobago/branches/tobago-1.0.x tobago-1.0.x

Building

You need Maven 2 (at least 2.2.1) and Java 5 to build Tobago 1.0.x.
You need Maven (at least 3.0.4) and Java 6 or 7 to build Tobago 1.5.x and Tobago 2.0.x.

In the main directory you can use

  mvn install

to run the install target on all sub projects. This will put all necessary artifacts into your local repository.

Building All

For building all the stuff you can use the profile all-modules

  mvn install -Pall-modules

The Demo

You can run the examples inside tobago-example with jetty

  mvn jetty:run

or (for the addressbook and the JSP versions of demo and test)

  mvn jetty:run-exploded

or

  mvn package

and deploy the WAR from the target directory manually.

Using different JSF implementations (Tobago 1.x)

By default the example will be started with MyFaces 1.2. You can run the examples with other version like you see here:

  mvn jetty:run
  mvn jetty:run -Djsf=myfaces-2.0
  mvn jetty:run -Djsf=myfaces-2.1
  mvn jetty:run -Djsf=mojarra-1.2
  mvn jetty:run -Djsf=mojarra-2.0
  mvn jetty:run -Djsf=mojarra-2.1
  mvn jetty:run -Djsf=mojarra-2.2

Using different JSF implementations (Tobago 2.x)

By default the example will be started with MyFaces 2.0 You can run the examples with other version like you see here:

  mvn jetty:run
  mvn jetty:run -Djsf=myfaces-2.1
  mvn jetty:run -Djsf=myfaces-2.2
  mvn jetty:run -Djsf=mojarra-2.0
  mvn jetty:run -Djsf=mojarra-2.1
  mvn jetty:run -Djsf=mojarra-2.2