验证(Validations)
在本章中,我们将深入研究Struts验证框架。 在Struts核心,我们有验证框架,可以帮助应用程序运行规则,以便在执行操作方法之前执行验证。
客户端验证通常使用Javascript实现。 但是,不应该单独依赖客户端验证。 最佳实践建议应在应用程序框架的所有级别引入验证。 现在让我们看看为Struts项目添加验证的两种方法。
在这里,我们将举例说明一个Employee的名字和年龄应该使用一个简单的页面来捕获,我们将把这两个验证放在一起,以确保用户总是输入一个名称和年龄,该名称和年龄应在28到28之间。 65。
让我们从示例的主JSP页面开始。
创建主页面
让我们编写主页JSP文件index.jsp ,它将用于收集上面提到的Employee相关信息。
<%@ page language = "java" contentType = "text/html; charset = ISO-8859-1"
pageEncoding = "ISO-8859-1"%>
<%@ taglib prefix = "s" uri = "/struts-tags"%>
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
"http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
<title>Employee Form</title>
</head>
<body>
<s:form action = "empinfo" method = "post">
<s:textfield name = "name" label = "Name" size = "20" />
<s:textfield name = "age" label = "Age" size = "20" />
<s:submit name = "submit" label = "Submit" align="center" />
</s:form>
</body>
</html>
index.jsp使用了我们尚未涉及的Struts标记,但我们将在标签相关章节中研究它们。 但是现在,假设s:textfield标签打印输入字段,s:submit打印一个提交按钮。 我们为每个标签使用了label属性,为每个标签创建标签。
创建视图 (Create Views)
我们将使用JSP文件success.jsp,如果定义的操作返回SUCCESS,将调用它。
<%@ page language = "java" contentType = "text/html; charset = ISO-8859-1"
pageEncoding = "ISO-8859-1"%>
<%@ taglib prefix = "s" uri = "/struts-tags"%>
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
"http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
<title>Success</title>
</head>
<body>
Employee Information is captured successfully.
</body>
</html>
Create Action
因此,让我们定义一个小动作类Employee ,然后添加一个名为validate()的方法,如下所示在Employee.java文件中。 确保您的操作类扩展了ActionSupport类,否则将不会执行您的validate方法。
package cn.xnip.struts2;
import com.opensymphony.xwork2.ActionSupport;
public class Employee extends ActionSupport {
private String name;
private int age;
public String execute() {
return SUCCESS;
}
public String getName() {
return name;
}
public void setName(String name) {
this.name = name;
}
public int getAge() {
return age;
}
public void setAge(int age) {
this.age = age;
}
public void validate() {
if (name == null || name.trim().equals("")) {
addFieldError("name","The name is required");
}
if (age < 28 || age > 65) {
addFieldError("age","Age must be in between 28 and 65");
}
}
}
如上例所示,验证方法检查“名称”字段是否具有值。 如果未提供任何值,我们会在“名称”字段中添加字段错误,并显示自定义错误消息。 其次,我们检查“年龄”字段的输入值是否介于28和65之间,如果此条件不符合,我们在验证字段上方添加错误。
配置文件 (Configuration Files)
最后,让我们使用struts.xml配置文件将所有内容放在一起,如下所示 -
<?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>
<constant name = "struts.devMode" value = "true" />
<package name = "helloworld" extends = "struts-default">
<action name = "empinfo"
class = "cn.xnip.struts2.Employee"
method = "execute">
<result name = "input">/index.jsp</result>
<result name = "success">/success.jsp</result>
</action>
</package>
</struts>
以下是web.xml文件的内容 -
<?xml version = "1.0" Encoding = "UTF-8"?>
<web-app xmlns:xsi = "http://www.w3.org/2001/XMLSchema-instance"
xmlns = "http://java.sun.com/xml/ns/javaee"
xmlns:web = "http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd"
xsi:schemaLocation = "http://java.sun.com/xml/ns/javaee
http://java.sun.com/xml/ns/javaee/web-app_3_0.xsd"
id = "WebApp_ID" version = "3.0">
<display-name>Struts 2</display-name>
<welcome-file-list>
<welcome-file>index.jsp</welcome-file>
</welcome-file-list>
<filter>
<filter-name>struts2</filter-name>
<filter-class>
org.apache.struts2.dispatcher.FilterDispatcher
</filter-class>
</filter>
<filter-mapping>
<filter-name>struts2</filter-name>
<url-pattern>/*</url-pattern>
</filter-mapping>
</web-app>
现在,右键单击项目名称,然后单击“ Export 》 WAR File以创建War文件。 然后在Tomcat的webapps目录中部署此WAR。 最后,启动Tomcat服务器并尝试访问URL http://localhost:8080/HelloWorldStruts2/index.jsp 。 这将产生以下屏幕 -
现在不要输入任何必要的信息,只需点击Submit按钮即可。 您将看到以下结果 -
输入所需信息,但输入错误的From字段,让我们将名称命名为“test”,将年龄改为30,最后单击Submit按钮。 您将看到以下结果 -
此验证如何工作?
当用户按下提交按钮时,Struts 2将自动执行validate方法,如果方法中列出的任何“if”语句为true,Struts 2将调用其addFieldError方法。 如果添加了任何错误,Struts 2将不会继续调用execute方法。 而Struts 2框架将作为调用操作的结果返回input 。
因此,当验证失败并且Struts 2返回input ,Struts 2框架将重新显示index.jsp文件。 因为,我们使用Struts 2表单标签,Struts 2会自动在表单上方添加错误消息。
这些错误消息是我们在addFieldError方法调用中指定的消息。 addFieldError方法有两个参数。 第一个是应用错误的form字段名称,第二个是在该表单字段上方显示的错误消息。
addFieldError("name","The name is required");
要处理input的返回值,我们需要将以下结果添加到struts.xml的action节点。
<result name = "input">/index.jsp</result>
基于XML的验证
第二种进行验证的方法是在操作类旁边放置一个xml文件。 基于Struts2 XML的验证提供了更多的验证选项,如电子邮件验证,整数范围验证,表单验证字段,表达式验证,正则表达式验证,必需的验证,必需字符串验证,stringlength验证等。
xml文件需要命名为'[action-class]'-validation.xml 。 因此,在我们的例子中,我们创建了一个名为Employee-validation.xml的文件,其中包含以下内容 -
<!DOCTYPE validators PUBLIC
"-//OpenSymphony Group//XWork Validator 1.0.2//EN"
"http://www.opensymphony.com/xwork/xwork-validator-1.0.2.dtd">
<validators>
<field name = "name">
<field-validator type = "required">
<message>
The name is required.
</message>
</field-validator>
</field>
<field name = "age">
<field-validator type = "int">
<param name = "min">29</param>
<param name = "max">64</param>
<message>
Age must be in between 28 and 65
</message>
</field-validator>
</field>
</validators>
上面的XML文件理想情况下会与类文件一起保存在CLASSPATH中。 让我们按照以下方式使用Employee操作类,而不使用validate()方法 -
package cn.xnip.struts2;
import com.opensymphony.xwork2.ActionSupport;
public class Employee extends ActionSupport{
private String name;
private int age;
public String execute() {
return SUCCESS;
}
public String getName() {
return name;
}
public void setName(String name) {
this.name = name;
}
public int getAge() {
return age;
}
public void setAge(int age) {
this.age = age;
}
}
其余的设置将保持原样,如前所示,现在如果您将运行应用程序,它将产生我们在前面的示例中收到的相同结果。
使用xml文件存储配置的优点允许将验证与应用程序代码分开。 您可以让开发人员编写代码和业务分析师来创建验证xml文件。 另一件需要注意的是默认情况下可用的验证器类型。
Struts默认有更多的验证器。 常用验证器包括Date Validator,Regex验证器和String Length验证器。 检查以下链接以获取更多详细信息Struts - 基于XML的验证器 。