下面略述com.opensymphony.xwork2.ActionSupport.getText()方法public String getText(String aTextName)说明:Gets a messages based on a message key,or null if no message is found Parameters:aTextName-the resource bundle key that is to be searched for得到一个基于key的消息,如果没有找到这个消息则返回null参数:aTextName是在资源包寻找到的所匹配的key小结:该方法用来完成国际化,接收的参数即资源包中的key,返回资源包中的valuepublic String getText(String aTextName,List args)说明:Gets a message based on a key using the supplied args,as defined in MessageFormat使用提供的一个被定义在MessageFormat中的参数args得到一个基于key的消息 小结:即此时资源包的key的值可以带参数,即{0}占位符,该参数由List类型的args提供 换句话说,此时可以传递一些运行时的参数,使得消息的产生是动态的 另外还有个与该方法功能相同的public String getText(String key,String[] args)只不过List参数的方法可接收Object参数,而数组参数的方法则只能接收String实际上Object类型的参数真正输出到页面时,也是调用toString()转换成字符串public String getText(String aTextName,String defaultValue)说明:Gets a message based on a key,if the message is not found,a supplied default value is returned小结:即当在资源包中找不到key时,就会返回defaultValue
Struts2里面国际化资源文件的三个存活范围Struts2提供了更精细化的资源文件定义方式,可分全局的和局部的 而局部的国际化资源文件又分为两种情况,分别是:包级别和类级别 包级别资源文件自然要在相应包下建立,它的命名是固定的package_zh_CN.properties若存在相同key,那么包级别中的提示信息要高于全局资源文件中的提示信息 这就好似Java一样,若定义了同名的成员变量和局部变量,那么成员变量将被覆盖掉 类级别资源文件同样要建立在相应包下,它的命名类似于LoginAction_zh_CN.properties类级别的提示信息更加具体,因此类级别的提示信息要高于包级别资源文件的提示信息
类级别和包级别在应用中的触发点 若要在表单中进行国际化信息的显示,则应去掉<s:form/>的theme="simple"属性 然后将姓名输入域改为<s:textfield name="username" key="username.xml.invalid"/>访问页面时,会在姓名位置显示包级别提示信息,即package_zh_CN.properties中的点击Submit时会在姓名位置显示类级别别提示信息,即RegisterAction_zh_CN.properties中的 点击Submit后,表单便与在struts.xml中设定的Action关联在一起,故显示类级别提示信息 所以当使用类级别国际化文件时,必须经过Action才能生效,才能按照预定的进行国际化 若未经Action而直接访问JSP页面,则无法显示类级别的国际化消息,这一点和Struts1.X是不一样的
在国际化资源文件中嵌套OGNL表达式 国际化资源文件中的内容示例如下login.text = 登录login.title = %{getText("login.text")}页面 那么在页面中显示login.title国际化消息时,就会显示:登录页面
页面中国际化的显示<s:text name="key"/>会自动按照范围到资源文件中查找name所指定的key然后输出Key所对应的Value,若Key不存在,则将name值原封不动的输出 并且它也是可以动态传递参数的,这时需要在该标签中嵌套<s:param/>标签<s:label key=""/>在输出国际化信息时,会自动在国际化文本后面加上一个多余的冒号 通过查看页面源文件发现:使用<s:label/>输出的国际化信息位于HTML的<label/>标签内 使用<s:text/>输出的国际化信息则是一些单纯的文本<s:i18n name=""/>用来明确的指定所使用的临时的国际化资源文件 并且该临时资源文件默认与struts.xml处于同一目录下,亦可在name中指定其存放路径 它的name值用来指定所要读取的国际化资源文件,然后再嵌套<s:text/>标签就可以输出指定的key值了在<s:param/>中显示国际化信息如在<s:param value="%{getText('login.tip')}"/>在<s:param/>中接收Action属性如<s:param value="%{username}"/> Struts2表单标签的key属性通常用来输出国际化信息,可以在key值中传一个OGNL表达式 而label属性中放的是字符串,所以也可以使用%{}输出国际化信息,如下所示<s:property value="getText('key')"/>或者<s:textfield label="%{getText('key')}"/>另外关于<s:radio/>标签的国际化显示,如下所示<s:radio list="#{1:getText('i18n.sex.male') ,0:getText('i18n.sex.female')}" name="sex" value="1" key="i18n.sex"/>这个时候就不用再写成%{getText('i18n.sex.male')}了,也就是说可以把%{}去掉了 由于<s:textfield label="%{getText('key')}"/>的label默认使用的是字符串,所以要加上%{}而在<s:radio/>的list属性里面本身已经有{}符号了,说明它已经是一个OGNL表达式了 所以在<s:radio list=“#{}”/>中就没必要再使用%{}了
浅述Struts2国际化的实现过程Struts2的I18nInterceptor拦截器会拦截所有的Action,它主要做的事情为 从客户端发送过来的请求参数中寻找是否存在名为request_locale的参数 若有,则将request_locale的value转化为locale保存起来 该locale是保存在以WW_TRANS_I18N_LOCALE所命名的session里面的 详见源码的第124行session.put(attributeName, locale)其中attributeName即79行的protected String attributeName = DEFAULT_SESSION_ATTRIBUTE和第75行的public static final String DEFAULT_SESSION_ATTRIBUTE = "WW_TRANS_I18N_LOCALE"于是便可通过这种方式实现一个选择页面所显示的语言环境的功能 比如选择中文,那么就可以将request_locale设置为zh_CN如果我们不做任何配置的话,客户端是不会发送request_locale参数的 它默认会用request的getLocale()方法得到默认locale,将其存放在session中 这样就使得以后客户的所有操作都是在同一个国际化的环境下执行 就不需要我们每一次都手工判断用户的国际化环境了