教程总目录: Java-Swing 图形界面开发（目录）
官方JavaDocsApi: javax.swing.JTree
JTree，树。将分层数据显示为树状轮廓的组件。
一颗树由若干节点，通过层级关系组成，一个节点由TreeNode实例来表示，节点在树中的位置（路径）由TreePath实例来表示（定位）。
创建树时，首先要创建一个根节点，然后创建第二层节点添加到根节点，继续创建节点添加到其父节点，最终形成由根节点所引领的一棵树，再由 JTree 数组件显示出来。所有拥有子节点的节点可以自由展开或折叠子节点。
TreeNode 是一个接口，创建节点对象时，通常使用已实现该接口的的 DefaultMutableTreeNode 类。
DefaultMutableTreeNode表示一个节点，拥有对节点增删改查等操作的丰富方法。DefaultMutableTreeNode 实现了 MutableTreeNode 接口，而 MutableTreeNode 接口继承自 TreeNode 接口。
DefaultMutableTreeNode 构造方法:
/**
* 参数说明:
* userObject: 节点的用户对象（节点显示的名称）
* allowsChildren: 是否允许有子节点
*/
DefaultMutableTreeNode()
DefaultMutableTreeNode(Object userObject)
DefaultMutableTreeNode(Object userObject, boolean allowsChildren)DefaultMutableTreeNode 常用方法:
// 添加一个子节点在末尾
void add(MutableTreeNode newChild);
// 在指定位置插入一个子节点
void insert(MutableTreeNode newChild, int childIndex)
// 移除子节点
void remove(int childIndex);
void remove(MutableTreeNode aChild);
void removeAllChildren();
// 获取子节点数量
int getChildCount();
// 获取叶子节点的数量
int getLeafCount();
// 获取指定索引位置的子节点
TreeNode getChildAt(int index);
// 获取指定子节点之后的子节点
TreeNode getChildAfter(TreeNode aChild);
// 获取指定子节点之前的子节点
TreeNode getChildBefore(TreeNode aChild);
// 判断某节点是否为此节点的子节点
boolean isNodeChild(TreeNode aNode);
// 获取此节点的父节点，没有父节点则返回 null
TreeNode getParent();
// 判断此节点是否为根节点
boolean isRoot();
// 判断是否为叶节点（没有子节点即为叶节点，则返回 true）
boolean isLeaf();
// 返回此节点上的级数，从根到此节点的距离。如果此节点为根，则返回 0。
int getLevel();
// 返回从根到此节点的路径。该路径中第一个元素是根节点，最后一个元素是此节点。
TreeNode[] getPath();
// 遍历子节点（只包括直接子节点，不包括孙节点）
Enumeration children();
// 按广度优先的顺序遍历以此节点为根的子树（包含此节点下的所有节点）
Enumeration breadthFirstEnumeration();
// 按深度优先的顺序遍历以此节点为根的子树（包含此节点下的所有节点）
Enumeration depthFirstEnumeration();
// 设置节点的用户对象（节点显示的名称）
void setUserObject(Object userObject);
// 获取节点的用户对象（节点显示的名称）
Object getUserObject();TreePath表示某节点的路径（从根节点到此节点），一般使用方式:
// 一个节点
DefaultMutableTreeNode node = ...;
// 获取节点的路径（从根节点到此节点沿路径的所有节点集）
TreeNode[] pathNodes = node.getPath();
// 使用节点路径集创建树路径
TreePath treePath = new TreePath(pathNodes);
/*
* 这里得到的 treePath 表示的是树中的一个路径，可以定位到具体的节点，
* 从而对该节点进行相关操作（展开/折叠子节点等），详见后面 JTree 的介绍。
*/
/* 树路径的其他常用方法 */
// 获取此树路径上的所有节点，返回数组的元素为节点对象
Object[] paths = treePath.getPath();
// 获取此树路径上的节点数量
int nodeCount = treePath.getPathCount();
// 获取此树路径表示的节点的父节点的树路径
TreePath parentPath = treePath.getParentPath();
// 判断指定树路径是否为此树路径的“子孙”树路径
boolean isDescendant = treePath.isDescendant(TreePath aTreePath);JTree表示一个树组件，负责把内存中构造的整颗结构树显示出来。因为对于树结构，只需要得到一个根节点，就相当于获取到了整棵树的应用，因此只需要把一颗树的根节点传递给 JTree 便可显示整棵树。
JTree 实例的创建:
// 方式一: 指定一个根节点创建树
JTree tree = JTree(TreeNode root);
// 方式二: 先创建一个树模型（自定义树模型或使用已实现的默认树模型），再用指定树模型创建树
TreeModel treeModel = new DefaultTreeModel(TreeNode root);
JTree tree = JTree(treeModel);
// 方式三: 先创建一个空树，在设置树模型
JTree tree = JTree();
tree.setModel(TreeModel newModel);JTree 对节点的操作:
// 通过行索引获取指定行的树路径（这里的行表示的是在 JTree 组件
// 内可以直接看到的行，即不包括已折叠的，根节点行索引为 0，如果
// 根节点展开，则根节点的直接第一个子节点行索引为 1）。
TreePath getPathForRow(int row);
// 根据树路径获取指定节点所在行索引
int getRowForPath(TreePath path);
// 根据在 JTree 组件内的坐标获取指定坐标处所在的节点定位，
// 通过监听鼠标点击事件获取到点击坐标，从而可利用此方法实现
// 监听对节点的单击或双击事件。
int getRowForLocation(int x, int y);
TreePath getPathForLocation(int x, int y);
// 展开指定节点（通过可视行索引或树路径定位目标节点）
void expandRow(int row);
void expandPath(TreePath path);
// 折叠指定节点
void collapseRow(int row);
void collapsePath(TreePath path);
// 判断指定节点是否处于展开状态
boolean isExpanded(int row);
boolean isExpanded(TreePath path);
// 设置当前默认选中的节点（可多选）
void setSelectionRow(int row);
void setSelectionRows(int[] rows);
void setSelectionPath(TreePath path);
void setSelectionPaths(TreePath[] paths);
// 获取当前选中的节点
int[] getSelectionRows();
TreePath getSelectionPath();
TreePath[] getSelectionPaths();
// 是否显示根节点（默认显示）
void setRootVisible(boolean rootVisible);
// 是否显示根节点的句柄（默认不显示）
void setShowsRootHandles(boolean newValue);
// 是否允许编辑节点
void setEditable(boolean flag);JTree 自定义节点样式（字体、图标等）:
// 首先，创建一个树节点的渲染器
DefaultTreeCellRenderer render = new DefaultTreeCellRenderer();
// 设置节点 展开 和 折叠 状态显示的图标
render.setOpenIcon(Icon newIcon);
render.setClosedIcon(Icon newIcon);
// 设置叶子节点显示的图标
render.setLeafIcon(Icon newIcon);
// 设置节点字体，以及 选中 和 未选中 时的颜色
render.setFont(Font font);
render.setTextSelectionColor(Color newColor);
render.setTextNonSelectionColor(Color newColor);
// 设置节点 选中 和 未选中 时的背景颜色
render.setBackgroundSelectionColor(Color newColor);
render.setBackgroundNonSelectionColor(Color newColor);
// 最后，设置树组件的节点渲染器
jTree.setCellRenderer(render);JTree 对节点变化的监听:
JTree tree = new JTree(rootNode);
/*
* 节点展开/折叠监听器
*/
tree.addTreeExpansionListener(new TreeExpansionListener() {
@Override
public void treeExpanded(TreeExpansionEvent event) {
System.out.println("展开的节点: " + event.getPath());
}
@Override
public void treeCollapsed(TreeExpansionEvent event) {
System.out.println("折叠的节点: " + event.getPath());
}
});
/*
* 节点展开/折叠监听器（比上一个监听器先执行）
*/
tree.addTreeWillExpandListener(new TreeWillExpandListener() {
@Override
public void treeWillExpand(TreeExpansionEvent event) throws ExpandVetoException {
System.out.println("展开的节点: " + event.getPath());
}
@Override
public void treeWillCollapse(TreeExpansionEvent event) throws ExpandVetoException {
System.out.println("折叠的节点: " + event.getPath());
}
});
/*
* 节点被选中的监听器
*/
tree.addTreeSelectionListener(new TreeSelectionListener() {
@Override
public void valueChanged(TreeSelectionEvent e) {
// 获取被选中的相关节点
TreePath path = e.getPath();
TreePath[] paths = e.getPaths();
TreePath newLeadPath = e.getNewLeadSelectionPath();
TreePath oldLeadPath = e.getOldLeadSelectionPath();
}
});
// 节点增删改监听器
tree.getModel().addTreeModelListener(new TreeModelListener() {
@Override
public void treeNodesChanged(TreeModelEvent e) {
System.out.println("节点改变: " + e.getTreePath());
}
@Override
public void treeNodesInserted(TreeModelEvent e) {
System.out.println("节点插入: " + e.getTreePath());
}
@Override
public void treeNodesRemoved(TreeModelEvent e) {
System.out.println("节点移除: " + e.getTreePath());
}
@Override
public void treeStructureChanged(TreeModelEvent e) {
System.out.println("结构改变: " + e.getTreePath());
}
});package com.xiets.swing;
import javax.swing.*;
import javax.swing.event.TreeSelectionEvent;
import javax.swing.event.TreeSelectionListener;
import javax.swing.tree.DefaultMutableTreeNode;
import java.awt.*;
public class Main {
public static void main(String[] args) {
JFrame jf = new JFrame("测试窗口");
jf.setSize(300, 300);
jf.setLocationRelativeTo(null);
jf.setDefaultCloseOperation(WindowConstants.EXIT_ON_CLOSE);
JPanel panel = new JPanel(new BorderLayout());
// 创建根节点
DefaultMutableTreeNode rootNode = new DefaultMutableTreeNode("中国");
// 创建二级节点
DefaultMutableTreeNode gdNode = new DefaultMutableTreeNode("广东");
DefaultMutableTreeNode fjNode = new DefaultMutableTreeNode("福建");
DefaultMutableTreeNode shNode = new DefaultMutableTreeNode("上海");
DefaultMutableTreeNode twNode = new DefaultMutableTreeNode("台湾");
// 把二级节点作为子节点添加到根节点
rootNode.add(gdNode);
rootNode.add(fjNode);
rootNode.add(shNode);
rootNode.add(twNode);
// 创建三级节点
DefaultMutableTreeNode gzNode = new DefaultMutableTreeNode("广州");
DefaultMutableTreeNode szNode = new DefaultMutableTreeNode("深圳");
DefaultMutableTreeNode fzNode = new DefaultMutableTreeNode("福州");
DefaultMutableTreeNode xmNode = new DefaultMutableTreeNode("厦门");
DefaultMutableTreeNode tbNode = new DefaultMutableTreeNode("台北");
DefaultMutableTreeNode gxNode = new DefaultMutableTreeNode("高雄");
DefaultMutableTreeNode jlNode = new DefaultMutableTreeNode("基隆");
// 把三级节点作为子节点添加到相应的二级节点
gdNode.add(gzNode);
gdNode.add(szNode);
fjNode.add(fzNode);
fjNode.add(xmNode);
twNode.add(tbNode);
twNode.add(gxNode);
twNode.add(jlNode);
// 使用根节点创建树组件
JTree tree = new JTree(rootNode);
// 设置树显示根节点句柄
tree.setShowsRootHandles(true);
// 设置树节点可编辑
tree.setEditable(true);
// 设置节点选中监听器
tree.addTreeSelectionListener(new TreeSelectionListener() {
@Override
public void valueChanged(TreeSelectionEvent e) {
System.out.println("当前被选中的节点: " + e.getPath());
}
});
// 创建滚动面板，包裹树（因为树节点展开后可能需要很大的空间来显示，所以需要用一个滚动面板来包裹）
JScrollPane scrollPane = new JScrollPane(tree);
// 添加滚动面板到那内容面板
panel.add(scrollPane, BorderLayout.CENTER);
// 设置窗口内容面板并显示
jf.setContentPane(panel);
jf.setVisible(true);
}
}结果展示：
