Struts2的校验器详解/验证框架详解/校验框架详解

本文详细介绍了如何在Struts2中使用校验器进行前端数据验证,包括步骤、实例配置和常见校验器如required、email等的使用。从创建校验器配置文件,到页面标记和Action实现,以及内置校验器的介绍,为开发者提供了一套完整的校验解决方案。
摘要由CSDN通过智能技术生成

简介

Struts2 的校验器是在后端对前端提交的数据进行校验,在调用 Action 的指定方法前会先调用校验器的有关方法,校验通过才会调用 Action 指定的方法,校验不通过则会调用 Action 的方法 input(),该方法返回字符串“input”。

校验不通过会将有关的提示信息存储到 Action 对象中的成员变量 validationAware 中(这个成员变量继承自 ActionSupport),然后再调用 Action 的方法 input()(这个方法继承自 ActionSupport),该方法返回字符串“input”。

控制器再将请求转发给名为“input”的 JSP 页面。

使用校验器步骤

1.先写前端页面 JSP

写页面时要确定哪些字段的数据需要校验,在需要校验的字段旁边添加标签 <s:fielderror/>,如下所示:

 <tr>
	td>邮箱:</td>
	<td><input type="text" name="email"/></td>
	<%--使用<s:fielderror/>标签输出对应字段的错误信息,属性fieldName指定出现错误信息的字段名称--%>
	<td><s:fielderror fieldName="email"/></td>
</tr>

2.写 Action

Action 的属性名称要和前端页面的字段名称保持一致。自定义的 Action 必须继承自 ActionSupport。

3.struts.xml 对 Action 配置

 <action name="register" class="priv.lwx.struts2.validator.web.RegisterAction">
	<result name="success">success.jsp</result>
	<!--校验失败后,struts2会把页面转到名为"input"的页面中-->
	<result name="input">register.jsp</result>
</action>

4.创建校验器配置文件

首先确定调用哪个 Action 需要校验请求参数的数据。

例如,调用名称为 register 的 Action 需要校验页面表单项的数据,那么就需要在 Action 所在的包目录下创建一个校验器配置文件,并且该配置文件的取名规则为:Action 类的名称-Action 的名称-validation.xml

Action 的名称:struts.xml 文件中标签 <action/> 的属性 name 的值

例如,下面的 action:

<action name="register" class="priv.lwx.struts2.validator.web.RegisterAction">
	<result name="success">success.jsp</result>
    <!--校验失败后,struts2会把页面转到名为"input"的页面中-->
	<result name="input">register.jsp</result>
</action>

访问 register,需要校验表单数据,那么就可以创建名为 RegisterAction-register-validation.xml 的配置文件。并将该配置文件存放在 RegisterAction 所在的包目录下。Maven 项目在开发时,只能将配置文件存放在目录 resources 下,因此需要将该配置文件存放在目录 resources 中相对应的包目录下,所以你要先在目录 resources 目录下创建和 RegisterAction 的包目录结构相同的目录,再将配置文件存放在对应的包目录下,如下图所示:
在这里插入图片描述

如果配置文件命名为 RegisterAction-validation.xml,则只要访问类 RegisterAction 就会去调用校验器。

校验器调用顺序:
按下面的顺序加载解析校验器配置文件,调用相应的校验器。
先加载 action类名-validation.xml,然后加载 action类名-name属性值-validation.xml 文件。

5.校验器配置

先指定被校验的字段,再指定校验器。谁被校验,由谁来校验!这是【字段 → 校验器】配置风格

例如:

  <!-- 属性name指定被校验的字段名称,这里对字段email进行校验 -->
    <field name="email">
        <!-- 属性type指定校验器名,requiredstring:非空字符串校验器 -->
        <field-validator type="requiredstring">
            <!--校验不通过,标签<message/>中的文本会作为标签<s:fielderror/>所输出的HTML标签的文本,显示在页面中-->
            <message>邮箱不能为空</message>
        </field-validator>
        <!-- 一个字段可以配置多个校验器,email:邮箱格式校验器 -->
        <field-validator type="email">
            <message>邮箱格式不正确</message>
        </field-validator>
    </field>

