[Portal参考手册]Portlet布局框架

Portlet布局组件类似java中的awt/swing组件。原因有二：
1) 象awt/swing一样，提供了相近的增删组件的API
2) 基于Composite设计模式，用户可以自己开发组件。

Portlet布局组件：
一个portlet布局,在用户看来就是一个PortletPage。一个PortletPage包含多个portlet组件。通常portlet布局组件继承于PortletContainer类，有width,height,CSS属性等。

PortletContent
允许使用include属性包含外部内容。
PortletTableLayout
表格布局。
PortletRowLayout
行布局。
PortletColumnLayout
列布局。
PortletTabbedPane
Tab面板布局。
PortletTab
一个tab定义了一个标题和一个 portlet组件，当tab被选择的时候这个组件将被显示。
PortletFrame
一个portlet frame 显示一个portlet。它包含标题边框和要显示的portlet的类名。如果transparent属性不被设为true, 标题栏不会被显示。required-role元素可以被指定为"GUEST", "USER", "ADMIN" 或 "SUPER"。

设计一个布局：
一个外部的web应用可以指定一种布局，通过年纪WEB-INF/layout.xml文件。布局描述文件定义了在一个double-tabbed 面板中的portlet的组织。下面时一个例子。
<portlet-tabbed-pane>


<portlet-tab>
<title lang="en">Examples</title>


<portlet-tabbed-pane style="sub-menu">


<portlet-tab>
<title lang="en">Simple Examples</title>
<table-layout>


<row-layout>


<column-layout width="50%>


<portlet-frame>


<portlet-class>org.myorg.portlets.examples.simpleone.1</portlet-class>
</portlet-frame>
</column-layout width="50%>
<column-layout width="50%>
<portlet-frame label="simpletwo">


<portlet-class>org.myorg.portlets.examples.simpletwo.1</portlet-class>
</portlet-frame>
</column-layout>
</row-layout>
</table-layout>
</portlet-tab>
<portlet-tab>
<title lang="en">Demos</title>
<table-layout>
<row-layout>
<column-layout>
<portlet-frame>
<name>DemoPortlet</name>
<portlet-class>com.kuaff.spirit.portlets.examples.DemoPortlet.1</portlet-class>
</portlet-frame>
</column-layout>
</row-layout>
</table-layout>
</portlet-tab>
</portlet-tabbed-pane>
</portlet-tab>
</portlet-tabbed-pane>

	每一个描述文件都必须以portlet-tabbed-pane 开始
	Tab标题可以本地化。
	不是必须的。
	Table布局。
	Row布局。
	Table布局。
	portlet frame。
	指定一个标签。意味着它可以被连接。

了解更多的信息，可以查看layout-mapping.xml文件，它定义了portlet组件类和描述符之间的关系。