树图 Java

树图 Java 是一种优秀的开源 Java 库，用于绘制自定义树形结构图表。它提供了丰富的 API 接口，可以轻松创建层次结构图和组织结构图等。同时，它还支持节点样式自定义、拖拽、缩放和异步加载等丰富的功能，非常适合用于企业级软件的可视化展示。

安装

树图 Java 可以通过在 Maven 或 Gradle 中添加以下依赖来轻松引入：

<dependency>
  <groupId>com.github.waylau</groupId>
  <artifactId>jstree-spring-boot-starter</artifactId>
  <version>1.0.1.RELEASE</version>
</dependency>

快速入门

以下是快速创建一个简单的树图的示例：

import com.fasterxml.jackson.core.JsonProcessingException;
import com.fasterxml.jackson.databind.ObjectMapper;
import com.github.waylau.spring.boot.tree.Tree;
import com.github.waylau.spring.boot.tree.domain.Node;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RestController;

@RestController
public class TreeController {

    @GetMapping("/api/tree")
    public String getTree() throws JsonProcessingException {
        ObjectMapper mapper = new ObjectMapper();
        Tree tree = new Tree("0");
        Node node1 = new Node("1", "Node 1");
        Node node2 = new Node("2", "Node 2");
        Node node3 = new Node("3", "Node 3");
        Node node4 = new Node("4", "Node 4");
        Node node5 = new Node("5", "Node 5");
        Node node6 = new Node("6", "Node 6");
        Node node7 = new Node("7", "Node 7");
        Node node8 = new Node("8", "Node 8");
        Node node9 = new Node("9", "Node 9");
        Node node10 = new Node("10", "Node 10");

        tree.addNode(node1);
        tree.addNode(node2);
        tree.addNode(node3);
        tree.addNode(node4);
        tree.addNode(node5);
        tree.addNode(node6);
        tree.addNode(node7);
        tree.addNode(node8);
        tree.addNode(node9);
        tree.addNode(node10);

        node1.addChild(node2);
        node1.addChild(node3);
        node1.addChild(node4);
        node2.addChild(node5);
        node2.addChild(node6);
        node3.addChild(node7);
        node4.addChild(node8);
        node4.addChild(node9);
        node4.addChild(node10);

        return mapper.writeValueAsString(tree);
    }
}

进阶使用

可以通过自定义节点和树的样式，来进行更加高级的功能开发。下面是一些基本概念和 API 示例：

创建树

Tree tree = new Tree("0"); // 创建一个根节点 ID 为 0 的树
Node node1 = new Node("1", "Node 1"); // 一个 ID 为 1，文本为 "Node 1" 的节点
tree.addNode(node1); // 将 node1 添加至树中

添加子节点

Node node2 = new Node("2", "Node 2");
node1.addChild(node2); // 将 node2 作为 node1 的子节点添加至树中

样式自定义

Node node = new Node("2", "Node 2");
node.setIcon("icon"); // 设置节点图标的样式
node.setLiAttributes(Map.of("class", "node")); // 设置节点的属性，class="node"
node.setAAttributes(Map.of("href", "http://example.com")); // 设置节点的 a 标签的属性

拖拽和缩放

import com.github.waylau.spring.boot.tree.Tree;
import com.github.waylau.spring.boot.tree.domain.Node;
import com.github.waylau.spring.boot.tree.domain.tree.DragAndDropEvent;
import com.github.waylau.spring.boot.tree.domain.tree.RefreshEvent;
import com.github.waylau.spring.boot.tree.domain.tree.State;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.PostMapping;
import org.springframework.web.bind.annotation.RequestBody;
import org.springframework.web.bind.annotation.RestController;

@RestController
public class TreeController {

    @PostMapping("/api/tree/drag")
    public State onDragAndDrop(@RequestBody DragAndDropEvent event) {
        State state = event.getState();

        // 更新节点信息
        // ...

        return state;
    }

    @GetMapping("/api/tree/refresh")
    public State onRefresh(@RequestBody RefreshEvent event) {
        State state = event.getState();

        // 重新加载节点信息
        // ...

        return state;
    }
}

支持异步加载

import com.github.waylau.spring.boot.tree.Tree;
import com.github.waylau.spring.boot.tree.domain.Node;
import com.github.waylau.spring.boot.tree.domain.tree.AjaxEvent;
import com.github.waylau.spring.boot.tree.domain.tree.State;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RestController;

@RestController
public class TreeController {

    @GetMapping("/api/tree/ajax")
    public State onAjax(@RequestBody AjaxEvent event) {
        State state = event.getState();

        Node node = new Node("2", "Node 2");
        node.addState("opened", true);
        state.addNodes(node);

        return state;
    }
}

总结

树图 Java 是一款非常优秀的树形结构图表库，其 API 接口非常丰富，可以满足大部分树形结构图表的需求。同时，它还支持节点样式自定义、拖拽和缩放、异步加载等实用的功能。因此，我们可以用它来快速开发高可视化的企业级软件，提高用户体验。