类 EntityDataService
java.lang.Object
net.sohelp.boot.engine.db.service.EntityDataService
实体数据操作服务类,提供实体相关的数据处理功能,包括自动生成编号、数据验证、格式化、公式计算以及事件执行等。
- 从以下版本开始:
- 2025/5/4 10:45
- 作者:
- AaronFung
-
构造器概要
构造器 -
方法概要
修饰符和类型方法说明为指定实体的特定属性生成自动编号。void自动生成代码(默认提交事务)。void根据实体定义的自动编号规则,为指定实体的属性生成唯一编号,并填充到数据映射中。voidexecuteAfterEvent(String entity, Map<String, Object> dataMap) 在实体操作之后执行后置脚本事件。voidexecuteBeforeEvent(String entity, Map<String, Object> dataMap) 在实体操作之前执行预设脚本事件。void根据实体定义对多条记录进行插入前的格式化处理。voidformatByInsert(String entity, Map<String, Object> dataMap) 根据实体定义对单条记录进行插入前的格式化处理。void根据实体定义对多条记录进行查询前的格式化处理。voidformatByQuery(String entity, Map<String, Object> dataMap) 根据实体定义对单条记录进行查询前的格式化处理。void根据报表格式化数据voidformatByReport(String entity, Map<String, Object> dataMap) 根据报表格式化数据void根据实体定义对多条记录进行更新前的格式化处理。voidformatByUpdate(String entity, Map<String, Object> dataMap) 根据实体定义对单条记录进行更新前的格式化处理。void根据实体定义的公式对多条记录进行计算处理。void根据实体定义的公式对单条记录进行计算处理。getDefaultValueByEntity(String entity) 获取指定实体的所有默认值。void对传入的数据进行校验,确保其符合实体定义的约束条件。
-
构造器详细资料
-
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
对传入的数据进行校验,确保其符合实体定义的约束条件。- 参数:
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
根据实体定义对多条记录进行插入前的格式化处理。- 参数:
entity- 实体名称dataList- 数据列表- 抛出:
SQLException- SQL异常
-
formatByUpdate
根据实体定义对多条记录进行更新前的格式化处理。- 参数:
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- 业务异常
-