About the Struts 2 Wiki Space
The Vault contains lots of unsorted problems, snippets, remarks and ideas, mostly found in posts in the mailing lists. You can think of this page as a place to store content before it is analyzed and put in a Tutorial, Guide, or FAQ. Material in the Wiki is raw, unpolished, and can contain typos. If you can't find it elsewhere, be sure to rummage through the Vault and search the forum.
Feel free to redraft material in this space! (That's why it's here!)
Visit Stuts 2 Documentation for the official project documentation
Should I make an action or rather link to a .jsp page ?
If you put an action configuration in your xwork.xml but don't put an action class attribute, it will default to using the ActionSupport class, which just returns SUCCESS.
Sample applications with Java 1.4.x
Struts 2 requires Java 5. However, an alternate set of jars for Java 1.4.x are available.
Steps to get Struts2 sample applications to work with java 1.4.x:
Type conversion for a static inner class ?
Collection_inner property name = your.package.ClassName$StaticInnerClassName (notice the dollar sign between the fully qualified Class name and the static inner class)
Freemarker, Velocity, JSP
How to disable Velocity template caching
The "wwclass" was the resource loader I need to change.
Here's the lines from Velocity.props:
How to catch Freemarker exceptions (the ugly big yellow pages)
FreeMarker delegates exception handling to so-called TemplateExceptionHandlers. By default the HTML_DEBUG_HANDLER is used (this one generates the yellow error page), but you can easily specify a different exception handler by using the setTemplateExceptionHandler method of your configuration object. FM provides some simple handlers you can use, in your case I recommend the RETHROW_HANDLER (
My s:include actions aren't processed
Did you declare the s tag library in your includes ? If I'm not mistaken, jsp includes work different from struts tags includes (struts tags process the pages before including them).
I'm using s:urlHelper in combination with the c:out tag, but it won't work !
if the url with & is used in the value attribute it will not work properly unless the escapeXml is set to false.
Why aren't my get parameters being propagated automatically under Websphere 5.1?
The symptoms of this issue are that when using the s:url tag, the get parameters won't be inlcuded when the includedParams attribute is set to 'get' under Websphere 5.1. (Websphere 6.1 is not affected by this issue) This issue occurs because Websphere 5.1 doesn't follow correct behavior regarding the request query string. To allow struts to work properly with Websphere 5.1, you must include the following interceptor in your interceptor stack:
This interceptor will grab the query string from the request before the forward occurs and put it under the query string servlet attribute as defined in the 2.4 servlet spec. This interceptor should have no affect on other servlet containers.
See https://issues.apache.org/struts/browse/WW-1563 for more details.
How to disable validation on the first page load (to show a in input form)?
If you define your own stack you can exclude methods from validation by adding the excludeMethods param to both Validation and Workflow. Assuming you are using the defaultStack the the methods input, back and cancel will be ignored. Change default to action!input and declare the input method to return INPUT.
How to disable validation on any given method?
@SkipValidation tag on the method.
When using clientside validation, DWR states it gets No Data From Server
When using firefox if a user has focus on an input control and then clicks the submit button i get a DWR error stating that there was no data from the server.
I searched around on this group and did not see a solution. Via the DWR mailing list I found a post fromi Joe Walker stating that a workaround was to register a custom DWR error handler ..
Why can't I use && (=and) in my validation rules ? || (=or) does work !
You can't use && directly since the validation files have to be wellformed xml. The correct syntax would be & ;& ; (without the spaces)
Validation on individual methods
To use validation on a specific method in an action you need to call your validation file
Where ActionName is the value matching the name attribute of the action in the action config. Wildcard methods treats / (slashes) as - (dashes). Here is an example, if we wanted to validate only the method dir/myMethod: -
We would call the validation file
MyAction-dir-myMethod-validation.xml. This is because ActionClassName is MyAction and ActionName is dir/myMethod, but the / is mapped to - so it becomes dir-myMethod.
Datepicker i18n problems
Is simple solution to overide files like:
The only way to fix that, is correct calendar-(your language).js...
Already fixed for 2.2.1, available via CVS HEAD:
Datepicker does not allow time editing, or works with wrong date format
The trick is to format the date correctly before sending it to the datepicker, AND telling the datepicker what format you are using.
And the use the following snippet instead:
Improving Dojo Performance
More Struts 1 -> 2 migration tips
Nested and indexed properties without the nestedTag
S2 hot-redeployment problem with Tomcat 5.5
Try to adjust your Tomcat context settings...
Deploying Struts/WebWork on Glassfish
One of my co-workers was deploying a forum application that uses WebWork code. He ran into some deployment and execution issues, related to the sercurity policy. If you want to deploy WebWork apps on GlassFish, you may want to read http://blogs.sun.com/roller/page/paulsen?entry=configuring_the_security_manager_in
Different version of a browser co-existing together
Spring Security (formerly Acegi Security System) is Spring's Authentication & Authorisation framework.
The following sections describe how to integrate Spring Security in Struts 2 applications.
Examples of Spring Security related set up are also provided, but they're just meant as a quick start guide. For compreehensive Spring Security documentation, please refer to the Spring Security Reference Documentation.
Spring Framework integration
Before using Spring Security, the Struts 2 application should be integrated with the Spring framework by means of the Spring Plugin. Please refer to the documentation of this plugin for information on how to use it.
Add the following Spring Security JAR files to the application:
Changes in web.xml
Add applicationContext-security.xml to Spring's contextConfigLocation:
Declare the following filter and filter mapping:
If restrictions are to be applied to the number of concurrent sessions per user, declare the following listener:
Declare mappings between URLs and required roles:
Declare an authentication provider. Below is an example of an in-memory authentication where two users with different sets of roles are defined:
Alternatively, an authentication provider using JDBC could be declared: