后端使用说明
pom 增加依赖
在 后端服务中需要添加以下依赖,该依赖放置在 <dependencies>
标签中且在第一位;
<dependency>
<groupId>org.hzero.boot</groupId>
<artifactId>hzero-boot-customize</artifactId>
<!-- <version>0.1.1.RELEASE</version> 组件版本应该在srm-parent中维护 -->
</dependency>
hzero-boot-customize
主要包含了个性化模型扫描REST端点以及个性化后端SQL拦截器,使用个性化插件的服务都需要依赖该boot组件- 在
srm-parent
中维护组件的版本号
在 srm-basic-platform
服务中添加以下依赖
<dependency>
<groupId>org.hzero.plugin</groupId>
<artifactId>platform-cusz-saas</artifactId>
<version>0.1.1.RELEASE</version>
</dependency>
platform-cusz-saas
依赖主要包含了个性化管理的后端维护代码,以插件形式打包,依托于srm-basic-platform
服务运行
Entity 类注意事项
- 字段相关
表中存在的字段必须声明在 Entity 类中,表中以 attribute
开头的字段无需声明,该类字段会从 AuditDomain.flex
属性中获取;
- 多语言相关
Entity 类上需要添加 @MultiLanguage
注解,多语言字段添加 @MultiLanguageField
注解;
不建议以
attribute
开头的字段作为多语言字段;
DTO 类需继承 AuditDomain
,且需重写 associateEntityClass()
方法,并返回对应 Entity 类的class;
查询逻辑注意事项
请确保在个性化配置中增加的个性化字段在后端查询的原始 SQL
中提前配置好相关表, 否则配置的个性化字段无法生效。
主模型关联的模型在
模型配置
中维护;
LOV 值集翻译
若模型字段的组件类型为值集
或下拉框
,且对应的值集时 URL值集
,需要在值集中配置 翻译SQL
;
例如,保存字段类型为值集的数据时,存入表中的为 code,但展示时需为 name;