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! Overview Nutshell AJAX Dependency Injection Profiling Debugging Configuration Zero Configuration Annotations Configuration Elements Configuration Files web.xml struts.xml struts.properties struts-default.xml velocity.properties struts-default.vm Wildcard Mappings Performance Tuning Application Servers Localization Localization

Validation Validation Type Conversion Type Conversion Interceptors Interceptors Writing Interceptors Actions Action Chaining Results Result Types DispatcherListener PreResultListener Portlets tutorial configuration FAQs

Tag Developers Guide

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

Struts Tags Generic Tags UI Tags Themes and Templates Tag Reference Ajax Tags OGNL Tag Syntax

JSP specific tags Freemarker specific tags Velocity specific tags

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.

• Writing Plugins

Bundled Plugins

Codebehind Plugin Config Browser Plugin JasperReports Plugin JFreeChart Plugin JSF Plugin Plexus Plugin

SiteGraph Plugin Sitemesh Plugin Spring Plugin Struts 1 Plugin Tiles Plugin

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

Architects Guide

• Big Picture
  • ObjectFactory
  • ActionMapper
  • Action Proxy & ActionProxy Factory
  • Configuration Provider & Configuration

Migration Guide

Getting here from there.

Release Notes 2.1.x

• Release Notes 2.1.0

Release Notes 2.0.x

• 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	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
• Requirements and Use Cases – under construction
• Precise Error Reporting
• Obtaining an IDEA license
• How to Write Doc Comments for the Javadoc Tool (Sun)

Documentation

• Editing the Documentation
• Documentation Colophon
• Documentation Style Guide

Core Guide TODOs

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

Tools

• Clean JIRA Comment Spam

Licensing and Copyright

• Third Party Licensing Policy RFC
• ASF Source Header and Copyright Notice Policy
• Author Tags

Next: FAQs