Struct Util 权威指南 - 基础应用入门实战

Struct Util 是一个 Java 语言开发的结构化数据映射处理工具。Struct Util 主要解决两个方面的问题。第一个方面将*.xls, *.csv 等配置友好型数据源转换为业务侧友好型的 bean 结构，对配置数据和使用数据进行解耦，让开发和运营、策划三方实现共赢。第二方面解决了数据表热重载，数据有条件过滤，表结构跨表引用等等应用相关的问题。

StructUtil是博主个人作品, 稍微有自吹自擂的嫌疑, 欢迎收藏。哈哈, 因为是个人作品，应该是足够”权威”了。嘻嘻~~

基础入门

框架核心由两个注解组成，业务代码也是围绕着两个注解实现的。下面我们根据注解中定义的属性学习一下 @StructSheet 和 @StructField 两个注解。

@StructSheet 注解

定义数据文件的结构.

@StructField 注解

定义列结构.

ref, refGroupBy, refUniqueKey 引用关系，groupby 将子数据集进行分组，uniqueKey 将子数据集的键值对的 key，主要是根据子数据集的字段进行数据划分和处理。

aggregateBy, aggregateType 使用父集合中的数据进行聚合处理，类型进支持数组和 List，暂时不支持聚合键值对。

converter 支持可扩展的字段类型转换器。

定义 Animal 类型

定义一个 Animal 的 Struct 结构，包含 name age weight 三个字段。结构对应的数据文件为”cfg_animal.xlsx”。

1
2
3
4
5
6
7

@StructSheet(fileName = "../cfg_animal.xlsx")
public class Animal {
    private String name;
    private int age;
    private int weight;
}

使用 StructWorker 进行数据加载。

1
2
3
4
5
6

@Test
public void test() {
    StructWorker<Animal> worker = WorkerUtil.newWorker("./data/", Animal.class);
    ArrayList<Animal> list = worker.load(ArrayList::new);
    //    ...
}

使用 @StructOptional 注解聚合异构对象

某些业务场景中我们可能需要聚合不同数据结构的类型到同一个表中。

1
2
3
4
5
6
7
8
9
10
11
12

@StructSheet(fileName = "../cfg_animal.xlsx")
public class Animal {
    private String name;
    private int age;
    private int weight;
    @StructOptional(value = {
            @StructField(ref = ExtraData1.class, refUniqueKey = "id"),
            @StructField(ref = ExtraData2.class, refUniqueKey = "id")
    })
    private Object extra;
}

根据 value 的 @StructField 顺序尝试解析引用数据，一直到找到某个值为止。例如动物的科属目信息，每个动物皆不相同，需要在总 Animal 信息集成。

本作品采用 知识共享署名-非商业性使用-相同方式共享 4.0 国际许可协议 进行许可。欢迎转载、使用、重新发布，但务必保留文章署名 TinyZ Zzh （包含链接： https://tinyzzh.github.io ），不得用于商业目的，基于本文修改后的作品务必以相同的许可发布。 如有任何疑问，请 与我联系 (tinyzzh815@gmail.com) 。

TinyZ Zzh

专注于高并发服务器、网络游戏相关(Java、PHP、Unity3D、Unreal Engine等)技术，热爱游戏事业, 正在努力实现自我价值当中。