JBoss.orgCommunity Documentation


Errai CDI Quickstart Guide

Legal Notice


This quickstart guide covers getting up and running with Errai CDI quickly.

1. Document Conventions
2. Feedback
1. Errai CDI Maven Archetype
A. Revision History

The different runtime models explained here are all incorporated into this maven archetype using profiles. It enables execution in Development Mode and supports both packaging for deployment to a Servlet Engine and the JBoss Application Server.

To begin with we'll create a project layout using a maven build structure, which will provide us with a bare bones project, including all dependencies, which can later on be imported in your IDE of choice.

mvn archetype:generate \
-DarchetypeGroupId=org.jboss.errai.archetypes \
-DarchetypeArtifactId=cdi-quickstart \
-DarchetypeVersion=1.3.2.Final \

Customize the build properties according to your needs.

Define value for property 'groupId': : foo.bar
Define value for property 'artifactId': : gwt-app
Define value for property 'version': 1.0-SNAPSHOT:
Define value for property 'package': foo.bar: com.foo.bar
Confirm properties configuration:
groupId: foo.bar
artifactId: gwt-app
version: 1.0-SNAPSHOT
package: com.foo.bar

The project will be created in a directory that corresponds to the provided artifactId.

In a few simple steps, you have created a build environment that can build, test, package, and launch a simple application. You can now launch GWT development mode, run integration tests with coverage reporting, and package your web application for deployment.

To launch the GWT development mode, change into the project directory (name corresponding to the provided artifactId) and type:

mvn gwt:run (launch hosted mode)
mvn gwt:debug (launch hosted with debug settings)

The example application comes with an integration test suite that exercises most of its client-side and server-side code. To run the test suite, type:

mvn test -Pintegration-test

To generate a set of HTML documents under target/site/jacoco/ detailing code coverage of the most recent test run, type:

mvn site

By default the archetype does package the web application for Development Mode execution. To deploy your application to JBoss AS 7, you need to execute a clean rebuild using the JBoss profile (e.g. -Pjboss7 ).

mvn -Pjboss7 clean install
cp target/gwt-app.war $JBOSS_HOME/standalone/deployments

Importing the project into eclipse

The setup instuctions for eclipse can be found in the Errai WIKI .

Revision History
Revision ToDo 0-0ToDo Wed Jan 19 2011ToDo Dude ToDo McPants
ToDo Initial creation of book