クライアントライブラリ

JVMアプリケーションからデータレイクを直接使うための Javaクライアント は2つです。各ストレージエンジンに個別に接続せず、ゲートウェイ1つでクエリを実行するか、CEPエンジンにイベントをプッシュします。

ライブラリ	機能	サーバー
Data Gatewayクライアント	4つのクエリ言語(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>

どのバージョンを固定するか

リリースごとに座標が 2つ あります。リリースを切った日には同じバイトですが、その後は異なります。

座標	性質
2026.09	動くポインタ。 その月内に出た修正が同じバージョンとして再アップロードされます — 後方のバイトが変わります。その月の最新修正が必要ならこちら
2026.09-20260904	固定されて変わりません。 2026-09-04 に切ったリリースを指し、再書き込みされません。明日も同じバイトでなければならないならこちら

運用デプロイは日付付き座標で

動くポインタは開発中は便利ですが、運用ビルドが昨日と異なるバイトを取得すると再現性が失われます。CIでは日付付き座標を固定してください。

共通事項

• Java 21 以上(Data Gatewayクライアントは11以上でも動作します)。
• 両クライアントとも AutoCloseable です。try-with-resourcesで閉じてください。
• HTTPSは 証明書の信頼とホスト検証を緩和 します。社内ネットワークの自己署名証明書が標準であるため、プラットフォームの他の内部HTTPクライアントと同じ固定ポリシーです。インターネットを経由して接続しないでください。
• 資格情報はコードに埋め込まず、環境変数またはサイドカーから読み取ってください → パスワード・APIキー