添加支持对森林结构进行处理的集合

This commit is contained in:
huangchengxing 2022-07-04 15:35:20 +08:00
parent adf23e1cf7
commit 59b5a17ee6
4 changed files with 1224 additions and 0 deletions

View File

@ -0,0 +1,285 @@
package cn.hutool.core.map;
import cn.hutool.core.collection.CollUtil;
import cn.hutool.core.lang.Opt;
import cn.hutool.core.util.ObjectUtil;
import java.util.Collection;
import java.util.Collections;
import java.util.Map;
import java.util.Set;
import java.util.function.BiConsumer;
import java.util.function.Function;
/**
* 基于多个{@link TreeEntry}构成的彼此平行的树结构构成的森林集合
*
* @param <K> key类型
* @param <V> value类型
* @author huangchengxing
* @see TreeEntry
*/
public interface ForestMap<K, V> extends Map<K, TreeEntry<K, V>> {
// ===================== Map接口方法的重定义 =====================
/**
* 添加一个节点效果等同于 {@code putNode(key, node.getValue())}
* <ul>
* <li>若key对应节点不存在则以传入的键值创建一个新的节点</li>
* <li>若key对应节点存在则将该节点的值替换为{@code node}指定的值</li>
* </ul>
*
* @param key 节点的key值
* @param node 节点
* @return 节点若key已有对应节点则返回具有旧值的节点否则返回null
* @see #putNode(Object, Object)
*/
@Override
default TreeEntry<K, V> put(K key, TreeEntry<K, V> node) {
return putNode(key, node.getValue());
}
/**
* 批量添加节点若节点具有父节点或者子节点则一并在当前实例中引入该关系
*
* @param treeEntryMap 节点集合
*/
@Override
default void putAll(Map<? extends K, ? extends TreeEntry<K, V>> treeEntryMap) {
if (CollUtil.isEmpty(treeEntryMap)) {
return;
}
treeEntryMap.forEach((k, v) -> {
if (v.hasParent()) {
final TreeEntry<K, V> parent = v.getDeclaredParent();
putLinkedNode(parent.getKey(), parent.getValue(), v.getKey(), v.getValue());
} else {
putNode(v.getKey(), v.getValue());
}
});
}
/**
* 将指定节点从当前{@link Map}中删除
* <ul>
* <li>若存在父节点或子节点则将其断开其与父节点或子节点的引用关系</li>
* <li>
* 若同时存在父节点或子节点则会在删除后将让子节点直接成为父节点的子节点比如<br>
* 现有引用关系 a -> b -> c删除 b 将有 a -> c
* </li>
* </ul>
*
* @param key 节点的key
* @return 删除的节点若key没有对应节点则返回null
*/
@Override
TreeEntry<K, V> remove(Object key);
/**
* 将当前集合清空并清除全部节点间的引用关系
*/
@Override
void clear();
// ===================== 节点操作 =====================
/**
* 批量添加节点
*
* @param values 要添加的值
* @param keyGenerator 从值中获取key的方法
* @param parentKeyGenerator 从值中获取父节点key的方法
*/
default <C extends Collection<V>> void putAllNode(
C values, Function<V, K> keyGenerator, Function<V, K> parentKeyGenerator) {
if (CollUtil.isEmpty(values)) {
return;
}
values.forEach(v -> {
final K key = keyGenerator.apply(v);
final K parentKey = parentKeyGenerator.apply(v);
linkNode(parentKey, key);
get(key).setValue(v);
});
}
/**
* 添加一个节点
* <ul>
* <li>若key对应节点不存在则以传入的键值创建一个新的节点</li>
* <li>若key对应节点存在则将该节点的值替换为{@code node}指定的值</li>
* </ul>
*
* @param key 节点的key
* @param value 节点的value
* @return 节点若key已有对应节点则返回具有旧值的节点否则返回null
*/
TreeEntry<K, V> putNode(K key, V value);
/**
* 同时添加父子节点
* <ul>
* <li>{@code parentKey}{@code childKey}对应的节点不存在则会根据键值创建一个对应的节点</li>
* <li>{@code parentKey}{@code childKey}对应的节点存在则会更新对应节点的值</li>
* </ul>
* 该操作等同于
* <pre>
* TreeEntry<K, V> parent = putNode(parentKey, parentValue);
* TreeEntry<K, V> child = putNode(childKey, childValue);
* linkNode(parentKey, childKey);
* </pre>
*
* @param parentKey 父节点的key
* @param parentValue 父节点的value
* @param childKey 子节点的key
* @param childValue 子节点的值
*/
default void putLinkedNode(K parentKey, V parentValue, K childKey, V childValue) {
linkNode(parentKey, childKey, (parent, child) -> {
parent.setValue(parentValue);
child.setValue(childValue);
});
}
/**
* 为指定的节点建立父子关系{@code parentKey}{@code childKey}对应节点不存在则会创建一个对应的值为null的空节点 <br>
*
* @param parentKey 父节点的key
* @param childKey 子节点的key
*/
default void linkNode(K parentKey, K childKey) {
linkNode(parentKey, childKey, null);
}
/**
* 为指定的节点建立父子关系{@code parentKey}{@code childKey}对应节点不存在则会创建一个对应的值为null的空节点
*
* @param parentKey 父节点的key
* @param childKey 子节点的key
* @param consumer 对父节点和子节点的操作允许为null
*/
void linkNode(K parentKey, K childKey, BiConsumer<TreeEntry<K, V>, TreeEntry<K, V>> consumer);
/**
* {@code parentKey}{@code childKey}对应节点都存在则移除指定该父节点与其直接关联的指定子节点间的引用关系
*
* @param parentKey 父节点的key
* @param childKey 子节点
*/
void unlinkNode(K parentKey, K childKey);
// ===================== 父节点相关方法 =====================
/**
* 获取指定节点所在树结构的全部树节点 <br>
* 比如存在 a -> b -> c 的关系则输入 a/b/c 都将返回 a, b, c
*
* @param key 指定节点的key
* @return 节点
*/
default Set<TreeEntry<K, V>> getTreeNodes(K key) {
final TreeEntry<K, V> target = get(key);
if (ObjectUtil.isNull(target)) {
return Collections.emptySet();
}
Set<TreeEntry<K, V>> results = CollUtil.newLinkedHashSet(target.getRoot());
CollUtil.addAll(results, target.getRoot().getChildren().values());
return results;
}
/**
* 获取以指定节点作为叶子节点的树结构然后获取该树结构的根节点 <br>
* 比如存在 a -> b -> c 的关系则输入 a/b/c 都将返回 a
*
* @param key 指定节点的key
* @return 节点
*/
default TreeEntry<K, V> getRootNode(K key) {
return Opt.ofNullable(get(key))
.map(TreeEntry::getRoot)
.orElse(null);
}
/**
* 获取指定节点的直接父节点 <br>
* 比如若存在 a -> b -> c 的关系此时输入 a 将返回 null输入 b 将返回 a输入 c 将返回 b
*
* @param key 指定节点的key
* @return 节点
*/
default TreeEntry<K, V> getDeclaredParentNode(K key) {
return Opt.ofNullable(get(key))
.map(TreeEntry::getDeclaredParent)
.orElse(null);
}
/**
* 获取以指定节点作为叶子节点的树结构然后获取该树结构中指定节点的指定父节点
*
* @param key 指定父节点的key
* @return 节点
*/
default TreeEntry<K, V> getParentNode(K key, K parentKey) {
return Opt.ofNullable(get(key))
.map(t -> t.getParent(parentKey))
.orElse(null);
}
/**
* 获取以指定节点作为叶子节点的树结构然后确认该树结构中当前节点是否存在指定父节点
*
* @param key 指定节点的key
* @param parentKey 指定父节点的key
* @return 是否
*/
default boolean containsParentNode(K key, K parentKey) {
return Opt.ofNullable(get(key))
.map(m -> m.containsParent(parentKey))
.orElse(false);
}
// ===================== 子节点相关方法 =====================
/**
* 判断以该父节点作为根节点的树结构中是否具有指定子节点
*
* @param parentKey 父节点
* @param childKey 子节点
* @return 是否
*/
default boolean containsChildNode(K parentKey, K childKey) {
return Opt.ofNullable(get(parentKey))
.map(m -> m.containsChild(childKey))
.orElse(false);
}
/**
* 获取指定父节点直接关联的子节点 <br>
* 比如若存在 a -> b -> c 的关系此时输入 b 将返回 c输入 a 将返回 b
*
* @param key key
* @return 节点
*/
default Collection<TreeEntry<K, V>> getDeclaredChildNodes(K key) {
return Opt.ofNullable(get(key))
.map(TreeEntry::getDeclaredChildren)
.map(Map::values)
.orElseGet(Collections::emptyList);
}
/**
* 获取指定父节点的全部子节点 <br>
* 比如若存在 a -> b -> c 的关系此时输入 b 将返回 c输入 a 将返回 bc
*
* @param key key
* @return 该节点的全部子节点
*/
default Collection<TreeEntry<K, V>> getChildNodes(K key) {
return Opt.ofNullable(get(key))
.map(TreeEntry::getChildren)
.map(Map::values)
.orElseGet(Collections::emptyList);
}
}

