Guides

Our in-depth guides focus on specific areas of the framework, such as Views, the Core framework, and Third-party Extensions.

Core Developers Guide

In processing a request, the framework utilizes three key class types: Actions, Interceptors, and Results, which are configured using one or more XML documents (or Java 5 annotations).

Testing Actions
- (arsenalist)
- (rosa)
Interceptors
- Writing Interceptors
Actions
- Model Driven
- Action Chaining
Results
Validation
Localization
- Formatting Dates and Numbers
Type Conversion
Static Content
Portlets
- Tutorial
- Configuration/Documentation
FAQs
- Cookbook
Javadoc APIs

Tag Developers Guide

The framework offers a flexible view layer that supports multiple view technologies, including JSP, FreeMaker, and Velocity.

Apache Struts 2 provides a simple plugin architecture so that developers can extend the framework just by adding a JAR to the application's classpath. Since plugins are contained in a JAR, they are easy to share with others. Several plugins are bundled with the framework, and others are available from third-party sources.

Bundled Plugins

For a complete list of bundled and third-party plugins, visit the Plugin Registry..

Architects Guide

Big Picture

Migration Guide

Getting here from there.

Version Notes 2.1.x

Release Notes 2.0.x

Struts 1 to Struts 2

Comparing Struts 1 and 2	How are Struts 1 and Struts 2 alike? How are they different?
Struts 1 Solutions	Various issues (and hopefully their solutions!) encountered during migrations to Struts 2.
Migration Strategies	Steps and overall strategies for migrating Struts 1 applications to Struts 2.
Migration Tools	Development tools to help aid the migration process.

Tutorials

Migrating to Struts 2	A three-hour workshop by Ted Husted (Oct 2006)
Migrating Applications to Struts 2	A three-part series by Ian Roughley (Sep 2006)

Roadmap

Roadmap FAQ	What's in store for Struts 2?
A History of Struts 2	Don Brown's summary of events
Struts Reloaded	An archive of the development discussions leading to Struts 2

Webwork 2.2 to Struts 2

Key Changes From WebWork 2	What has been removed or changed from WebWork 2.2 to Struts 2
WebWork 2 Migration Strategies	Steps and overall strategies for migrating WebWork 2 applications to Struts 2.

Contributors Guide

Source

Building the Framework from Source
- Building with Maven
Creating and Signing a Distribution
Creating and Signing a Struts 2.1.x Distribution
Creating a XWork Distribution
Requirements and Use Cases - under construction
Precise Error Reporting
Obtaining an IDEA license
How to Write Doc Comments for the Javadoc Tool (Sun)

Documentation

Core Guide TODOs

Creating Resources
Writing Validators
Writing Type Converters
Actions
Writing Actions
Writing Results

Tools

Clean JIRA Comment Spam

Licensing and Copyright

Errata?

To suggest a change or a correction to any part of the documentation, log in and leave a comment on the appropriate page. We are always looking for help with the documentation!