Public/feishu-table-helper
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
31 Commits 1 Branch 0 Tags 611 KiB
main
Commit Graph

31 Commits

This Branch
This Branch
All Branches
Author SHA1 Message Date
liushuang
f191e57c9a feat(core): 添加Map方式操作飞书表格的功能- 新增MapSheetConfig和MapTableConfig配置类，支持通过Map方式定义表格结构 
- 添加MapFieldDefinition字段定义类，提供丰富的字段类型和配置选项
- 实现MapSheetBuilder构建器，支持链式调用创建飞书表格- 实现MapReadBuilder构建器，支持从飞书表格读取数据并转换为Map格式- 添加MapOptionsUtil工具类，提供枚举选项提取和动态选项处理功能
- 在FsHelper中新增createMapSheet、createMapSheetBuilder、readMap和readMapBuilder方法-优化包导入结构，使用通配符简化builder包的导入
- 添加详细的JavaDoc文档和使用示例，提升API易用性- 支持动态字段、分组表格、唯一键计算等高级功能
- 实现数据过滤机制，自动过滤空行数据
 2025-10-16 20:43:36 +08:00
liushuang
f9cff00b2f feat(core): 新增Map数据写入飞书表格功能- 新增MapWriteBuilder类，支持链式调用写入Map格式数据 
- 新增MapTableConfig配置类，用于替代注解配置
- 新增MapDataUtil工具类，提供唯一ID计算和字段映射功能- 在FsHelper中新增writeMap和writeMapBuilder方法
- 在WriteBuilder中增加空字段位置检查逻辑
- 完善字段位置映射处理，避免空指针异常
 2025-10-16 16:06:38 +08:00
liushuang
9500a1df12 feat(feishu): 添加关闭官方Client连接池功能 
- 在FeishuClient中新增closeOfficialPool配置项，用于控制是否关闭官方SDK的连接池- 新增Builder模式下的closeOfficialPool方法，支持链式调用设置该选项
- 修改FsApiUtil工具类，在调用飞书API时根据配置决定是否添加Connection: close头部
- 更新FsClient初始化逻辑，支持传入closeOfficialPool参数并传递给FeishuClient
- 调整部分日志级别，将info级别改为debug以减少生产环境日志量
-优化代码格式，移除不必要的空行和注释中的多余换行符号
 2025-10-15 14:21:12 +08:00
liushuang
e1b1d5cd01 docs(readme): 更新依赖版本至0.0.5 
- 将Maven依赖版本从0.0.4更新到0.0.5
- 将Gradle依赖版本从0.0.4更新到0.0.5
 2025-10-14 15:55:25 +08:00
liushuang
59fe126864 docs(readme): 更新表格配置说明- 修改表格配置示例中的headLine和titleRow参数- 添加uniKeys配置项说明 
- 更新表格样式配置文档内容
 2025-10-14 15:22:37 +08:00
liushuang
59d5d937cc feat(feishu): 增强飞书表格客户端功能和数据处理能力- 添加自定义服务支持，包括表格、行列、单元格、数据值等扩展服务 
-优化客户端管理器，实现线程安全和客户端实例缓存
- 改进表格数据读取逻辑，支持字段映射和唯一标识生成
- 增强表格工具类功能，添加分组数据处理和表头模板构建
- 完善表格构建器，支持字段描述和下拉选项设置
-优化HTTP客户端配置，增加调用超时时间
- 修复数据处理中的空值判断逻辑- 添加表格样式设置和单元格合并功能
 2025-10-14 15:07:39 +08:00
liushuang
3c31130cbe feat(table): 新增表格选项配置方法- 新增 setTableOptions重载方法，支持自定义属性和包含字段列表 
-优化字段映射过滤逻辑，支持按包含字段列表过滤- 移除冗余的表头处理方法和注释代码
- 调整方法参数顺序，提升代码可读性- 完善表格配置逻辑，支持启用描述信息- 重构字段属性处理流程，提高代码复用性
 2025-09-29 11:49:50 +08:00
liushuang
b4a6fdc278 feat(core):优化数值转换逻辑以支持科学计数法 
- 移除不必要的 Nullable 注解导入- 新增 isScientificNotation 方法用于检测科学计数法格式
- 修改 Double 类型数值转换逻辑，区分科学计数法与普通数值- 对于无法转换的科学计数法数值，记录警告日志并返回原始值
- 添加详细的 JavaDoc 注释说明科学计数法判断规则
 2025-09-29 10:42:44 +08:00