View File

@ -0,0 +1,672 @@
package cn.hutool.core.map;
import cn.hutool.core.collection.CollUtil;
import cn.hutool.core.lang.Assert;
import cn.hutool.core.util.ClassUtil;
import cn.hutool.core.util.ObjectUtil;
import cn.hutool.core.util.StrUtil;
import java.util.*;
import java.util.function.BiConsumer;
import java.util.function.BiPredicate;
import java.util.function.Consumer;
import java.util.function.Predicate;
import java.util.stream.Collectors;
/**
* {@link ForestMap}的基本实现
*
* <p>该集合可以被视为以{@link TreeEntryNode#getKey()}作为key{@link TreeEntryNode}实例作为value的{@link LinkedHashMap}<br>
* 使用时将每一对键与值对视为一个{@link TreeEntryNode}节点节点的id即为{@link TreeEntryNode#getKey()}
* 任何情况下使用相同的key都将会访问到同一个节点<br>
*
* <p>节点通过key形成父子关系并最终构成多叉树结构多组平行的多叉树将在当前集合中构成森林
* 使用者可以通过{@link ForestMap}本身的方法来对森林进行操作或访问
* 也可以在获取到{@link TreeEntry}使用节点本身的方法对数进行操作或访问
*
* @param <K> key类型
* @author huangchengxing
*/
public class LinkedForestMap<K, V> implements ForestMap<K, V> {
/**
* 节点集合
*/
private final Map<K, TreeEntryNode<K, V>> nodes;
/**
* 当指定节点已经与其他节点构成了父子关系是否允许将该节点的父节点强制替换为指定节点
*/
private final boolean allowOverrideParent;
/**
* 构建{@link LinkedForestMap}
*
* @param allowOverrideParent 当指定节点已经与其他节点构成了父子关系是否允许将该节点的父节点强制替换为指定节点
*/
public LinkedForestMap(boolean allowOverrideParent) {
this.allowOverrideParent = allowOverrideParent;
this.nodes = new LinkedHashMap<>();
}
// ====================== Map接口实现 ======================
/**
* 获取当前实例中的节点个数
*
* @return 节点个数
*/
@Override
public int size() {
return nodes.size();
}
/**
* 当前实例是否为空
*
* @return 是否
*/
@Override
public boolean isEmpty() {
return nodes.isEmpty();
}
/**
* 当前实例中是否存在key对应的节点
*
* @param key key
* @return 是否
*/
@Override
public boolean containsKey(Object key) {
return nodes.containsKey(key);
}
/**
* 当前实例中是否存在对应的{@link TreeEntry}实例
*
* @param value {@link TreeEntry}实例
* @return 是否
*/
@Override
public boolean containsValue(Object value) {
return nodes.containsValue(value);
}
/**
* 获取key对应的节点
*
* @param key key
* @return 节点
*/
@Override
public TreeEntry<K, V> get(Object key) {
return nodes.get(key);
}
/**
* 将指定节点从当前{@link Map}中删除
* <ul>
* <li>若存在父节点或子节点则将其断开其与父节点或子节点的引用关系</li>
* <li>
* 若同时存在父节点或子节点则会在删除后将让子节点直接成为父节点的子节点比如<br>
* 现有引用关系 a -> b -> c删除 b 将有 a -> c
* </li>
* </ul>
*
* @param key 节点的key
* @return 删除的且引用关系已经改变的节点若key没有对应节点则返回null
*/
@Override
public TreeEntry<K, V> remove(Object key) {
final TreeEntryNode<K, V> target = nodes.remove(key);
if (ObjectUtil.isNull(target)) {
return null;
}
// 若存在父节点
// 1.将该目标从父节点的子节点中移除
// 2.将目标的子节点直接将目标的父节点作为父节点
if (target.hasParent()) {
final TreeEntryNode<K, V> parent = target.getDeclaredParent();
parent.removeDeclaredChild(target.getKey());
target.getDeclaredChildren()
.forEach((k, c) -> parent.addChild((TreeEntryNode<K, V>)c));
}
return target;
}
/**
* 将当前集合清空并清除全部节点间的引用关系
*/
@Override
public void clear() {
nodes.values().forEach(TreeEntryNode::clear);
nodes.clear();
}
/**
* 返回当前实例中全部的key组成的{@link Set}集合
*
* @return 集合
*/
@Override
public Set<K> keySet() {
return nodes.keySet();
}
/**
* 返回当前实例中全部{@link TreeEntry}组成的{@link Collection}集合
*
* @return 集合
*/
@Override
public Collection<TreeEntry<K, V>> values() {
return new ArrayList<>(nodes.values());
}
/**
* 由key与{@link TreeEntry}组成的键值对实体的{@link Set}集合
* 注意返回集合中{@link Map.Entry#setValue(Object)}不支持调用
*
* @return 集合
*/
@Override
public Set<Map.Entry<K, TreeEntry<K, V>>> entrySet() {
return nodes.entrySet().stream()
.map(this::wrap)
.collect(Collectors.toSet());
}
/**
* {@link TreeEntryNode}包装为{@link EntryNodeWrapper}
*/
private Map.Entry<K, TreeEntry<K, V>> wrap(Map.Entry<K, TreeEntryNode<K, V>> nodeEntry) {
return new EntryNodeWrapper<>(nodeEntry.getValue());
}
// ====================== ForestMap接口实现 ======================
/**
* 添加一个节点
* <ul>
* <li>若key对应节点不存在则以传入的键值创建一个新的节点</li>
* <li>若key对应节点存在则将该节点的值替换为{@code node}指定的值</li>
* </ul>
*
* @param key 节点的key
* @param value 节点的value
* @return 节点若key已有对应节点则返回具有旧值的节点否则返回null
*/
@Override
public TreeEntryNode<K, V> putNode(K key, V value) {
TreeEntryNode<K, V> target = nodes.get(key);
if (ObjectUtil.isNotNull(target)) {
final V oldVal = target.getValue();
target.setValue(value);
return target.copy(oldVal);
}
target = new TreeEntryNode<>(null, key, value);
nodes.put(key, target);
return null;
}
/**
* 为指定的节点建立父子关系{@code parentKey}{@code childKey}对应节点不存在则会创建一个对应的值为null的空节点
*
* @param parentKey 父节点的key
* @param childKey 子节点的key
* @param consumer 对父节点和子节点的操作允许为null
*/
@Override
public void linkNode(K parentKey, K childKey, BiConsumer<TreeEntry<K, V>, TreeEntry<K, V>> consumer) {
consumer = ObjectUtil.defaultIfNull(consumer, (parent, child) -> {});
final TreeEntryNode<K, V> parentNode = nodes.computeIfAbsent(parentKey, t -> new TreeEntryNode<>(null, t));
TreeEntryNode<K, V> childNode = nodes.get(childKey);
// 1.子节点不存在
if (ObjectUtil.isNull(childNode)) {
childNode = new TreeEntryNode<>(parentNode, childKey);
consumer.accept(parentNode, childNode);
nodes.put(childKey, childNode);
return;
}
// 2.子节点存在且已经是该父节点的子节点了
if (ObjectUtil.equals(parentNode, childNode.getDeclaredParent())) {
consumer.accept(parentNode, childNode);
return;
}
// 3.子节点存在但是未与其他节点构成父子关系
if (false == childNode.hasParent()) {
parentNode.addChild(childNode);
}
// 4.子节点存在且已经与其他节点构成父子关系但是允许子节点直接修改其父节点
else if (allowOverrideParent) {
childNode.getDeclaredParent().removeDeclaredChild(childNode.getKey());
parentNode.addChild(childNode);
}
// 5.子节点存在且已经与其他节点构成父子关系但是不允许子节点直接修改其父节点
else{
throw new IllegalArgumentException(StrUtil.format(
"[{}] has been used as child of [{}], can not be overwrite as child of [{}]",
childNode.getKey(), childNode.getDeclaredParent().getKey(), parentKey
));
}
consumer.accept(parentNode, childNode);
}
/**
* 移除指定父节点与其直接关联的子节点间的引用关系但是不会将该节点从集合中删除
*
* @param parentKey 父节点的key
* @param childKey 子节点
*/
@Override
public void unlinkNode(K parentKey, K childKey) {
final TreeEntryNode<K, V> childNode = nodes.get(childKey);
if (ObjectUtil.isNull(childNode)) {
return;
}
if (childNode.hasParent()) {
childNode.getDeclaredParent().removeDeclaredChild(childNode.getKey());
}
}
/**
* 树节点
*
* @param <K> key类型
* @author huangchengxing
*/
public static class TreeEntryNode<K, V> implements TreeEntry<K, V> {
/**
* 根节点
*/
private TreeEntryNode<K, V> root;
/**
* 父节点
*/
private TreeEntryNode<K, V> parent;
/**
* 权重表示到根节点的距离
*/
private int weight;
/**
* 子节点
*/
private final Map<K, TreeEntryNode<K, V>> children;
/**
* key
*/
private final K key;
/**
*
*/
private V value;
/**
* 创建一个节点
*
* @param parent 节点的父节点
* @param key 节点的key
*/
public TreeEntryNode(TreeEntryNode<K, V> parent, K key) {
this(parent, key , null);
}
/**
* 创建一个节点
*
* @param parent 节点的父节点
* @param key 节点的key
* @param value 节点的value
*/
public TreeEntryNode(TreeEntryNode<K, V> parent, K key, V value) {
this.parent = parent;
this.key = key;
this.value = value;
this.children = new LinkedHashMap<>();
if (ObjectUtil.isNull(parent)) {
this.root = this;
this.weight = 0;
} else {
parent.addChild(this);
this.weight = parent.weight + 1;
this.root = parent.root;
}
}
/**
* 获取当前节点的key
*
* @return 节点的key
*/
@Override
public K getKey() {
return key;
}
/**
* 获取当前节点与根节点的距离
*
* @return 当前节点与根节点的距离
*/
public int getWeight() {
return weight;
}
/**
* 获取节点的value
*
* @return 节点的value
*/
@Override
public V getValue() {
return value;
}
/**
* 设置节点的value
*
* @param value 节点的value
* @return 节点的旧value
*/
@Override
public V setValue(V value) {
final V oldVal = getValue();
this.value = value;
return oldVal;
}
// ================== 父节点的操作 ==================
/**
* 从当前节点开始向上递归当前节点的父节点
*
* @param includeCurrent 是否处理当前节点
* @param consumer 对节点的操作
* @param breakTraverse 是否终止遍历
* @return 遍历到的最后一个节点
*/
TreeEntryNode<K, V> traverseParentNodes(
boolean includeCurrent, Consumer<TreeEntryNode<K, V>> consumer, Predicate<TreeEntryNode<K, V>> breakTraverse) {
breakTraverse = ObjectUtil.defaultIfNull(breakTraverse, n -> false);
TreeEntryNode<K, V> curr = includeCurrent ? this : this.parent;
while (ObjectUtil.isNotNull(curr)) {
consumer.accept(curr);
if (breakTraverse.test(curr)) {
break;
}
curr = curr.parent;
}
return curr;
}
/**
* 当前节点是否为根节点
*
* @return 当前节点是否为根节点
*/
public boolean isRoot() {
return getRoot() == this;
}
/**
* 获取以当前节点作为叶子节点的树结构然后获取该树结构的根节点
*
* @return 根节点
*/
@Override
public TreeEntryNode<K, V> getRoot() {
if (ObjectUtil.isNotNull(this.root)) {
return this.root;
} else {
this.root = traverseParentNodes(true, p -> {}, p -> !p.hasParent());
}
return this.root;
}
/**
* 获取当前节点直接关联的父节点
*
* @return 父节点当节点不存在对应父节点时返回null
*/
@Override
public TreeEntryNode<K, V> getDeclaredParent() {
return parent;
}
/**
* 获取以当前节点作为叶子节点的树结构然后获取该树结构中当前节点的指定父节点
*
* @param key 指定父节点的key
* @return 指定父节点当不存在时返回null
*/
@Override
public TreeEntryNode<K, V> getParent(K key) {
return traverseParentNodes(false, p -> {}, p -> p.equalsKey(key));
}
/**
* 指定key与当前节点的key是否相等
*
* @param key 要比较的key
*/
public boolean equalsKey(K key) {
return ObjectUtil.equal(getKey(), key);
}
// ================== 子节点的操作 ==================
/**
* 从当前节点开始按广度优先向下遍历当前节点的所有子节点
*
* @param includeCurrent 是否包含当前节点
* @param consumer 对节点与节点和当前节点的距离的操作{code includeCurrent}为false时下标从1开始否则从0开始
* @param breakTraverse 是否终止遍历为null时默认总是返回{@code true}
* @return 遍历到的最后一个节点
*/
TreeEntryNode<K, V> traverseChildNodes(
boolean includeCurrent, BiConsumer<Integer, TreeEntryNode<K, V>> consumer, BiPredicate<Integer, TreeEntryNode<K, V>> breakTraverse) {
breakTraverse = ObjectUtil.defaultIfNull(breakTraverse, (i, n) -> false);
final Deque<List<TreeEntryNode<K, V>>> keyNodeDeque = CollUtil.newLinkedList(CollUtil.newArrayList(this));
boolean needProcess = includeCurrent;
int index = includeCurrent ? 0 : 1;
TreeEntryNode<K, V> lastNode = null;
while (!keyNodeDeque.isEmpty()) {
final List<TreeEntryNode<K, V>> curr = keyNodeDeque.removeFirst();
final List<TreeEntryNode<K, V>> next = new ArrayList<>();
for (final TreeEntryNode<K, V> node : curr) {
if (needProcess) {
consumer.accept(index, node);
if (breakTraverse.test(index, node)) {
return node;
}
} else {
needProcess = true;
}
CollUtil.addAll(next, node.children.values());
}
if (!next.isEmpty()) {
keyNodeDeque.addLast(next);
}
lastNode = CollUtil.getLast(next);
index++;
}
return lastNode;
}
/**
* 添加子节点
*
* @param child 子节点
* @throws IllegalArgumentException 当要添加的子节点已经是其自身父节点时抛出
*/
void addChild(TreeEntryNode<K, V> child) {
if (containsChild(child.key)) {
return;
}
// 检查循环引用
traverseParentNodes(true, s -> Assert.notEquals(
s.key, child.key,
"circular reference between [{}] and [{}]!",
s.key, this.key
), null);
// 调整该节点的信息
child.traverseChildNodes(true, (i, c) -> {
c.root = getRoot();
c.weight = i + getWeight() + 1;
}, null);
// 将该节点添加为当前节点的子节点
children.put(child.key, child);
}
/**
* 移除子节点
*
* @param key 子节点
*/
void removeDeclaredChild(K key) {
TreeEntryNode<K, V> child = children.get(key);
if (ObjectUtil.isNull(child)) {
return;
}
// 断开该节点与其父节点的关系
child.getDeclaredParent().children.remove(key);
// 将子节点从当前节点中移除并重置子节点及其下属节点的相关属性
children.remove(child.getKey());
child.parent = null;
child.traverseChildNodes(true, (index, node) -> {
node.root = child;
node.weight = index;
}, null);
}
/**
* 获取以当前节点作为根节点的树结构然后获取该树结构中的当前节点的指定子节点
*
* @param key 指定子节点的key
* @return 节点
*/
@Override
public TreeEntryNode<K, V> getChild(K key) {
return traverseChildNodes(false, (i, c) -> {}, (i, c) -> c.equalsKey(key));
}
/**
* 获取当前节点直接关联的子节点
*
* @return 节点
*/
@Override
public Map<K, TreeEntry<K, V>> getDeclaredChildren() {
return new LinkedHashMap<>(this.children);
}
/**
* 获取以当前节点作为根节点的树结构然后获取该树结构中的当前节点的全部子节点
*
* @return 节点
*/
@Override
public Map<K, TreeEntry<K, V>> getChildren() {
final Map<K, TreeEntry<K, V>> childrenMap = new LinkedHashMap<>();
traverseChildNodes(false, (i, c) -> childrenMap.put(c.getKey(), c), null);
return childrenMap;
}
/**
* 移除对子节点父节点与根节点的全部引用
*/
void clear() {
this.root = null;
this.children.clear();
this.parent = null;
}
/**
* 比较目标对象与当前{@link TreeEntry}是否相等<br>
* 默认只要{@link TreeEntry#getKey()}的返回值相同即认为两者相等
*
* @param o 目标对象
* @return 是否
*/
@Override
public boolean equals(Object o) {
if (this == o) {
return true;
}
if (o == null || this.getClass().equals(o.getClass()) || ClassUtil.isAssignable(this.getClass(), o.getClass())) {
return false;
}
final TreeEntry<?, ?> treeEntry = (TreeEntry<?, ?>)o;
return ObjectUtil.equals(this.getKey(), treeEntry.getKey());
}
/**
* 返回当前{@link TreeEntry}的哈希值<br>
* 默认总是返回{@link TreeEntry#getKey()}的哈希值
*
* @return 哈希值
*/
@Override
public int hashCode() {
return Objects.hash(getKey());
}
/**
* 复制一个当前节点
*
* @param value 复制的节点的值
* @return 节点
*/
TreeEntryNode<K, V> copy(V value) {
TreeEntryNode<K, V> copiedNode = new TreeEntryNode<>(this.parent, this.key, ObjectUtil.defaultIfNull(value, this.value));
copiedNode.children.putAll(children);
return copiedNode;
}
}
/**
* {@link java.util.Map.Entry}包装类
*
* @param <K> key类型
* @param <V> value类型
* @param <N> 包装的{@link TreeEntry}类型
* @see #entrySet()
* @see #values()
*/
public static class EntryNodeWrapper<K, V, N extends TreeEntry<K, V>> implements Map.Entry<K, TreeEntry<K, V>> {
private final N entryNode;
EntryNodeWrapper(N entryNode) {
this.entryNode = entryNode;
}
@Override
public K getKey() {
return entryNode.getKey();
}
@Override
public TreeEntry<K, V> getValue() {
return entryNode;
}
@Override
public TreeEntry<K, V> setValue(TreeEntry<K, V> value) {
throw new UnsupportedOperationException();
}
}
}

View File

@ -0,0 +1,127 @@
package cn.hutool.core.map;
import cn.hutool.core.collection.CollUtil;
import cn.hutool.core.util.ObjectUtil;
import java.util.Map;
/**
* 允许拥有一个父节点与多个子节点的{@link Map.Entry}实现
* 表示一个以key作为唯一标识并且可以挂载一个对应值的树节点
* 提供一些基于该节点对其所在树结构进行访问的方法
*
* @param <V> 节点的key类型
* @param <K> 节点的value类型
* @author huangchengxing
* @see ForestMap
*/
public interface TreeEntry<K, V> extends Map.Entry<K, V> {
// ===================== Entry方法的重定义 =====================
/**
* 比较目标对象与当前{@link TreeEntry}是否相等<br>
* 默认只要{@link TreeEntry#getKey()}的返回值相同即认为两者相等
*
* @param o 目标对象
* @return 是否
*/
@Override
boolean equals(Object o);
/**
* 返回当前{@link TreeEntry}的哈希值<br>
* 默认总是返回{@link TreeEntry#getKey()}的哈希值
*
* @return 哈希值
*/
@Override
int hashCode();
// ===================== 父节点相关方法 =====================
/**
* 获取以当前节点作为叶子节点的树结构然后获取该树结构的根节点
*
* @return 根节点
*/
TreeEntry<K, V> getRoot();
/**
* 当前节点是否存在直接关联的父节点
*
* @return 是否
*/
default boolean hasParent() {
return ObjectUtil.isNotNull(getDeclaredParent());
}
/**
* 获取当前节点直接关联的父节点
*
* @return 父节点当节点不存在对应父节点时返回null
*/
TreeEntry<K, V> getDeclaredParent();
/**
* 获取以当前节点作为叶子节点的树结构然后获取该树结构中当前节点的指定父节点
*
* @param key 指定父节点的key
* @return 指定父节点当不存在时返回null
*/
TreeEntry<K, V> getParent(K key);
/**
* 获取以当前节点作为叶子节点的树结构然后确认该树结构中当前节点是否存在指定父节点
*
* @param key 指定父节点的key
* @return 是否
*/
default boolean containsParent(K key) {
return ObjectUtil.isNotNull(getParent(key));
}
// ===================== 子节点相关方法 =====================
/**
* 获取当前节点直接关联的子节点
*
* @return 节点
*/
Map<K, TreeEntry<K, V>> getDeclaredChildren();
/**
* 获取以当前节点作为根节点的树结构然后获取该树结构中的当前节点的全部子节点
*
* @return 节点
*/
Map<K, TreeEntry<K, V>> getChildren();
/**
* 当前节点是否有子节点
*
* @return 是否
*/
default boolean hasChildren() {
return CollUtil.isEmpty(getDeclaredChildren());
}
/**
* 获取以当前节点作为根节点的树结构然后获取该树结构中的当前节点的指定子节点
*
* @param key 指定子节点的key
* @return 节点
*/
TreeEntry<K, V> getChild(K key);
/**
* 获取以当前节点作为根节点的树结构然后确认该树结构中当前节点是否存在指定子节点
*
* @param key 指定子节点的key
* @return 是否
*/
default boolean containsChild(K key) {
return ObjectUtil.isNotNull(getChild(key));
}
}

