Java: API - What about manipulating an array of float in Embedding ?

The Embedding contains a List<Float> to represent the vector. You can pass this list to the constructor and get its content as a List

    private final List<Float> vector;

    public Embedding(@Nonnull List<Float> vector) {
        Objects.requireNonNull(vector);
        this.vector = Collections.unmodifiableList(vector);
    }

    public List<Float> getVector() {
        return vector;
    }

But there are several external APIs (such as PGVector for example) that manipulate arrays of floats. So we end up casting arrays to lists back and forth.

It would be handy if Embedding had a constructor that takes an array of float, and a method to return the vector as an array:

    public Embedding(float[] vector);

    public float[] toArray();

WDYT ?

首先定位 Embedding 类及其现有的构造函数和 getVector API。检查当前向量的存储方式以及附近的测试，然后验证所提议的基于数组的构造和获取能够保留预期值，并且 API 行为已得到覆盖，之后再考虑该功能完成。