Liferay-portlet.xml概要解释

一，Liferay-Portlet.xml的功能

In addition to the standard portlet.xml options, there are optional Liferay-specific enhancements for Java Standard portlets that are installed on a Liferay Portal server.

这个是liferay-porlet.xml总体的功能，具体说就是描述liferay Portal这个特定平台上的Portlet的特性的。而Portlet.xml描述任意平台上的Porlet的共性。

二，Liferay-portlext.xml的格式

<liferay-portlet-app> <portlet> <portlet-name>jsp-portlet</portlet-name> <icon>/icon.png</icon> <instanceable>true</instanceable> <header-portlet-css>/css/test.css</header-portlet-css> <header-portlet-javascript>/js/test.js</header-portlet-javascript> </portlet> <role-mapper> <role-name>administrator</role-name> <role-link>Administrator</role-link> </role-mapper> <role-mapper> <role-name>user</role-name> <role-link>User</role-link> </role-mapper> </liferay-portlet-app>

三，Liferay-Portlet.xml各标签的含义

portlet-name The portlet-name element contains the canonical name of the portlet. This needs to be the same as the portlet-name given in portlet.xml

这个portlet-name就是某一个Portlet的标识，必须跟portlext.xml中的一样。

icon Path to icon image for this portlet

instanceable Indicates if multiple instances of this portlet can appear on the same page.

struts-path

Tells the portal that all requests with the path ext/library/* are considered part of this portlet's scope.For example, a struts-path of ext/library will give us access to /ext/library/view in struts-config.xml, but not /ext/reports/view.

role-mapper

role-mapper可以将在Portlet.xml中定义的role-security-ref中的name映射到一个具体的角色实现中。不同的门户体系中的角色定义可能不同，但都支持三种：Administrator,Guest,Power User。好像是JSR-168规范里规定的吧。

四，Liferay-portlet.xml的实例

<?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE liferay-portlet-app PUBLIC "-//Liferay//DTD Portlet Application 5.2.0//EN" "http://www.liferay.com/dtd/liferay-portlet-app_5_2_0.dtd">   <liferay-portlet-app>     <portlet>        <portlet-name>testportal</portlet-name>        <instanceable>true</instanceable>     </portlet>     <role-mapper>        <role-name>administrator</role-name>        <role-link>Administrator</role-link>     </role-mapper>     <role-mapper>        <role-name>guest</role-name>        <role-link>Guest</role-link>     </role-mapper>     <role-mapper>        <role-name>power-user</role-name>        <role-link>Power User</role-link>     </role-mapper>     <role-mapper>        <role-name>user</role-name>        <role-link>User</role-link>     </role-mapper> </liferay-portlet-app>

本文参考了liferay portal 5.0的development文档。