金蝶云苍穹左树右表单据列表插件refreshNode事件案例

1. 新建模板单据

2. 设置单据表名

3. 添加基础资料并将其资料类型设置为业务应用实体

4. 如下图所示设置列表属性

列表表单模板: bos_templatetreelist

F7列表表单模板: bos_templatetreelistf7

5. 编码

package kd.bos.zsybbill.plugin;

import java.util.ArrayList;
import java.util.EventObject;
import java.util.HashMap;
import java.util.Iterator;
import java.util.List;
import java.util.Map;

import kd.bos.algo.DataSet;
import kd.bos.algo.Row;
import kd.bos.dataentity.utils.StringUtils;
import kd.bos.entity.tree.TreeNode;
import kd.bos.form.control.events.RefreshNodeEvent;
import kd.bos.list.events.BuildTreeListFilterEvent;
import kd.bos.list.plugin.AbstractTreeListPlugin;
import kd.bos.orm.ORM;
import kd.bos.orm.query.QCP;
import kd.bos.orm.query.QFilter;

/**
 * <p>Title: </p>
 * <p>
 *    Description:
 *    试验成功
 * </p>
 * <p>Copyright: Copyright (c) 2020</p>
 * @author xx
 * @date 2020年3月16日
 * @version 1.0
 */
public class RefreshNodeSample extends AbstractTreeListPlugin {
    /** 树形控件上方的按钮的主面板 */
    private static final String KEY_TREEBUTTONPANEL  = "flexpanel_treebtn";  
    /** 业务应用字段标识 */
    private static final String KEY_BIZAPPID  = "bizappid";
    
    /**
     * <p>Title: </p>
     * <p>
     *    Description:
     * 初始化树分组控件上的工具面板时，触发此事件
     * @remark
     * 插件在此事件，隐藏树工具面板
     * </p>
     * <p>Copyright: Copyright (c) 2020</p>
     * @author xx
     * @date 2020年3月16日
     * @param param the bare_field_name
     * @param e
     * @see kd.bos.list.plugin.AbstractTreeListPlugin#initTreeToolbar(java.util.EventObject)
     * @version 1.0
     */
    @Override
    public void initTreeToolbar(EventObject e) {
        super.initTreeToolbar(e);
        this.getView().setVisible(false, KEY_TREEBUTTONPANEL);//控制树形面板的显示
//      this.getView().setVisible(false, "btndel");//设置新增(btnnew)、修改(btnedit)、删除(btndel)显示与否
    }

    /**
     * <p>Title: </p>
     * <p>
     *    Description:
     * 加载、刷新子节点事件
     * @remark
     * 默认情况下，系统会自动加载基础资料分组表格中的数据作为分组树节点；
     * 插件可以在此事件中，自行构建分组树上的节点；
     * 另外，在展开任意节点、或者是列表刷新时，均会触发本事件，需要避免重复添加子节点
     * </p>
     * <p>Copyright: Copyright (c) 2020</p>
     * @author xx
     * @date 2020年3月16日
     * @param param the bare_field_name
     * @param e
     * @see kd.bos.list.plugin.AbstractTreeListPlugin#refreshNode(kd.bos.form.control.events.RefreshNodeEvent)
     * @version 1.0
     */
    @Override
    public void refreshNode(RefreshNodeEvent e) {
        super.refreshNode(e);
        
        // 取缓存的根节点
        TreeNode root = this.getTreeModel().getRoot();
        
        // 当前节点
        String currNodeId = (String)e.getNodeId();
        TreeNode currNode = root.getTreeNode(currNodeId, 10);
        
        // 判断当前节点下，是否已经缓存了子节点：如果有，无需重复加载
        if (currNode.getChildren() != null && !currNode.getChildren().isEmpty()){
            // 直接返回缓存的子节点
            e.setChildNodes(currNode.getChildren());
        }
        else {
            // 没有缓存子节点
            if (StringUtils.equals(currNodeId, root.getId())){
                // 当前要刷新的是根节点：读取全部业务云、业务应用，生成节点返回
                e.setChildNodes(this.loadAppNodes());
            }
            else {
                // 当前要刷新非根节点
                // 业务应用节点是一次性加载完毕的，没有采用懒加载；如果在缓存中没有找到其子节点，则说明其没有子节点
                // TODO 如果采用了懒加载子节点方案，则需要在这里尝试加载子节点
                e.setChildNodes(null);
            }
        }
    }

