程序包 cn.isliu.core.utils

类 FsTableUtil

java.lang.Object

cn.isliu.core.utils.FsTableUtil

public class FsTableUtil
extends Object

飞书表格工具类 提供处理飞书表格数据和格式的工具方法， 包括数据处理、样式设置、选项设置等功能

嵌套类概要

嵌套类

修饰符和类型	类	说明
static class	FsTableUtil.HeaderCell	表头单元格类，用于支持合并单元格

构造器概要

构造器

构造器	说明
FsTableUtil()

方法概要

修饰符和类型	方法	说明
static String	addLineBreaks(String text, int charsPerLine)	按指定字符数给文本添加换行符
static String	addLineBreaksPer8Chars(String text)	每8个字符添加一个换行符（默认方法）
static List<List<FsTableUtil.HeaderCell>>	buildHierarchicalHeaders(Map<String,FieldProperty> fieldsMap)	构建多层级表头结构，支持按层级排序和合并 根据需求实现层级分组和order排序： 1.
static String	getColumnName(int columnIndex)
static String	getColumnNameByNuNumber(int columnNumber)
static String	getDefaultTableStyle(String sheetId, int size, Map<String,FieldProperty> fieldsMap, TableConf tableConf)
static CustomCellService.StyleCellsBatchBuilder	getDefaultTableStyle(String sheetId, Map<String,FieldProperty> fieldsMap, TableConf tableConf)
static List<FsTableData>	getFsTableData(Sheet sheet, String spreadsheetToken, TableConf tableConf)	获取飞书表格数据 从指定的工作表中读取并处理表格数据
static List<FsTableData>	getFsTableData(Sheet sheet, String spreadsheetToken, TableConf tableConf, List<String> ignoreUniqueFields)	获取飞书表格数据（支持忽略唯一字段）
static CustomValueService.ValueRequest	getHeadTemplateBuilder(String sheetId, List<String> headers, Map<String,FieldProperty> fieldsMap, TableConf tableConf)
static CustomValueService.ValueRequest	getHeadTemplateBuilder(String sheetId, List<String> headers, Map<String,FieldProperty> fieldsMap, List<String> includeFields, TableConf tableConf)
static CustomValueService.ValueRequest	getHeadTemplateBuilder(String sheetId, List<String> headers, Map<String,FieldProperty> fieldsMap, List<String> includeFields, TableConf tableConf, Map<String,String> fieldDescriptions)
static List<CustomCellService.CellRequest>	getMergeCell(String sheetId, Map<String,FieldProperty> fieldsMap)
static TableConf	getTableConf(Class<?> zClass)
static Map<String,String>	getTitlePostionMap(Sheet sheet, String spreadsheetToken, TableConf tableConf)
static Map<Integer,List<String>>	groupFieldsByLevel(Map<String,FieldProperty> fieldsMap)	根据层级分组字段属性，并按order排序
static TableData	processSheetData(Sheet metadata, List<List<Object>> values)	处理表格数据，将合并单元格转换为对象，并补齐合并区域的值
static void	setTableOptions(String spreadsheetToken, List<String> headers, Map<String,FieldProperty> fieldsMap, String sheetId, boolean enableDesc)
static void	setTableOptions(String spreadsheetToken, List<String> headers, Map<String,FieldProperty> fieldsMap, String sheetId, boolean enableDesc, Map<String,Object> customProperties)

从类继承的方法 java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

构造器详细资料

FsTableUtil

public FsTableUtil()

方法详细资料

getFsTableData

public static List<FsTableData> getFsTableData(Sheet sheet,
 String spreadsheetToken,
 TableConf tableConf)

获取飞书表格数据 从指定的工作表中读取并处理表格数据

参数:

sheet - 工作表对象

spreadsheetToken - 电子表格Token

返回:

飞书表格数据列表

getFsTableData

public static List<FsTableData> getFsTableData(Sheet sheet,
 String spreadsheetToken,
 TableConf tableConf,
 List<String> ignoreUniqueFields)

获取飞书表格数据（支持忽略唯一字段）

参数:

sheet - 工作表对象

spreadsheetToken - 电子表格Token

tableConf - 表格配置

ignoreUniqueFields - 计算唯一标识时忽略的字段列表

返回:

飞书表格数据列表

processSheetData

public static TableData processSheetData(Sheet metadata,
 List<List<Object>> values)

处理表格数据，将合并单元格转换为对象，并补齐合并区域的值

getColumnName

public static String getColumnName(int columnIndex)

getColumnNameByNuNumber

public static String getColumnNameByNuNumber(int columnNumber)

getTitlePostionMap

public static Map<String,String> getTitlePostionMap(Sheet sheet,
 String spreadsheetToken,
 TableConf tableConf)

setTableOptions

public static void setTableOptions(String spreadsheetToken,
 List<String> headers,
 Map<String,FieldProperty> fieldsMap,
 String sheetId,
 boolean enableDesc,
 Map<String,Object> customProperties)

setTableOptions

public static void setTableOptions(String spreadsheetToken,
 List<String> headers,
 Map<String,FieldProperty> fieldsMap,
 String sheetId,
 boolean enableDesc)

getHeadTemplateBuilder

public static CustomValueService.ValueRequest getHeadTemplateBuilder(String sheetId,
 List<String> headers,
 Map<String,FieldProperty> fieldsMap,
 TableConf tableConf)

getHeadTemplateBuilder

public static CustomValueService.ValueRequest getHeadTemplateBuilder(String sheetId,
 List<String> headers,
 Map<String,FieldProperty> fieldsMap,
 List<String> includeFields,
 TableConf tableConf)

getHeadTemplateBuilder

public static CustomValueService.ValueRequest getHeadTemplateBuilder(String sheetId,
 List<String> headers,
 Map<String,FieldProperty> fieldsMap,
 List<String> includeFields,
 TableConf tableConf,
 Map<String,String> fieldDescriptions)

getDefaultTableStyle

public static String getDefaultTableStyle(String sheetId,
 int size,
 Map<String,FieldProperty> fieldsMap,
 TableConf tableConf)

getDefaultTableStyle

public static CustomCellService.StyleCellsBatchBuilder getDefaultTableStyle(String sheetId,
 Map<String,FieldProperty> fieldsMap,
 TableConf tableConf)

groupFieldsByLevel

public static Map<Integer,List<String>> groupFieldsByLevel(Map<String,FieldProperty> fieldsMap)

根据层级分组字段属性，并按order排序

参数:

fieldsMap - 字段属性映射

返回:

按层级分组的映射，key为层级，value为该层级的字段名数组（已按order排序）

buildHierarchicalHeaders

public static List<List<FsTableUtil.HeaderCell>> buildHierarchicalHeaders(Map<String,FieldProperty> fieldsMap)

构建多层级表头结构，支持按层级排序和合并 根据需求实现层级分组和order排序： 1. 按全局order排序，但确保同一分组的字段相邻 2. 同一分组内的字段能够正确合并

参数:

fieldsMap - 字段属性映射

返回:

多层级表头结构，外层为行，内层为列

getMergeCell

public static List<CustomCellService.CellRequest> getMergeCell(String sheetId,
 Map<String,FieldProperty> fieldsMap)

getTableConf

public static TableConf getTableConf(Class<?> zClass)

addLineBreaks

public static String addLineBreaks(String text,
 int charsPerLine)

按指定字符数给文本添加换行符

参数:

text - 需要处理的文本

charsPerLine - 每行字符数

返回:

添加换行符后的文本

addLineBreaksPer8Chars

public static String addLineBreaksPer8Chars(String text)

每8个字符添加一个换行符（默认方法）

参数:

text - 需要处理的文本

返回:

添加换行符后的文本