Struts2数据输入验证教程详解

什么是数据输入验证

在应用程序中，数据输入验证是一项重要的任务。它可以确保应用程序接受有效的、可靠的和正确的数据。数据输入验证通常采用静态和动态验证技术，在前台和后台进行验证。

静态验证技术用于验证数据格式是否为正确的格式，比如数字、日期等。而动态验证技术则用于验证数据是否是符合业务规则和逻辑的，例如输入的身份证号码必须符合国家标准。

Struts2 数据输入验证

Struts2提供了完整的数据输入验证功能，帮助开发者快速实现输入验证。它支持基于XML和基于注解的两种验证方式。下面详细介绍如何在Struts2中使用数据输入验证。

基于XML的验证

Struts2提供了基于XML的验证方式。在struts.xml文件中可以定义输入验证器，并在Action中引用这些验证器来对数据进行验证。具体步骤如下：

1. 在struts.xml文件中定义验证器和验证规则。例如：

<validators>  
    <validator type="requiredstring"   
        message="姓名不能为空！">   
        <param name="fieldName">name</param>   
    </validator>  
</validators>  

上述代码定义了一个验证器，并指定该验证器类型为requiredstring，即验证该字段是否为非空字符串。

1. 在Action中引用验证器。例如：

<action name="register" class="com.example.action.RegisterAction">  
    <result name="success">/success.jsp</result>  
    <result name="error">/error.jsp</result>  
    <interceptor-ref name="defaultStack">  
        <param name="validation.excludeMethods">execute</param>  
    </interceptor-ref>  
    <interceptor-ref name="validation">  
        <param name="excludeMethods">input</param>  
    </interceptor-ref>  
    <interceptor-ref name="workflow">  
        <param name="excludeMethods">input</param>  
    </interceptor-ref>  
    <allowed-methods>register</allowed-methods>  
</action> 

上述代码中，<interceptor-ref name="validation">表示使用Struts2的验证拦截器对Action进行验证。在<interceptor-ref>标签中，可以设置一些属性，例如excludeMethods表示排除某些方法不进行验证。此处排除了input方法，因为input方法是用于显示验证错误消息的方法。

1. 在JSP页面中使用<s:fielderror>标签显示验证出现的错误信息。例如：

<s:form action="register">  
    <s:textfield name="name">  
        <s:validator/>  
    </s:textfield>  
    <s:submit value="提交"/>  
    <s:fielderror fieldName="name"/>  
</s:form>  

上述代码定义了一个表单，其中包含一个文本框和一个提交按钮。在文本框中使用了<s:validator>标签，表示该字段需要进行验证。在错误消息部分，使用了<s:fielderror>标签，并指定了验证出现错误的字段名。

基于注解的验证

Struts2也支持基于注解的验证方式。开发者可以在Action中使用注解的方式定义验证规则。例如：

@Action(value = "register")  
@Result(name="success",location = "/success.jsp")  
@Result(name="error",location = "/error.jsp")  
public class RegisterAction extends ActionSupport{  
    private String name;  

    @Validations(  
        requiredStrings={  
        @RequiredStringValidator(type = ValidatorType.FIELD, fieldName = "name", message = "姓名不能为空")  
    })  
    @InputConfig(methodName = "input")  
    public String execute(){  
        //TODO:在这里进行业务逻辑处理，如保存数据到数据库  
        return SUCCESS;  
    }  

    public String input(){  
        return INPUT;  
    }  

    //Getter和Setter方法  
}  

上述代码中，使用@RequiredStringValidator注解对name字段进行验证，当该字段为null或者空字符串时，将会出现"姓名不能为空"的错误信息。

示例

下面是两个示例，演示在Struts2中如何使用数据输入验证。

示例一：身份证号码输入验证

身份证号码是一个复杂的格式字符串，需要使用正则表达式验证。下面是一个演示在Struts2中如何验证身份证号码的示例。

<validators>  
    <validator type="regex"   
        message="请输入有效的身份证号码！"   
        expression="\d{17}[0-9xX]"/>  
</validators>  

上述代码定义了一个验证器，类型为regex，表示使用正则表达式验证字段。正则表达式为\d{17}[0-9xX]，表示验证字符串是否是18位长，前17位为数字，最后一位可以是数字或字母X/x。

在JSP页面中，可以调用该验证器进行验证：

<s:form action="register">  
    <s:textfield name="idcard" label="身份证号码："/>  
    <s:submit value="提交"/>  
    <s:fielderror fieldName="idcard"/>  
</s:form>  

上述代码定义了一个文本框，并指定了该文本框需要进行输入验证。在错误信息部分，使用了<s:fielderror>标签，并指定了验证出现错误的字段名。

示例二：密码输入验证

密码是一个敏感的信息，需要进行多重验证，包括长度、数字和字母等。下面是一个演示如何验证密码的示例：

@Action(value = "login")  
@Result(name="success",location = "/success.jsp")  
@Result(name="error",location = "/error.jsp")  
public class LoginAction extends ActionSupport{  
    private String password;  

    @Validations(  
        requiredFields={  
            @RequiredFieldValidator(type = ValidatorType.FIELD, fieldName = "password", message = "密码不能为空！")  
        },  
        stringLengthFields={  
            @StringLengthFieldValidator(type = ValidatorType.FIELD, fieldName = "password", minLength = "6", maxLength = "18", message = "密码长度必须在6-18之间！")  
        },  
        regexFields={  
            @RegexFieldValidator(type = ValidatorType.FIELD, fieldName = "password", regexExpression = "^([a-zA-Z]+\\d+)|(\\d+[a-zA-Z]+)[a-zA-Z0-9]*$", message = "密码应包含字母和数字！")  
        }  
    )  
    @InputConfig(methodName = "input")  
    public String execute(){  
        //TODO:在这里进行业务逻辑处理，如通过用户名和密码验证登录  
        return SUCCESS;  
    }  

    public String input(){  
        return INPUT;  
    }  
    //Getter和Setter方法
}  

上述代码中，使用了@Validations注解，指定了对password字段进行验证。该注解包含了三个子注解，@RequiredFieldValidator表示验证该字段是否为非空字符串，@StringLengthFieldValidator表示验证该字段的长度是否在指定范围内，@RegexFieldValidator表示验证该字段是否包含字母和数字。

在JSP页面中，可以定义一个密码输入框，并指定该输入框需要进行验证：

<s:password name="password" label="密码："/>  
<s:fielderror fieldName="password"/>  

上述代码中，使用了<s:password>标签定义一个密码输入框，并指定该输入框需要进行输入验证。在错误信息部分，使用了<s:fielderror>标签，并指定了验证出现错误的字段名。

总结

本文介绍了在Struts2中如何使用数据输入验证。我们可以使用基于XML和基于注解的两种方式来进行数据输入验证。基于XML的验证方式需要在struts.xml文件中定义验证器，并在Action中进行引用；而基于注解的验证方式可以在Action中直接使用注解的方式进行定义和使用。无论使用哪种方式，我们都可以使用各种验证器来验证输入的数据的有效性，确保应用程序可以接受有效的、可靠的和正确的数据。