liferay开发小记---portlet文件构造

书接上回，说说portlet的开发，每一个portlet就是对应着一个web应用，在liferay中它把多个portlet集成到一个页面展示出来。如果你的开发环境搭建完成，启动tomcat，用帐号/密码：test@liferay.com/test登录到liferay中，liferay的手册中有关于权限、页面布局、样式定义等的介绍，这里不说了。我们先看一下ipc-baseball-portlet这个portlet的构造。docroot文件夹是你的portlet存放应用文件的根目录，先看WEB-INF下的几个配置文件。liferay-display.xml文件是你的portlet的显示信息：

<display>
	<category name="IPC">
		<portlet id="pitcher-portlet" />
		<portlet id="catcher-portlet"/>
	</category>
</display>

 其中"IPC"是你"Add Application"时候弹出窗口中的一个分类名称，以上配置说明在IPC这一类下有两个portlet应用。liferay-plugin-package.properties是开发包的属性文件；liferay-portlet.xml是一个liferay和具体portlet的关联文件，

<liferay-portlet-app>
	<portlet>
		<portlet-name>pitcher-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>
	<portlet>
		<portlet-name>catcher-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>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>

 该文件中，pitcher-portlet是该portlet的ID，它要和liferay-display.xml文件中的ID对应，这个id下面几行是指定这个portlet加载的时候要引入的css和js文件，我试了一下，用逗号分隔不能添加多个文件。文件后半段是说明什么样的角色可以访问这两个portlet。

portlet.xml才是描述这个portlet的关键文件：

<portlet>
	
		<portlet-name>pitcher-portlet</portlet-name>
		<display-name>Pitcher Portlet</display-name>
		<portlet-class>com.liferay.ipc.PitcherPortlet</portlet-class>
		<init-param>
			<name>view-jsp</name>
			<value>/pitcher/view.jsp</value>
		</init-param>
		<expiration-cache>0</expiration-cache>
		<supports>
			<mime-type>text/html</mime-type>
		</supports>
		<portlet-info>
			<title>Pitcher Portlet</title>
			<short-title>Pitcher Portlet</short-title>
			<keywords>IPC Baseball Pitcher</keywords>
		</portlet-info>
		
		<security-role-ref>
			<role-name>administrator</role-name>
		</security-role-ref>
		<security-role-ref>
			<role-name>guest</role-name>
		</security-role-ref>
		<security-role-ref>
			<role-name>power-user</role-name>
		</security-role-ref>
		<security-role-ref>
			<role-name>user</role-name>
		</security-role-ref>
		
		<supported-publishing-event>
			<qname xmlns:x="http://liferay.com/events">x:ipc.pitch</qname>
		</supported-publishing-event>
		
	</portlet>
	
	<portlet>
		<portlet-name>catcher-portlet</portlet-name>
		<display-name>Catcher Portlet</display-name>
		<portlet-class>com.liferay.ipc.CatcherPortlet</portlet-class>
		<init-param>
			<name>view-jsp</name>
			<value>/catcher/view.jsp</value>
		</init-param>
		<expiration-cache>0</expiration-cache>
		<supports>
			<mime-type>text/html</mime-type>
		</supports>
		<portlet-info>
			<title>Catcher Portlet</title>
			<short-title>Catcher Portlet</short-title>
			<keywords>IPC Baseball Catcher</keywords>
		</portlet-info>
		<security-role-ref>
			<role-name>administrator</role-name>
		</security-role-ref>
		<security-role-ref>
			<role-name>guest</role-name>
		</security-role-ref>
		<security-role-ref>
			<role-name>power-user</role-name>
		</security-role-ref>
		<security-role-ref>
			<role-name>user</role-name>
		</security-role-ref>
		
		<supported-processing-event>
			<qname xmlns:x="http://liferay.com/events">x:ipc.pitch</qname>
		</supported-processing-event>
	</portlet>
	
	<event-definition>
		<qname xmlns:x="http://liferay.com/events">x:ipc.pitch</qname>
		<value-type>java.lang.String</value-type>
	</event-definition>

 portlet-name要和刚才的id对应，display-name是portlet的标题名，portlet-class是这个portlet对应的请求处理类，init-param中配置的是这个portlet加载到页面中时初始页面，当然这个也可以是一个映射请求；expiration-cache是缓存，supports中配置的是支持的文件格式，这个以后还会再说到，我现在不怎么清楚怎么添加多种文件支持格式；以下是一些权限控制信息。supported-publishing-event是说明一下这个portlet支持的事件，这个例子本身就是介绍两个portlet怎么通信的，这一块我还没看。

别的方面，感觉看看例子就差不多了。