一,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文档。