【标题】：[Portal参考手册]Portlet描述文件
【关键字】：Portal,Portlet
【来源】：http://blog.csdn.net/smallnest/archive/2006/04/17/666267.aspx

[Portal参考手册]Portlet描述文件

Portlet描述文件通过portlet.xml文件定义application portlet和conrete portlet。这一节将介绍portlet.xml的定义。

Portlet描述文件有下面的结构：

<?xml version="1.0" encoding="UTF-8"?>

<portlet-app-collection>

<portlet-app-def>

            <portlet-app ...>

            <concrete-portlet-app ...>

            <concrete-portlet-app ...>

      </portlet-app-def>

</portlet-app-collection>

	portlet-app-collection定义portlet的集合
	portlet-app-def定义了application porlet和多个conrete portlet
	portlet-app提供了一个application portlet的定义
	concrete-portlet-app提供了一个concrete portlet的定义

一个具体portlet定义了conrete portlet的属性。一个application portlet可以有多个conrete portlet。

<concrete-portlet-app id="org.myorganization.portlets.myportlet.1">

<context-param>

<param-name>buzzle</param-name>

<param-value>yea</param-value>

</context-param>

<concrete-portlet>

<portlet-name>Hello World 1</portlet-name>

<default-locale>en</default-locale>

<title>Hello World - Sample Portlet #1</title>

<title-short>Hello World</title-short>

<description>Here is a simple portlet</description>

<keywords>portlet hello world</keywords>

</language>

<title-short>您好 </title-short>

</language>

<allowed-access visibility="PRIVATE" role="ADMIN"/>

<config-param>

<param-name>a config parameter</param-name>

<param-value>a config value</param-value>

</config-param>

</concrete-portlet>

</concrete-portlet-app>

	Id是conrete portlet的指示符，由application portlet Id加上一个整数组成。一般来说，由1开始递增
	（可选）定义了portlet context信息，由PortletApplicationSettings 对象封装
	concrete portlet，用作产生PortletSettings对象
	（可选）conrete portlet的指示符
	（可选）缺省的locale
	（可选）其他的locale
	（可选）title
	（可选）更简短的title,可以被用作WML设备上显示
	（可选）摘要
	（可选）关键字
	（可选）定义了用户浏览这个portlet的时候的可视化属性。Allowed 的值有两个 PRIVATE 和PUBLIC. Role属性哪个角色可以访问这个portlet。可用的值是在PortletRole 对象中定义的值
	附加的concrete portlet 设置，可以通过PortletSettings 对象取得