ZhouXY108/plusone-commons
1
0
Fork 0
forked from plusone/plusone-commons
Code Pull Requests Activity

添加注释说明。

Browse Source
This commit is contained in:
zhouxy108 2024-08-08 14:55:42 +08:00
parent 0850e765c8
commit 566202ce47
1 changed files with 2 additions and 1 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

3
src/main/java/xyz/zhouxy/plusone/commons/util/TreeBuilder.java
View File

@ -54,13 +54,14 @@ public class TreeBuilder<T, TSubTree extends T, TIdentity> {
/** /**
* 将节点构建成树。 * 将节点构建成树。
* <p> * <p>
* <b>注意，该方法会直接操作 nodes 列表中的节点，并没有做深拷贝， * <b>！！注意：该方法会直接操作 nodes 列表中的节点，并没有做深拷贝，
* 注意避免 nodes 中的元素产生变化所带来的意料之外的影响。</b> * 注意避免 nodes 中的元素产生变化所带来的意料之外的影响。</b>
* *
* @param nodes 平铺的节点列表 * @param nodes 平铺的节点列表
* @param comparator 用于节点的排序。 * @param comparator 用于节点的排序。
* 若为 {@code null}，则使用 {@link #defaultComparator}； * 若为 {@code null}，则使用 {@link #defaultComparator}；
* 若 {@link #defaultComparator} 也为 {@code null}，则不排序。 * 若 {@link #defaultComparator} 也为 {@code null}，则不排序。
* <b>仅影响调用 addChild 的顺序，如果操作对象本身对应的控制了子节点的顺序，无法影响其相关逻辑。</b>
*/ */
public List<T> buildTree(Collection<T> nodes, @Nullable Comparator<? super T> comparator) { public List<T> buildTree(Collection<T> nodes, @Nullable Comparator<? super T> comparator) {
Preconditions.checkNotNull(nodes); Preconditions.checkNotNull(nodes);