文档章节

JeeSite 4.x 树形结构的表设计和用法

ThinkGem
 ThinkGem
发布于 11/19 23:04
字数 1935
阅读 584
收藏 8

有些同仁对于 JeeSite 4 中的树表设计不太了解,本应简单的方法就可实现,却写了很多复杂的语句和代码,所以有了这篇文章。

在 JeeSite 4 中的树表设计我还是相对满意的,这种设计比较容易理解,不会太依赖数据库的语法,对兼容多数据库比较好。相比网上大牛的左右值树设计简单了很多,并且可随时调换父节点,并级联更新所有子节点数据。

看下表字段说明我们发现除了父级节点外又多了很多辅助字段,这写字段的维护可能会稍微影响我们的插入和更新性能, 但是这将极大的简化了我们的查询,并不限深度。废话不多说,下面我们一同来就来看看都有哪些好处。

树表字段说明

字段名说明
xxx_code节点编码(xxx表示用户自定义名称)
xxx_name节点名称(xxx表示用户自定义名称)
以下是树表关键字段:
parent_code节点上级编码
parent_codes节点所有上级编码(快速检索下级节点)
tree_sort当前层级排序号(decimal类型)
tree_sorts树节点的完整排序号,10位数字组成(快速整树排序)
tree_leaf是否是末级,是否叶子节点(0:否,1:是,char类型)
tree_level节点层次级别(从0开始,decimal类型,快速分级查询,根据层级缩进)
tree_names节点的全名称(用“/”分隔,快速获取当前节点完整路径)
以下是树表可选字段:
status节点状态(0:正常,1:删除,2:停用)
create_by创建者用户编码
create_date数据创建时间
update_by更新者用户编码
update_date数据更新时间

下面以区域树表举例

定义实体Entity

用户自定义的节点编码是area_code,节点名称是area_name,实体注解配置如下:

@Table(name="${_prefix}sys_area", alias="a", columns={
		@Column(includeEntity=DataEntity.class),
		@Column(includeEntity=TreeEntity.class),
		@Column(name="area_code", attrName="areaCode", label="区域代码", isPK=true),
		@Column(name="area_name", attrName="areaName", label="区域名称", queryType=QueryType.LIKE, isTreeName=true),
		@Column(name="area_type", attrName="areaType", label="区域类型"),
	}, orderBy="a.tree_sorts, a.area_code"
)
public class Area extends TreeEntity<Area> {
	private String areaCode;		// 区域代码
	private String areaName;		// 区域名称
	private String areaType; 		// 区域类型(1:国家;2:省份、直辖市;3:地市;4:区县)
	// get set 省略
}
  1. Column 注解中的 includeEntity=TreeEntity.class 则自动导入树表关键字段配置(parent_code...)
  2. Column 注解中的 includeEntity=DataEntity.class 则自动导入树表可选字段配置(create_by...)
  3. 继承 TreeEntity 类就会自动拥有树表关键字段和可选字段的属性(parent_code...、create_by...)
  4. 节点编码 Column 必须设置 isPk=true 来确定是一个唯一主键
  5. 节点名称 Column 必须设置 isTreeName=true 来确定是一个节点名称,用来生成 tree_names 的值

定义业务层Service

下面我们介绍怎么来通过API操作这张表

@Service
@Transactional(readOnly=true)
public class AreaService extends TreeService<AreaDao, Area> {

}

该类继承了 TreeService,类的内容可以什么都不用写,就拥有了树表的增删改查等方法,以及树表维护的关键字段和可选字段的生成与更新。

下面我们就来展示下 TreeService 的方法:

@Transactional(readOnly=true)
public abstract class TreeService<D extends TreeDao<T>, T extends TreeEntity<T>> {

	/**
	 * 获取单条数据
	 * @param entity id
	 */
	@Override
	public T get(T entity) 
	
	/**
	 * 根据父节点获取子节点最后一条记录
	 * @param entity parentCode
	 */
	public T getLastByParentCode(T entity)
	
	/**
	 * 列表查询数据
	 * @param entity
	 */
	@Override
	public List<T> findList(T entity)
    
	/**
	 * 查询列表总数
	 * @param entity
	 */
	@Override
	public long findCount(T entity)
	
	/**
	 * 保存数据(插入或更新)
	 * 实现自动保存字段:所有父级编号、所有排序号、是否是叶子节点、节点的层次级别等数据
	 * 实现级联更新所有子节点数据:同父级自动保存字段
	 */
	@Override
	@Transactional(readOnly=false)
	public void save(T entity)
	
	/**
	 * 更新当前节点排序号
	 */
	@Transactional(readOnly=false)
	public void updateTreeSort(T entity)
	
	/**
	 * 预留接口事件,更新子节点
	 * @param childEntity 当前操作节点的子节点
	 * @param parentEntity 当前操作节点
	 */
	protected void updateChildNode(T childEntity, T parentEntity)
	
