基于 Polaris 构建自定义服务器

本页介绍了基于 Apache Polaris 构建自定义服务器的几个关键要点。

Polaris 会生成多个 jar。根据 Polaris 分发版本中所包含的许可证条款，可以使用这些 jar 来构建自定义的 catalog 服务器。

一般原则

• 在你的项目（Maven、Gradle 或任何其他构建工具）中创建一个模块，用于构建 Quarkus 应用。
• 将 polaris-runtime-service 作为运行时或编译期依赖引入。
• 根据项目需要引入或排除其他依赖（例如替代的 JDBC 驱动）。
• 不要将 polaris-runtime-defaults 或 polaris-server 作为依赖引入。
• 为你的 Quarkus 构建提供自己的 application.properties 文件。
• 定义你自己的 Quarkus 应用名称和版本（不要将 "Apache Polaris" 用作应用名称）。

背景

polaris-server 模块是构建 Polaris 服务器的一种特定方式。它包含被认定为 Apache Polaris 分发版本所必需的依赖。对于下游构建而言，情况未必如此——下游构建可能希望排除某些功能并引入其他功能（或许包括对某些 Polaris SPI 接口的自定义实现）。

polaris-runtime-defaults 模块用于存放为默认 Apache Polaris 分发版本配置的 application.properties。虽然在下游构建中复用它并为某些属性添加覆盖配置看起来颇具吸引力，但实践表明，这样一来就很难预测下游构建中属性自定义所产生的影响。虽然这一点或许只与 Gradle 构建相关，但把完整的属性集合放在自定义的 application.properties 文件中，并确保传递依赖中不存在其他 application.properties 文件，会清晰得多。

polaris-runtime-service 模块包含标准的服务端点实现，旨在被复用。下游项目可以使用自定义的 CDI Bean 来覆盖或增强 polaris-runtime-service 所提供的 Bean。