View File

@ -0,0 +1,140 @@
package cn.hutool.core.map;
import cn.hutool.core.collection.CollStreamUtil;
import cn.hutool.core.collection.CollUtil;
import org.junit.Assert;
import org.junit.Before;
import org.junit.Test;
import java.util.Collection;
/**
* {@link LinkedForestMap}的测试用例
* <ul>
* <li>创建一个树节点Map构建 a -> b -> c -> d 的别名关系测试调用结果是否符合期望</li>
* <li>移除 b -> c 之间的引用关系构建 a -> b, c -> d的结构测试调用结果是否符合期望</li>
* <li>重新构建 b -> c 之间的引用关系构建 a -> b -> c -> d的结构测试调用结果是否符合期望</li>
* <li>
* b 添加 c2c2 添加 d2 作为子节点构建
* <pre>
* a -> b -> c --> d
* | -> c2 -> d2
* </pre>
* 的结构测试调用结果是否符合期望
* </li>
* </ul>
*/
public class LinkedForestMapTest {
private final ForestMap<String, String> treeNodeMap = new LinkedForestMap<>(false);
@Before
public void beforeTest() {
// a -> b -> c -> d
treeNodeMap.linkNode("a", "b");
treeNodeMap.linkNode("b", "c");
treeNodeMap.linkNode("c", "d");
}
@Test
public void testRegisterBeforeRemove() {
// containsChildNode
Assert.assertTrue(treeNodeMap.containsChildNode("a", "b"));
Assert.assertTrue(treeNodeMap.containsChildNode("a", "c"));
Assert.assertTrue(treeNodeMap.containsChildNode("a", "d"));
Assert.assertFalse(treeNodeMap.containsChildNode("a", "e"));
// getChildNodes
Assert.assertEquals(CollUtil.newLinkedHashSet("b", "c", "d"), transKey(treeNodeMap.getChildNodes("a")));
Assert.assertEquals(CollUtil.newLinkedHashSet("c", "d"), transKey(treeNodeMap.getChildNodes("b")));
Assert.assertEquals(CollUtil.newLinkedHashSet("d"), transKey(treeNodeMap.getChildNodes("c")));
Assert.assertEquals(CollUtil.newLinkedHashSet(), transKey(treeNodeMap.getChildNodes("d")));
// getRootNode
Assert.assertEquals("a", transKey(treeNodeMap.getRootNode("a")));
Assert.assertEquals("a", transKey(treeNodeMap.getRootNode("b")));
Assert.assertEquals("a", transKey(treeNodeMap.getRootNode("c")));
Assert.assertEquals("a", transKey(treeNodeMap.getRootNode("d")));
// getTreeNodes
Assert.assertEquals(CollUtil.newLinkedHashSet("a", "b", "c", "d"), transKey(treeNodeMap.getTreeNodes("a")));
Assert.assertEquals(CollUtil.newLinkedHashSet("a", "b", "c", "d"), transKey(treeNodeMap.getTreeNodes("b")));
Assert.assertEquals(CollUtil.newLinkedHashSet("a", "b", "c", "d"), transKey(treeNodeMap.getTreeNodes("c")));
Assert.assertEquals(CollUtil.newLinkedHashSet("a", "b", "c", "d"), transKey(treeNodeMap.getTreeNodes("d")));
// 循环依赖
Assert.assertThrows(IllegalArgumentException.class, () -> treeNodeMap.linkNode("d", "a"));
}
@Test
public void testAfterRemove() {
// a -> b, c -> d
treeNodeMap.unlinkNode("b", "c");
// getDeclaredChildren
Assert.assertEquals(CollUtil.newLinkedHashSet("b"), transKey(treeNodeMap.getChildNodes("a")));
Assert.assertEquals(CollUtil.newLinkedHashSet(), transKey(treeNodeMap.getChildNodes("b")));
Assert.assertEquals(CollUtil.newLinkedHashSet("d"), transKey(treeNodeMap.getChildNodes("c")));
Assert.assertEquals(CollUtil.newLinkedHashSet(), transKey(treeNodeMap.getChildNodes("d")));
// getRootNode
Assert.assertEquals("a", transKey(treeNodeMap.getRootNode("a")));
Assert.assertEquals("a", transKey(treeNodeMap.getRootNode("b")));
Assert.assertEquals("c", transKey(treeNodeMap.getRootNode("c")));
Assert.assertEquals("c", transKey(treeNodeMap.getRootNode("d")));
// getTreeNodes
Assert.assertEquals(CollUtil.newLinkedHashSet("a", "b"), transKey(treeNodeMap.getTreeNodes("a")));
Assert.assertEquals(CollUtil.newLinkedHashSet("a", "b"), transKey(treeNodeMap.getTreeNodes("b")));
Assert.assertEquals(CollUtil.newLinkedHashSet("c", "d"), transKey(treeNodeMap.getTreeNodes("c")));
Assert.assertEquals(CollUtil.newLinkedHashSet("c", "d"), transKey(treeNodeMap.getTreeNodes("d")));
}
@Test
public void testReRegisterAfterRemove() {
// a -> b -> c -> d
treeNodeMap.linkNode("b", "c");
testRegisterBeforeRemove();
}
@Test
public void testParallelRegister() {
// a -> b -> c --> d
// | -> c2 -> d2
treeNodeMap.linkNode("b", "c2");
treeNodeMap.linkNode("c2", "d2");
// getDeclaredChildren
Assert.assertEquals(CollUtil.newLinkedHashSet("b", "c", "d", "c2", "d2"), transKey(treeNodeMap.getChildNodes("a")));
Assert.assertEquals(CollUtil.newLinkedHashSet("c", "d", "c2", "d2"), transKey(treeNodeMap.getChildNodes("b")));
Assert.assertEquals(CollUtil.newLinkedHashSet("d"), transKey(treeNodeMap.getChildNodes("c")));
Assert.assertEquals(CollUtil.newLinkedHashSet(), transKey(treeNodeMap.getChildNodes("d")));
Assert.assertEquals(CollUtil.newLinkedHashSet("d2"), transKey(treeNodeMap.getChildNodes("c2")));
Assert.assertEquals(CollUtil.newLinkedHashSet(), transKey(treeNodeMap.getChildNodes("d2")));
// getRootNode
Assert.assertEquals("a", transKey(treeNodeMap.getRootNode("a")));
Assert.assertEquals("a", transKey(treeNodeMap.getRootNode("b")));
Assert.assertEquals("a", transKey(treeNodeMap.getRootNode("c")));
Assert.assertEquals("a", transKey(treeNodeMap.getRootNode("d")));
Assert.assertEquals("a", transKey(treeNodeMap.getRootNode("c2")));
Assert.assertEquals("a", transKey(treeNodeMap.getRootNode("d2")));
// getTreeNodes
Assert.assertEquals(CollUtil.newLinkedHashSet("a", "b", "c", "d", "c2", "d2"), transKey(treeNodeMap.getTreeNodes("a")));
Assert.assertEquals(CollUtil.newLinkedHashSet("a", "b", "c", "d", "c2", "d2"), transKey(treeNodeMap.getTreeNodes("b")));
Assert.assertEquals(CollUtil.newLinkedHashSet("a", "b", "c", "d", "c2", "d2"), transKey(treeNodeMap.getTreeNodes("c")));
Assert.assertEquals(CollUtil.newLinkedHashSet("a", "b", "c", "d", "c2", "d2"), transKey(treeNodeMap.getTreeNodes("d")));
Assert.assertEquals(CollUtil.newLinkedHashSet("a", "b", "c", "d", "c2", "d2"), transKey(treeNodeMap.getTreeNodes("c2")));
Assert.assertEquals(CollUtil.newLinkedHashSet("a", "b", "c", "d", "c2", "d2"), transKey(treeNodeMap.getTreeNodes("d2")));
}
private static <K, V> Collection<K> transKey(Collection<TreeEntry<K, V>> entryNodes) {
return CollStreamUtil.toSet(entryNodes, TreeEntry::getKey);
}
private static <K, V> K transKey(TreeEntry<K, V> entryNodes) {
return entryNodes.getKey();
}
}