客户端库
在 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 密钥