    /**
     * <p>Title: </p>
     * <p>
     *    Description:
     * 基于当前选择的分组节点，生成单据列表过滤条件时触发
     * @remark
     * 插件可以在此插件中，略过系统内置的分组条件，自行生成分组过滤条件
     * </p>
     * <p>Copyright: Copyright (c) 2020</p>
     * @author xx
     * @date 2020年3月16日
     * @param param the bare_field_name
     * @param e
     * @see kd.bos.list.plugin.AbstractTreeListPlugin#buildTreeListFilter(kd.bos.list.events.BuildTreeListFilterEvent)
     * @version 1.0
     */
    @Override
    public void buildTreeListFilter(BuildTreeListFilterEvent e) {
        super.buildTreeListFilter(e);
        
        // 生成过滤条件
        QFilter filter = this.buildAppQFilter(KEY_BIZAPPID, (String)e.getNodeId());
        e.addQFilter(filter);
        
        e.setCancel(true);  // 略过系统内置的分组过滤条件
    }
    
    /************** 如下代码，用来加载、搜索业务应用清单  *****************/
    
    /**
     * List<TreeNode></br>
     * 
     * <p>Title: </p>
     * <p>
     *    Description:
     * 构造业务应用树节点返回
     * </p>
     * <p>Copyright: Copyright (c) 2020</p>
     * @author xx
     * @date 2020年3月16日
     * @param param the bare_field_name
     * @return the bare_field_name
     * @return
     * @version 1.0
     */
    private List<TreeNode> loadAppNodes(){
        
        // 读取全部业务云
        Map<String, TreeNode> allNodes = new HashMap<>(); 
        List<TreeNode> cloudNode4 = getCloudData();
        for(TreeNode node: cloudNode4){
            allNodes.put(node.getId(), node);
        }
        
        // 读取全部应用
        List<TreeNode> appNode4 = getAppData();
        for(TreeNode node: appNode4){
            allNodes.put(node.getId(), node);
        }
        
        // 构建节点的父子关系
        for(TreeNode node : allNodes.values()){
            TreeNode parentNode = allNodes.get(node.getParentid());
            if (parentNode != null){
                parentNode.addChild(node);
            }
        }
        
        return cloudNode4;
    }
    
    /**
     * List<TreeNode></br>
     * 
     * <p>Title: </p>
     * <p>
     *    Description:
     * 查询数据库，获取业务云数据，构造为树节点集合返回
     * </p>
     * <p>Copyright: Copyright (c) 2020</p>
     * @author xx
     * @date 2020年3月16日
     * @param param the bare_field_name
     * @return the bare_field_name
     * @return
     * @version 1.0
     */
    private List<TreeNode> getCloudData() {
        List<TreeNode> cloudNode = new ArrayList<TreeNode>();

        ORM orm = ORM.create();
        String fields = "id, number, name";
//      String orderby = "seq asc";
        QFilter[] filters = new QFilter[] {};
        
//      try(DataSet ds = orm.queryDataSet("bos_devportal_bizcloud", "bos_devportal_bizcloud", fields, filters, orderby)) {
        try(DataSet ds = orm.queryDataSet("bos_devportal_bizcloud", "bos_devportal_bizcloud", fields, filters)) {
            Iterator<Row> rows = ds.iterator();
            while (rows.hasNext()) {
                Row row = rows.next();
                TreeNode node = new TreeNode();
                String nodeID = "cloud/" + row.getString("number");
                node.setText(row.getString("name"));
                node.setParentid("0");
                node.setId(nodeID);
                cloudNode.add(node);
            }
        }
        return cloudNode;
    }

    /**
     * List<TreeNode></br>
     * 
     * <p>Title: </p>
     * <p>
     *    Description:
     *    查询数据库，获取业务应用数据，构造为业务应用树节点集合返回
     * </p>
     * <p>Copyright: Copyright (c) 2020</p>
     * @author xx
     * @date 2020年3月16日
     * @param param the bare_field_name
     * @return the bare_field_name
     * @return
     * @version 1.0
     */
    private static List<TreeNode> getAppData() {
        // 可见性与发布状态
        List<TreeNode> appNode = new ArrayList<TreeNode>();

        ORM orm = ORM.create();
        String fields = "id,number, name, bizcloud.id, bizcloud.number";
//      String orderby = "seq asc";
        
        QFilter[] filters = new QFilter[] {};
        
//      try (DataSet ds = orm.queryDataSet("bos_devportal_bizapp", "bos_devportal_bizapp", fields, filters, orderby)){
        try (DataSet ds = orm.queryDataSet("bos_devportal_bizapp", "bos_devportal_bizapp", fields, filters)){
            Iterator<Row> rows = ds.iterator();
            while (rows.hasNext()) {
                Row row = rows.next();
                TreeNode node = new TreeNode();
                String parentId = "cloud/" + row.getString("bizcloud.number");
                String nodeID = row.getString("id");
                node.setId(nodeID);
                node.setParentid(parentId);
                node.setText(row.getString("name"));
                appNode.add(node);
            }
        }
        return appNode;
    }
    
