Liferay开发指南：Portlet与主题定制详解

Liferay开发手册是一份详尽的指南，主要关注Portlet和主题（Look-and-Feel）的开发，以及它们在Liferay Portal框架中的应用。以下是关键知识点的详细解读： 1. **Portlet开发** - Liferay Portal基于Java Portlet技术构建，Portlet是Liferay的核心组件，负责扩展其用户界面。开发过程中，开发者需关注以下几个关键文件： - `liferay-display-ext.xml`: 定义Portlet的显示逻辑，如视图的配置和呈现方式。 - `liferay-portlet-ext.xml`: 描述Portlet的元数据，包括名称、描述等，以及它如何与其他Portlet交互。 - `portlet-ext.xml`: 为Portlet提供配置信息，如JSR-168属性和其他扩展属性。 - `tiles-defs-ext.xml`: 使用Tiles框架管理Portlet的布局和导航，定制端到端的用户体验。 - `struts-config-ext.xml`: 如果使用Struts2作为Portlet的后端控制器，这个文件用于配置Action和结果映射。 - `ConfigurationActionImpl.java` 是Portlet的配置功能实现，继承自`ConfigurationAction`，处理与用户交互的配置信息存储和获取。 - `StrutsPortletImpl.java` 是Portlet的具体实现类，扩展了`StrutsPortlet`，要求实现`doView`和`processAction`方法，用于数据展示和处理用户请求。 - `ViewAction.java` 控制Portlet页面间的跳转，属于PortletAction的子类，用于管理页面之间的导航逻辑。 - JSP文件主要分布在`\WebRoot\html\portlet\ext\[portletName]`目录下，例如`configuration.jsp`用于配置页面，`init.jsp`负责数据初始化，`view.jsp`和`view_article.jsp`分别显示列表和详细内容，`view_more.jsp`可按需提供“更多”选项。 2. **主题开发** - 主题决定了Portal的整体外观和用户界面风格。核心配置文件是`liferay-look-and-feel.xml`，位于`\WebRoot\WEB-INF`，每个`<theme>`标签代表一个独特的主题，拥有唯一的`id`和显示名称，并通过`root-path`指定主题文件路径。 - 主题文件结构通常包含样式表(.css)、图片、JavaScript和模板文件，这些文件放在`\html\themes\[主题名称]`目录下。新主题开发时，通常基于现有主题进行复制，并在此基础上添加或修改自定义内容。 3. **布局（Layout）开发** - 布局是Portlet在页面中的组织方式，通过配置文件定义不同区域的显示内容。尽管具体细节未在给定内容中明确指出，但通常涉及使用Liferay提供的布局引擎，比如Tiles，来管理Portlet在整个门户中的显示位置和结构。 Liferay开发手册详细指导了如何创建Portlet及其配置，定制主题和布局，以创建功能丰富的用户界面。对于Liferay开发者而言，理解并掌握这些文件和概念至关重要，以确保开发出符合Liferay架构和用户需求的扩展组件。