Struts数据验证

Struts数据效验

表单数据的验证：

前台验证：主要是通过JS验证， 表达数据是否合法！
后台验证：通过后台java代码进行验证!
      Struts也提供了数据效验的方式！

Struts数据效验， 通过拦截器完成：

    <interceptor 
name="validation" class="org.apache.struts2.interceptor.validation.AnnotationValidationInterceptor"/>

代码方式验证Action中所有的方法：

步骤：

1. 搭建struts环境
2. login.jsp
3.UserAction.java

Struts数据效验错误信息处理：

public synchronized void addFieldError(String fieldName, String errorMessage) {
        // 1. 保存错误信息的map集合
        final Map<String, List<String>> errors = internalGetFieldErrors();
        // 2. Map的value值  (一个key，对应的多个值用list存储)
        List<String> thisFieldErrors = errors.get(fieldName);
        // 3. 如果错误信息的map中没有当前的key，就直接创建集合
        if (thisFieldErrors == null) {
            // 创建
            thisFieldErrors = new ArrayList<String>();
            errors.put(fieldName, thisFieldErrors);
        }
         // 4. 添加错误信息
        thisFieldErrors.add(errorMessage);
    }

Action实现：

/**
 * 注意：如果要想用struts的数据效验功能，必须继承ActionSupport或实现相关接口
 * @author Jie.Yuan
 *
 */
public class UserAction extends ActionSupport {

    // 封装请求数据
    private User user = new User();
    public void setUser(User user) {
        this.user = user;
    }
    public User getUser() {
        return user;
    }

    // 重写数据验证的方法
    @Override
    public void validate() {
        // 用户名非空
        if (user.getUserName() == null || "".equals(user.getUserName())) {
            // 保存错误信息
            super.addFieldError("userName", "用户名必须填写！");
        }
        // 密码
        if (user.getPwd() == null || "".equals(user.getPwd())) {
            super.addFieldError("pwd", "密码必填");
        }
    }
}

代码方式验证Action中指定的方法：

写验证方法命名规则：

validate + 要验证的方法名

如：