先指定校验器,再指定被校验的字段。由谁来校验,来校验谁!这是【校验器 → 字段】配置风格。

例如:

<validator type="校验器名">
    <param name="fieldName">需要被校验的字段</param>
    <param name="参数名">参数值</param>
    <!--校验不通过在页面显示的提示信息 -->
    <message>提示信息</message>
</validator>

演示案例

项目结构图如下:
在这里插入图片描述

register.jsp的代码如下:

<%@ page language="java" contentType="text/html; charset=UTF-8" pageEncoding="UTF-8" %>
<%--引用struts2标签库--%>
<%@ taglib uri="/struts-tags" prefix="s" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
    <s:head/>
    <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
    <title>注册</title>
</head>
<body>
<form action="register1.action" method="post">
    <table>
        <tr>
            <td>邮箱:</td>
            <td><input type="text" name="email"/></td>
            <%--使用<s:fielderror/>标签输出对应字段的错误信息,属性fieldName指定出现错误信息的字段名称--%>
            <td><s:fielderror fieldName="email"/></td>
        </tr>
        <tr>
            <td>密码:</td>
            <td><input type="password" name="password"/></td>
            <td><s:fielderror fieldName="password"/></td>
        </tr>
        <tr>
            <td>重复密码:</td>
            <td>
                <input type="password" name="repassword"/></td>
            <td><s:fielderror fieldName="repassword"/></td>
        </tr>
        <tr>
            <td>电话:</td>
            <td><input type="text" name="phone"/></td>
            <td><s:fielderror fieldName="phone"/></td>
        </tr>
        <tr>
            <td><input type="submit" value="提交"/></td>
            <td></td>
            <td></td>
        </tr>
    </table>
</form>
</body>
</html>

success.jsp的代码如下:

<%@ page language="java" contentType="text/html; charset=UTF-8" pageEncoding="UTF-8" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
    <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
    <title>注册成功</title>
</head>
<body>
欢迎你 ${email}
</body>
</html>

RegisterAction 的代码如下:

package priv.lwx.struts2.validator.web;

import com.opensymphony.xwork2.ActionSupport;

/**
 * description
 *
 * @author liaowenxiong
 * @date 2022/5/31 18:43
 */

public class RegisterAction extends ActionSupport {
  // 页面中需要校验的字段必须和Action的属性一一对应
  private String email;
  private String password;
  private String repassword;
  private String phone;

  public String execute() throws Exception {
    return SUCCESS;
  }

  public String getEmail() {
    return email;
  }

  public void setEmail(String email) {
    this.email = email;
  }

  public String getPassword() {
    return password;
  }

  public void setPassword(String password) {
    this.password = password;
  }

  public String getRepassword() {
    return repassword;
  }

  public void setRepassword(String repassword) {
    this.repassword = repassword;
  }

  public String getPhone() {
    return phone;
  }

  public void setPhone(String phone) {
    this.phone = phone;
  }
}

struts.xml 的配置如下:

<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE struts PUBLIC
        "-//Apache Software Foundation//DTD Struts Configuration 2.3//EN"
        "http://struts.apache.org/dtds/struts-2.3.dtd">

<struts>
    <constant name="struts.i18n.encoding" value="UTF-8"/>
    <package name="default" namespace="/" extends="struts-default">
        <!-- http://localhost:8080/sv/register.jsp -->
        <action name="register" class="priv.lwx.struts2.validator.web.RegisterAction">
            <result name="success">success.jsp</result>
            <!--校验失败后,struts2会把页面转到名为"input"的页面中-->
            <result name="input">register.jsp</result>
        </action>
    </package>
</struts>

RegisterAction-validation.xml 的代码如下:

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE validators PUBLIC
        "-//Apache Struts//XWork Validator 1.0.2//EN"
        "http://struts.apache.org/dtds/xwork-validator-1.0.2.dtd">
