java - OpenHFT/Chronicle-Values 中的 @Array(length= ?) 注释是如何使用的

Question

这个问题是关于 Chronicle-Values 的

网站中的一个例子是:

interface SomeStats {
    @Array(length=100)
    long getPercentFreqAt(int index);
    void setPercentFreqAt(int index, long percentFreq);
    long addPercentFreqAt(int index, long addition);
}

此处注解仅应用于其中一种方法。这是否意味着之后的所有方法都被视为处理数组数据？

在one of the test我发现的案例

package net.openhft.chronicle.values;

public interface HasArraysInterface {
    @Array(length = 4)
    void setFlagAt(int idx, boolean flag);

    boolean getFlagAt(int idx);

    @Array(length = 4)
    void setByteAt(int idx, byte b);

    byte getByteAt(int idx);

    @Array(length = 4)
    void setShortAt(int idx, short s);

    short getShortAt(int idx);

    @Array(length = 4)
    void setCharAt(int idx, char ch);

    char getCharAt(int idx);

    @Array(length = 4)
    void setIntAt(int idx, int i);

    int getIntAt(int idx);

    @Array(length = 4)
    void setFloatAt(int idx, float f);

    float getFloatAt(int idx);

    @Array(length = 4)
    void setLongAt(int idx, long l);

    long getLongAt(int idx);

    @Array(length = 4)
    void setDoubleAt(int idx, double d);

    double getDoubleAt(int idx);

    @Array(length = 4)
    void setStringAt(int idx, @MaxUtf8Length(8) String s);

    String getStringAt(int idx);
}

据我了解，您可以在此接口(interface)中拥有多个数组，其中 @Array(length = 4) 应用于以 At 结尾的方法，直到下一个注释.这样对吗？

此外，您是否可以使用类似以下内容来模拟 4 个 double 组和 8 个字符串数组:

    @Array(length = 4)
    void setDoubleAt(int idx, double d);

    double getDoubleAt(int idx);

    @Array(length = 8)
    void setStringAt(int idx, @MaxUtf8Length(8) String s);

    String getStringAt(int idx);

在一个接口(interface)中分配多个@Array(length= ?)的多个数组的内存布局是怎样的？您可以在面向列或面向行的布局之间进行选择吗？如果 length 不同，将如何处理布局？

也代替:

interface SomeStats {
    @Array(length=100)
    long getPercentFreqAt(int index);
    void setPercentFreqAt(int index, long percentFreq);
    long addPercentFreqAt(int index, long addition);
}

你能不能把它写成:

@Array(length=100)
interface SomeStats {
    long getPercentFreqAt(int index);
    void setPercentFreqAt(int index, long percentFreq);
    long addPercentFreqAt(int index, long addition);
}

暗示 @Array(length=100) 适用于整个界面。

您还可以将指定长度推迟到创建点吗？

Answer 1

1. Here the annotation is only applied to the one of the methods. Does this imply all methods afterwards are treated as working on the array data?

来自 @Array javadoc :

This annotation must be put on a single method accessing the array elements: getter, or setter, or adder, etc.

我。 e. @Array 应该放在一个(任何) 方法上，访问一个字段。 “字段”由标准访问器方法和名称定义，即。 e.在您的示例中，在 SomeStats 值接口(interface)中，有一个名为 PercentFreq 的(数组)字段。如果你向这个接口(interface)添加像 getAnotherField(), setAnotherField() 这样的方法，它将是一个单独的字段，@Array 注释不会'申请，我。 e.这将是一个“标量”字段，除非您将 @Array 放在 getAnotherField() 或 setAnotherField() 上并添加 int index 这些方法的参数，以及 -At 后缀。

2.

What I understood from this is that you can have multiple arrays within this interface where @Array(length = 4) applies to methods ending with At until the next annotation. Is this right?

不，不是“直到下一个注释”。注释应用于字段。字段访问器方法(由字段名称标识)可以在接口(interface)定义中以任何顺序进行。

3.

What is the memory layout of multiple arrays allocated with multiple @Array(length= ?) within one interface? Can you choose between column oriented or row oriented layout? How will the layouts be handled if the length is different?

在您的示例中，布局将是:

Double element 0 (8 bytes)
Double element 1 (8 bytes)
Double element 2 (8 bytes)
Double element 3 (8 bytes)
String element 0 (9 bytes: 1 bytes to encode size + 8 bytes of reserved space)
...
String element 7 (9 bytes)

要进行基于行的对齐，您应该定义另一个接口(interface):

interface Row {
    void setDouble(double d);
    double getDouble();

    void setString(@MaxUtf8Length(8) String s);
    String getString();
}

然后定义数组或行:

interface MyTopInterface {
    @Array(length=8)
    void setRowAt(int index, Row row);
    Row getRowAt(int index);
}

这将与“面向列”的布局一样高效并占用相同数量的内存。 Read about nested structures in the tutorial.

4.

implying @Array(length=100) applies to the whole interface.

你不能这样做，使用上面建议的模式(嵌套接口(interface))

5.

Also can you defer specifying the length until the point of creation?

不，Chronicle Values 的整个想法是它们的总大小是静态已知的。