Struts2讲义35

8.2  利用配置文件进行输入校验方法说明

8.1 小节中说明的输入校验方法会让程序产生很多代码。如果是 1 个项目生命周期很短的项目，必然对时间的要求会很高。这时候利用 Struts2 来对该项目进行开发，开发者势必不喜欢 8.1 小节中介绍的输入校验方法。因为代码太多，工作量一下子就增大了不少。而且它是一种硬编码的形式，增大了系统各个模块之间的耦合度，也不利于项目后期的维护和实施。因此本节介绍的利用配置文件进行输入校验的方式则很好的解决了上述问题。

利用配置文件进行校验主要是增加了一些 xml 文件来对具体表单中各个字段进行输入校验。当然配置文件能做的事情不止这些。其本身的输入校验规则的书写格式也有字段和非字段两种，下面笔者就来具体介绍这些知识点。

8.2.1   Struts2 字段校验的配置文件形式

技术要点

Struts2 输入校验配置文件字段校验格式介绍。

输入校验配置文件命名方式和相关注意点。

字段校验格式和相关注意点。

演示代码

数据输入 JSP 代码：

<!---------------------文件名：register.jsp---------------->
…………
                  <!-- 用户信息注册form表单 -->
         <s:form action="Register.action"  validate="true">
                   <table width="60%" height="76" border="0">
                                     <!-- 各标签定义 -->
                                     <s:textfield name="username" label="用户名"/>
                                     <s:password name="password" label="密  码" />
                                     <s:password name="repassword" label="密  码确认" />
                                     <s:textfield name="birthday" label="生日"/>
                                     <s:textfield name="mobile" label="手机号码"/>
                                     <s:textfield name="age" label="年龄"/>
                                     <s:submit value="注册" align="center"/>                              
                   </table>
         </s:form>
…………

 

输入校验文件代码：

<!---------文件名：RegisterAction-validation.xml---------->
<?xml version="1.0" encoding="gb2312"?>
<!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="username">
                   <!—检验用户名的长度 -- >
                   <field-validator type="stringlength">
                            <param name="minLength">6</param>
                            <param name="maxLength">8</param>
                            <message>用户名长度必须在${minLength}-${maxLength}位之间</message>
                   </field-validator>
                   <!—检验用户名是否已输入 -- >
<field-validator type="requiredstring">
                            <message>请输入用户名</message>
                   </field-validator>
         </field>
         <field name="password">
                   <!—检验密码的长度 -- >
                   <field-validator type="stringlength">
                            <param name="minLength">6</param>
                            <param name="maxLength">8</param>
                            <message>密码长度必须在${minLength}-${maxLength}位之间</message>
                   </field-validator>
<!—检验密码是否已输入 -- >
                   <field-validator type="requiredstring">
                            <message>请输入密码</message>
                   </field-validator>
         </field>
         <field name="repassword">
         <!—检验确认密码的长度 -- >
                   <field-validator type="stringlength">
                            <param name="minLength">6</param>
                            <param name="maxLength">8</param>
                            <message>确认密码长度必须在${minLength}-${maxLength}位之间</message>
                   </field-validator>
<!—检验确认密码是否已输入 -- >
                   <field-validator type="requiredstring">
                            <message>请输入确认密码</message>
                   </field-validator>
         <!—检验密码和确认密码的输入内容是否一致 -- >
                   <field-validator type="fieldexpression">
                            <param name="expression">password==repassword</param>
                            <message>确认密码和密码输入不一致</message>
                   </field-validator>
         </field>
         <field name="birthday">
         <!—检验生日是否已输入 -- >
                   <field-validator type="required">
                            <message>请输入生日日期</message>
                   </field-validator>
<!—检验输入日期是否在一个有效日期范围内 -- >
                   <field-validator type="date">
                            <param name="min">1928-01-01</param>
                            <param name="max">2004-01-01</param>
                            <message>输入生日日期无效</message>
                   </field-validator>
         </field>
         <field name="mobile">
                   <!—检验手机号码是否已输入 -- >
