Skip to content

Add RemoteTransportException for remote transport/server faults#193

Open
rajdeep714 wants to merge 2 commits intomainfrom
testfix/KVSTORE-3070
Open

Add RemoteTransportException for remote transport/server faults#193
rajdeep714 wants to merge 2 commits intomainfrom
testfix/KVSTORE-3070

Conversation

@rajdeep714
Copy link
Member

Introduce a new RemoteTransportException to surface server-side faults that likely originate from remote networking/transport issues between service components.

Files changed:
A driver/src/main/java/oracle/nosql/driver/RemoteTransportException.java

  • Added RemoteTransportException (extends NoSQLException) with Javadoc that explains recommended application behavior:
    • Idempotent operations: retry is generally safe.
    • Non-idempotent operations: verify with a read before retrying.

M driver/src/main/java/oracle/nosql/driver/ops/serde/BinaryProtocol.java

  • Map the new BinaryProtocol.REMOTE_ERROR code to RemoteTransportException.

M driver/src/main/java/oracle/nosql/driver/util/BinaryProtocol.java

  • Added new error code BinaryProtocol.REMOTE_ERROR (127).
  • The new error code is intentionally in the 125+ “non-retryable” range so the SDK does not automatically retry internally; callers can decide whether/how to retry.

Introduce ProxyRemoteException and map BinaryProtocol REMOTE_ERROR (127)
to it so server-side remote transport FaultExceptions are surfaced as
non-retryable, preventing automatic SDK retries and letting callers
decide whether/how to retry.
Introduce RemoteTransportException and map REMOTE_ERROR to it in BinaryProtocol, ensuring these remote networking/transport failures are not retried by the SDK retry handler and leaving retry decisions to application code.
@rajdeep714 rajdeep714 requested a review from connelly38 March 10, 2026 13:14
@oracle-contributor-agreement oracle-contributor-agreement bot added the OCA Verified All contributors have signed the Oracle Contributor Agreement. label Mar 10, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

OCA Verified All contributors have signed the Oracle Contributor Agreement.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants