Liferay研究之十七：由Velocity模板的国际化问题引出的“大秘密”

事由：

想在每个layout（page）增加一个统一的Footer。这时，就需要修改portal-normal.vm。

对于复杂的，可以参考Liferay默认的一个Theme liferay-noir-theme的实现方式，通过：

$serviceLocator.findService("com.liferay.portlet.journal.service.JournalArticleLocalService"))

获取一个文章的服务，并通过liferay-look-and-feel.xml中的文章编号配置，来显示一篇文章；

对于简单的，我们只是写几个文字就可以了，比如说，联系我们，copyright等等。

如果直接在portal-normal.vm中增加文字，英文还可以，但如果增加中文，那么就会出现乱码，需要通过Liferay的国际化机制来实现。

具体的办法是：

$languageUtil.get($locale, "msgKey")

这里的msgKey就是你的资源文件中的键值。

再深入分析一下，liferay是如何实现$languageUtil.get调用的呢？

首先，查找得知，languageUtil是在VelocityVariables中定义的， 而在VelocityFilter中，将所有的这些变量写入到HttpRequest中。

VelocityFilter在哪里定义？当然是web.xml中了。

有一个问题是：在VelocityVariables中，定义的theme是一个Theme对象，但是在vm中，$theme却好像是VelocityTaglib对象，其方法匹配不上，比如runtime方法。

答案可以在ThemeUtil.includeVM中找到， 在该方法中，确实是用VelocityTaglib的一个对象，替换了原来的theme属性值。

打破砂锅问到底，什么地方调用ThemeUtil.includeVM？ 这个就牵扯出更深层的“秘密”：liferay是如何实现Portlet的。

WrapPortletTag调用了ThemeUtil.includeVM,而这个Tag是由<liferay-theme:wrap-portlet >来触发的。哪里调用liferay-theme:wrap-portlet ? Portlet.jsp!

阅读portal-web/doc-root/html/common/theme/portlet.jsp中，可以知道很多事情，比如如何显示一个Portlet？如何调用tile中的页面等等。具体的以后再详细分析。

另外，在系统的init.jsp中，有一个<liferay-theme:defineObjects/>标签，该标签对应的DefineObjectsTag就是将很多liferay的变量放到pageContext。