Liferay Blade Samples 开源项目指南

1. 目录结构及介绍

Liferay Blade Samples 是一个丰富的示例集合，旨在帮助开发者快速上手 Liferay Portal 的开发。此项目支持多种构建工具，如 Liferay Workspace、Maven 和 JSP Portlet 模板等。以下是核心目录结构概述：

• liferay-workspace: 包含基于 Liferay Workspace 的样本项目，这里你将找到不同的应用模块及其测试组件。
  • modules: 存放业务逻辑、portlet模块以及相关的测试代码，如sample/sample-test。
  • apps 和 wars: 分别存储Portlet的应用和WAR包项目。
• maven: 直接使用Maven管理的项目模板存放位置。
• jsp-portlet: 展示JSP端口的简单实现，包括通知框架的使用。
• github/workflows, gradle, maven, yarn-workspace 等: 配置自动化构建流程、构建工具相关文件和依赖管理。
• LICENSE.txt: 许可证文件，声明该项目遵循 Apache-2.0 协议。
• README.md: 主要的项目说明文档，提供安装和使用的基本指导。

2. 项目的启动文件介绍

对于 Liferay Workspace 项目：

• build.gradle: Gradle 构建脚本，定义了项目依赖、编译任务以及部署规则。启动或构建项目通常在相应模块目录下运行 gradlew build 或 gradlew deploy 命令。
• 在模块根目录下，可能会有特定的启动命令，例如测试集成环境启动可能执行 gradlew buildService testIntegration。

Maven 项目：

• pom.xml: Maven 的项目对象模型文件，控制着项目的构建过程、依赖关系、插件配置等。启动Maven项目通常通过命令 mvn clean install 或配置成IDE中的生命周期目标来完成。

JSP WAR Portlet 或其他传统类型：

• 对于直接部署的WAR项目，无特定“启动文件”，但构建后，该WAR文件需被部署到Liferay服务器中。这通常是通过Liferay控制台或使用命令行工具完成。

3. 项目的配置文件介绍

共享配置和环境特定配置：

• 在 Liferay Workspace 环境下，主要配置通常位于 .liferay 文件夹内（如 .liferay/portal-ext.properties），用于覆盖Liferay默认设置。
• Maven项目中，配置可能分散在多个地方，如 pom.xml 内的配置节段或特定于应用的配置文件。
• 特定样本项目内部也可能会有自己的配置文件，比如 Spring Boot 应用会有 application.properties 或者 application.yml。

服务和模块配置：

• 对于模块化项目，每个模块内的 module-info.java 定义了模块的接口和服务。
• OSGi相关的配置可能存在于 config.properties 或通过编程式服务注册进行配置。

请注意，实际项目中的配置文件及其详细配置内容将依据具体示例而异，上述仅为通用指引。深入了解特定示例的配置，建议查阅各模块下的 README 文件和具体的配置注释。