程序包 net.sohelp.boot.engine.db.service

类 EntityDataService

java.lang.Object

net.sohelp.boot.engine.db.service.EntityDataService

@Component
public class EntityDataService
extends Object

实体数据操作服务类，提供实体相关的数据处理功能，包括自动生成编号、数据验证、格式化、公式计算以及事件执行等。

从以下版本开始:

2025/5/4 10:45

作者:

AaronFung

构造器概要

构造器

构造器	说明
EntityDataService()

方法概要

修饰符和类型	方法	说明
String	autocode(String entityName, String propertyName, Map<String,Object> dataMap, boolean commit)	为指定实体的特定属性生成自动编号。
void	autocode(String entityName, Map<String,Object> dataMap)	自动生成代码（默认提交事务）。
void	autocode(String entityName, Map<String,Object> dataMap, boolean commit)	根据实体定义的自动编号规则，为指定实体的属性生成唯一编号，并填充到数据映射中。
void	executeAfterEvent(String entity, Map<String,Object> dataMap)	在实体操作之后执行后置脚本事件。
void	executeBeforeEvent(String entity, Map<String,Object> dataMap)	在实体操作之前执行预设脚本事件。
void	formatByInsert(String entity, List<Map<String,Object>> dataList)	根据实体定义对多条记录进行插入前的格式化处理。
void	formatByInsert(String entity, Map<String,Object> dataMap)	根据实体定义对单条记录进行插入前的格式化处理。
void	formatByQuery(String entity, List<Map<String,Object>> dataList)	根据实体定义对多条记录进行查询前的格式化处理。
void	formatByQuery(String entity, Map<String,Object> dataMap)	根据实体定义对单条记录进行查询前的格式化处理。
void	formatByReport(String entity, List<Map<String,Object>> dataList)	根据报表格式化数据
void	formatByReport(String entity, Map<String,Object> dataMap)	根据报表格式化数据
void	formatByUpdate(String entity, List<Map<String,Object>> dataList)	根据实体定义对多条记录进行更新前的格式化处理。
void	formatByUpdate(String entity, Map<String,Object> dataMap)	根据实体定义对单条记录进行更新前的格式化处理。
void	formula(String entity, List<Map<String,Object>> dataList)	根据实体定义的公式对多条记录进行计算处理。
void	formula(String entity, Map<String,Object> dataMap)	根据实体定义的公式对单条记录进行计算处理。
Map<String,Object>	getDefaultValueByEntity(String entity)	获取指定实体的所有默认值。
void	validate(String entity, Map<String,Object> dataMap)	对传入的数据进行校验，确保其符合实体定义的约束条件。

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

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

构造器详细资料

EntityDataService

public EntityDataService()

方法详细资料

autocode

public void autocode(String entityName,
 Map<String,Object> dataMap,
 boolean commit)
              throws EntityException,
TokenAuthenticationException,
SQLException

根据实体定义的自动编号规则，为指定实体的属性生成唯一编号，并填充到数据映射中。

参数:

entityName - 实体名称

dataMap - 包含实体属性的数据映射

commit - 是否提交事务

抛出:

EntityException - 如果实体相关逻辑出错时抛出

TokenAuthenticationException - 如果身份认证失败时抛出

SQLException - 如果数据库访问异常时抛出

autocode

public void autocode(String entityName,
 Map<String,Object> dataMap)
              throws EntityException,
TokenAuthenticationException,
SQLException

自动生成代码（默认提交事务）。

参数:

entityName - 实体名称

dataMap - 包含数据的Map

抛出:

EntityException - 如果实体名称无效或实体类不存在时抛出

TokenAuthenticationException - 如果身份验证失败时抛出

SQLException - 如果数据库操作出错时抛出

autocode

public String autocode(String entityName,
 String propertyName,
 Map<String,Object> dataMap,
 boolean commit)
                throws SQLException,
TokenAuthenticationException

为指定实体的特定属性生成自动编号。

参数:

entityName - 实体名称

propertyName - 属性名称

dataMap - 数据映射

commit - 是否提交事务

返回:

生成的编号字符串

抛出:

SQLException - 数据库异常

TokenAuthenticationException - 认证异常

validate

public void validate(String entity,
 Map<String,Object> dataMap)
              throws BusiException

对传入的数据进行校验，确保其符合实体定义的约束条件。

参数:

entity - 实体名称

dataMap - 待校验的数据对象

抛出:

BusiException - 当业务逻辑不符合要求时抛出

formatByQuery

public void formatByQuery(String entity,
 Map<String,Object> dataMap)
                   throws BusiException,
SQLException

根据实体定义对单条记录进行查询前的格式化处理。

参数:

entity - 实体名称

dataMap - 数据映射

抛出:

BusiException - 业务异常

SQLException - SQL异常

formatByReport

public void formatByReport(String entity,
 List<Map<String,Object>> dataList)
                    throws BusiException,
SQLException

根据报表格式化数据

参数:

entity - 实体名称，用于标识要处理的数据实体

dataList - 包含待格式化数据的列表，每个元素是一个Map，表示一条记录

抛出:

BusiException - 业务异常，当处理过程中发生业务错误时抛出

SQLException - 数据库异常，当数据库操作失败时抛出

formatByReport

public void formatByReport(String entity,
 Map<String,Object> dataMap)
                    throws BusiException,
SQLException

根据报表格式化数据

参数:

entity - 实体名称，用于标识需要格式化的数据实体类型

dataMap - 数据映射表，包含需要格式化的数据键值对

抛出:

BusiException - 业务异常，当业务逻辑处理出现错误时抛出

SQLException - SQL异常，当数据库操作出现错误时抛出

formatByInsert

public void formatByInsert(String entity,
 List<Map<String,Object>> dataList)
                    throws SQLException

根据实体定义对多条记录进行插入前的格式化处理。

参数:

entity - 实体名称

dataList - 数据列表

抛出:

SQLException - SQL异常

formatByUpdate

public void formatByUpdate(String entity,
 List<Map<String,Object>> dataList)
                    throws SQLException

根据实体定义对多条记录进行更新前的格式化处理。

参数:

entity - 实体名称

dataList - 数据列表

抛出:

SQLException - SQL异常

formatByInsert

public void formatByInsert(String entity,
 Map<String,Object> dataMap)
                    throws SQLException,
EntityException,
TokenAuthenticationException

根据实体定义对单条记录进行插入前的格式化处理。

参数:

entity - 实体名称

dataMap - 数据映射

抛出:

SQLException - SQL异常

EntityException - 实体异常

TokenAuthenticationException - 认证异常

getDefaultValueByEntity

public Map<String,Object> getDefaultValueByEntity(String entity)
                                           throws EntityException,
SQLException,
TokenAuthenticationException

获取指定实体的所有默认值。

参数:

entity - 实体名称

返回:

默认值映射

抛出:

EntityException - 实体异常

SQLException - SQL异常

TokenAuthenticationException - 认证异常

formatByUpdate

public void formatByUpdate(String entity,
 Map<String,Object> dataMap)
                    throws BusiException,
SQLException

根据实体定义对单条记录进行更新前的格式化处理。

参数:

entity - 实体名称

dataMap - 数据映射

抛出:

BusiException - 业务异常

SQLException - SQL异常

formatByQuery

public void formatByQuery(String entity,
 List<Map<String,Object>> dataList)
                   throws BusiException,
SQLException

根据实体定义对多条记录进行查询前的格式化处理。

参数:

entity - 实体名称

dataList - 数据列表

抛出:

BusiException - 业务异常

SQLException - SQL异常

formula

public void formula(String entity,
 List<Map<String,Object>> dataList)
             throws ScriptException,
BusiException,
SQLException

根据实体定义的公式对多条记录进行计算处理。

参数:

entity - 实体名称

dataList - 数据列表

抛出:

ScriptException - 脚本执行异常

BusiException - 业务异常

SQLException - SQL异常

formula

public void formula(String entity,
 Map<String,Object> dataMap)
             throws BusiException,
ScriptException,
SQLException

根据实体定义的公式对单条记录进行计算处理。

参数:

entity - 实体名称

dataMap - 数据映射

抛出:

BusiException - 业务异常

ScriptException - 脚本执行异常

SQLException - SQL异常

executeBeforeEvent

public void executeBeforeEvent(String entity,
 Map<String,Object> dataMap)
                        throws ScriptException,
BusiException

在实体操作之前执行预设脚本事件。

参数:

entity - 实体名称

dataMap - 数据映射

抛出:

ScriptException - 脚本执行异常

BusiException - 业务异常

executeAfterEvent

public void executeAfterEvent(String entity,
 Map<String,Object> dataMap)
                       throws ScriptException,
BusiException

在实体操作之后执行后置脚本事件。

参数:

entity - 实体名称

dataMap - 数据映射

抛出:

ScriptException - 脚本执行异常

BusiException - 业务异常