PDF《Realizing the Benefits of Lifreay'》

11 Portlet 项目概览 expiration-cache 表明 portlet 的输出多少秒后就过期了.如果值是 -1 表示不会过期. supports portlet 模式(mode)支持的 MIME 类型, portlet 模式 的概念是由 portlet 规范 定义的.模式用来区分 portlet 不同的特定视图(view).portal 识别 portlet 模式,并提 供模式之间跳转(导航)的通用方法(这句话没太理解:for example, using links in the box surrounding the potlet when it'

s added to a page),因此,这对大多数 portlet 的常 规操作非常有用.最常用的常规用法是建立一个用户可以填写偏好设置的编辑页面. [TODO: 这部分不太理解,以后再改] portlet-info 定义用于 portlet 的 title-bar 和分类的信息.JSR-286 规范只定义了几个资源 元素:title、short-title、keywords.可以直接在 portlet-info 中添加资源元素,也可以把 它们放到资源包(resouce bundle)中.这里所说的 资源 应该是指语言资源吧. 直接在 portlet.xml 的 portlet-info 元素中填写信息非常简单,例如,可以像这样填写一个 天气 portlet 的信息: ... title>

Weather Portlet short-title>

Weather>

keywords>

weather,forecast ... 或者,在资源包文件中添加相同的信息.例如,在 src/main/resources/content 目录中创 建 Language.properties 文件,在文件中填写 portlet 的标题、短标题和关键字: # Default Resource Bundle # # filename: Language.properties # Portlet Info resource bundle example javax.portlet.title=Weather Portlet javax.portlet.short-title=Weather javax.portlet.keywords=weather,forecast 需要在 portlet.xml 中引用这个资源包: ... content.Language ... ... Liferay Portal 6.2 开发指南

12 Portlet 项目概览 如果不打算支持本地化的标题、短标题和关键字,就简单地在 portlet.xml 中定义,否则 就应该写到资源包中. 注意:不应该在 portlet.xml 和资源文件中重复定义标题、关键字等.如果这样做了,资源文件中的内容优先于 portlet.xml 在资源文件中指定标题、短标题、关键字非常简单.例如,如果要支持德语和英语,应 该在 src/main/resources/content目录(和缺省的语言文件在相同的目录)中创建 Language_de.properties 和 Language_en.properties 文件.这两个文件的内容类似以下 内容: # English Resource Bundle # # filename: Language_en.properties # Portlet Info resource bundle example javax.portlet.title=Weather Portlet javax.portlet.short-title=Weather fjavax.portlet.keywords=weather,forecast # German Resource Bundle # # filename: Language_de.properties # Portlet Info resource bundle example javax.portlet.title=Wetter Portlet javax.portlet.short-title=Wetter javax.portlet.keywords=wetter,vorhersage 还应该在 portlet.xml 中引用缺省的和本地化的资源文件,如下: ... content.Language content.Language_de content.Language_en ... ... 浏览 JSR-286 portlet规范 获取更多信息. _security-role-ref 可以访问 portlet 的角色. src/main/webapp/WEB-INF/liferay-portlet.xml portlet.xml 之外的附加参数,是 Java 标准 portlet 部署到 Liferay portal 服务器时用到的可选的 Liferay 增强配置.Liferay IDE 默认会创 建并填充内容: Liferay Portal 6.2 开发指南

13 Portlet 项目概览 图 3.4:My Greeting portlet 的 liferay-portlet.xml 文件. 简要说明: portlet-name portlet 的标准名称,要和 portlet.xml 中的 portlet-n........