public void validateRegister() {
只会验证当前action的register方法！

XML方式验证Action中所有的方法：

总结代码方式验证：

繁琐，设计很多重复的验证逻辑！例如：非空验证、数值验证、email、日期等。

Struts对于常用的验证，进行了封装，即提供了验证器， 验证指定的常用业务逻辑！
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，从而定义验证规则：

1）XML文件名称语法： ActionClassName-validation.xml
    注意：此xml需要与当期要验证的action在同一个目录：
    举例：UserAction-validation.xml
2） 写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>

    <!-- 验证的每一个字段用field表示 -->
    <field name="user.userName">
        <!-- 指定使用的验证器 -->
        <field-validator type="requiredstring">
            <!-- 验证失败的错误提示信息 -->
            <message>用户名不能为空！</message>
        </field-validator>
    </field>

    <!-- 验证pwd -->
    <field name="user.pwd">

        <!-- 非空 -->
        <field-validator type="requiredstring">
            <message>密码不能为空！</message>
        </field-validator>

        <!-- 长度 -->
        <field-validator type="stringlength">
            <param name="minLength">6</param>
            <param name="maxLength">8</param>
            <message>密码必须为6-8位！</message>
        </field-validator>
    </field>

    <!-- 验证日期 -->
    <field name="user.birth">
        <field-validator type="date">
            <message>日期格式不对！</message>
        </field-validator>
    </field>

    <!-- 验证Email -->
    <field name="user.email">
        <field-validator type="email">
            <message>邮箱格式错误！</message>
        </field-validator>
    </field>

</validators> 

XML方式验证Action中指定的方法:

与上面xml验证方式大致相同： 验证xml文件内容不变；
文件命名：

语法：ActionClassName-ActionName-validation.xml
举例：UserAction-user_register-validation.xml
      验证UserAction中的register方法

验证总结

代码：
    重写validate()   ,  验证action所有方法
     Validate方法名(),  验证指定“方法名”的方法
Xml：
    验证所有方法： ActionClassName-validation.xml
    验证指定方法： ActionClassName-actionName-validation.xml

代码验证，
    比较灵活，可以满足所有的需求.
    比较繁琐，要写重复的验证判断逻辑!
    适合： 表单字段较少的情况用！
XML验证：
    通用，但不够灵活； 可以验证特定简单的业务。
    适合： 验证表单字段较多，可以大大简化代码！
          (配置文件过多)

验证错误处理

Struts在进行数据效验的时候，验证失败，会返回input视图，要求我们要在struts.xml中配置input视图对应的错误页面！
配置：
Struts.xml

<!-- 注册失败跳转到注册页面，显示失败信息 -->
        <global-results>
            <result name="input">/register.jsp</result>
        </global-results>

Jsp显示错误：
方式1：显示所有错误

<%@taglib uri="/struts-tags" prefix="s" %>
    <!-- 显示的是struts在运行时期产生的所有错误 -->
    <s:fielderror></s:fielderror>

方式2：显示指定的错误

<!-- 修改struts标签默认的样式： 不让换行 --> 
    <style type="text/css">
    ul{
        display: inline;
    }
    ul li{
        display: inline;
        color: red;
    }
    </style>

显示指定的错误：

<s:fielderror fieldName="user.userName"></s:fielderror>

方式3: 修改标签定义的模板

找到fielderror标签定义的模板文件:
Struts-core.jar\template\simple\ fielderror.ftl

把修改后的fielderror.ftl文件，放到src/ template/ simple/ fielderror.ftl
这样标签显示的样式就修改了!

Struts 简单UI标签

<!-- 服务器标签 : 最终别解析为html标签-->
    <s:form action="/user_login" method="post" name="frmLogin" id="frmLogin" theme="simple">

        用户名：<s:textfield name="user.name"></s:textfield>
        密码：<s:textfield name="user.pwd"></s:textfield>
        <s:submit value="登陆"></s:submit>
    </s:form>

注意：

给form指定主题，form下所有的表单元素都应用此主题！

对于struts标签默认的主题样式：default.xml/struts.ui.theme=xhtml
可以通过常量修改, 改为简单主题：

<!-- 修改主题 (当前项目所有的标签都用此主题)-->
<constant 
name="struts.ui.theme" value="simple"></constant>

Struts ognl表达式语言几个符号

# 获取非根元素值 、 动态都建map集合
$ 配置文件取值
% 提供一个ognl表达式运行环境

<body>
     <br/>获取request域数据<br/>
     <!-- property 标签是对象类型的标签，默认支持ognl表达式, 会从根元素去China名称对应的值 -->
     <s:property value="China"/>        <br/>
     <!-- 如果直接赋值，需要用单引号 -->
     <s:property value="'China'"/>      <br/>
     <s:property value="%{#request.cn}"/>       <br/>

     <!-- 值类型的标签，value值默认就是值类型，不支持ognl表达式 -->
     国家：<s:textfield name="txtCountry" value="%{#request.cn}"></s:textfield>
  </body>

Struts中常用的几个技术

数据回显:数据回显，必须要用struts标签！
Action中：

// 进入修改页面
    public String viewUpdate() {
        // 模拟一个对象(先获取一个id，再根据id调用service查询，把查到的结果保存到域)
        User userInfo = new User();
        userInfo.setUserName("Jack");
        userInfo.setEmail("yuanjie@itcast.cn");

        ActionContext ac = ActionContext.getContext();
//      Map<String,Object> request = (Map<String, Object>) ac.get("request");
//      request.put("userInfo", userInfo);

        /************* 数据回显***************/
        // 获取值栈
        ValueStack vs = ac.getValueStack();
        vs.pop();// 移除栈顶元素
        vs.push(userInfo);  // 入栈


        // 进入修改页面
        return "viewUpdate";
    }

JSP页面：

<body>
    <%@taglib uri="/struts-tags" prefix="s" %>


    <br/>
    <!-- 在页面文本框内，显示要修改记录的数据 -->

    <!-- 手动通过value设置显示的值 
    <s:form action="#">

        用户名： <s:textfield name="user.userName" value="%{#request.userInfo.userName}"></s:textfield>   <br/>

        邮箱： <s:textfield name="user.email" value="%{#request.userInfo.email}"></s:textfield>     <br/>
    </s:form>
    -->

    <!-- 数据回显技术：s:textfield会自动查找根元素数据(Ognl表达式语言取值)  -->
    <s:form action="#">

        用户名： <s:textfield name="userName"></s:textfield>   <br/>

        邮箱： <s:textfield name="email"></s:textfield>     <br/>
    </s:form>

    <s:debug></s:debug>
  </body>

模型驱动

Struts运行时候，会执行默认的拦截器栈，其中有一个拦截器，模型驱动拦截器：

<interceptor 
name="modelDriven" class="com.opensymphony.xwork2.interceptor.ModelDrivenInterceptor"/>

@Override
    public String intercept(ActionInvocation invocation) throws Exception {
        Object action = invocation.getAction();

        if (action instanceof ModelDriven) {
            ModelDriven modelDriven = (ModelDriven) action;
            ValueStack stack = invocation.getStack();
            Object model = modelDriven.getModel();
            if (model !=  null) {
                stack.push(model);
            }
            if (refreshModelBeforeResult) {
                invocation.addPreResultListener(new RefreshModelBeforeResult(modelDriven, model));
            }
        }
        return invocation.invoke();
    }

引入:

prams拦截器，可以把请求数据自动填充的action的属性中

举例1：
JSP
   <input type=text name=userName />
   <input type=text name=pwd />

Action
    class UserAction{
        // 封装请求数据
        private String userName;
        private String pwd;
        //.. set方法
    }

举例2：
JSP
   <input type=text name=user.userName />
   <input type=text name=user.pwd />

Action
    class UserAction{
        // 封装请求数据
        private User user;

        ..
    }

举例3：(模型驱动)
JSP
   <input type=text name=userName />
   <input type=text name=pwd />

Action
    class UserAction{
        // 封装请求数据
        private User user;

        ..
    }

步骤及原理

步骤：

1. 实现ModelDriver接口
2. 实现接口方法： 接口方法返回的就是要封装的对象
3. 对象一定要实例化。

分析：

/**
 * 1. 数据回显
 * 2. 模型驱动
 * @author Jie.Yuan
 *
 */
public class UserAction extends ActionSupport implements ModelDriven<User> {

    // 封装请求数据
    private User user = new User();
    public void setUser(User user) {
        this.user = user;
    }
    public User getUser() {
        return user;
    }

    // 实现模型驱动接口方法
    @Override
    public User getModel() {
        return user;
    }


    public String add() {
        // 测试： 使用了模型驱动，是否数据正常？ Ok
        System.out.println(user);
        return "success";
    }

防止表单重复提交

Struts提供了防止表单重复提交拦截器：

<interceptor name="token" 
class="org.apache.struts2.interceptor.TokenInterceptor"/>

综合案例：
1. 建库、建表

-- 删除数据库
DROP DATABASE hib_demo;
-- 创建数据库
CREATE DATABASE hib_demo DEFAULT CHARACTER SET utf8;
-- 建表
CREATE TABLE employee (
   id INT PRIMARY KEY AUTO_INCREMENT,
   empName VARCHAR(20),
   workDate DATE      -- 入职时间
)

1. 搭建环境
   搭建struts环境
   组件：c3p0/dbutils/驱动
2. 代码
   add.jsp

  <body>
    <s:form action="/emp_save" method="post">
        <!-- 防止表单重复提交，第一步：生成id(客户端、服务器) -->
        <s:token></s:token>

        <table>
            <tr>
                <td>员工名：</td>
                <td><s:textfield name="empName" /></td>
            </tr>
            <tr>
                <td>日期：</td>
                <td><s:textfield name="workDate" /></td>
            </tr>
            <tr>
                <td colspan="2">
                    <s:submit value="保存员工"></s:submit>
                </td>
            </tr>
        </table>
    </s:form>
  </body>

/**
 * 员工管理Action
 * @author Jie.Yuan
 *
 */
public class EmployeeAction extends ActionSupport implements ModelDriven<Employee>{

    /****封装数据****/
    private Employee employee = new Employee();
    public Employee getEmployee() {
        return employee;
    }
    public void setEmployee(Employee employee) {
        this.employee = employee;
    }
    // 重写模型驱动方法
    @Override
    public Employee getModel() {
        return employee;
    }



    /****调用的Service****/
    private IEmployeeService employeeService = new EmployeeService();

    /**
     * 1. 添加员工
     */
    public String save() {
        try {
            // 调用service保存
            employeeService.save(employee);
            // 添加成功，去到列表页面
            return list();
            //return "addsuccess";
        } catch (Exception e) {
            e.printStackTrace();
            return ERROR;
        }
    }

    /**
     * 2. 列表显示
     */
    public String list() {
        try {
            // 查询全部
            List<Employee> listEmp = employeeService.getAll();
            // 保存到request域
            ActionContext.getContext().getContextMap().put("listEmp", listEmp);
            return "list";
        } catch (Exception e) {
            e.printStackTrace();
            return ERROR;
        }
    }

    /**
     * 3. 进入修改页面
     */
    public String viewUpdate() {
        try {
            // 3.1 获取当前修改的记录的主键值
            int id = employee.getId();
            // 3.2 service查询
            Employee emp = employeeService.findById(id);
            // 3.3 数据回显
            // a. 先得到值栈
            ValueStack vs = ActionContext.getContext().getValueStack();
            vs.pop();   //移除栈顶元素
            vs.push(emp);   // emp对象放入栈顶

            return "update";
        } catch (Exception e) {
            e.printStackTrace();
            return ERROR;
        }
    }

    /**
     * 4. 修改员工
     */
    public String update() {
        try {
            // 调用service修改
            employeeService.update(employee);
            return list();
        } catch (Exception e) {
            e.printStackTrace();
            return ERROR;
        }
    }
}

配置：

<struts>
    <!-- 更改主题 -->
    <constant name="struts.ui.theme" value="simple"></constant>

    <package name="emp" extends="struts-default">

        <!-- 全局视图 -->
        <global-results>
            <result name="error">/error/error.jsp</result>
        </global-results>

        <action name="emp_*" class="cn.itcast.action.EmployeeAction" method="{1}">

            <!-- 防止表单重复提交，第二步： 配置" 防止表单重复提交拦截器" -->
            <interceptor-ref name="defaultStack"></interceptor-ref>
            <interceptor-ref name="token">
                <!-- 指定拦截哪些方法需要防止表单重复提交(save) -->
                <param name="includeMethods">save</param>
            </interceptor-ref>

            <!-- 防止表单重复提交，第三步： 如果用户重复提交了跳转到指定的错误页面  -->
            <result name="invalid.token" type="redirectAction">emp_list</result>

            <!-- 首页显示 -->
            <result name="list">/WEB-INF/list.jsp</result>

            <!-- 进入修改页面 -->
            <result name="update">/WEB-INF/update.jsp</result>

            <!-- 
            <result name="addsuccess" type="redirectAction">emp_list</result>
             -->
        </action>

    </package>
</struts>

list.jsp

<body>
     <table border="1" align="center">
        <tr>
            <th>序号</th>
            <th>编号</th>
            <th>员工名称</th>
            <th>日志日期</th>
            <th>操作</th>
        </tr>
        <!-- 1. 先判断；2.  再迭代 -->
        <s:if test="#request.listEmp != null">
            <s:iterator var="emp" value="#request.listEmp" status="st">
                <tr>
                    <td><s:property value="#st.count"/></td>
                    <td><s:property value="#emp.id"/></td>
                    <td><s:property value="#emp.empName"/></td>
                    <td><s:property value="#emp.workDate"/></td>
                    <td>
                        <s:a href="emp_viewUpdate?id=%{#emp.id}">修改</s:a>
                    </td>
                </tr>
            </s:iterator>
        </s:if>
        <s:else>
            <tr>
                <td colspan="5">对不起，没有你要显示的数据</td>
            </tr>
        </s:else>
     </table>
  </body>

update.jsp

<body>
    <s:form action="/emp_update" method="post">
        <!-- 隐藏域，保存主键 -->
        <s:hidden name="id"></s:hidden>

        <table>
            <tr>
                <td>员工名：</td>
                <td><s:textfield name="empName" /></td>
            </tr>
            <tr>
                <td>日期：</td>
                <!-- 
                <td><s:date name="workDate" format="yyyy-MM-dd"/>
                    <s:hidden name="workDate"></s:hidden>
                </td>
                 -->
                 <td>
                    <s:textfield name="workDate" />
                 </td>
            </tr>
            <tr>
                <td colspan="2">
                    <s:submit value="修改员工"></s:submit>
                </td>
            </tr>
        </table>
    </s:form>
  </body>