	/**
	 * 更新状态(级联更新父节点的tree_leaf字段)
	 * @param entity
	 */
	@Override
	@Transactional(readOnly=false)
	public void updateStatus(T entity) 
	
	/**
	 * 删除数据(级联删除子节点和父节点的tree_leaf字段)
	 * @param entity
	 */
	@Override
	@Transactional(readOnly=false)
	public void delete(T entity) 
	
	/**
	 * 修正本表树结构的所有父级编号
	 * 包含:数据修复(parentCodes、treeLeaf、treeLevel)字段
	 */
	@Transactional(readOnly=false) // 可读取未提交数据
	public void fixTreeData()
	
	/**
	 * 按父级编码修正树结构的所有父级编号
	 * 包含:数据修复(parentCodes、treeLeaf、treeLevel、treeSorts、treeNames)字段
	 */
	@Transactional(readOnly=false) // 可读取未提交数据
	public void fixTreeData(String parentCode)
	
	/**
	 * 修正指定节点及下级节点的所有父级编号(这是个递归程序)
	 */
	private void fixTreeData(List<T> list, String parentCode, String parentCodes, String treeSorts, String treeNames)
	
	/**
	 * 将不同级别无序的树列表进行排序,前提是sourcelist每一级是有序的<br>
	 * 举例如下:<br>
	 * 	List<T> targetList = ListUtils.newArrayList();<br>
	 * 	List<T> sourceList = service.findList(entity);<br>
	 * 	service.listTreeSort(targetList, sourceList, T.ROOT_CODE);<br>
	 * @param sourceList 源数据列表
	 * @param targetList 目标数据列表
	 * @param parentCode 目标数据列表的顶级节点
	 */
	public void listTreeSort(List<T> sourceList, List<T> targetList, String parentCode)

	/**
	 * 将简单列表code,parentCode转换为嵌套列表形式[code,childList[code,childList[...]]]<br>
	 * 举例如下:<br>
	 * 	List<T> targetList = ListUtils.newArrayList();<br>
	 * 	List<T> sourceList = service.findList(entity);<br>
	 * 	service.convertChildList(targetList, sourceList, T.ROOT_CODE);<br>
	 * @param sourceList 源数据列表
	 * @param targetList 目标数据列表
	 * @param parentCode 目标数据列表的顶级节点
	 */
	public void convertChildList(List<T> sourceList, List<T> targetList, String parentCode)
	
}

常用示例调用

保存一条数据:

Area area = new Area();
area.setIsNewRecord(true);    // 代表新增还是更新
area.setParentCode('370000'); // 上级编码
area.setAreaCode('371000');   // 节点编码(唯一)
area.setAreaName('济南市');   // 节点名称
area.setTreeSort(1000);       // 本级排序号
areaService.save(area);

除了一些用户输入字段,其余辅助字段有save方法自动维护,调用者无需关心。

获取当前节点最大编号:

Area where = new Area();
where.setParentCode("370000");
Area last = areaService.getLastByParentCode(where);
System.out.println(last.getAreaCode());

查找下级子节点:

SQL:

select a.* from sys_area a where a.area_code='370000'

API:

Area where = new Area();
where.setParentCode("370000");
List<area> list = areaService.findList(where);
System.out.println(list);

查找所有子节点:

SQL:

select a.* from sys_area a where (a.area_code='370000' or a.parent_codes like '0,370000,%')

API:

Area where = new Area();
where.getSqlMap().getWhere().andBracket("area_code", QueryType.EQ, "370000", 1)
        .or("parent_codes", QueryType.LEFT_LIKE, "0,370000,%", 2).endBracket();
List<area> list = areaService.findList(where);
System.out.println(list);

只查找一级和二级节点:

SQL:

select a.* from sys_area a where a.tree_level <= 1

API:

Area where = new Area();
where.getSqlMap().getWhere().and("tree_level", QueryType.LTE, 1);
List<area> list = areaService.findList(where);
System.out.println(list);

排除叶子节点:

SQL:

select a.* from sys_area a where a.tree_leaf = '0'

API:

Area where = new Area();
where.setTreeLeaf("0");
List<area> list = areaService.findList(where);
System.out.println(list);

当前层级排序:

SQL:

select a.* from sys_area a where a.parent_code = '0' order tree_sort asc

API:

Area where = new Area();
where.setParentCode("0");
where.getSqlMap().getOrder().setOrderBy("a.tree_sort asc");
List<area> list = areaService.findList(where);
System.out.println(list);

全部层级排序:

SQL:

select a.* from sys_area a where (a.area_code='370000' or a.parent_codes like '0,370000,%') order tree_sorts asc

API:

