MLE-22706 Added encode/decode support for vectors

[rjrudin]

No description provided.

[Copilot]

Pull Request Overview

This PR adds support for Base64 encoding and decoding of float vectors in the Java client to match the MarkLogic server’s vec:base64-encode/vec:base64-decode behavior and verifies interoperability via new tests.

• Introduces VectorUtil.encode(float...) and VectorUtil.decode(String) with versioned, little-endian serialization.
• Adds JUnit tests in VectorUtilTest to validate round-trip encoding/decoding using both Java client and server evaluations.

Reviewed Changes

Copilot reviewed 2 out of 2 changed files in this pull request and generated 3 comments.

File	Description
marklogic-client-api/src/main/java/com/marklogic/client/util/VectorUtil.java	Adds static methods for Base64 vector serialization with version handling.
marklogic-client-api/src/test/java/com/marklogic/client/util/VectorUtilTest.java	Implements tests covering client-only, server-only, and cross-boundary encode/decode scenarios.

Comments suppressed due to low confidence (2)

marklogic-client-api/src/test/java/com/marklogic/client/util/VectorUtilTest.java:15

• [nitpick] Test constants are generally defined as static final. Consider changing this to private static final float[] VECTOR to follow standard constant conventions and avoid redundant instance fields.

	private final float[] VECTOR = new float[]{3.14f, 1.59f, 2.65f};

marklogic-client-api/src/main/java/com/marklogic/client/util/VectorUtil.java:36

• Add a test case to cover this IllegalArgumentException path by decoding a Base64 string with a non-zero version to ensure the exception is thrown as expected.

			throw new IllegalArgumentException("Unsupported vector version: " + version);

[Copilot]

Extract the hard-coded version 0 into a named constant (e.g. VERSION = 0) to improve clarity and make future version changes easier.

Suggested change

	static String encode(float... vector) {
	final int dimensions = vector.length;
	ByteBuffer buffer = ByteBuffer.allocate(8 + 4 * dimensions);
	buffer.order(ByteOrder.LITTLE_ENDIAN);
	buffer.putInt(0); // version
	// Define the version constant
	public static final int VERSION = 0;
	static String encode(float... vector) {
	final int dimensions = vector.length;
	ByteBuffer buffer = ByteBuffer.allocate(8 + 4 * dimensions);
	buffer.order(ByteOrder.LITTLE_ENDIAN);
	buffer.putInt(VERSION); // version

[Copilot]

Use the same named constant instead of the literal 0 when checking the version to maintain consistency with the encoding logic.

Suggested change

	if (version != 0) {
	if (version != VECTOR_VERSION) {

[Copilot]

Instead of casting from JsonNode, consider using .evalAs(ArrayNode.class) directly to improve type safety and remove the unchecked cast.