Context
The Go SDK now has a public SDK.IsHealthy(ctx) (bool, error) method (opentdf/platform#3412) that lets downstream services run readiness probes through the SDK instead of open-coding http.Client.Get(healthzEndpoint). The Go version honors ctx for deadline/cancellation, supports OTEL tracing via interceptors, and uses gRPC Health v1.
This issue tracks the equivalent for the Java SDK.
Why
Cross-SDK feature parity for an idiomatic readiness probe. Without this, Java consumers have to either:
- Open-code an HTTP
/healthz check (no auth interceptor, no OTEL trace propagation, easy to misconfigure)
- Skip readiness probes entirely
Proposed shape
Go signature is IsHealthy(ctx) (bool, error). Java idioms differ — possibilities:
boolean isHealthy() throwing a checked exception (e.g. PlatformUnreachableException) on transport failure
- A typed
HealthCheckResult if more granularity is wanted
- Match whatever pattern the Java SDK already uses for similar transport-failure-vs-success calls
Let the implementer pick the most natural Java idiom; this issue is about the capability, not the exact signature.
Acceptance
Context
The Go SDK now has a public
SDK.IsHealthy(ctx) (bool, error)method (opentdf/platform#3412) that lets downstream services run readiness probes through the SDK instead of open-codinghttp.Client.Get(healthzEndpoint). The Go version honors ctx for deadline/cancellation, supports OTEL tracing via interceptors, and uses gRPC Health v1.This issue tracks the equivalent for the Java SDK.
Why
Cross-SDK feature parity for an idiomatic readiness probe. Without this, Java consumers have to either:
/healthzcheck (no auth interceptor, no OTEL trace propagation, easy to misconfigure)Proposed shape
Go signature is
IsHealthy(ctx) (bool, error). Java idioms differ — possibilities:boolean isHealthy()throwing a checked exception (e.g.PlatformUnreachableException) on transport failureHealthCheckResultif more granularity is wantedLet the implementer pick the most natural Java idiom; this issue is about the capability, not the exact signature.
Acceptance
grpchealth-style test server