如果 From 数据操作有误,比如输入不是我们需要的数据,又或者没有输入等输入原因。 Action 实例执行 execute 方法前会使用校验来进行控制。本节就是介绍如何在 Struts2 中实现校验功能。
技术要点
本节代码中还是使用登录功能作为示例
= Action 类中 ActionSupport 使用以及 validate 方法重写实现。
= 属性文件 messageResource.properties 定义以及 JSP 页面上错误信息如何显示。
= 导航结果页面演示。
演示代码
<!------------------------------------------- 文件名: LoginAction.java-------------------------------->
public class LoginAction extends ActionSupport {
// 校验方法,用来校验输入值为空或没有输入返回错误信息
public void validate() {
if (getUsername() == null || getUsername().trim().equals("")) {
// 返回错误信息键值, user.required 包含具体内容见 messageResource.properties
addFieldError("username", getText("user.required"));
}
if (getPassword() == null || getPassword().trim().equals("")) {
// 返回错误信息键值, pass.required 包含具体内容见 messageResource.properties
addFieldError("password", getText("pass.required"));
}
}
}
struts.properties 定义显示信息文件名
<!------------------------------------------- 文件名: struts.properties -------------------------------->
# 支持本地化的资源文件名定义
struts.custom.i18n.resources=messageResource
messageResource.properties 定义出错信息
<!------------------------------------------- 文件名: messageResource.properties -------------------------------->
# 用 key=value 格式定义页面上显示的内容
user.required= 请输入用户名!
pass.required= 请输入密码!
登录 JSP 代码:
<!------------------------------------------- 文件名: login.jsp -------------------------------->
<%@ page language="java" pageEncoding="gb2312"%>
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<!-- struts2 标签库调用声明 -->
<%@taglib prefix="s" uri="/struts-tags"%>
<html>
<head>
<title> 登录页面 </title>
</head>
<body>
<!-- form 标签库定义,以及调用哪个 Action 声明 -->
<s:form action="Login">
<table width="60%" height="76" border="0">
<!-- 各标签定义 -->
<s:textfield name="username" label=" 用户名 "/>
<s:password name="password" label=" 密 码 " />
<s:submit value=" 登录 " align="center"/>
</table>
</s:form>
</body>
</html>
登录页面如图 3.1 所示。
图 3.1 登录初始页面
不输入直接登录显出出错页面如图 3.2 所示。
图 3.2 错误提示页面
输入数据页面如图 3.3 所示。
图 3.3 输入数据页面
登录成功 JSP 代码:
<!------------------------------------------- 文件名: success.jsp -------------------------------->
<%@ page language="java" contentType="text/html; charset=GB2312"%>
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<title> 登录成功 </title>
</head>
<body>
<!-- 取得 session 中用户名值 -->
${sessionScope.user}, 欢迎您 ~~
</body>
</html>
登录成功页面如图 3.4 所示。
图 3.4 登录成功页面
代码解释
( 1 ) LoginAction 类中继承 ActionSupport 类,此类也是 Struts2 自带的类之一。该类有一个 validate 方法,所以继承 ActionSupport 类的 Action 子类都可以通过重写此方法来定义自己开发的项目操作失败后的错误提示信息。
注意: Struts2 类库里有个 BaseAction 类,该类也是继承 ActionSupport 类的。因此也可以在具体 Action 类代码里,直接继承 BaseAction 类。比如在 LoginAction 代码粗体所示处,将“ ActionSupport ”改为“ BaseAction ”,这样同样可以重写 validate 方法,不会产生任何编译错误。
如代码所示出错信息,其中 addFieldError 方法和 getText 方法也是 ActionSupport 类的方法,只是 Action 子类是直接调用没有重写它们。 addFieldError 方法顾名思义就是对 JSP 页面上 Form 中某个需要校验的 field ,如果操作有错误时候如何进行错误信息处理的方法。比如“ username ”就是 JSP 页面上这个字段的名字,而“ user.required ”是错误信息属性文件里定义的。我们使用 getText 方法可以得到属性文件里“ user.required ”对应的具体错误信息。
注意: validate 方法一般都是 Action 类执行 execute 方法之前执行,这样如果操作失败,就直接返回到 struts.xml 中定义的“ input ”指向的 URL 。而“ input ”指向的 JSP 页面也正是登录初始页面,如图 3.2 所示,在登录初始页面显示了错误提示信息。
( 2 )在 Struts2 中还有个很重要的概念就是属性文件,一般有个名字为 struts.properties 的属性文件是 Struts2 中全局属性配置的文件。如代码里看到的,对于本地化的处理,直接使用该文件里定义的 messageResource.properties 文件。
( 3 ) messageResource.propertie 文件定义的两个属性就是在 Action 类里显示的“ user.required ”和“ pass.required ”,采用“ key=value ”格式,定义了具体错误信息内容。
如果 result 值为“ success ”则转到 success.jsp 。在该示例中这个页面代码中我们显示了之前放置在 HTTP 的 session 里的用户名值。如图 3.4 所示。
如果 result 值为“ input ”则转到 login.jsp 。在该示例中, login.jsp 将之前所述的错误提示信息值在 JSP 页面上显示。如图 3.2 所示。
( 4 ) login.jsp 里用 Struts2 的标签库显示 Form 和它里面各字段定义。具体标签使用方式可见之后章节内容,在此就不详述了。唯一值得说的就是只有在 JSP 页面使用 Form 标签,这节叙述的校验功能才会起作用。因为 Form 标签本身已具备显示校验错误的能力。
更多信息请查看 java进阶网 http://www.javady.com