<field-validator type="requiredstring">
                            <message>请输入手机号码</message>
                   </field-validator>
         <!—检验输入手机号码长度是否是11位有效手机号码-- >
                   <field-validator type="stringlength">
                            <param name="minLength">11</param>
                            <message>请输入正确的手机号码,号码位数必须为11位</message>
                   </field-validator>
         </field>
         <field name="age">
              <!—检验年龄是否已输入 -- >
                  <field-validator type="required">
            <message>请输入年龄</message>
           </field-validator>
<!—检验输入年龄是否符合特定年龄范围 -- >
                  <field-validator type="int">
                            <param name="min">1</param>
                            <param name="max">80</param>
                            <message>年龄必须在${min}-${max}岁之间</message>
                   </field-validator>
         </field>
</validators>

 

代码解释

（ 1 ）使用配置文件来完成输入校验这种方式，首先在 Action 代码中去除所有 validate 和 validateXXX 方法的代码。然后在和 Action 类文件同一级目录下增加 XXX-validation.xml 配置文件。这里“ XXX ”是 Action 类文件名字，表示该 XML 文件中所有输入校验的规则定义和错误信息显示方式都只针对该 Action 有效。

（ 2 ）该输入校验的配置文件有 2 种书写格式， 1 种是本节笔者要说的字段校验格式。另 1 种是下 1 小节要介绍的非字段格式。首先来说明字段校验格式。如代码所示。在 <validators> 和 </validators> 之间使用 <field> 来对输入界面表单中每 1 个字段进行输入校验规则定义和错误信息定义。

<field> 中的 name 属性就是表单中字段名字。它里面包含 <field-validator> 标签，它的 type 属性表明是何种类型的输入校验。这些输入校验的 type 都是在 Struts2 中缺省定义的。被称之为校验器。具体这些校验器是如何形成的以及如何生效，在之后章节还有有介绍。这里读者只是知道一下就可以。

在 <field-validator> 标签内可以有 2 种标签。 1 种是 <param> 标签，该标签定义了一些输入校验规则需要用到的参数。这些参数更可以以“ ${ 参数名 } ”格式显示在视图页面上。除此之外还有 <message> 标签，该标签定义的是输入校验出错后的出错信息。这些信息是可以显示在试图界面上的。

（ 3 ）值得说的是代码中黑体表明的参数名字。因为 Struts2 中特定的校验类型的参数名是已经在 Struts2 代码中缺省定义过的。因此如果开发者定义的参数名字和它本身缺省定义的不符合。那么输入校验时候在配置文件中定义的该校验规则是不会生效的。比如代码中的“ stringlength ”类型校验，如果定义的最大长度不是“ maxLength ”而是其他的。则在输入数据界面，如果输入的数据超过最大长度，视图界面不会给出特定的出错信息的。

（ 4 ）如果在输入数据的视图界面的表单中输入上述 JSP 文件中的黑体“ validate="true" ”。则其实是另外 1 种输入校验的方式。这种方式称之为“客户端输入校验方式”。它会自动在试图页面中生成很多 JavaScript 代码。但是它是有其局限性的，因此这些代码的适合程度不是对 Struts2 中所有的主题都适合的（有关主题的基本概念翻阅“ Struts2 标签”章节）。因此笔者本身不赞同这样的输入校验方式。这里只是向读者介绍希望读者对 Struts2 的输入校验有个完整的印象。

8.2.2   Struts2 非字段校验的配置文件形式

技术要点

Struts2 输入校验配置文件非字段校验格式介绍。

非字段校验格式和相关注意点。

演示代码

于上一小节代码相比，只是输入校验配置文件中内容有所不同。代码如下：

<!--------文件名：RegisterAction-validation.xml----------->
<validators>
         <!—检验输入用户名长度是否在一个有效范围内 -- >
         <validator type="stringlength">
                   <param name="fieldName">username</param>
                   <param name="minLength">6</param>
                   <param name="maxLength">8</param>
                   <message>用户名长度必须在${minLength}-${maxLength}位之间</message>
         </validator>
         <!—检验用户名是否已输入 -- >
         <validator type="requiredstring">
                   <param name="fieldName">username</param>
                   <message>请输入用户名</message>
         </validator>
         <!—检验密码的长度 -- >
         <validator type="stringlength">
                   <param name="fieldName">password</param>
                   <param name="minLength">6</param>
                   <param name="maxLength">8</param>
                   <message>密码长度必须在${minLength}-${maxLength}位之间</message>
         </validator>
         <!—检验密码是否已输入 -- >
         <validator type="requiredstring">
                   <param name="fieldName">password</param>
                   <message>请输入密码</message>
         </validator>
         <!—检验确认密码的长度 -- >
