Struts2第十篇【数据校验、代码方式、XML配置方式、错误信息返回样式】
回顾以前的数据校验
- 使用一个FormBean对象来封装着web端来过来的数据
- 维护一个Map集合保存着错误信息…对各个字段进行逻辑判断
//表单提交过来的数据全都是String类型的,birthday也不例外!
private String username;
private String password;
private String password2;
private String email;
private String birthday;
//记录错误的信息
private HashMap<String, String> error = new HashMap<>();
/*用于判断表单提交过来的数据是否合法*/
public boolean validate() {
//用户名不能为空,并且要是3-8的字符 abcdABcd
if (this.username == null || this.username.trim().equals("")) {
error.put("username", "用户名不能为空,并且要是3-8的字符");
return false;
} else {
if (!this.username.matches("[a-zA-Z]{3,8}")) {
error.put("username", "用户名不能为空,并且要是3-8的字符");
return false;
}
}
//密码不能为空,并且要是3-8的数字
if (this.password == null || this.password.trim().equals("")) {
error.put("password", "密码不能为空,并且要是3-8的数字");
return false;
} else {
if (!this.password.matches("\\d{3,8}")) {
error.put("password", "密码不能为空,并且要是3-8的数字");
return false;
}
}
//两次密码要一致
if (this.password2 != null && !this.password2.trim().equals("")) {
if (!this.password2.equals(this.password)) {
error.put("password2", "两次密码要一致");
return false;
}
}
//邮箱可以为空,如果为空就必须合法
if (this.email != null && !this.email.trim().equals("")) {
if (!this.email.matches("\\w+@\\w+(\\.\\w+)+")) {
error.put("email", "邮箱不合法!");
return false;
}
}
//日期可以为空,如果为空就必须合法
if (this.birthday != null && !this.birthday.trim().equals("")) {
try {
DateLocaleConverter dateLocaleConverter = new DateLocaleConverter();
dateLocaleConverter.convert(this.birthday);
} catch (Exception e) {
error.put("birthday", "日期不合法!");
return false;
}
}
//如果上面都没有执行,那么就是合法的了,返回true
return true;
}
//.....各种的setter和getter
- 在Servlet上判断数据是否合法
//验证表单的数据是否合法,如果不合法就跳转回去注册的页面
if(formBean.validate()==false){
//在跳转之前,把formbean对象传递给注册页面
request.setAttribute("formbean", formBean);
request.getRequestDispatcher("/WEB-INF/register.jsp").forward(request, response);
return;
}
- 最后在JSP页面使用EL表达式进行回显
Struts2数据校验
Struts2为了简化我们的开发,也提供了数据校验的功能…前面已经说过了,如果想要使用数据校验的功能,在编写Action的时候就必须继承着ActionSupport类或者实现相对应的接口
Struts2数据校验实现思路
现在,我们的Action类已经继承了ActionSupport类了,现在那怎么使用数据校验的功能呢??我们想一下….
如果我们不写FormBean对象,直接在Action进行校验的话,我们可能会这样写:
private Map<String, String> map;
public void validation() {
//如果有错误了,那么就将错误信息添加到map集合
map.put();
}
public String login() {
//判断map是否有错误信息,如果有,就直接跳转到相对应的页面了,不执行login剩下的代码了。
}
上面的思路是可行的,但是不优雅…..在login()方法验证map集合,就与数据校验耦合了….于是乎,我们想要的是在调用login()方法之前就验证map集合是否存在…如果存在了错误的信息,就不调用login()方法了。
明显地,我们就需要使用拦截器…….Struts2内部的数据校验也是使用拦截器来实现的。
<interceptor name="validation" class="org.apache.struts2.interceptor.validation.AnnotationValidationInterceptor"/>
Struts2为我们提供了4种方式来实现拦截
- 使用代码拦截所有的方法
- 使用代码拦截部分的方法
- 使用XML配置拦截所有的方法
- 使用XML配置拦截部分的方法
使用代码拦截所有的方法
Struts2提供了我们做校验的方法….实现validate()
@Override
public void validate() {
super.validate();
}
validate()方法在内部已经维护了一个Map集合了
public synchronized void addFieldError(String fieldName, String errorMessage) {
Map errors = this.internalGetFieldErrors();
Object thisFieldErrors = (List)errors.get(fieldName);
if(thisFieldErrors == null) {
thisFieldErrors = new ArrayList();
errors.put(fieldName, thisFieldErrors);
}
((List)thisFieldErrors).add(errorMessage);
}
我们如果捕获到了错误信息,那么直接使用底层为我们写好的Map集合就好了!
@Override
public void validate() {
//判断用户名是否为空
if (user.getUsername() == null || "".equals(user.getUsername())) {
super.addFieldError("username","用户名是空的");
}
//判断密码是否为空
if (user.getPassword() == null || "".equals(user.getPassword())) {
super.addFieldError("username","密码是空的");
}
}
配置struts.xml文件
<package name="xxx" extends="struts-default">
<action name="user_*" class="zhongfucheng.action.UserAction" method="{1}">
<!--如果校验成功,那么回到首页-->
<result name="success">/index.jsp</result>
<!--如果失败,重新回到login页面,并显示错误信息-->
<result name="input">/login.jsp</result>
</action>
</package>
在JSP页面中,可以使用Struts自带的标签来显示错误信息
<s:fielderror></s:fielderror>
- 测试:
使用代码拦截部分方法
上面已经实现了数据校验的功能了,但是呢。现在我有一个list()方法。使用list()方法讲道理是不用进行数据校验的…
//查看user信息
public String list() {
return SUCCESS;
}
但是呢,当我执行list()方法的时候,还是经过了数据校验….
因此,我们要做的是:拦截特定的方法..非常简单,只要重命名validate()方法就行了!
- 格式:
validate + 要验证的方法名
将validate()方法名改成是validateLogin(),那么Struts2就仅仅过滤指定的方法了。
效果
使用XML配置拦截所有方法
前面我们已经使用过了代码验证的方法,,,,感觉还是要写很多代码….很多代码也是啰嗦的,要判断非空啊,数值的验证啊..等等的处理…这样判断、验证往往都是通用的…于是Struts又帮我们封装了很多的校验器
- 路径: xwork-core-2.3.4.1.jar/com.opensymphony.xwork2.validator.validators/default.xml
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE validators PUBLIC
"-//Apache Struts//XWork Validator Definition 1.0//EN"
"http://struts.apache.org/dtds/xwork-validator-definition-1.0.dtd">
<!-- START SNIPPET: validators-default -->
<validators>
<validator name="required" class="com.opensymphony.xwork2.validator.validators.RequiredFieldValidator"/>
<validator name="requiredstring" class="com.opensymphony.xwork2.validator.validators.RequiredStringValidator"/>
<validator name="int" class="com.opensymphony.xwork2.validator.validators.IntRangeFieldValidator"/>
<validator name="long" class="com.opensymphony.xwork2.validator.validators.LongRangeFieldValidator"/>
<validator name="short" class="com.opensymphony.xwork2.validator.validators.ShortRangeFieldValidator"/>
<validator name="double" class="com.opensymphony.xwork2.validator.validators.DoubleRangeFieldValidator"/>
<validator name="date" class="com.opensymphony.xwork2.validator.validators.DateRangeFieldValidator"/>
<validator name="expression" class="com.opensymphony.xwork2.validator.validators.ExpressionValidator"/>
<validator name="fieldexpression" class="com.opensymphony.xwork2.validator.validators.FieldExpressionValidator"/>
<validator name="email" class="com.opensymphony.xwork2.validator.validators.EmailValidator"/>
<validator name="url" class="com.opensymphony.xwork2.validator.validators.URLValidator"/>
<validator name="visitor" class="com.opensymphony.xwork2.validator.validators.VisitorFieldValidator"/>
<validator name="conversion" class="com.opensymphony.xwork2.validator.validators.ConversionErrorFieldValidator"/>
<validator name="stringlength" class="com.opensymphony.xwork2.validator.validators.StringLengthFieldValidator"/>
<validator name="regex" class="com.opensymphony.xwork2.validator.validators.RegexFieldValidator"/>
<validator name="conditionalvisitor" class="com.opensymphony.xwork2.validator.validators.ConditionalVisitorFieldValidator"/>
</validators>
<!-- END SNIPPET: validators-default -->
以上的校验器我们可以通过XML文件来配置,编写XML文件的语法:
- 名称语法: ActionClassName-validation.xml
- xml需要与当期要验证的action在同一个目录
- 例子:UserAction-validation.xml
那么XML该怎么写呢????Struts2也为我们提供了DTD文件
<?xml version="1.0" encoding="UTF-8"?>
<!--
XWork Validators DTD.
Used the following DOCTYPE.
<!DOCTYPE validators PUBLIC
"-//Apache Struts//XWork Validator 1.0.3//EN"
"http://struts.apache.org/dtds/xwork-validator-1.0.3.dtd">
-->
<!ELEMENT validators (field|validator)+>
<!ELEMENT field (field-validator+)>
<!ATTLIST field
name CDATA #REQUIRED
>
<!ELEMENT field-validator (param*, message)>
<!ATTLIST field-validator
type CDATA #REQUIRED
short-circuit (true|false) "false"
>
<!ELEMENT validator (param*, message)>
<!ATTLIST validator
type CDATA #REQUIRED
short-circuit (true|false) "false"
>
<!ELEMENT param (#PCDATA)>
<!ATTLIST param
name CDATA #REQUIRED
>
<!ELEMENT message (#PCDATA|param)*>
<!ATTLIST message
key CDATA #IMPLIED
>
- XML文件代码:
<?xml version="1.0" encoding="utf-8" ?>
<!DOCTYPE validators PUBLIC
"-//Apache Struts//XWork Validator 1.0.3//EN"
"http://struts.apache.org/dtds/xwork-validator-1.0.3.dtd">
<validators>
<!--指定Bean对象的username属性-->
<field name="user.username">
<!--指定类型不能是空的-->
<field-validator type="requiredstring">
<message>用户名不能是空的</message>
</field-validator>
</field>
<!--指定Bean对象的属性-->
<field name="user.password">
<!--指定类型不能是空的-->
<field-validator type="requiredstring">
<message>密码不能是空的</message>
</field-validator>
<!--设置密码的长度6到8位-->
<field-validator type="stringlength">
<param name="minLength">6</param>
<param name="maxLength">8</param>
<message>密码只能是6-8位</message>
</field-validator>
</field>
</validators>
测试
用户名和密码都不能为空
密码只能是6-8位
使用XML配置拦截特定的方法
和代码的方式一样,我们写上了XML文件,它也是默认拦截所有的方法。那么我们想要它只拦截特定的方法,怎么办呢???
修改XML文件的名称:
- 语法:
ActionClassName-ActionName-validation.xml
- 例子:UserAction-user_login-validation.xml
返回错误信息的样式
css修改Struts标签样式
我们发现,返回错误信息的样式是这样的:
这明显不符合我们的审美的……于是乎我们是可以修改它的样式的…我们查看源文件的时候,可以发现Struts为它自动加了ul li
我们可以在css文件中把它们去除就行了
<style type="text/css">
ul{
display: inline;
}
ul li {
display: inline;
color: red;;
}
</style>
修改标签定义的模板
Struts2标签的样式是由文件来指定的…具体路径如下:
我们发现ul li
是它指定加上去的,我们把它修改,然后覆盖掉它,那么Struts2在读取的时候就使用我们的文件
在src下创建template.simple包..文件是fielderror.ftl…项目在执行的时候就会把Struts2自带的给覆盖了!
指定返回错误
使用<s:fielderror></s:fielderror>
是默认返回全部错误的,我们通常来说,都是把错误放在输入框的后面的…Struts提供了指定返回错误..只要指定fileName就行了
<form action="${pageContext.request.contextPath}/user_login" method="post">
用户名:<input type="text" name="user.username"><s:fielderror fieldName="user.username"/><br>
密码:<input type="password" name="user.password"><s:fielderror fieldName="user.password"/><br>
<input type="submit" value="登陆"><br>
</form>
配置客户端校验
Struts2也支持客户端的校验,在使用Struts2的form标签的使用,在validate属性上设置为true,那么Struts2会自动加载JavaScript的类库来实现客户端的数据校验了!
总结
Struts2也提供了客户端的数据校验功能….
我们现在已经学会了使用手写代码的方式和XML配置的方式去校验数据了。。
那么哪种方式更好呢???我们来总结一下
手写代码方式:
- 更加灵活,要校验的逻辑全都是自己把握
- 但是比较繁琐,有很多的重复逻辑代码
XML配置方式
- 不用自己手写逻辑代码,调用Struts提供给我们的拦截器即可
- 但是如果拦截的方法比较多的话,会出现多个XML配置文件
最后补充:Struts2也支持通过注解的方式实现数据校验,但是这会造成Action类看起来十分冗余,一般很少使用