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()

方法概要

限定符和类型	方法和说明
void	autocode(String entityName, Map<String,Object> dataMap) 自动生成代码（默认提交事务）。
void	autocode(String entityName, Map<String,Object> dataMap, boolean commit) 根据实体定义的自动编号规则，为指定实体的属性生成唯一编号，并填充到数据映射中。
String	autocode(String entityName, String propertyName, 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	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异常

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 - 业务异常