关于国际化、OGNL表达式语言

2022-10-20,,,

一、国际化

准备资源文件,资源文件的命名格式如下:
basename_language_country.properties
basename_language.properties
basename.properties
其中basename是资源文件的基本名,我们可以自定义,但language和country必须是java支持的语言和国家。如:
中国大陆: basename_zh_cn.properties
美国: basename_en_us.properties

现在为应用添加两个资源文件:
第一个存放中文:csdn_zh_cn.properties
内容为:welcome=欢迎来到传智播客
第二个存放英语(美国): csdn_en_us.properties
内容为: welcome=welcome to csdn

对于中文的属性文件,我们编写好后,应该使用jdk提供的native2ascii命令把文件转换为unicode编码的文件。命令的使用方式如下:
native2ascii  源文件.properties  目标文件.properties

二、配置全局资源与输出国际化信息

当准备好资源文件之后,我们可以在struts.xml中通过struts.custom.i18n.resources常量把资源文件定义为全局资源文件,如下:
<constant name="struts.custom.i18n.resources" value=“csdn" />
csdn为资源文件的基本名。

后面我们就可以在页面或在action中访问国际化信息:
在jsp页面中使用<s:text name=“”/>标签输出国际化信息:
<s:text name=“user”/>,name为资源文件中的key
在action类中,可以继承actionsupport,使用gettext()方法得到国际化信息,该方法的第一个参数用于指定资源文件中的key。
在表单标签中,通过key属性指定资源文件中的key,如:
<s:textfield name="realname" key="user"/>

三、国际化—输出带占位符的国际化信息

资源文件中的内容如下:
welcome= {0},欢迎来到传智播客{1}

在jsp页面中输出带占位符的国际化信息
<s:text name="welcome">
    <s:param><s:property value="realname"/></s:param>
 <s:param>学习</s:param>
</s:text>

在action类中获取带占位符的国际化信息,可以使用gettext(string key, string[] args)或gettext(string atextname, list args)方法。

四、国际化—包范围资源文件

在一个大型应用中,整个应用有大量的内容需要实现国际化,如果我们把国际化的内容都放置在全局资源属性文件中,显然会导致资源文件变的过于庞大、臃肿,不便于维护,这个时候我们可以针对不同模块,使用包范围来组织国际化文件。

方法如下:
在java的包下放置package_language_country.properties资源文件,package为固定写法,处于该包及子包下的action都可以访问该资源。当查找指定key的消息时,系统会先从package资源文件查找,当找不到对应的key时,才会从常量struts.custom.i18n.resources指定的资源文件中寻找。

五、国际化—action范围资源文件

我们也可以为某个action单独指定资源文件,方法如下:
在action类所在的路径,放置actionclassname_language_country.properties资源文件,actionclassname为action类的简单名称。

当查找指定key的消息时,系统会先从actionclassname_language_country.properties资源文件查找,如果没有找到对应的key,然后沿着当前包往上查找基本名为package 的资源文件,一直找到最顶层包。如果还没有找到对应的key,最后会从常量struts.custom.i18n.resources指定的资源文件中寻找。

六、国际化—jsp中直接访问某个资源文件

struts2为我们提供了<s:i18n>标签,使用<s:i18n>标签我们可以在类路径下直接从某个资源文件中获取国际化数据,而无需任何配置:
<s:i18n name=“csdn">
    <s:text name=“welcome”/>
</s:i18n>
csdn为类路径下资源文件的基本名。

如果要访问的资源文件在类路径的某个包下,可以这样访问:
<s:i18n name=“cn/csdn/action/package">
   <s:text name="welcome">
    <s:param>小张</s:param>
   </s:text>
</s:i18n>
上面访问cn.csdn.action包下基本名为package的资源文件。

七、ognl表达式语言

ognl是object graphic navigation language(对象图导航语言)的缩写,它是一个开源项目。 struts 2框架使用ognl作为默认的表达式语言。

相对el表达式,它提供了平时我们需要的一些功能,如:
支持对象方法调用,如xxx.sayhello();
支持类静态方法调用和值访问,表达式的格式为@[类全名(包括包路径)]@[方法名 |  值名],例如:@java.lang.string@format('foo %s', 'bar')或@cn.csdn.constant@app_name;
操作集合对象。

