JUnion为 Java 提供结构类型

JUnion 用于为 Java 编程语言提供结构类型。

功能特性

• 结构类型

• 自动对齐数据

• 手动对齐数据

• 创建结构类型的数组

• 64 位可寻址数组

• 修改原生 DirectByteBuffers

• 检查数组下标

• 嵌套结构

• 结构引用

• 空引用检查

• 数组切割

• 泛型

• 栈分配

查看更多特性介绍 https://tehleo.github.io/junion/features.html

当创建 int 数组时，我们有两个主要选项：

int[] intArray = new int[1000];  
Integer[] intBoxedArray = new Integer[1000];

那么，intArray, intBoxedArray 需要多少个字节才能存储 1000 个 int 数据？结果如下 ——

intArray 4016 bytes 4*1000 + ~16(around 16 bytes for array header) 
intBoxedArray 20016 bytes (4 + ~12 + ~4)*1000 + ~16 （具体数据取决于 VM）

可以看到，后者几乎是前者的 5 倍，因此我们应该偏向于选择使用原始数组 (primitive arrays)。

考虑这样一个问题

class Point { float x,y;}
Point[] arr = new Point[500];

arr 占用了 14016 个字节，而数据包含了 500 个 points，每个 points 有两个浮点数，因此 4000 个字节应该足够了。

但如果 Point 是一个结构类型(struct)，arr 大约只占用 4000 个字节。

使用 JUnion，可以通过 @Struct 注解标记一个类来做到这一点！

创建 struct Vec3:

@Struct
public class Vec3 {
    public float x,y,z;
}

然后，你可以将其用作：

//Create a new struct array
Vec3[] arr = Vec3[10];
arr[5].x = 10;
Vec3 v = arr[5];
...
//
ByteBuffer a = ByteBuffer.allocateDirect(10*Mem.sizeOf(Vec3.class))
   .order(ByteOrder.nativeOrder());
//Modify Direct Native Bytebuffer as it were a struct
Vec3 arr = Mem.wrap(a);
arr[5].x = 10;
...

性能测试