클라이언트 라이브러리

JVM 애플리케이션에서 데이터레이크를 직접 쓰는 자바 클라이언트 둘입니다. 각 저장 엔진에 따로 붙지 않고, 게이트웨이 하나로 질의하거나 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 클라이언트와 같은 고정 정책입니다. 인터넷을 건너 붙이지 마십시오.
• 자격은 코드에 박지 말고 환경변수나 사이드카에서 읽으십시오 → 비밀번호 · API 키