Struts Maven Archetypes

This page is deprecated and replaced by the Struts 2 Maven Archetypes page.

It is being kept (for now) for release note links.

Struts provides several Maven Archetypes that create working applications based on a template.

Available Archetypes

The following archetypes are available:

The Starter Archetype (struts2-archetype-starter)

The Starter archetype creates a more featured application using several common technologies used in production applications.

Features

Sitemesh integration
Action example (both instantiated through Spring and Struts itself)
Validation example (action and action-alias level)
Conversion example (global and action level)
Resource bundle (both global, action and package level)

The Portlet Blank Archetype (struts2-archetype-portlet)

The Portlet blank archetype creates a minimally populated JSR 168 portlet.

Features

View, Edit, and Help mode examples
Simple form for preferences in Edit mode
Can be deployed as a servlet or portlet application
Can use Maven Jetty plugin to deploy as a servlet webapp

The Portlet Database Archetype (struts2-archetype-dbportlet)

The Portlet database archetype creates a simple JSR 168 portlet that displays the contents of a database table.

Features

Uses Spring and Hsql to show a real database query
Builtin caching of query results
View, Edit, and Help mode examples
Simple form for preferences in Edit mode
Can be deployed as a servlet or portlet application
Can use Maven Jetty plugin to deploy as a servlet webapp

Creating an Application Using an Archetype

From a working directory for your project, run the following command:

mvn archetype:create   -DgroupId=tutorial \
                       -DartifactId=tutorial \
                       -DarchetypeGroupId=org.apache.struts \
                       -DarchetypeArtifactId=struts2-archetype-starter \
                       -DarchetypeVersion=2.0.11.2

This table describes the parameters used above:

Name	Description
`groupId`	The id for the group the application belongs to. Usually is the root package for applications in your company, e.g. com.mycompany
`artifactId`	The id for the project
`package`	The base Java package to use for generated source code. Defaults to `archetypeGroupId` if not specified.
`archetypeGroupId`	The group id of the archetype. Will always be `org.apache.struts` for Struts archetypes
`archetypeArtifactId`	The id of the archetype
`archetypeVersion`	The version of the archetype
`remoteRepositories`	A list of remote repositories that contain the archetype. If deployed to the standard Maven repository or locally, this is optional

The Archetype will create a ready-run Struts project. Just run "mvn install" to build.

Command Quick Reference

To build
```
   mvn install
```

To create IntelliJ IDEA project files
```
   mvn idea:idea
```

To create Eclipse project files
```
   mvn eclipse:eclipse
```

To run test cases
```
   mvn test
```

To clean up
```
   mvn clean
```

To package
```
   mvn package
```

To grab necessary JAR files etc.
```
   mvn initialize
```

To run it with Jetty
```
   mvn jetty:run
```