liushuang
c8e2e2dc5e feat(core):优化表格构建逻辑以支持字段过滤与描述映射 
- 在 `FsTableUtil` 中移除冗余的 `getHeadTemplateBuilder` 重载方法，统一构建入口
- 新增 `getIncludeFieldHeaders` 方法，增强字段包含逻辑，支持驼峰与下划线格式匹配
-修复表头排序问题，确保启用描述时正确应用字段顺序
- 在 `PropertyUtil` 中新增 `getHeaders`重载方法，支持传入字段过滤列表
-`优化 `SheetBuilder 构建流程，使其能正确传递 `includeFields` 并应用字段描述映射
- 移除不必要的包导入与空行，提升代码可读性- 增加 `@NotNull` 注解以强化静态检查能力
 2025-09-28 16:03:45 +08:00
liushuang
6d9908bfbb ``` 
docs(readme): 更新飞书表格助手依赖版本至0.0.4

更新 README.md 文件中的 Maven 和 Gradle依赖版本号，
将 feishu-table-helper 的版本从 0.0.3 升级到 0.0.4。
```
 2025-09-27 23:32:58 +08:00
liushuang
891b019ae3 ``` 
feat(core): 增强飞书表格功能与工具类支持

-为 ConvertFieldUtil、FileUtil、FsApiUtil 和 FsTableUtil 类添加更详细的 JavaDoc 注释，提升代码可读性- 在 FileUtil 中优化图片文件判断逻辑并增强 getFileName 方法以支持 URL 场景
- 扩展 FsApiUtil 支持更多飞书 API 参数格式化及异常处理
- 在 FsHelper 中引入 ReadBuilder 和 WriteBuilder 构建器模式，提供链式调用方式操作飞书表格读写
- FsTableUtil 新增对忽略唯一字段的支持，并扩展表头模板构建能力，支持字段描述自定义- GenerateUtil优化数字转换精度控制，并修复部分日志提示文案
- OptionsValueProcess 接口增加泛型参数支持，提高灵活性和类型安全性```
 2025-09-26 19:15:06 +08:00
liushuang
3e25a91aed feat(core): 新增飞书文件服务和表格构建器功能 
- 新增 CustomFileService 类，用于获取根目录元数据等文件操作
- 新增 RootFolderMetaResponse 类，用于解析根目录元数据响应
- 新增 SheetBuilder 类，提供链式调用方式创建飞书表格
- 在 FeishuClient 中添加 customFiles 方法，返回 CustomFileService 实例
- 在 FsApiUtil 中添加创建文件夹和表格的方法
- 在 FsHelper 中添加创建表格构建器方法
 2025-08-28 18:47:54 +08:00
liushuang
a34df121bc fix(core.converters): 优化 FileUrlProcess 中的 URL 处理逻辑 
- 在添加 URL 到 fileUrls 列表之前增加非空和非空字符串的检查- 避免将空或空字符串添加到列表中，提高数据处理的准确性
 2025-08-28 11:17:41 +08:00
liushuang
1ea23d96fa docs(README): 更新快速开始指南 
- 在初始化配置部分添加 TODO 提示，引导用户进行读写数据操作
- 更新员工表截图，确保文档中的示例与实际功能保持一致
 2025-08-26 23:15:00 +08:00