Area where = new Area();
where.getSqlMap().getWhere().andBracket("area_code", QueryType.EQ, "370000", 1)
        .or("parent_codes", QueryType.LEFT_LIKE, "0,370000,%", 2).endBracket();
where.getSqlMap().getOrder().setOrderBy("a.tree_sorts asc");
List<area> list = areaService.findList(where);
System.out.println(list);

显示当前节点的全名称:

SQL:

select a.tree_names from sys_area a where a.area_code='370000'

API:

Area where = new Area();
where.setAreaCode("370000");
Area area = areaService.get(where);
System.out.println(area.getTreeNames());

综合实例:

查询编号为370000,及所有下级的数据,并只查询2级数据,并按照升序排序

SQL:

select a.* from sys_area a where (a.area_code='370000' or a.parent_codes like '0,370000,%') and a.tree_level <= 1 order by a.tree_sorts

API:

Area where = new Area();
where.getSqlMap().getWhere().andBracket("area_code", QueryType.EQ, "370000", 1)
        .or("parent_codes", QueryType.LEFT_LIKE, "0,370000,%", 2).endBracket();
where.getSqlMap().getWhere().and("tree_level", QueryType.LTE, 1);
where.getSqlMap().getOrder().setOrderBy("a.tree_sorts asc");
List<area> list = areaService.findList(where);
System.out.println(list);

© 著作权归作者所有

共有 人打赏支持
ThinkGem

ThinkGem

粉丝 1063
博文 138
码字总数 24109
作品 2
济南
架构师
私信 提问
ThinkGem/JeeSite4 Spring Cloud

引言 JeeSite Spring Cloud 是基于 Spring Cloud Finchley 的一个分布式系统套件的整合。 特点:用经典开发模式,开发分布式应用,两个字【简单】,一个字【快】。 技术选型 分布式系统主框架...

ThinkGem
12/07
0
0
分布式系统套件的整合 - JeeSite Spring Cloud

引言 JeeSite Spring Cloud 是基于 Spring Cloud Finchley 的一个分布式系统套件的整合。 特点:用经典开发模式,开发分布式应用,两个字【简单】,一个字【快】。 技术选型 分布式系统主框架...

ThinkGem
11/19
0
0
JeeSite环境搭建及运行和打包(master20161117)

涉及的软件: 1、phpStudy(主要用MySql) 2、maven3(用于依赖包,下面我将上传已经下载好所有依赖包的版本,保证运行正常) 具体操作: 0、前言 由于GitHub上的Release版本没有及时更新,所...

easonjim
2016/11/18
0
0
jeesite 快速开发平台 初体验

http://www.jeesite.com/ GitHub:https://github.com/thinkgem/jeesite 开源中国:http://git.oschina.net/thinkgem/jeesite 更多文档 https://github.com/thinkgem/jeesite/tree/master/do......

晨猫
05/21
0
0
JeeSite 4.0.0 开发平台社区测试版公布,欢迎大家测试反馈意见

JeeSite 是一个 Java EE 企业级快速开发平台,基于经典技术组合(Spring Boot、Spring MVC、Apache Shiro、MyBatis、Beetl、Bootstrap、AdminLTE),在线代码生成功能,包括核心模块如:组织...

ThinkGem
02/25
11.4K
32

没有更多内容

加载失败,请刷新页面

加载更多

dubbo 搭建与使用

官网:http://dubbo.apache.org/en-us/ 一,安装监控中心(可以不安装) admin管理控制台,monitor监控中心 下载 bubbo ops 这个是新版的,需要node.js环境,我没有就用老版的了...

小兵胖胖
12分钟前
0
0
mac 下 mysql 8.0.13 安装并记录遇到的问题 以便以后查看

安装 官网mysql 下载地址 安装过程 省去 安装好之后 下载navicat 错误1 链接 遇到 mysql 2003 - Can't connect to MySQL server 错误, 解决方案 重启mysql 服务 #错误2 ERROR 1045: Acces...

杭州-IT攻城狮
昨天
5
0

中国龙-扬科
昨天
1
0
[Spring4.x]基于spring4.x纯注解的Web工程搭建

在前文中已经说明了如何基于 Spring4.x+ 版本开发纯注解的非web项目,链接如下: https://my.oschina.net/morpheusWB/blog/2985600 本文则主要说明,如何在Web项目中,"基于spring纯注解方式...

morpheusWB
昨天
17
0
基础编程题目集-7-13 日K蜡烛图

股票价格涨跌趋势,常用蜡烛图技术中的K线图来表示,分为按日的日K线、按周的周K线、按月的月K线等。以日K线为例,每天股票价格从开盘到收盘走完一天,对应一根蜡烛小图,要表示四个价格:开...

niithub
昨天
5
0

没有更多内容

加载失败,请刷新页面

加载更多

返回顶部
顶部