XmlUtil (hutool-core 4.0.3 API)

java.lang.Object
- cn.hutool.core.util.XmlUtil

```
public class XmlUtil
extends Object
```
XML工具类
此工具使用w3c dom工具，不需要依赖第三方包。
工具类封装了XML文档的创建、读取、写出和部分XML操作

作者:

xiaoleilu

字段概要

字段
限定符和类型字段和说明

static String INVALID_REGEX
在XML中无效的字符正则

字段
限定符和类型	字段和说明
`static String`	`INVALID_REGEX` 在XML中无效的字符正则

构造器概要

构造器
构造器和说明

XmlUtil()

构造器
构造器和说明
`XmlUtil()`

方法概要

方法
限定符和类型	方法和说明
`static String`	`cleanInvalid(String xmlContent)` 去除XML文本中的无效字符
`static Document`	`createXml(String rootElementName)` 创建XML文档创建的XML默认是utf8编码，修改编码的过程是在toStr和toFile方法里，既XML在转为文本的时候才定义编码
`static XPath`	`createXPath()` 创建XPath Xpath相关文章：https://www.ibm.com/developerworks/cn/xml/x-javaxpathapi.html
`static String`	`elementText(Element element, String tagName)` 根据节点名获得第一个子节点
`static String`	`elementText(Element element, String tagName, String defaultValue)` 根据节点名获得第一个子节点
`static Object`	`getByXPath(String expression, Object source, QName returnType)` 通过XPath方式读取XML节点等信息 Xpath相关文章：https://www.ibm.com/developerworks/cn/xml/x-javaxpathapi.html
`static Element`	`getElement(Element element, String tagName)` 根据节点名获得第一个子节点
`static List<Element>`	`getElements(Element element, String tagName)` 根据节点名获得子节点列表
`static Element`	`getRootElement(Document doc)` 获得XML文档根节点
`static Document`	`parseXml(String xmlStr)` 将String类型的XML转换为XML文档
`static <T> T`	`readObjectFromXml(File source)` 从XML中读取对象 Reads serialized object from the XML file.
`static <T> T`	`readObjectFromXml(InputSource source)` 从XML中读取对象 Reads serialized object from the XML file.
`static <T> T`	`readObjectFromXml(String xmlStr)` 从XML中读取对象 Reads serialized object from the XML file.
`static Document`	`readXML(File file)` 读取解析XML文件
`static Document`	`readXML(InputSource source)` 读取解析XML文件编码在XML中定义
`static Document`	`readXML(InputStream inputStream)` 读取解析XML文件编码在XML中定义
`static Document`	`readXML(Reader reader)` 读取解析XML文件
`static Document`	`readXML(String pathOrContent)` 读取解析XML文件如果给定内容以“<”开头，表示这是一个XML内容，直接读取，否则按照路径处理路径可以为相对路径，也可以是绝对路径，相对路径相对于ClassPath
`static void`	`toFile(Document doc, String absolutePath)` 将XML文档写入到文件使用Document中的编码
`static void`	`toFile(Document doc, String path, String charset)` 将XML文档写入到文件
`static String`	`toStr(Document doc)` 将XML文档转换为String 字符编码使用XML文档中的编码，获取不到则使用UTF-8
`static String`	`toStr(Document doc, String charset)` 将XML文档转换为String 此方法会修改Document中的字符集
`static String`	`toStr(Document doc, String charset, boolean isPretty)` 将XML文档转换为String 此方法会修改Document中的字符集
`static List<Element>`	`transElements(Element parentEle, NodeList nodeList)` 将NodeList转换为Element列表非Element节点将被忽略
`static List<Element>`	`transElements(NodeList nodeList)` 将NodeList转换为Element列表
`static void`	`write(Document doc, Writer writer, boolean isPretty)` 将XML文档写出
`static <T> void`	`writeObjectAsXml(File dest, T t)` 将可序列化的对象转换为XML写入文件，已经存在的文件将被覆盖 Writes serializable object to a XML file.

从类继承的方法 java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- 字段详细资料
  - INVALID_REGEX
```
public static final String INVALID_REGEX
```
    在XML中无效的字符正则
    
    另请参阅:
    常量字段值
- 构造器详细资料
  - XmlUtil
```
public XmlUtil()
```
- 方法详细资料
  - readXML
