6、Struts2中的国际化、Ognl（对象图导航语言）表达式语言

Struts2中的国际化、Ognl（对象图导航语言）表达式语言

回顾：Servlet 中国际化：
1). 写资源文件
基础名.properties 【默认的语言环境的配置】
基础名语言简称国家简称.properties
2). 读取资源文件，再使用
程序：ResourceBundle
Jsp: jstl提供的格式化与国际化标签库。

一、Struts2中国际化：
1. 写资源文件 (同servlet)
2. 读资源文件
程序：ResourceBundle (同servlet)
JSP:
1）jstl表亲啊 （同servlet）
2）struts标签获取资源文件内容

区别：
Struts2加载资源文件更加简单！通过常量加载即可！再在jsp页面直接使用！

1. 写资源文件
   Msg.properties 默认的语言环境； 找不到配置就找它
   Msg_en_US.properties 美国
2. 加载

<constant name="struts.custom.i18n.resources" value="cn.itcast.config.msg"></constant>

1. 使用: 标签name值直接写配置文件中的key

<s:text name="title"></s:text>

另外一点，
(推荐)加载资源文件通过常量加载
还可以在页面加载, 这样用：

        <s:i18n name="cn.itcast.config.msg">
            <s:text>  标签必须放到标签体中。
</s:i18n>

二、 Ognl表达式语言
概述
?OGNL表达式
OGNL是Object Graphic Navigation Language（对象图导航语言）的缩写，它是一个开源项目。 Struts2框架使用OGNL作为默认的表达式语言。
?OGNL优势
1、支持对象方法调用，如xxx.doSomeSpecial()；
2、支持类静态的方法调用和值访问，表达式的格式:
@[类全名（包括包路径）]@[方法名 | 值名]，例如：
@java.lang.String@format(‘foo %s’, ‘bar’)
或@tutorial.MyConstant@APP_NAME；
3、支持赋值操作和表达式串联，如price=100, discount=0.8,
calculatePrice()，这个表达式会返回80；
4、访问OGNL上下文（OGNL context）和ActionContext；
5、操作集合对象。
?总结
OGNL 有一个上下文（Context）概念，说白了上下文就是一个MAP结构，它实现了 java.utils.Map 的接口。 OgnlContext对象

分析：
?Struts框架默认就支持Ognl表达式语言。
(struts必须引用的包：ognl.jar)
?作用
页面取值用。

El表达式语言，用于页面取值，jsp页面取值的标准。(默认直接可以使用)
(应用范围更广。)
Ognl表达式语言， struts标签默认支持的表达式语言。
必须配置struts标签用，不能离开struts标签直接用。

OgnlContext对象(了解)
OgnlContext对象是ognl表达式语言的核心。
源码类：

public class OgnlContext extends Object implements Map{..}

硬编码方式，了解OgnlContext对象：

// OgnlContext用法
public class OgnlDemo1 {

    /**
     * 1. Ognl表达式语言语言取值，取非根元素的值，必须用#号
     * @throws Exception
     */
    @Test
    public void testOgnl() throws Exception {
        // 创建一个Ognl上下文对象
        OgnlContext context = new OgnlContext();
        // 放入数据
        User user = new User();
        user.setId(100);
        user.setName("Jack");
        // 【往非根元素放入数据， 取值的时候表达式要用"#"】
        context.put("user", user);

        // 获取数据(map)
        // 先构建一个Ognl表达式, 再解析表达式
        Object ognl = Ognl.parseExpression("#user.name");
        Object value = Ognl.getValue(ognl, context, context.getRoot());

        System.out.println(value);
    }

    /**
     * 2. Ognl表达式语言语言取值，取根元素的值，不用带#号
     * @throws Exception
     */
    @Test
    public void testOgn2() throws Exception {
        // 创建一个Ognl上下文对象
        OgnlContext context = new OgnlContext();
        // 放入数据
        User user = new User();
        user.setId(100);
        user.setName("Jack");
        // 【往根元素放入数据】
        context.setRoot(user);

        // 获取数据(map)
        // 先构建一个Ognl表达式, 再解析表达式
        Object ognl = Ognl.parseExpression("address.province");
        Object value = Ognl.getValue(ognl, context, context.getRoot());

        System.out.println(value);
    }

    /**
     * 3.Ognl对 静态方法调用的支持
     * @throws Exception
     */
    @Test
    public void testOgn3() throws Exception {
        // 创建一个Ognl上下文对象
        OgnlContext context = new OgnlContext();

        // Ognl表单式语言，调用类的静态方法
        //Object ognl = Ognl.parseExpression("@Math@floor(10.9)");
        // 由于Math类在开发中比较常用，所以也可以这样写
        Object ognl = Ognl.parseExpression("@@floor(10.9)");
        Object value = Ognl.getValue(ognl, context, context.getRoot());
        System.out.println(value);
    }
}

ValueStack对象
ValueStack, 即值栈对象。
值栈对象：
是整个struts数据存储的核心，或者叫中转站。
用户每次访问struts的action，都会创建一个Action对象、值栈对象、ActionContext对象； 然后把Action对象放入值栈中； 最后再把值栈对象放入request中，传入jsp页面。
(key: struts.valueStack)； 开发者只需要通过ActionContext对象就可以访问struts的其他的关键对象。 （ActionContext是给开发者用的，便于学习与使用。）

问题：
OgnlContext与ValueStack对象的关系？

Struts标签
Struts标签取值，就使用了Ognl表达式语言。

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

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

这样标签显示的样式就修改了!

1. 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>

1. Struts ognl表达式语言几个符号
   1） # 获取非根元素值 、 动态都建map集合
   2） $ 配置文件取值
   3） % 提供一个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>

1. 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      -- 入职时间
)

2. 搭建环境
    搭建struts环境
    组件：c3p0/dbutils/驱动