ognl 有一个上下文(context)概念,说白了上下文就是一个map结构,它实现了java.utils.map接口,在struts2中上下文(context)的实现为actioncontext,下面是上下文(context)的结构示意图

访问上下文(context)中的对象需要使用#符号标注命名空间,如#application、#session

另外ognl会设定一个根对象(root对象),在struts2中根对象就是valuestack(值栈) 。如果要访问根对象(即valuestack)中对象的属性,则可以省略#命名空间,直接访问该对象的属性即可。

在struts2中,根对象valuestack的实现类为ognlvaluestack,该对象不是我们想像的只存放单个值,而是存放一组对象。在ognlvaluestack类里有一个list类型的root变量,就是使用他存放一组对象
   |--request  
   |--application  
context ------|--ognlvaluestack root变量[action, ognlutil, ... ]  
   |--session  
   |--attr  
   |--parameters

在root变量中处于第一位的对象叫栈顶对象。通常我们在ognl表达式里直接写上属性的名称即可访问root变量里对象的属性,搜索顺序是从栈顶对象开始寻找,如果栈顶对象不存在该属性,就会从第二个对象寻找,如果没有找到就从第三个对象寻找,依次往下访问,直到找到为止。
大家注意: struts2中,ognl表达式需要配合struts标签才可以使用。如:<s:property value="name"/>

由于valuestack(值栈)是struts 2中ognl的根对象,如果用户需要访问值栈中的对象,在jsp页面可以直接通过下面的el表达式访问valuestack(值栈)中对象的属性:
${foo} //获得值栈中某个对象的foo属性

如果访问其他context中的对象,由于他们不是根对象,所以在访问时,需要添加#前缀。
application对象:用于访问servletcontext,例如#application.username或者#application['username'],相当于调用servletcontext的getattribute("username")。

session对象:用来访问httpsession,例如#session.username或者#session['username'],相当于调用session.getattribute("username")。

request对象:用来访问httpservletrequest属性(attribute)的map,例如#request.username或者#request['username'],相当于调用request.getattribute("username")。

parameters对象:用于访问http的请求参数,例如#parameters.username或者#parameters['username'],相当于调用request.getparameter("username")。

attr对象:用于按page->request->session->application顺序访问其属性。

八、为何使用el表达式能够访问valuestack中对象的属性

原因是struts2对httpservletrequest作了进一步的封装。简略代码如下:

 public class strutsrequestwrapper extends httpservletrequestwrapper {
       public strutsrequestwrapper(httpservletrequest req) {
           super(req);
       }
       public object getattribute(string s) {
        ......
        actioncontext ctx = actioncontext.getcontext();
        object attribute = super.getattribute(s);//先从request范围获取属性值
        if (ctx != null) {
            if (attribute == null) {//如果从request范围没有找到属性值,即从valuestack中查找对象的属性值
               ......
               valuestack stack = ctx.getvaluestack();
               attribute = stack.findvalue(s);
               ......
            }
        }
        return attribute;
    }
 }

九、采用ognl表达式创建list/map集合对象

如果需要一个集合元素的时候(例如list对象或者map对象),可以使用ognl中同集合相关的表达式。
使用如下代码直接生成一个list对象:
 <s:set name="list" value="{'zhangming','xiaoi','liming'}" />
<s:iterator value="#list" id="n">
 <s:property value="n"/><br>
</s:iterator>

生成一个map对象:
<s:set name="foobar" value="#{'foo1':'bar1', 'foo2':'bar2'}" />
<s:iterator value="#foobar" >
 <s:property value="key"/>=<s:property value="value"/><br>
</s:iterator>

set标签用于将某个值放入指定范围。
scope:指定变量被放置的范围,该属性可以接受application、session、request、 page或action。如果没有设置该属性,则默认放置在ognl context中。
value:赋给变量的值.如果没有设置该属性,则将valuestack栈顶的值赋给变量。

《关于国际化、OGNL表达式语言.doc》

下载本文的Word格式文档,以方便收藏与打印。