```
public static Document readXML(File file)
```
    读取解析XML文件
    
    参数:
    file - XML文件
    
    返回:
    XML文档对象
  - readXML
```
public static Document readXML(String pathOrContent)
```
    读取解析XML文件
    如果给定内容以“<”开头，表示这是一个XML内容，直接读取，否则按照路径处理
    路径可以为相对路径，也可以是绝对路径，相对路径相对于ClassPath
    
    参数:
    pathOrContent - 内容或路径
    
    返回:
    XML文档对象
    从以下版本开始:
    
    3.0.9
  - readXML
```
public static Document readXML(InputStream inputStream)
                        throws UtilException
```
    读取解析XML文件
    编码在XML中定义
    
    参数:
    inputStream - XML流
    
    返回:
    XML文档对象
    
    抛出:
    
    UtilException - IO异常或转换异常
    从以下版本开始:
    
    3.0.9
  - readXML
```
public static Document readXML(Reader reader)
                        throws UtilException
```
    读取解析XML文件
    
    参数:
    reader - XML流
    
    返回:
    XML文档对象
    
    抛出:
    
    UtilException - IO异常或转换异常
    从以下版本开始:
    
    3.0.9
  - readXML
```
public static Document readXML(InputSource source)
```
    读取解析XML文件
    编码在XML中定义
    
    参数:
    source - InputSource
    
    返回:
    XML文档对象
    从以下版本开始:
    
    3.0.9
  - parseXml
```
public static Document parseXml(String xmlStr)
```
    将String类型的XML转换为XML文档
    
    参数:
    xmlStr - XML字符串
    
    返回:
    XML文档
  - readObjectFromXml
```
public static <T> T readObjectFromXml(File source)
                           throws IOException
```
    从XML中读取对象 Reads serialized object from the XML file.
    
    类型参数:
    T - 对象类型
    参数:
    source - XML文件
    
    返回:
    对象
    
    抛出:
    
    IOException - IO异常
  - readObjectFromXml
```
public static <T> T readObjectFromXml(String xmlStr)
                           throws IOException
```
    从XML中读取对象 Reads serialized object from the XML file.
    
    类型参数:
    T - 对象类型
    参数:
    xmlStr - XML内容
    
    返回:
    对象
    
    抛出:
    
    IOException - IO异常
    从以下版本开始:
    
    3.2.0
  - readObjectFromXml
```
public static <T> T readObjectFromXml(InputSource source)
                           throws IOException
```
    从XML中读取对象 Reads serialized object from the XML file.
    
    类型参数:
    T - 对象类型
    参数:
    source - InputSource
    
    返回:
    对象
    
    抛出:
    
    IOException - IO异常
    从以下版本开始:
    
    3.2.0
  - toStr
```
public static String toStr(Document doc)
```
    将XML文档转换为String
    字符编码使用XML文档中的编码，获取不到则使用UTF-8
    
    参数:
    doc - XML文档
    
    返回:
    XML字符串
  - toStr
```
public static String toStr(Document doc,
           String charset)
```
    将XML文档转换为String
    此方法会修改Document中的字符集
    
    参数:
    doc - XML文档
    charset - 自定义XML文件的编码，如果为null 读取XML文档中的编码，否则默认UTF-8
    
    返回:
    XML字符串
  - toStr
```
public static String toStr(Document doc,
           String charset,
           boolean isPretty)
```
    将XML文档转换为String
    此方法会修改Document中的字符集
    
    参数:
    doc - XML文档
    charset - 自定义XML文件的编码，如果为null 读取XML文档中的编码，否则默认UTF-8
    isPretty - 是否格式化输出
    
    返回:
    XML字符串
    从以下版本开始:
    
    3.0.9
  - toFile
```
public static void toFile(Document doc,
          String absolutePath)
```
    将XML文档写入到文件
    使用Document中的编码
    
    参数:
    doc - XML文档
    absolutePath - 文件绝对路径，不存在会自动创建
  - toFile
```
public static void toFile(Document doc,
          String path,
          String charset)
```
    将XML文档写入到文件
    
    参数:
    doc - XML文档
    path - 文件路径绝对路径或相对ClassPath路径，不存在会自动创建
    charset - 自定义XML文件的编码，如果为null 读取XML文档中的编码，否则默认UTF-8
  - write
```
public static void write(Document doc,
         Writer writer,
         boolean isPretty)
```
    将XML文档写出
    
    参数:
    doc - Document XML文档
    writer - 写出的Writer，Writer决定了输出XML的编码
    isPretty - 是否格式化输出
    从以下版本开始:
    
    3.0.9
  - createXml
```
public static Document createXml(String rootElementName)
```
    创建XML文档
    创建的XML默认是utf8编码，修改编码的过程是在toStr和toFile方法里，既XML在转为文本的时候才定义编码
    
    参数:
    rootElementName - 根节点名称
    
    返回:
    XML文档
  - getRootElement
```
public static Element getRootElement(Document doc)
```
    获得XML文档根节点
    
    参数:
    doc - Document
    
    返回:
    根节点
    从以下版本开始:
    
    3.0.8
    
    另请参阅:
    Document.getDocumentElement()
  - cleanInvalid
```
public static String cleanInvalid(String xmlContent)
```
    去除XML文本中的无效字符
    
    参数:
    xmlContent - XML文本
    
    返回:
    当传入为null时返回null
  - getElements
```
public static List<Element> getElements(Element element,
                        String tagName)
```
    根据节点名获得子节点列表
    
    参数:
    element - 节点
    tagName - 节点名，如果节点名为空（null或blank），返回所有子节点
    
    返回:
    节点列表
  - getElement
```
public static Element getElement(Element element,
                 String tagName)
```
    根据节点名获得第一个子节点
    
    参数:
    element - 节点
    tagName - 节点名
    
    返回:
    节点
  - elementText
```
public static String elementText(Element element,
                 String tagName)
```
    根据节点名获得第一个子节点
    
    参数:
    element - 节点
    tagName - 节点名
    
    返回:
    节点中的值
  - elementText
```
public static String elementText(Element element,
                 String tagName,
                 String defaultValue)
```
    根据节点名获得第一个子节点
    
    参数:
    element - 节点
    tagName - 节点名
    defaultValue - 默认值
    
    返回:
    节点中的值
  - transElements
```
public static List<Element> transElements(NodeList nodeList)
```
    将NodeList转换为Element列表
    
    参数:
    nodeList - NodeList
    
    返回:
    Element列表
  - transElements
```
public static List<Element> transElements(Element parentEle,
                          NodeList nodeList)
```
    将NodeList转换为Element列表
    非Element节点将被忽略
    
    参数:
    parentEle - 父节点，如果指定将返回此节点的所有直接子节点，nul返回所有就节点
    nodeList - NodeList
    
    返回:
    Element列表
  - writeObjectAsXml
```
public static <T> void writeObjectAsXml(File dest,
                        T t)
                             throws IOException
```
    将可序列化的对象转换为XML写入文件，已经存在的文件将被覆盖
    Writes serializable object to a XML file. Existing file will be overwritten
    
    类型参数:
    T - 对象类型
    参数:
    dest - 目标文件
    t - 对象
    
    抛出:
    
    IOException - IO异常
  - createXPath
```
public static XPath createXPath()
```
    创建XPath
    Xpath相关文章：https://www.ibm.com/developerworks/cn/xml/x-javaxpathapi.html
    
    返回:
    XPath
    从以下版本开始:
    
    3.2.0
  - getByXPath
```
public static Object getByXPath(String expression,
                Object source,
                QName returnType)
```
    通过XPath方式读取XML节点等信息
    Xpath相关文章：https://www.ibm.com/developerworks/cn/xml/x-javaxpathapi.html
    
    参数:
    expression - XPath表达式
    source - 资源，可以是Docunent、Node节点等
    returnType - 返回类型，XPathConstants
    
    返回:
    匹配返回类型的值
    从以下版本开始:
    
    3.2.0

类 XmlUtil

字段概要

构造器概要

方法概要

从类继承的方法 java.lang.Object

字段详细资料

INVALID_REGEX

构造器详细资料

XmlUtil

方法详细资料

readXML

readXML

readXML

readXML

readXML

parseXml

readObjectFromXml

readObjectFromXml

readObjectFromXml

toStr

toStr

toStr

toFile

toFile

write

createXml

getRootElement

cleanInvalid

getElements

getElement

elementText

elementText

transElements

transElements

writeObjectAsXml

createXPath

getByXPath