mirror of
https://github.com/tiennm99/zfoo.git
synced 2026-05-19 09:27:07 +00:00
jaysunxiao
57 lines
1.5 KiB
Markdown
57 lines
1.5 KiB
Markdown
### Ⅰ. 简介
|
||
|
||
- [storage](https://github.com/zfoo-project/zfoo/blob/main/storage/README.md)
|
||
Excel和Java类自动映射框架，只需要定义一个和Excel对应的类，直接解析Excel
|
||
|
||
- 利用Java动态语言的反射特性，用最少的代码去解析Excel
|
||
|
||
### Ⅱ. 自动映射
|
||
|
||
- Excel的第一行对应Java类属性，第二行和第三行不会起到注释的作用，其中第一列必须是Id属性
|
||
|
||
|
||
|
||
- Excel对应的Java类
|
||
|
||
|
||
|
||
- 解析过后有两种使用方式
|
||
1. 通过注解
|
||
```
|
||
@Component
|
||
public class StudentManager {
|
||
|
||
@ResInjection
|
||
private Storage<Integer, StudentResource> studentResources;
|
||
|
||
}
|
||
```
|
||
2. 通过类动态获取
|
||
```
|
||
Storage<Integer, StudentResource> studentResources = (Storage<Integer, StudentResource>) StorageContext.getStorageManager().getStorage(StudentResource.class);
|
||
```
|
||
|
||
- 通过id找到对应的行
|
||
|
||
```
|
||
var studentResource = studentResources.get(1000);
|
||
```
|
||
|
||
- 通过索引找对应的行，默认为可重复的索引，返回了一个列表list
|
||
|
||
```
|
||
var students = studentResources.getIndex("name", "james0");
|
||
```
|
||
|
||
- 唯一索引通过Storage.getUniqueIndex()获取，需要把索引注解标注为@Index(unique = true)
|
||
|
||
### Ⅲ. 热更新Excel
|
||
|
||
- [tank](https://github.com/zfoo-project/tank-game-server/blob/main/common/src/main/java/com/zfoo/tank/common/util/HotUtils.java)
|
||
分布式热更新Excel配置文件实现
|
||
|
||
### Ⅳ. 用途
|
||
|
||
- 财务分析，数据分析统计
|
||
- 游戏中的数值配置
|