Struts中非常常用的有这样的一个标签:
众所周知,这个标签做的事情是这样的:
访问在struts-config.xml中定义的资源文件,一般是application.properties,一般是这样定义的:
根据以上的定义,Struts将到WEB-INF/classes/resource/下去找application.properties文件,这是从以上配置信息的表面上看起来是这样,但通过查看Struts的源码,可以看到如下的代码:在org.apache.struts.util.PropertyMessageResources类中,有如下的代码:
通过这段代码,可以看到
A、.properties扩展名是写死在代码中的,所以资源文件必须使用这个扩展名
B、Struts并不是单纯去寻找application.properties文件,而是首先找到application,赋给name变量然后加上下划线”_”,然后再加上localeKey(如zh,en),然后再加上.properties
C、确定了文件名之后,Struts使用了ClassLoader类的getResourceAsStream方法得到了一个InputStream
D、然后Struts使用了java.util.Properties类的load方法,将资源文件中的所有资源读出放到了一个HashMap里面
E、然后Struts就可以根据key值取出不同的message给前台了
// Set up to load the property resource for this locale key, if we can<br /> String name = config.replace('.', '/');<br /> if (localeKey.length() > 0) {<br /> name += "_" + localeKey;<br /> }<br /> name += ".properties";<br /> InputStream is = null;<br /> Properties props = new Properties();<br /> // Load the specified property resource<br /> if (log.isTraceEnabled()) {<br /> log.trace(" Loading resource '" + name + "'");<br /> }<br /> ClassLoader classLoader = Thread.currentThread().getContextClassLoader();<br /> if (classLoader == null) {<br /> classLoader = this.getClass().getClassLoader();<br /> }<br /> is = classLoader.getResourceAsStream(name);<br /> if (is != null) {<br /> try {<br /> props.load(is);<br /> } catch (IOException e) {<br /> log.error("loadLocale()", e);<br /> } finally {<br /> try {<br /> is.close();<br /> } catch (IOException e) {<br /> log.error("loadLocale()", e);<br /> }<br /> }<br /> }
D步骤中的load方法可以参看JDK的帮助文档,load方法要求这个资源文件必须以ISO8859编码进行书写方能正确解析 所以,如果我们在资源文件中写入了中文,并在运行时出现了中文编码问题(?出现),那么只需确认您的资源文件是否是以ISO8859为编码进行书写的即可
另外,Struts在查找资源文件时,首先是按照如上的描述进行$Filename_$Locale.properties文件的查找如果他找不到,那么他就会用默认的$Filename.properties来找,如果还找不到,那就报错了这个Struts的查找顺序并不是我的杜撰,有如下Struts源码为证(这个方法是PropertyMessageResources.java中的):
public String getMessage(Locale locale, String key) {<br /> if (log.isDebugEnabled()) {<br /> log.debug("getMessage(" + locale + "," + key + ")");<br /> }<br /> // Initialize variables we will require<br /> String localeKey = localeKey(locale);<br /> String riginalKey = messageKey(localeKey, key);<br /> String messageKey = null;<br /> String message = null;<br /> int underscore = 0;<br /> boolean addIt = false; // Add if not found under the original key<br /> // Loop from specific to general Locales looking for this message<br /> while (true) {<br /> // Load this Locale's messages if we have not done so yet<br /> loadLocale(localeKey);<br /> // Check if we have this key for the current locale key<br /> messageKey = messageKey(localeKey, key);<br /> synchronized (messages) {<br /> message = (String) messages.get(messageKey);<br /> if (message != null) {<br /> if (addIt) {<br /> messages.put(originalKey, message);<br /> }<br /> return (message);<br /> }<br /> }<br /> // Strip trailing modifiers to try a more general locale key<br /> addIt = true;<br /> underscore = localeKey.lastIndexOf("_");<br /> if (underscore < 0) {<br /> break;<br /> }<br /> localeKey = localeKey.substring(0, underscore);<br /> }<br /> // Try the default locale if the current locale is different<br /> if (!defaultLocale.equals(locale)) {<br /> localeKey = localeKey(defaultLocale);<br /> messageKey = messageKey(localeKey, key);<br /> loadLocale(localeKey);<br /> synchronized (messages) {<br /> message = (String) messages.get(messageKey);<br /> if (message != null) {<br /> messages.put(originalKey, message);<br /> return (message);<br /> }<br /> }<br /> }
// As a last resort, try the default Locale
这里可以看到Struts最后将localeKey赋空
这样资源文件就是$Filename.properties了
localeKey = “”;
messageKey = messageKey(localeKey, key);
loadLocale这个方法将读取资源文件,填入HashMap
这个方法的代码在上面已经列出来了
loadLocale(localeKey);<br /> synchronized (messages) {<br /> message = (String) messages.get(messageKey);<br /> if (message != null) {<br /> messages.put(originalKey, message);<br /> return (message);<br /> }<br /> }<br /> // Return an appropriate error indication<br /> if (returnNull) {<br /> return (null);<br /> } else {<br /> return ("???" + messageKey(locale, key) + "???");<br /> }<br /> }
至于这个$Locale的值是多少,通过很长时间的查找之后,发现了这样一些代码:
在org.apache.struts.util.RequestUtils类中的600多行左右,有这样一个方法:
public static Locale getUserLocale(HttpServletRequest request, String locale) {<br /> Locale userLocale = null;<br /> HttpSession session = request.getSession(false);<br /> if (locale == null) {<br /> locale = Globals.LOCALE_KEY; //这个值是org.apache.struts.action.LOCALE<br /> }<br /> // Only check session if sessions are enabled<br /> if (session != null) {<br /> userLocale = (Locale) session.getAttribute(locale);<br /> }<br /> if (userLocale == null) {<br /> // Returns Locale based on Accept-Language header or the server default<br /> userLocale = request.getLocale();<br /> }<br /> return userLocale;<br /> }
可以看出,Struts将Locale的实例对象放到了session中,但是他什么时候将这个对象放到session里面的,尚未找到(很多配置在ActionServlet中读取并储存的,因为这个类是第一个启动的类,但这个类中没发现Locale对象的储存)
奋斗令我们的生活充满生机,责任让我们的生命充满意义!