Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Two key configuration files utilized by the framework are web.xml and actionstruts.xml. The configuration elements in these two files will reference any other required or optional configuration files.

...

File

Optional

Location (relative to webapp)

Purpose

web.xml

no

/WEB-INF/

Web deployment descriptor to include all necessary framework components

struts.xml

no

/WEB-INF/classes/

Main configuration, contains result/view types, action mappings, interceptors, and so forth

actionstruts.properties

yes

/WEB-INF/classes/

Framework properties

struts-default.xml

yes

/WEB-INF/lib/struts-action-x.x.jar

Default configuration that should be included in action.xml

velocity.properties

yes

/WEB-INF/classes/

Override the default Velocity configuration

actionstruts-default.vm

yes

/WEB-INF/classes/

Default macros referenced by velocity.properties

...

Common static content that is needed by the framework (JavaScript and CSS files, etc.) is served automatically by the FilterDispatcher filter. Any request starting with "/actionstruts/" denotes that static content is required, and then mapping the value after "/actionstruts/" to common packages in Struts Action 2 and, optionally in the application's class path.

By default, the following packages are searched:

  • org.apache.struts.action2struts2.static
  • template

Additional packages can be specified by providing a comma separated list to the configuration parameter named "packages" (configured in web.xml for the FilterDispatcher filter). When specifying additional static content, you should be careful not to expose sensitive configuration information (i.e. database password).

...