Work in progress
This is a work in progress and not yet finished! More complex examples will follow. For now, have a look at the unit tests within the xwork-tiger project path.
To use J2SE 5 support with the framework, you have to add struts-action-tiger.jar
to your classpath.
The struts-action-tiger.jar
can be obtained via the Maven repository and is located in the lib/tiger
directory.
Interceptor Annotations
To use these annotations, you have to specify the AnnotationWorkflowInterceptor to your interceptor stack.
Annotation |
Description |
---|---|
Marks a action method that needs to be executed before the result. |
|
Marks a action method that needs to be executed before the main action method. |
|
Marks a action method that needs to be executed before the result. |
Validation Annotations
If you want to use annotation based validation, you have to annotate the class or interface with Validation Annotation.
These are the standard validator annotations that come with XWork-tiger:
Annotation |
Description |
---|---|
Checks if there are any conversion errors for a field. |
|
Checks that a date field has a value within a specified range. |
|
Checks that a double field has a value within a specified range. |
|
Checks that a field is a valid e-mail address. |
|
Validates an expression. |
|
Uses an OGNL expression to perform its validator. |
|
Checks that a numeric field has a value within a specified range. |
|
Validates a regular expression for a field. |
|
Checks that a field is non-null. |
|
Checks that a String field is not empty. |
|
Checks that a String field is of the right length. |
|
|
|
Checks that a field is a valid URL. |
|
Marker annotation for validation at Type level. |
|
Used to group validation annotations. |
|
|
|
Use this annotation for your custom validator types. |
Type Conversion Annotations
If the xwork-tigerjar is added to the classpath, you will directly have type conversion support for Maps and Collections using generics.
In short, instead of specifying the types found in collections and maps as documented in Type Conversion, the collection's generic type is used. This means you most likely don't need any ClassName-conversion.properties files.
If you want to use annotation based type conversion, you have to annotate the class or interface with the Conversion Annotation.
Annotation |
Description |
---|---|
Marker annotation for type conversions at Type level. |
|
For Collection and Map types: Create the types within the Collection or Map, if null. |
|
For Generic types: Specify the element type for Collection types and Map values. |
|
For Generic types: Specify the key type for Map keys. |
|
For Generic types: Specify the key property name value. |
|
Used for class and application wide conversion rules. |
Create ClassName-conversion.properties via "ant apt" target
This is an example for the apt ant target:
<target name="apt"> <mkdir dir="${build}/generated"/> <path id="classpath"> <pathelement path="${basedir}/build/java"/> <pathelement path="${basedir}/build/test"/> <!-- xwork.jar and xwork-tiger.jar must be in one of the following lib dirs --> <fileset dir="${basedir}/lib/build" includes="*.jar"/> <fileset dir="${basedir}/lib/default" includes="*.jar"/> <fileset dir="${basedir}/lib/spring" includes="*.jar"/> </path> <property name="pclasspath" refid="classpath"/> <!-- Change the includes attribute value to match your annotated java files --> <fileset id="sources" dir="." includes="src/test/**/*.java" /> <pathconvert pathsep=" " property="sourcefiles" refid="sources"/> <echo> CLASSPATH ${pclasspath} SOURCES: ${sourcefiles} </echo> <exec executable="apt" > <arg value="-s"/> <arg value="${build}/generated"/> <arg value="-classpath"/> <arg pathref="classpath"/> <arg value="-nocompile"/> <arg value="-factory"/> <arg value="com.opensymphony.xwork.apt.XWorkProcessorFactory"/> <arg line="${sourcefiles}"/> </exec> </target>