Java Proxy Client Library Release Notes

Fixes

• CLIENT-3097 Add XDR_KEY_BUSY result code.

• CLIENT-3081 Upgrade grpc version to 1.65.1.

• Upgrade to netty 4.1.112.Final and commons-cli 1.9.0 per snyk.

Fixes

• CLIENT-2933 If binNames array is specified and empty, read all bins.

• CLIENT-2962 Remove unnecessary imports.

• CLIENT-2971 Make metrics classes public in javadoc.

• CLIENT-2972 Allow scan to work in a mixed cluster of server 5.7 and 6.4 nodes.

• CLIENT-3002 Change ReadModeSC doc from server to client perspective.

• Upgrade netty version to 4.1.110.Final per snyk.

• Upgrade commons-cli to 1.8.0 per snyk.

Features

• CLIENT-2839 Add methods for copying default policies.

• CLIENT-2843 Add getKeyRecord() in RecordSet and RecordSequenceRecordSet.

• CLIENT-2868 Add readTouchTtlPercent command line option to benchmarks.

Fixes

• CLIENT-2842 Use default batch policy (ClientPolicy batchWritePolicyDefault, batchUDFPolicyDefault or batchDeletePolicyDefault) when the record level batch policy is null.

• Upgrade netty version to 4.1.108.Final per snyk.

• Upgrade commons-cli to 1.7.0 per snyk.

Features

• CLIENT-2817 Support readTouchTtlPercent in Policy and BatchReadPolicy. This feature requires server version 7.1+.

Fixes

• CLIENT-2808 Use same message format in timeout exceptions as all other exceptions.

• CLIENT-2813 Remove GeoJSON map key query example because the server no longer supports GeoJSON map keys.

• CLIENT-2785 Update map key docs to say that only string, integer and byte[] types are allowed as map keys.

• CLIENT-2785 Update sendKey policy doc to say what happens when a user key is sent on a read operation.

• Update PartitionFilter.after() doc to say that records in other partitions than the key's partition are filtered out. Also, mention why after() is not accurate for a secondary index query. Both digest and bval are required to determine a secondary index query cursor and bval is not passed in as an argument.

• Update Exp.cond() doc to say that all action expressions must return the same type, with the exception being Exp.unknown().

• Upgrade netty version to 4.1.107.Final per snyk.

• Upgrade netty io_uring version to 0.0.25.Final per snyk.

Features

• CLIENT-2764 Support persistent list indexes.

Fixes

• CLIENT-2775 Do not use batch repeat flag on batch writes when sendKey policy is true.

• CLIENT-2755 Return error when command line object spec is invalid in benchmarks. Also, cleanup DBObjectSpec class and fix random generation when run multiple times.

• CLIENT-2762 Do not force timeout exception to be a server timeout. Instead, use the chosen timeout type when the exception was generated.

• Upgrade netty version to 4.1.104.Final and netty io_uring version to 0.0.24.Final per Snyk.

• Update add() docs to mention that the record/bin will be created by default when the record/bin does not already exist.

Fixes

• CLIENT-2754 Release new version to keep in sync with the native java client release. The proxy client requires JDK 8+ and does not have a JDK 21 specific release because the proxy client does not use virtual threads.

Features

• CLIENT-2737 Add setters to applicable policies. This is done to facilitate Spring's ConfigurationProperties.

• Support transactions only on given partitions in benchmarks.

Fixes

• CLIENT-2667 In Java proxy client, create/Throw invalid namespace exception at the end of applicable batch reads on invalid namespace errors to be consistent with the java native client.

• CLIENT-2674 Replace SimpleDateFormat/Date with DateTimeFormatter/LocalDateTime.

• CLIENT-2706 In scan/query with maxRecords set, mark node's partitions for retry on next scan/query page when that node returns records that are discarded due to exceeding maxRecords.

• CLIENT-2720 Include all partition unavailable errors in the scan/query sub-exception list.

• Fix ACT random command line argument in benchmark code.

• Use Thread.getName() in ThreadLocalData debug log messages.

• Upgrade to netty 4.1.103.Final, grpc 1.59.0 and commons-cli 1.6.0.

• Change ListExp/MapExp doc examples to use EXISTS when searching keys/values in list/map.

• Clarify the purpose of gCallbackSet in Log.isSet() api doc.

Features

• CLIENT-2570 Support Exp.recordSize(). This feature requires server version 7.0+.

• CLIENT-2584 Support secondary index on a blob (byte[]). This feature requires server version 7.0+.

• CLIENT-2597 Support Record.getBytes().

• CLIENT-2598 Support persistent map indexes. This feature requires server version 7.0+.

Fixes

• CLIENT-2483 Add returnType argument to relevant MapExp.removeBy() and ListExp.removeBy() methods. See Incompatible API change.

• CLIENT-2439 Document valid map key types (string, integer, byte[], list).

• CLIENT-2554 Use the standard Base64 class instead of the old javax.xml.bind.DatatypeConverter for base64 encoding/decoding. DatatypeConverter was used when bouncycastle crypto was enabled. DatatypeConverter has been removed from newer versions of the java JDK.

• CLIENT-2554 Add manifest filters to examples/benchmarks “pom.xml” to fix jar-with-dependencies jar signing errors when running with bouncycastle crypto and newer versions of the java JDK.

• CLIENT-2554 Fix the set_crypto sed script when running on Linux.

• CLIENT-2623 Use base 64 url decoder for decoding the claims token.

• Update operate() docs to mention the bin result type will be a list when multiple operations occur on the same bin.

• Change SERVER_NOT_AVAILABLE doc to say "Connection to server failed".

• Upgrade netty version to 4.1.99.Final per Snyk.

• Upgrade netty iouring version to 0.0.23.Final per Snyk.

Features

• Proxy client initial release. This client can be used with the database-as-a-service (dbaas) server.