    /**
     * QFilter</br>
     * 
     * <p>Title: </p>
     * <p>
     *    Description:
     * 根据当前选择节点，生成过滤业务应用范围的条件：
     * 
     * 如果当前点击的节点是业务应用，则直接按此业务应用过滤；
     * 如果点钱点击的节点是业务云，则取此业务云下全部业务应用进行过滤；
     * </p>
     * <p>Copyright: Copyright (c) 2020</p>
     * @author xx
     * @date 2020年3月16日
     * @param param the bare_field_name
     * @return the bare_field_name
     * @param appIdFldKey 单据上，业务应用字段名
     * @param nodeId 当前点击的节点
     * @return
     * @version 1.0
     */
    private QFilter buildAppQFilter(String appIdFldKey, String nodeId){
        
        List<String> appIds = new ArrayList<>();
        TreeNode root = this.getTreeModel().getRoot();
        List<TreeNode> bizCloudNodes = root.getChildren();
        
        if (bizCloudNodes != null){
            for(TreeNode bizCloudNode : bizCloudNodes){
                if (matchCloudNode(nodeId, bizCloudNode, appIds)){
                    break;
                }
            }
        }
        
        if (appIds.isEmpty()){
            // 所选节点，未命中任何业务应用：应该选择的是根节点，不限条件
            return null;
        }
        else if (appIds.size() == 0) {
            return new QFilter(appIdFldKey, QCP.equals, appIds.get(0));
        }
        else {
            return new QFilter(appIdFldKey, QCP.in, appIds.toArray(new String[appIds.size()]));
        }
    }

    /**
     * boolean</br>
     * 
     * <p>Title: </p>
     * <p>
     *    Description:
     * 判断当前节点，是否与指定的业务云匹配；如果是，返回true，并把本业务云下的全部应用，输出到outAppIds参数中
     * </p>
     * <p>Copyright: Copyright (c) 2020</p>
     * @author xx
     * @date 2020年3月16日
     * @param param the bare_field_name
     * @return the bare_field_name
     * @param nodeId 当前节点
     * @param bizCloudNode 待匹配的业务云节点
     * @param outAppIds 输出
     * @return
     * @version 1.0
     */
    private boolean matchCloudNode(String nodeId, TreeNode bizCloudNode, List<String> outAppIds){
        
        if (StringUtils.equals(nodeId, bizCloudNode.getId())){
            // 当前节点，就是本次比较的业务云节点：则输出全部业务应用进行过滤
            
            if (bizCloudNode.getChildren() != null){
                for(TreeNode appNode : bizCloudNode.getChildren()){
                    outAppIds.add(appNode.getId());
                }
            }
            if (outAppIds.isEmpty()){
                // 如果本业务云下没有任何业务应用：
                // 输出一个不存在的业务应用标识，生成一个永不成立的条件，使单据列表不显示任何数据
                outAppIds.add(nodeId);
            }
            return true;
        }
        else {
            // 当前节点，不是本次比较的业务云节点：则往下匹配其包含的业务应用节点
            
            if (matchAppNode(nodeId, bizCloudNode)){
                outAppIds.add(nodeId);
                return true;
            }
        }
        
        return false;
    }
    
    /**
     * boolean</br>
     * 
     * <p>Title: </p>
     * <p>
     *    Description:
     * 判断当前节点，是否属于所传业务云下的业务应用节点，如果是，返回true
     * </p>
     * <p>Copyright: Copyright (c) 2020</p>
     * @author xx
     * @date 2020年3月16日
     * @param param the bare_field_name
     * @return the bare_field_name
     * @param nodeId 当前节点
     * @param bizCloudNode 待匹配的业务云节点
     * @return
     * @version 1.0
     */
    private boolean matchAppNode(String nodeId, TreeNode bizCloudNode){
        if (bizCloudNode.getChildren() != null){
            for(TreeNode appNode : bizCloudNode.getChildren()){
                if (StringUtils.equals(appNode.getId(), nodeId)){
                    return true;
                }
            }
        }
        return false;
    }
}

6. 列表界面预览测试，如下图所示测试成功

以上就是我关于 金蝶云苍穹左树右表单据列表插件refreshNode事件案例 知识点整理与总结的全部内容，希望对你有帮助。。。。。。。

分割线