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).

Tutorials - Read me first!

Unit Testing (TODO)

Developing Applications with Struts 2 o Nutshell

(arsenalist) (rosa)

o o o

AJAX

Dependency Injection

o o

Profiling Debugging Development Mode

Configuration Zero Configuration

o Annotations Configuration Elements

Actions, Wildcard Mappings, Beans, Constants, Exceptions Includes, Interceptors, Namespaces, Packages, Results Configuration Files

o Writing Interceptors Actions o Model Driven (TODO) o Action Chaining o Writing Actions (TODO) Results o Result Types o DispatcherListener o PreResultListener o Multipage Forms (TODO)
Pagination for large result lists (TODO)

Interceptors

o o

struts-default.vm Application Servers Performance Tuning

web.xml struts.xml struts.properties

Validation

Localization Formatting Dates and Numbers Type Conversion

struts-default.xml velocity.properties

Portlets o 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.

Struts Tags Generic Tags o UI Tags Themes and Templates o Tag Reference o Ajax Tags

o o o

JSP specific tags

Freemarker specific tags Velocity specific tags

Ajax and JavaScript Recipes OGNL Tag Syntax

Plugin Developers Guide

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.

Plugins Extending an Application with Custom Plugins

Bundled Plugins

Codebehind Plugin Config Browser Plugin JasperReports Plugin JFreeChart Plugin

REST Plugin (2.1.1+)

JSF Plugin Plexus Plugin Portlet Plugin DWR Plugin

SiteGraph Plugin Sitemesh Plugin Spring Plugin Struts 1 Plugin Tiles Plugin JUnit Plugin TestNG Plugin

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

Architects Guide

Big Picture

o o o o

ObjectFactory ActionMapper Action Proxy & ActionProxy Factory Configuration Provider & Configuration

Migration Guide
Getting here from there.

Version Notes 2.1.x

Version Notes 2.1.2 Version Notes 2.1.1 Version Notes 2.1.0

Release Notes 2.0.x

Release Notes 2.0.11.2 Release Notes 2.0.11.1 Release Notes 2.0.11 Release Notes 2.0.10 Release Notes 2.0.9 Release Notes 2.0.8 Release Notes 2.0.7 Release Notes 2.0.6 Release Notes 2.0.5 Release Notes 2.0.4 Release Notes 2.0.3 Release Notes 2.0.2 Release Notes 2.0.1 Release Notes 2.0.0

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

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

Roadmap
Roadmap FAQ A History of Struts 2 Struts Reloaded What's in store for Struts 2? Don Brown's summary of events 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 o Building with Maven Creating and Signing a Distribution Creating and Signing a Struts 2.1.x Distribution Requirements and Use Cases Precise Error Reporting Obtaining an IDEA license How to Write Doc Comments for the Javadoc Tool (Sun) under construction

Documentation

Editing the Documentation Documentation Colophon Documentation Style Guide

Core Guide TODOs

Tools

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

Clean JIRA Comment Spam

Licensing and Copyright

Third Party Licensing Policy RFC ASF Source Header and Copyright Notice Policy

Author Tags

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!