<validator type="stringlength">
                   <param name="fieldName">repassword</param>
                   <param name="minLength">6</param>
                   <param name="maxLength">8</param>
                   <message>确认密码长度必须在${minLength}-${maxLength}位之间</message>
         </validator>
         <!—检验确认密码是否已输入 -- >
         <validator type="requiredstring">
                   <param name="fieldName">repassword</param>
                   <message>请输入确认密码</message>
         </validator>
         <!—检验密码和确认密码的输入内容是否一致 -- >
         <validator type="fieldexpression">
                   <param name="fieldName">password</param>
                   <param name="fieldName">repassword</param>
                   <param name="expression">password==repassword</param>
                   <message>确认密码和密码输入不一致</message>
         </validator>
         <!—检验生日是否已输入 -- >
         <validator type="required">
                   <param name="fieldName">birthday</param>
                   <message>请输入生日日期</message>
         </validator>
         <!—检验输入日期是否在一个有效日期范围内 -- >
         <validator type="date">
                   <param name="fieldName">birthday</param>
                   <param name="min">1928-01-01</param>
                   <param name="max">2004-01-01</param>
                   <message>输入生日日期无效</message>
         </validator>
         <!—检验手机号码是否已输入 -- >
         <validator type="requiredstring">
                   <param name="fieldName">mobile</param>
                   <message>请输入手机号码</message>
         </validator>
         <!—检验输入手机号码长度是否是11位有效手机号码-- >
         <validator type="stringlength">
                   <param name="fieldName">mobile</param>
                   <message>请输入正确的手机号码,号码位数必须为11位</message>
         </validator>
         <!—检验年龄是否已输入 -- >
         <validator type="required">
                   <param name="fieldName">age</param>
                   <message>请输入年龄</message>
         </validator>
         <!—检验输入年龄是否符合特定年龄范围 -- >
         <validator type="int">
                   <param name="fieldName">age</param>
                   <param name="min">1</param>
                   <param name="max">80</param>
                   <message>年龄必须在${min}-${max}岁之间</message>
         </validator>
</validators>

 

代码解释

（ 1 ） 非字段格式的输入校验方式与上 1 小节相比主要是它的书写格式不是像之前在 <validators> 和 </validators> 之间包含 <field> 标签，而是 <validator> 标签。每个 <validator> 标签定义的 type 属性还是 Struts2 自带的输入校验器的类型格式。

（ 2 ）在 <validator> 标签之内包含的还是 <param> 和 <message> 两种标签。但是在 <param> 中多定义了一个 fieldName 属性。这个属性定义的就是输入校验的表单字段名字。其他和之前字段格式都类似。

（ 3 ）由于所有数据输入的校验出错的错误信息和 8.1 节相同，因此所有的校验出错的信息显示读者可以参看图 8.1 到图 8.4 这几张图示。

8.2.3   Struts2 输入校验出错信息的国际化配置形式

技术要点

Struts2 输入校验配置文件中定义了 <message> 标签。该标签定义了很多输入校验出错信息。之前还是使用硬编码写死在配置文件中。其实可以使用 Struts2 的国际化配置将这些错误信息写在属性文件中。本小节就介绍一下如何将错误信息定义在属性文件中也为之后 Struts2 国际化章节做个基础介绍。

配置文件中修改代码介绍，介绍出错信息的 key 属性定义。

使用中文的属性文件出错信息定义代码

演示代码

配置文件代码如下：

