跳到主要内容

客户端库

在 JVM 应用中直接使用数据湖的两个 Java 客户端。它们不分别连接各个存储引擎,而是通过一个网关进行查询,或将事件推送到 CEP 引擎。

库功能服务器
Data Gateway 客户端四种查询语言(PQL · CQL · SQL · TQL)与缓存查询plantpulse-data-gateway (5501)
CEP 客户端EQL 规则部署 · 事件发送 · 匹配回调plantpulse-cep (7401)

从哪里获取​

两个库均可从公司内部 Maven 仓库无需认证获取。

repositories {
maven { url "https://maven.kopens.io/releases/" }
}
dependencies {
implementation "plantpulse-platform:plantpulse-data-gateway-client:2026.09"
implementation "plantpulse-platform:plantpulse-cep-client:2026.09"
}
<repository>
<id>kopens</id>
<url>https://maven.kopens.io/releases/</url>
</repository>

固定哪个版本​

每次发布都会提供两个坐标。在发布截断的当天它们是相同的字节,但之后会有所不同。

坐标性质
2026.09移动指针。 那个月内产生的修正会以相同的版本号再次发布——后面的字节会变化。如果想获取该月的最新修正,请使用此坐标
2026.09-20260904已固定,不会变化。 指向 2026-09-04 截断的发布,之后不会重写。如果要求明天也是相同的字节,请使用此坐标
生产部署请使用带日期的坐标

移动指针在开发过程中很方便,但如果生产构建拉取到与昨天不同的字节,将无法重现。在 CI 中请固定使用带日期的坐标。

通用事项​

  • Java 21 或更高版本(Data Gateway 客户端在 11 或更高版本中也可运行)。
  • 两个客户端都实现了 AutoCloseable——请使用 try-with-resources 关闭。
  • HTTPS 会放宽证书信任和主机验证。因公司内部网络的自签名证书是标准做法,所以采用与平台其他内部 HTTP 客户端相同的固定策略。请勿跨互联网连接。
  • 请勿将凭据硬编码在代码中,应从环境变量或 sidecar 中读取 → 密码 · API 密钥