liushuang
3bd232059f Merge remote-tracking branch 'origin/main' 2025-08-26 23:09:54 +08:00
liushuang
7fa5300273 style(core): 调整表格头默认样式 
- 修改表格头默认字体颜色为黑色 (#000000)
- 修改表格头默认背景颜色为灰色 (#cccccc)
- 更新相关服务类、工具类和注解的默认值
 2025-08-26 23:09:25 +08:00
liushuang
f53e9e6aff style(core): 调整表格头默认样式 
- 修改表格头默认字体颜色为黑色 (#000000)
- 修改表格头默认背景颜色为灰色 (#cccccc)
- 更新相关服务类、工具类和注解的默认值
 2025-08-26 19:05:29 +08:00
liushuang
8a49e5280b refactor(core): 重构飞书客户端并优化单元格操作 
- 重构 FeishuClient 类，优化自定义服务管理
- 新增 ServiceManager 类，统一管理自定义服务
- 优化 CustomCellService 中的单元格操作逻辑- 移除不必要的请求类型和参数处理
- 新增合并单元格功能
- 调整表格样式设置接口
- 优化 FsClient 类，使用 ThreadLocal管理客户端实例
 2025-08-26 18:24:52 +08:00
liushuang
5a43a7f2e3 feat(core): 重构配置管理并优化表格处理逻辑 
- 移除 FsConfig 类，使用 TableConf 注解替代
- 重构 FsHelper 类，使用新配置方式- 优化 FsTableUtil 类，支持多级表头和描述行
- 更新 CustomValueService 类，添加 majorDimension 支持
- 修改 BaseEntity 类，增加 row 和 rowData 字段
 2025-08-20 23:35:31 +08:00
liushuang
aa14a659ee refactor(core): 重构飞书 API 客户端 
-将 FeishuApiClient 重命名为 AbstractFeishuApiService，作为抽象服务类
- 更新相关服务类的继承关系，改为继承 AbstractFeishuApiService
-调整包结构，将客户端相关代码移至 service 包- 修改 FeishuClient 中的 getHttpClient 方法为 public
 2025-08-18 23:26:36 +08:00
liushuang
b3f4463bcf feat(core): 添加文件上传功能- 新增 FileData 类用于存储文件相关数据 
- 新增 FileType 枚举用于区分文件类型- 修改 FsHelper 类，支持文件上传
- 更新 FileUrlProcess 类，处理文件 URL
-调整 FsApiUtil 类，使用新逻辑上传文件
- 修改 GenerateUtil 类，处理文件数据
 2025-08-16 14:07:45 +08:00
liushuang
af7c1a3a51 build: 更新 feishu-table-helper 版本至 0.0.2 
- 在 Maven 依赖中将 feishu-table-helper 版本从 0.0.1 升级到 0.0.2
- 在 Gradle依赖中将 feishu-table-helper 版本从 0.0.1 升级到 0.0.2
 2025-08-16 12:17:08 +08:00
liushuang
c5e1dfcec7 refactor(README): 更新代码示例 
- 修改初始化配置的代码示例，使用 FsClient.getInstance().initializeClient() 方法替代 FsConfig.initConfig()
- 更新创建表格的代码示例，明确返回值为 String 类型的 sheetId
 2025-08-16 12:12:18 +08:00
liushuang
dfd230ca04 refactor(logging): 重构日志记录方式 
- 使用自定义 FsLogger 替代 java.util.logging.Logger
- 统一日志记录格式，支持错误码和异常信息
- 移除冗余的 FsClientUtil 类
- 重构 FsConfig 类，使用单例模式
- 更新相关类的日志记录方式
 2025-08-16 10:27:00 +08:00
liushuang
5b9695b7e8 refactor(FsHelper): 修改 create 方法返回类型 
- 将 create 方法的返回类型从 Boolean 改为 String
- 方法成功执行后返回工作表 ID，而不是布尔值
- 这个改动可以让调用者获取到新创建的工作表 ID，提供更多灵活性
 2025-08-14 18:43:47 +08:00
liushuang
62baa68cba docs(README): 更新注解和配置类的链接 
- 修改了 README.md 文件中的两个文件链接- 将绝对路径替换为相对路径，以提高文档的可移植性和稳定性
 2025-08-14 15:58:54 +08:00
liushuang
2f25916622 docs(README): 更新项目文档- 添加项目简介、功能特性、安装方法、快速开始指南 
- 详细说明核心注解和配置选项的使用
- 补充依赖信息和许可证说明
 2025-08-14 15:48:45 +08:00
liushuang
02a3ef0132 build(pom): 更新 Maven 插件和配置 
- 将 Git 连接方式从 ssh 改为 https
- 更新 maven-source-plugin 到 3.2.1 版本
- 更新 maven-javadoc-plugin 到 3.2.0 版本- 更新 maven-gpg-plugin到 1.6 版本
- 添加 central-publishing-maven-plugin 0.5.0版本
- 添加 maven-release-plugin 2.5.3版本
- 调整插件配置以适应新版本和项目需求
 2025-08-14 15:10:44 +08:00
liushuang
52620ab108 docs: 更新代码文档并添加项目元数据 
- 为所有主要类和方法添加了详细的 JavaDoc 注释
- 更新了 pom.xml 文件，添加了项目元数据信息
- 优化了代码结构，提高了代码可读性和可维护性
 2025-08-14 11:48:10 +08:00
liushuang
7bac7917a0 feat(core): 新增核心功能模块 2025-08-13 16:50:38 +08:00
luckday
f89ce6f884 Initial commit 2025-08-13 16:41:38 +08:00