Recommendation: Enhance Java SDK error handling to catch connection failures and provide clearer messages. This requires changes to the SDK code itself, not documentation:
// Suggested enhancement in io.opentdf.platform.sdk.SDKBuildertry {
// existing connection code
} catch (StatusRuntimeExceptione) {
if (e.getStatus().getCode() == Status.Code.UNAVAILABLE) {
thrownewSDKException(String.format(
"Failed to connect to OpenTDF platform at %s. " +
"Is the platform running? Verify with: curl -k %s/healthz",
platformEndpoint, platformEndpoint
), e);
}
throwe;
}
Recommendation: Enhance Java SDK error handling to catch connection failures and provide clearer messages. This requires changes to the SDK code itself, not documentation: