doc[zfoo]: 更新文档

protocol/src/main/java/com/zfoo/protocol/util/DomUtils.java

@@ -15,6 +15,7 @@ package com.zfoo.protocol.util;
 
 import com.fasterxml.jackson.databind.DeserializationFeature;
 import com.fasterxml.jackson.dataformat.xml.XmlMapper;
+import com.zfoo.protocol.collection.CollectionUtils;
 import com.zfoo.protocol.exception.RunException;
 import org.w3c.dom.Element;
 import org.w3c.dom.Node;
@@ -24,10 +25,7 @@ import java.io.File;
 import java.io.FileInputStream;
 import java.io.IOException;
 import java.io.InputStream;
-import java.util.ArrayList;
-import java.util.Arrays;
-import java.util.Collection;
-import java.util.List;
+import java.util.*;
 
 /**
  * DOM(Document Object Model)文档对象模型
@@ -71,6 +69,35 @@ public abstract class DomUtils {
         }
     }
 
+
+    /**
+     * 获取包含有指定属性的Element
+     */
+    public static List<Element> getElementsByAttribute(Element element, String attribute, String attributeValue) {
+        var elements = new ArrayList<Element>();
+
+        var queue = new LinkedList<Element>();
+        queue.add(element);
+        while (!queue.isEmpty()) {
+            var ele = queue.poll();
+
+            var eleClassName = ele.getAttribute(attribute);
+            if (StringUtils.isNotEmpty(eleClassName) && eleClassName.equalsIgnoreCase(attributeValue)) {
+                elements.add(ele);
+                continue;
+            }
+
+            var eles = DomUtils.getChildElements(ele);
+            if (CollectionUtils.isNotEmpty(eles)) {
+                for (var e : eles) {
+                    queue.offer(e);
+                }
+            }
+        }
+
+        return elements;
+    }
+
     /**
      * 只返回第一层的孩子节点，不返回第一层孩子节点的孩子节点
      * <p>