| |
Struts Tutorials:
Struts2 Tag CheckBoxList
, Checkbox, Iterator, IF
Struts2 Tag Library Example
Struts2 Tiles Example
Struts2 Tiles I18N Example
Struts2 Questions
Struts Tiles I18N Example
Struts Eclipse MVC
Struts2 Tags
Struts2 Example and Tutorial
Struts MVC
Struts2 Validation
Hibernate Tutorials:
Hibernate Case Study
Class Hierarchy Persist Example
Using Hibernate Interceptor
Hibernate Questions with Answer
Hibernate Many-to-Many Mapping Example
Hibernate one-to-many Mapping Example
Hibernate and ORM tools
Spring Hibernate Example
Hibernate SessionFactory Example
Hibernate Mapping Class Hierarchy
Hibernate Questions
Hibernate SessionFactory Questions
Spring Hibernate Example:
Spring Hibernate Case Study
Written By : ISHTEK
Title :
Struts2
Description :
Tags such as IF Iterator Tags
More...
|
Written By : guddu
Title :
Struts Eclipse MVC
Description :
Step by step demonstration
More...
|
Written By : Girish
Title :
Struts Tiles I18N Example
Description :
Code with Sample Action
More...
|
Written By : ISHTEK
Title :
Struts2 questions
Description :
open for discussion
More...
|
Written By : ISHTEK
Title :
Struts2 Tiles Example
Description :
with Code and article
More...
|
Written By : ISHTEK
Title :
Struts2 Tiles I18N Example
Description :
with code explained article
More...
|
Written By : Amit
Title :
Struts2 Tag Library Example
Description :
Tutorial
More...
|
| Struts2 Validation,Validation Example, Struts 2 Example
Author : Amit
Date (Year/Month/Date): 2009-04-25
Struts2 Validation Example | |
Let us take the existing Example of using Struts2 Frameworks and build
code for some basic validation arround the text field.
Software environment I have used for this example, so far as follows:
1. JDK 5.0
2. Tomcat 5.5.x
3. Eclipse 3.2
4. Apache Struts 2.1.6 (example Web application should have
following JAR files in WEB-INF\lib folder)
4.1. commons-fileupload-1.2.1.jar
4.2. commons-io-1.3.2.jar
4.3. commons-logging-1.1.jar
4.4. freemarker-2.3.13.jar
4.5. ognl-2.6.11.jar
4.6. struts2-core-2.1.6.jar
4.7. xwork-2.1.2.jar
(Note: This example is not tested with any
other version of Apache Struts )
This example is having a screen that has text fields, checkboxes and radio buttons
to accept user inputs. Let us put some "required" constraint arround these text fields
and don't allow to proceed to the preview screen, before user enters some values into
these text fields.
In order to apply validation for the mandatory text fields, we need to make changes
in JSP file,struts.xml file, Action class and provide a Validation XML file with name
as Action_Class_Name-validation.xml, so in this example if Action class is ExamplePOJOAction
, then this Action class should extend ActionSupport from Struts2 and the
validation XML file should be named as "ExamplePOJOAction-validation.xml" file.
So let us take each of these parts of this example and discuss:
index.jsp
<%@ taglib uri="/struts-tags" prefix="struts2"%>
<html>
<body>
<struts2:actionerror/>
<struts2:bean id="so" name="sample.SubscriptionOptions"/>
<struts2:bean id="consentOption" name="sample.ConsentOptions"/>
<struts2:form method="post" action="example" namespace="/sample">
<table>
<tr><td><struts2:textfield key="myBean.userName" label="Name "/></td></tr>
<tr><struts2:textfield key="myBean.roll" label="Roll "/></td></tr>
<tr><td><struts2:textfield key="myBean.section" label="Section "/></td></tr>
<tr><struts2:textfield key="myBean.stdClass" label="Std/Class "/></td></tr>
<struts2:checkbox key="myBean.newsLetterOption" label="Subscription for News Letters "/>
<struts2:checkboxlist label="Other Subscription Options " key="myBean.subscriptionOptions" list="so" labelSeparator=":"/>
<struts2:radio label="You opinion " key="myBean.consentOptions" list="consentOption" labelSeparator=":"/>
<tr><td colspan="2"><struts2:submit value="Register"/></td></tr>
</table>
</struts2:form>
</body>
</html>
|
Text with bold red color, shows that, any validation error will be shown on
this screen at the place of this actionerror TAG.
struts.xml file will have a result name as "input", which is implicitly used
by validation for taking navigation to this result path.
<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE struts PUBLIC
"-//Apache Software Foundation//DTD Struts Configuration 2.0//EN"
"http://struts.apache.org/dtds/struts-2.0.dtd">
<struts>
<package name="hibernate-example" namespace="/sample"
extends="struts-default">
<action name="example" class="sample.ExamplePOJOAction"
method="preview">
<result name="preview">/preview.jsp</result>
<result name="input">/index.jsp</result>
</action>
</package>
</struts>
|
As mentioned earlier, the validation specific XML file, that holds
information about the field name and the type of declarative constraint
to be imposed on the field, this validation XML file will have to
be named as "ExamplePOJOAction-validation.xml" (Bold being Action class
name) and this validation XML file should be placed in the same folder where
the Action class is put/present.
<!DOCTYPE validators PUBLIC
"-//OpenSymphony Group//XWork Validator 1.0.3//EN"
"http://www.opensymphony.com/xwork/xwork-validator-1.0.3.dtd">
<validators>
<field name="myBean.userName">
<field-validator type="requiredstring">
<message>Please enter User name</message>
</field-validator>
</field>
</validators>
|
So only userName field from MyBean class will be validated for
requiredstring constraint/validation.
Action class can be same as that of earlier example and as shown below:
ExamplePOJOAction.java
package sample;
/**
* This code is provided "AS IS" without any guaranty
* Use of this code only for educational and learning
* purpose only.
* Author: Amit
* Contact : usingframeworks@gmail.com
* Date: 16-Feb-2009
*/
import java.util.Map;
import com.opensymphony.xwork2.ActionSupport;
/**
* This is the Action POJO class
*/
public class ExamplePOJOAction extends ActionSupport {
private MyBean myBean;
public String preview() throws Exception {
return "preview";
}
public void setMyBean(MyBean argMyBean) {
myBean = argMyBean;
}
public MyBean getMyBean() {
return myBean;
}
}
|
All remaining supporting files can be obtained from my earlier example
from the link below:
Struts 2 Example
OR as follows:
Now Mybean is the class that is holding all the variables those will
be accepting values from Struts2 Tags from index.jsp file.
Now I am going to add another variable "consentOptions" of type java.util.List
and corresponding setter and getter methods.
MyBean.java
package sample;
/**
* This code is provided "AS IS" without any guaranty
* Use of this code only for educational and learning
* purpose only.
* Author: Amit
* Contact : usingframeworks@gmail.com
* Date: 16-Feb-2009
*/
import java.util.List;
import java.util.ArrayList;
public class MyBean
{
private String userName;
private String roll;
private String section;
private String stdClass;
private List subscriptionOptions;
private List consentOptions;
private boolean newsLetterOption;
public String getUserName() {
return this.userName;
}
public void setUserName(String argUserName) {
userName = argUserName;
}
public String getRoll() {
return this.roll;
}
public void setRoll(String argRoll) {
roll = argRoll;
}
public String getSection() {
return this.section;
}
public void setSection(String argSection) {
section = argSection;
}
public String getStdClass() {
return this.stdClass;
}
public void setStdClass(String argStdClass) {
stdClass = argStdClass;
}
public List getSubscriptionOptions() {
return subscriptionOptions;
}
public void setSubscriptionOptions(List argSubscriptionOptions) {
subscriptionOptions = argSubscriptionOptions;
}
public void setNewsLetterOption(boolean argNewsLetterOption) {
newsLetterOption = argNewsLetterOption;
}
public boolean getNewsLetterOption() {
return newsLetterOption;
}
public void setConsentOptions(List argConsentOptions) {
consentOptions = argConsentOptions;
}
public List getConsentOptions() {
return consentOptions;
}
}
|
And another class file that holds all the hard coded subscription options
for this example, those are to be shown in checkbox list as labels.
SubscriptionOptions.java
package sample;
/**
* This code is provided "AS IS" without any guaranty
* Use of this code only for educational and learning
* purpose only.
* Author: Amit
* Contact : usingframeworks@gmail.com
* Date: 16-Feb-2009
*/
import java.util.ArrayList;
public class SubscriptionOptions extends ArrayList
{
public SubscriptionOptions() {
super();
add("Technical Support");
add("Business Support");
add("HR Support");
add("Help Desk Emails");
}
}
|
Just like Subscription options, I have introduced another class "ConsentOptions.java".
This class file holds all the labels for the radio buttons, like for this example,
these are "Agree" and "Disagree" .
ConsentOptions.java
package sample;
/**
* This code is provided "AS IS" without any guaranty
* Use of this code only for educational and learning
* purpose only.
* Author: Amit
* Contact : usingframeworks@gmail.com
* Date: 16-Feb-2009
*/
import java.util.ArrayList;
public class ConsentOptions extends ArrayList
{
public ConsentOptions() {
super();
add("Agree");
add("Disagree");
}
}
|
Once all the fields in MyBean are populated with values from index.jsp
screen, then these values are to be shown in preview page, so comes the
preview.jsp file. There is a slight change in this preview.jsp file, to include
Radio button selectioned value, either Agree or Disagree.
preview.jsp
<%@ taglib uri="/struts-tags" prefix="struts2"%>
<html>
<head></head>
<body>
<h2>Preview Page</h2>
<table>
<tr><td>
<b><font color="green">Name : </font>
</td><td><struts2:property value="myBean.userName"/></td></tr>
<tr><td><b><font color="green">Roll No. : </font></b></td><td>
<struts2:property value="myBean.roll"/></td></tr>
<tr><td><b><font color="green">Section : </font>
</b></td><td><struts2:property value="myBean.section"/></td></tr>
<tr><td><b><font color="green">Std/Class : </font>
</b></td><td><struts2:property value="myBean.stdClass"/></td></tr>
<tr><td>
<b><font color="green">New Letter Subscription :</font></b></td><td>
<struts2:if test="myBean.newsLetterOption">
Yes
</struts2:if>
<struts2:else>
No
</struts2:else>
</td></tr>
<tr><td valign="top"><b><font color="green">Other Subscription Options:</font></b></td><td>
<struts2:iterator id="a" value="myBean.subscriptionOptions">
<struts2:property value="a"/>
<br>
</struts2:iterator>
</td></tr>
<tr><td valign="top"><b><font color="green">User consent Option selected :</font></b></td><td>
<struts2:iterator id="b" value="myBean.consentOptions">
<struts2:property value="b"/>
<br>
</struts2:iterator>
</td></tr>
</table>
</body>
</html>
|
If you are interested in setting up this example in tomcat web server,
following are some other files details such as
web.xml
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE web-app
PUBLIC "-//Sun Microsystems, Inc.//DTD Web Application 2.3//EN"
"http://java.sun.com/dtd/web-app_2_3.dtd">
<web-app>
<display-name>Struts Blank</display-name>
<filter>
<filter-name>sample-filter</filter-name>
<filter-class>
org.apache.struts2.dispatcher.ng.filter.StrutsPrepareAndExecuteFilter
</filter-class>
</filter>
<filter-mapping>
<filter-name>sample-filter</filter-name>
<url-pattern>/*</url-pattern>
</filter-mapping>
</web-app>
|
After running this example on Browser following are the screens, one before
validation/error and the other after validation:
I shall be writing many more examples on using Validation with Struts2 Framework
and for various types of Struts2 Tags like Date type field, E-mail type field,
Numeric only fields and many more.
 | Author of this article/writeup has expressed his/her willingness |
to help or guide users with any technical difficulties he/she faces
while working with the example code environment setting up, running
and resolving any such exception raised during compile or at runtime.
You may ask for any technical doubt or seek technical help related to
this article by using following form to reach for technical help
from the Author for FREE.
This article's Author shall be reading your request and responding
within reasonable time (no resolution timeframe defined as such).
|
|
|
Commented By ->
Guddu | Can you please show any example on using Client or Browser
side validation using JavaScript?
And any example code on using AJAX and Struts 2? |
| | |
Commented By ->
Guddu | Is there any ways to change the way error message is shown?
Like any other CSS attribute to be included to show this erro message.
Any example code would definitely will help..
|
| |
|
|
<- requires login