<!------------文件名：RegisterAction-validation.xml------------->
<validators>
         <validator type="stringlength">
                   <param name="fieldName">username</param>
                   <param name="minLength">6</param>
                   <param name="maxLength">8</param>
                   <message key="userNameLengthRange"></message>
         </validator>
         <validator type="requiredstring">
                   <param name="fieldName">username</param>
                   <message key="userNameRequired"></message>
         </validator>
         <validator type="stringlength">
                   <param name="fieldName">password</param>
                   <param name="minLength">6</param>
                   <param name="maxLength">8</param>
                   <message key="passwordLength"></message>
         </validator>
         <validator type="requiredstring">
                   <param name="fieldName">password</param>
                   <message key="passwordRequired"></message>
         </validator>
         <validator type="stringlength">
                   <param name="fieldName">repassword</param>
                   <param name="minLength">6</param>
                   <param name="maxLength">8</param>
                   <message key="repasswordLength"></message>
         </validator>
         <validator type="requiredstring">
                   <param name="fieldName">repassword</param>
                   <message key="repasswordRequired"></message>
         </validator>
         <validator type="fieldexpression">
                   <param name="fieldName">password</param>
                   <param name="fieldName">repassword</param>
                   <param name="expression">password==repassword</param>
                   <message key="repasswordEquals"></message>
         </validator>
         <validator type="required">
                   <param name="fieldName">birthday</param>
                   <message key="birthdayRequired"></message>
         </validator>
         <validator type="date">
                   <param name="fieldName">birthday</param>
                   <param name="min">1928-01-01</param>
                   <param name="max">2004-01-01</param>
                   <message key="birthdayRange"></message>
         </validator>
         <validator type="requiredstring">
                   <param name="fieldName">mobile</param>
                   <message key="mobileRequired"></message>
         </validator>
         <validator type="stringlength">
                   <param name="fieldName">mobile</param>
                   <message key="mobileLength"></message>
         </validator>
         <validator type="required">
                   <param name="fieldName">age</param>
                   <message key="ageRequired"></message>
         </validator>
         <validator type="int">
                   <param name="fieldName">age</param>
                   <param name="min">1</param>
                   <param name="max">80</param>
                   <message key="ageRange"></message>
         </validator>
</validators>

 

支持中文的国际化配置属性文件代码如下：

<!---------------文件名：messageResource.properties-------------->
#配置文件中<message>的key属性定义
userNameLengthRange=用户名长度必须在${minLength}-${maxLength}位之间
userNameRequired=请输入用户名
passwordLength=密码长度必须在${minLength}-${maxLength}位之间
passwordRequired=请输入密码
repasswordLength=确认密码长度必须在${minLength}-${maxLength}位之间
repasswordRequired=请输入确认密码
repasswordEquals=确认密码和密码输入不一致
birthdayRequired=请输入生日日期
birthdayRange=输入生日日期无效
mobileRequired=请输入手机号码
mobileLength=请输入正确的手机号码,号码位数必须为11位
ageRequired=请输入年龄
ageRange=年龄必须在${min}-${max}岁之间

 

代码解释

（ 1 ） 在配置文件中笔者对 <message> 标签做了修改。使用了 key 属性，这些 key 属性定义的内容都是一个个出错信息名字。而这些名字是在国际化配置的属性文件中定义的。这里笔者使用了非字段定义的格式来写配置文件中的代码。其实字段格式也是相同，都是修改 <message> 标签中的内容。

（ 2 ）在支持中文的国际化配置属性文件“ messageResource.properties ”中，笔者对所有 keu 属性定义的出错信息名字做了一一具体相关的出错信息定义。因为该文件是中文国际化的属性文件，因此都是中文的出错信息。

（ 3 ）有关 Struts2 国际化的配置在后面章节会具体完整的介绍，这里只是让读者知道输入校验的出错信息都是可以国际化的赋予各个语言版本。

怎么验证复选框？

messageResource.properties 的名字可以改吗？
位置可以随便放吗？
有没有哪里指定该文件的？谢谢了~~

有没有详细 说一下 visitor用法

为啥不在前台就用js验证了呢？这样很是麻烦啊！

一般情况下是前台js验证,楼主写的是后台验证(增加了安全性)
因为有的人可以绕过前台验证，直接进后台，这时后台验证就起到作用了,估计很少有后台验证的吧？

你应该听说过sql注入和恶意脚本侵入吧？我以前的观点和你相同，后来做了几个互联网项目发觉不对。之所以会产生你这样的观点，因为我之前也是一直做企业级应用的BS系统，没有做过互联网BS系统。我想你大概和我以前情况相同，没有做过互联网BS系统导致