<!--配置校验器-->
<validators>
    <!-- 属性name指定被校验的字段名称,这里对字段email进行校验 -->
    <field name="email">
        <!-- 属性type指定校验器名,requiredstring:非空字符串校验器 -->
        <field-validator type="requiredstring">
            <!--校验不通过,标签<message/>中的文本会作为标签<s:fielderror/>所输出的HTML标签的文本,显示在页面中-->
            <message>邮箱不能为空</message>
        </field-validator>
        <!-- 一个字段可以配置多个校验器,email:邮箱格式校验器 -->
        <field-validator type="email">
            <message>邮箱格式不正确</message>
        </field-validator>
    </field>

    <field name="password">
        <field-validator type="requiredstring">
            <message>密码不能为空</message>
        </field-validator>
        <!-- stringlength:字符串长度校验器 -->
        <field-validator type="stringlength">
            <!-- 通过校验器参数来添加和设置校验规则,minlength:最小长度 -->
            <param name="minLength">6</param>
            <message>密码长度不能少于6位</message>
        </field-validator>
    </field>

    <!-- 校验两次密码是否一致,使用fieldexpression校验器。expression参数指定判断用的表达式-->
    <field name="repassword">
        <field-validator type="fieldexpression">
            <!-- 表达式要写在<![CDATA[]]>内 -->
            <param name="expression"><![CDATA[repassword==password]]></param>
            <message>两次密码不一至</message>
        </field-validator>
    </field>

    <!-- 校验电话格式,使用regex正则表达式校验器,regexExpression参数指定正则表达式 -->
    <field name="phone">
        <field-validator type="regex">
            <!-- 注意!2.3.15前的版本使用expression参数 -->
            <param name="regexExpression"><![CDATA[\d{11}]]></param>
            <message>电话号码格式不正确</message>
        </field-validator>
    </field>
</validators>

常用校验器

Struts2 提供了大量的内置校验器,你可以在 xwork-core-2.1.6.jar 的 com.opensymphony.xwork2.validator.validators 下的 default.xml 中查看所有的内置校验器。

required

必填校验器,要求field的值不能为null。

requiredstring

必填字符串校验器,要求field的值不能为null,并且长度大于0

参数说明
trim指定在校验字符串长度之前是否去除字符串前后的空格。

stringlength

字符串长度校验器,要求field的值的长度必须在指定的范围内,否则校验不通过。

参数说明
minLength指定最小长度。
maxLength指定量大长度。
trim指定在校验字符串长度之前是否去除字符串前后的空格。

regex

正则表达式校验器,校验field的值是否与指定的正则表达式相匹配。

参数说明
expression指定正则表达式(2.3.15版用regexExpression)。
caseSensitive指定进行正则表达式匹配时是否区分大小写。

int

整数校验器,要求field的值必须是整型数值,且数值必须在指定的范围内。

参数说明
min指定最小值。
max指定最大值。

double

双精度浮点数校验器,要求field的值必须是double数值,并且数值必须在指定范围内。

参数说明
min指定最小值。
max指定最大值。

fieldexpression

OGNL 表达式校验器。要求 field 的值满足一个 ognl 表达式。

参数说明
expression指定ognl表达式(表达式要写在 <![CDATA[]]>内)。

email

邮件地址校验器。如果field的值非空,则必须符合邮箱地址格式的要求(即必须是合法的邮箱地址)

url

网址校验器。如果field的值非空,则必须符合url格式的要求(即必须是合法的URL地址)

date

日期校验器,要求field的值必须是日期类型的,且日期值必须在指定范围内

参数说明
min指定最小值。
max指定最大值。

conversion

转换校验器,指定在类型转换失败时,提示错误信息。

visitor

用于校验action中的复合属性。它指定一个校验文件用于校验复合属性中的属性。

expression

OGNL表达式校验器。要求 field 满足一个ognl表达式。该校验器不可用在【字段 → 校验器】风格的配置中!

参数说明
expression指定ognl表达式(表达式要写在 <![CDATA[]]> 内)。

参考

1.https://www.cnblogs.com/likailan/p/3302284.html

评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值