Xml (polaris-toolkit 3.3.6 API)

java.lang.Object
- io.polaris.core.xml.Xml

```
public class Xml
extends Object
```
作者:

Qt

嵌套类概要

嵌套类
限定符和类型类和说明

static class Xml.UniversalNamespaceCache
全局命名空间上下文
见：https://www.ibm.com/developerworks/cn/xml/x-nmspccontext/

嵌套类
限定符和类型	类和说明
`static class`	`Xml.UniversalNamespaceCache` 全局命名空间上下文见：https://www.ibm.com/developerworks/cn/xml/x-nmspccontext/

字段概要

字段
限定符和类型	字段和说明
`static String`	`AMP` 字符串常量：XML And 符转义 `"&" -> "&"`
`static String`	`APOS` 字符串常量：XML 单引号转义 `"&apos" -> "'"`
`static String`	`COMMENT_REGEX` 在XML中注释的内容正则
`static String`	`GT` 字符串常量：XML 大于号转义 `">" -> ">"`
`static int`	`INDENT_DEFAULT` XML格式化输出默认缩进量
`static String`	`INVALID_REGEX` 在XML中无效的字符正则
`static String`	`LT` 字符串常量：XML 小于号转义 `"<" -> "<"`
`static String`	`NBSP` 字符串常量：XML 不间断空格转义 `" " -> " "`
`static String`	`QUOTE` 字符串常量：XML 双引号转义 `""" -> "\""`

构造器概要

构造器
构造器和说明

Xml()

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

方法概要

所有方法静态方法具体方法
限定符和类型	方法和说明
`static void`	`append(Node node, Object data)` 追加数据子节点，可以是Map、集合、文本
`static Element`	`appendChild(Node node, String tagName)` 在已有节点上创建子节点
`static Element`	`appendChild(Node node, String tagName, String namespace)` 在已有节点上创建子节点
`static Node`	`appendText(Node node, CharSequence text)` 创建文本子节点
`static Document`	`beanToXml(Object bean)` 将Bean转换为XML
`static Document`	`beanToXml(Object bean, String namespace)` 将Bean转换为XML
`static Document`	`beanToXml(Object bean, String namespace, boolean ignoreNull)` 将Bean转换为XML
`static String`	`cleanComment(String xmlContent)` 去除XML文本中的注释内容
`static String`	`cleanInvalid(String xmlContent)` 去除XML文本中的无效字符
`static DocumentBuilder`	`createDocumentBuilder()` 创建 DocumentBuilder
`static DocumentBuilderFactory`	`createDocumentBuilderFactory()` 创建`DocumentBuilderFactory` 默认使用"com.sun.org.apache.xerces.internal.jaxp.DocumentBuilderFactoryImpl" 如果使用第三方实现，请调用`disableDefaultDocumentBuilderFactory()`
`static Document`	`createXml()` 创建XML文档创建的XML默认是utf8编码，修改编码的过程是在toStr和toFile方法里，即XML在转为文本的时候才定义编码
`static Document`	`createXml(String rootElementName)` 创建XML文档创建的XML默认是utf8编码，修改编码的过程是在toStr和toFile方法里，即XML在转为文本的时候才定义编码
`static Document`	`createXml(String rootElementName, String namespace)` 创建XML文档创建的XML默认是utf8编码，修改编码的过程是在toStr和toFile方法里，即XML在转为文本的时候才定义编码
`static XPath`	`createXPath()` 创建XPath Xpath相关文章：https://www.ibm.com/developerworks/cn/xml/x-javaxpathapi.html
`static void`	`disableDefaultDocumentBuilderFactory()` 禁用默认的DocumentBuilderFactory，禁用后如果有第三方的实现（如oracle的xdb包中的xmlparse），将会自动加载实现。
`static String`	`elementText(Element element, String tagName)` 根据节点名获得第一个子节点
`static String`	`elementText(Element element, String tagName, String defaultValue)` 根据节点名获得第一个子节点
`static String`	`escape(String string)` 转义XML特殊字符: & (ampersand) 替换为 & < (小于) 替换为 < > (大于) 替换为 > " (双引号) 替换为 "
`static String`	`format(Document doc)` 格式化XML输出
`static String`	`format(String xmlStr)` 格式化XML输出
`static Object`	`getByXPath(String expression, Object source, QName returnType)` 通过XPath方式读取XML节点等信息 Xpath相关文章：https://www.ibm.com/developerworks/cn/xml/x-javaxpathapi.html
`static Object`	`getByXPath(String expression, Object source, QName returnType, NamespaceContext nsContext)` 通过XPath方式读取XML节点等信息 Xpath相关文章： https://www.ibm.com/developerworks/cn/xml/x-javaxpathapi.html https://www.ibm.com/developerworks/cn/xml/x-nmspccontext/
`static Element`	`getElement(Element element, String tagName)` 根据节点名获得第一个子节点
`static Element`	`getElementByXPath(String expression, Object source)` 通过XPath方式读取XML节点等信息 Xpath相关文章：https://www.ibm.com/developerworks/cn/xml/x-javaxpathapi.html
`static List<Element>`	`getElements(Element element, String tagName)` 根据节点名获得子节点列表
`static Node`	`getNodeByXPath(String expression, Object source)` 通过XPath方式读取XML节点等信息 Xpath相关文章：https://www.ibm.com/developerworks/cn/xml/x-javaxpathapi.html
`static NodeList`	`getNodeListByXPath(String expression, Object source)` 通过XPath方式读取XML的NodeList Xpath相关文章：https://www.ibm.com/developerworks/cn/xml/x-javaxpathapi.html
`static Document`	`getOwnerDocument(Node node)` 获取节点所在的Document
`static Element`	`getRootElement(Document doc)` 获得XML文档根节点
`static boolean`	`isElement(Node node)` 给定节点是否为`Element` 类型节点
`static Document`	`mapToXml(Map<?,?> data, String rootName)` 将Map转换为XML
`static Document`	`mapToXml(Map<?,?> data, String rootName, String namespace)` 将Map转换为XML
`static String`	`mapToXmlStr(Map<?,?> data)` 将Map转换为XML格式的字符串
`static String`	`mapToXmlStr(Map<?,?> data, boolean omitXmlDeclaration)` 将Map转换为XML格式的字符串
`static String`	`mapToXmlStr(Map<?,?> data, String rootName)` 将Map转换为XML格式的字符串
`static String`	`mapToXmlStr(Map<?,?> data, String rootName, String namespace)` 将Map转换为XML格式的字符串
`static String`	`mapToXmlStr(Map<?,?> data, String rootName, String namespace, boolean omitXmlDeclaration)` 将Map转换为XML格式的字符串
`static String`	`mapToXmlStr(Map<?,?> data, String rootName, String namespace, boolean isPretty, boolean omitXmlDeclaration)` 将Map转换为XML格式的字符串
`static String`	`mapToXmlStr(Map<?,?> data, String rootName, String namespace, String charset, boolean isPretty, boolean omitXmlDeclaration)` 将Map转换为XML格式的字符串
`static Document`	`parseXml(String xmlStr)` 将String类型的XML转换为XML文档
`static void`	`readBySax(File file, ContentHandler contentHandler)` 使用Sax方式读取指定的XML 如果用户传入的contentHandler为`DefaultHandler`，则其接口都会被处理
`static void`	`readBySax(InputSource source, ContentHandler contentHandler)` 使用Sax方式读取指定的XML 如果用户传入的contentHandler为`DefaultHandler`，则其接口都会被处理
`static void`	`readBySax(InputStream source, ContentHandler contentHandler)` 使用Sax方式读取指定的XML 如果用户传入的contentHandler为`DefaultHandler`，则其接口都会被处理
`static void`	`readBySax(Reader reader, ContentHandler contentHandler)` 使用Sax方式读取指定的XML 如果用户传入的contentHandler为`DefaultHandler`，则其接口都会被处理
`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`	`setNamespaceAware(boolean isNamespaceAware)` 设置是否打开命名空间支持，默认打开
`static void`	`toFile(Document doc, String absolutePath)` 将XML文档写入到文件使用Document中的编码
`static void`	`toFile(Document doc, String path, String charsetName)` 将XML文档写入到文件
`static String`	`toStr(Document doc)` 将XML文档转换为String 字符编码使用XML文档中的编码，获取不到则使用UTF-8 默认非格式化输出，若想格式化请使用`format(Document)`
`static String`	`toStr(Document doc, boolean isPretty)` 将XML文档转换为String 字符编码使用XML文档中的编码，获取不到则使用UTF-8
`static String`	`toStr(Document doc, String charset, boolean isPretty)` 将XML文档转换为String 字符编码使用XML文档中的编码，获取不到则使用UTF-8
`static String`	`toStr(Node doc)` 将XML文档转换为String 字符编码使用XML文档中的编码，获取不到则使用UTF-8 默认非格式化输出，若想格式化请使用`format(Document)`
`static String`	`toStr(Node doc, boolean isPretty)` 将XML文档转换为String 字符编码使用XML文档中的编码，获取不到则使用UTF-8
`static String`	`toStr(Node doc, String charset, boolean isPretty)` 将XML文档转换为String 字符编码使用XML文档中的编码，获取不到则使用UTF-8
`static String`	`toStr(Node doc, String charset, boolean isPretty, boolean omitXmlDeclaration)` 将XML文档转换为String 字符编码使用XML文档中的编码，获取不到则使用UTF-8
`static List<Element>`	`transElements(Element parentEle, NodeList nodeList)` 将NodeList转换为Element列表非Element节点将被忽略
`static List<Element>`	`transElements(NodeList nodeList)` 将NodeList转换为Element列表
`static void`	`transform(Source source, Result result, String charset, int indent)` 将XML文档写出格式化输出逻辑参考：https://stackoverflow.com/questions/139076/how-to-pretty-print-xml-from-java
`static void`	`transform(Source source, Result result, String charset, int indent, boolean omitXmlDeclaration)` 将XML文档写出格式化输出逻辑参考：https://stackoverflow.com/questions/139076/how-to-pretty-print-xml-from-java
`static String`	`unescape(String string)` 反转义XML特殊字符:
`static void`	`write(Node node, OutputStream out, String charset, int indent)` 将XML文档写出
`static void`	`write(Node node, OutputStream out, String charset, int indent, boolean omitXmlDeclaration)` 将XML文档写出
`static void`	`write(Node node, Writer writer, String charset, int indent)` 将XML文档写出
`static void`	`write(Node node, Writer writer, String charset, int indent, boolean omitXmlDeclaration)` 将XML文档写出
`static void`	`writeObjectAsXml(File dest, Object bean)` 将可序列化的对象转换为XML写入文件，已经存在的文件将被覆盖 Writes serializable object to a XML file.
`static <T> T`	`xmlToBean(Node node, Class<T> bean)` XML转Java Bean
`static Map<String,Object>`	`xmlToMap(Node node)` XML格式字符串转换为Map
`static Map<String,Object>`	`xmlToMap(Node node, Map<String,Object> result)` XML节点转换为Map
`static Map<String,Object>`	`xmlToMap(String xmlStr)` XML格式字符串转换为Map
`static Map<String,Object>`	`xmlToMap(String xmlStr, Map<String,Object> result)` XML格式字符串转换为Map 只支持第一级别的XML，不支持多级XML

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

- 字段详细资料
  - NBSP
```
public static final String NBSP
```
    字符串常量：XML 不间断空格转义 " " -> " "
    
    另请参阅:
    
    常量字段值
  - AMP
```
public static final String AMP
```
    字符串常量：XML And 符转义 "&" -> "&"
    
    另请参阅:
    
    常量字段值
  - QUOTE
```
public static final String QUOTE
```
    字符串常量：XML 双引号转义 """ -> "\""
    
    另请参阅:
    
    常量字段值
  - APOS
```
public static final String APOS
```
    字符串常量：XML 单引号转义 "&apos" -> "'"
    
    另请参阅:
    
    常量字段值
  - LT
```
public static final String LT
```
    字符串常量：XML 小于号转义 "<" -> "<"
    
    另请参阅:
    
    常量字段值
  - GT
```
public static final String GT
```
    字符串常量：XML 大于号转义 ">" -> ">"
    
    另请参阅:
    
    常量字段值
  - INVALID_REGEX
```
public static final String INVALID_REGEX
```
    在XML中无效的字符正则
    
    另请参阅:
    
    常量字段值
  - COMMENT_REGEX
```
public static final String COMMENT_REGEX
```
    在XML中注释的内容正则
    
    另请参阅:
    
    常量字段值
  - INDENT_DEFAULT
```
public static final int INDENT_DEFAULT
```
    XML格式化输出默认缩进量
    
    另请参阅:
    
    常量字段值
- 构造器详细资料
  - Xml
```
public Xml()
```
- 方法详细资料
  - disableDefaultDocumentBuilderFactory
```
public static void disableDefaultDocumentBuilderFactory()
```
    禁用默认的DocumentBuilderFactory，禁用后如果有第三方的实现（如oracle的xdb包中的xmlparse），将会自动加载实现。
  - setNamespaceAware
```
public static void setNamespaceAware(boolean isNamespaceAware)
```
    设置是否打开命名空间支持，默认打开
    
    参数:
    
    isNamespaceAware - 是否命名空间支持
  - readXML
```
public static Document readXML(@Nonnull
                               File file)
                        throws IOException
```
    读取解析XML文件
    
    参数:
    
    file - XML文件
    
    返回:
    
    XML文档对象
    
    抛出:
    
    IOException
  - readXML
```
public static Document readXML(@Nonnull
                               String pathOrContent)
                        throws IOException
```
    读取解析XML文件
    如果给定内容以“<”开头，表示这是一个XML内容，直接读取，否则按照路径处理
    路径可以为相对路径，也可以是绝对路径，相对路径相对于ClassPath
    
    参数:
    
    pathOrContent - 内容或路径
    
    返回:
    
    XML文档对象
    
    抛出:
    
    IOException
  - readXML
```
public static Document readXML(InputStream inputStream)
                        throws IOException
```
    读取解析XML文件
    编码在XML中定义
    
    参数:
    
    inputStream - XML流
    
    返回:
    
    XML文档对象
    
    抛出:
    
    IOException
  - readXML
```
public static Document readXML(Reader reader)
                        throws IOException
```
    读取解析XML文件
    
    参数:
    
    reader - XML流
    
    返回:
    
    XML文档对象
    
    抛出:
    
    IOException
  - readXML
```
public static Document readXML(InputSource source)
                        throws IOException
```
    读取解析XML文件
    编码在XML中定义
    
    参数:
    
    source - InputSource
    
    返回:
    
    XML文档对象
    
    抛出:
    
    IOException
  - readBySax
```
public static void readBySax(File file,
                             ContentHandler contentHandler)
                      throws IOException
```
    使用Sax方式读取指定的XML
    如果用户传入的contentHandler为DefaultHandler，则其接口都会被处理
    
    参数:
    
    file - XML源文件,使用后自动关闭
    
    contentHandler - XML流处理器，用于按照Element处理xml
    
    抛出:
    
    IOException
  - readBySax
```
public static void readBySax(Reader reader,
                             ContentHandler contentHandler)
                      throws IOException
```
    使用Sax方式读取指定的XML
    如果用户传入的contentHandler为DefaultHandler，则其接口都会被处理
    
    参数:
    
    reader - XML源Reader,使用后自动关闭
    
    contentHandler - XML流处理器，用于按照Element处理xml
    
    抛出:
    
    IOException
  - readBySax
```
public static void readBySax(InputStream source,
                             ContentHandler contentHandler)
                      throws IOException
```
    使用Sax方式读取指定的XML
    如果用户传入的contentHandler为DefaultHandler，则其接口都会被处理
    
    参数:
    
    source - XML源流,使用后自动关闭
    
    contentHandler - XML流处理器，用于按照Element处理xml
    
    抛出:
    
    IOException
  - readBySax
```
public static void readBySax(InputSource source,
                             ContentHandler contentHandler)
                      throws IOException
```
    使用Sax方式读取指定的XML
    如果用户传入的contentHandler为DefaultHandler，则其接口都会被处理
    
    参数:
    
    source - XML源，可以是文件、流、路径等
    
    contentHandler - XML流处理器，用于按照Element处理xml
    
    抛出:
    
    IOException
  - parseXml
```
public static Document parseXml(String xmlStr)
                         throws IOException
```
    将String类型的XML转换为XML文档
    
    参数:
    
    xmlStr - XML字符串
    
    返回:
    
    XML文档
    
    抛出:
    
    IOException
  - toStr
```
public static String toStr(Node doc)
                    throws IOException
```
    将XML文档转换为String
    字符编码使用XML文档中的编码，获取不到则使用UTF-8
    默认非格式化输出，若想格式化请使用format(Document)
    
    参数:
    
    doc - XML文档
    
    返回:
    
    XML字符串
    
    抛出:
    
    IOException
  - toStr
```
public static String toStr(Document doc)
                    throws IOException
```
    将XML文档转换为String
    字符编码使用XML文档中的编码，获取不到则使用UTF-8
    默认非格式化输出，若想格式化请使用format(Document)
    
    参数:
    
    doc - XML文档
    
    返回:
    
    XML字符串
    
    抛出:
    
    IOException
  - toStr
```
public static String toStr(Node doc,
                           boolean isPretty)
                    throws IOException
```
    将XML文档转换为String
    字符编码使用XML文档中的编码，获取不到则使用UTF-8
    
    参数:
    
    doc - XML文档
    
    isPretty - 是否格式化输出
    
    返回:
    
    XML字符串
    
    抛出:
    
    IOException
  - toStr
```
public static String toStr(Document doc,
                           boolean isPretty)
                    throws IOException
```
    将XML文档转换为String
    字符编码使用XML文档中的编码，获取不到则使用UTF-8
    
    参数:
    
    doc - XML文档
    
    isPretty - 是否格式化输出
    
    返回:
    
    XML字符串
    
    抛出:
    
    IOException
  - toStr
```
public static String toStr(Node doc,
                           String charset,
                           boolean isPretty)
                    throws IOException
```
    将XML文档转换为String
    字符编码使用XML文档中的编码，获取不到则使用UTF-8
    
    参数:
    
    doc - XML文档
    
    charset - 编码
    
    isPretty - 是否格式化输出
    
    返回:
    
    XML字符串
    
    抛出:
    
    IOException
  - toStr
```
public static String toStr(Document doc,
                           String charset,
                           boolean isPretty)
                    throws IOException
```
    将XML文档转换为String
    字符编码使用XML文档中的编码，获取不到则使用UTF-8
    
    参数:
    
    doc - XML文档
    
    charset - 编码
    
    isPretty - 是否格式化输出
    
    返回:
    
    XML字符串
    
    抛出:
    
    IOException
  - toStr
```
public static String toStr(Node doc,
                           String charset,
                           boolean isPretty,
                           boolean omitXmlDeclaration)
                    throws IOException
```
    将XML文档转换为String
    字符编码使用XML文档中的编码，获取不到则使用UTF-8
    
    参数:
    
    doc - XML文档
    
    charset - 编码
    
    isPretty - 是否格式化输出
    
    omitXmlDeclaration - 是否忽略 xml Declaration
    
    返回:
    
    XML字符串
    
    抛出:
    
    IOException
  - format
```
public static String format(Document doc)
                     throws IOException
```
    格式化XML输出
    
    参数:
    
    doc - Document XML文档
    
    返回:
    
    格式化后的XML字符串
    
    抛出:
    
    IOException
  - format
```
public static String format(String xmlStr)
                     throws IOException
```
    格式化XML输出
    
    参数:
    
    xmlStr - XML字符串
    
    返回:
    
    格式化后的XML字符串
    
    抛出:
    
    IOException
  - toFile
```
public static void toFile(Document doc,
                          String absolutePath)
                   throws IOException
```
    将XML文档写入到文件
    使用Document中的编码
    
    参数:
    
    doc - XML文档
    
    absolutePath - 文件绝对路径，不存在会自动创建
    
    抛出:
    
    IOException
  - toFile
```
public static void toFile(Document doc,
                          String path,
                          String charsetName)
                   throws IOException
```
    将XML文档写入到文件
    
    参数:
    
    doc - XML文档
    
    path - 文件路径
    
    charsetName - 自定义XML文件的编码，如果为null 读取XML文档中的编码，否则默认UTF-8
    
    抛出:
    
    IOException
  - write
```
public static void write(Node node,
                         Writer writer,
                         String charset,
                         int indent)
                  throws IOException
```
    将XML文档写出
    
    参数:
    
    node - Node XML文档节点或文档本身
    
    writer - 写出的Writer，Writer决定了输出XML的编码
    
    charset - 编码
    
    indent - 格式化输出中缩进量，小于1表示不格式化输出
    
    抛出:
    
    IOException
  - write
```
public static void write(Node node,
                         Writer writer,
                         String charset,
                         int indent,
                         boolean omitXmlDeclaration)
                  throws IOException
```
    将XML文档写出
    
    参数:
    
    node - Node XML文档节点或文档本身
    
    writer - 写出的Writer，Writer决定了输出XML的编码
    
    charset - 编码
    
    indent - 格式化输出中缩进量，小于1表示不格式化输出
    
    omitXmlDeclaration - 是否输出 xml Declaration
    
    抛出:
    
    IOException
  - write
```
public static void write(Node node,
                         OutputStream out,
                         String charset,
                         int indent)
                  throws IOException
```
    将XML文档写出
    
    参数:
    
    node - Node XML文档节点或文档本身
    
    out - 写出的Writer，Writer决定了输出XML的编码
    
    charset - 编码
    
    indent - 格式化输出中缩进量，小于1表示不格式化输出
    
    抛出:
    
    IOException
  - write
```
public static void write(Node node,
                         OutputStream out,
                         String charset,
                         int indent,
                         boolean omitXmlDeclaration)
                  throws IOException
```
    将XML文档写出
    
    参数:
    
    node - Node XML文档节点或文档本身
    
    out - 写出的Writer，Writer决定了输出XML的编码
    
    charset - 编码
    
    indent - 格式化输出中缩进量，小于1表示不格式化输出
    
    omitXmlDeclaration - 是否输出 xml Declaration
    
    抛出:
    
    IOException
  - transform
```
public static void transform(Source source,
                             Result result,
                             String charset,
                             int indent)
                      throws IOException
```
    将XML文档写出
    格式化输出逻辑参考：https://stackoverflow.com/questions/139076/how-to-pretty-print-xml-from-java
    
    参数:
    
    source - 源
    
    result - 目标
    
    charset - 编码
    
    indent - 格式化输出中缩进量，小于1表示不格式化输出
    
    抛出:
    
    IOException
  - transform
```
public static void transform(Source source,
                             Result result,
                             String charset,
                             int indent,
                             boolean omitXmlDeclaration)
                      throws IOException
```
    将XML文档写出
    格式化输出逻辑参考：https://stackoverflow.com/questions/139076/how-to-pretty-print-xml-from-java
    
    参数:
    
    source - 源
    
    result - 目标
    
    charset - 编码
    
    indent - 格式化输出中缩进量，小于1表示不格式化输出
    
    omitXmlDeclaration - 是否输出 xml Declaration
    
    抛出:
    
    IOException
  - createXml
```
public static Document createXml()
                          throws IOException
```
    创建XML文档
    创建的XML默认是utf8编码，修改编码的过程是在toStr和toFile方法里，即XML在转为文本的时候才定义编码
    
    返回:
    
    XML文档
    
    抛出:
    
    IOException
  - createDocumentBuilder
```
public static DocumentBuilder createDocumentBuilder()
                                             throws IOException
```
    创建 DocumentBuilder
    
    返回:
    
    DocumentBuilder
    
    抛出:
    
    IOException
  - createDocumentBuilderFactory
```
public static DocumentBuilderFactory createDocumentBuilderFactory()
```
    创建DocumentBuilderFactory
    默认使用"com.sun.org.apache.xerces.internal.jaxp.DocumentBuilderFactoryImpl"
    如果使用第三方实现，请调用disableDefaultDocumentBuilderFactory()
    
    返回:
    
    DocumentBuilderFactory
  - createXml
```
public static Document createXml(String rootElementName)
                          throws IOException
```
    创建XML文档
    创建的XML默认是utf8编码，修改编码的过程是在toStr和toFile方法里，即XML在转为文本的时候才定义编码
    
    参数:
    
    rootElementName - 根节点名称
    
    返回:
    
    XML文档
    
    抛出:
    
    IOException
  - createXml
```
public static Document createXml(String rootElementName,
                                 String namespace)
                          throws IOException
```
    创建XML文档
    创建的XML默认是utf8编码，修改编码的过程是在toStr和toFile方法里，即XML在转为文本的时候才定义编码
    
    参数:
    
    rootElementName - 根节点名称
    
    namespace - 命名空间，无则传null
    
    返回:
    
    XML文档
    
    抛出:
    
    IOException
  - getRootElement
```
public static Element getRootElement(Document doc)
```
    获得XML文档根节点
    
    参数:
    
    doc - Document
    
    返回:
    
    根节点
    
    另请参阅:
    
    Document.getDocumentElement()
  - getOwnerDocument
```
public static Document getOwnerDocument(Node node)
```
    获取节点所在的Document
    
    参数:
    
    node - 节点
    
    返回:
    
    Document
  - cleanInvalid
```
public static String cleanInvalid(String xmlContent)
```
    去除XML文本中的无效字符
    
    参数:
    
    xmlContent - XML文本
    
    返回:
    
    当传入为null时返回null
  - cleanComment
```
public static String cleanComment(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 - 父节点，如果指定将返回此节点的所有直接子节点，null返回所有就节点
    
    nodeList - NodeList
    
    返回:
    
    Element列表
  - writeObjectAsXml
```
public static void writeObjectAsXml(File dest,
                                    Object bean)
                             throws IOException
```
    将可序列化的对象转换为XML写入文件，已经存在的文件将被覆盖
    Writes serializable object to a XML file. Existing file will be overwritten
    
    参数:
    
    dest - 目标文件
    
    bean - 对象
    
    抛出:
    
    IOException
  - createXPath
```
public static XPath createXPath()
```
    创建XPath
    Xpath相关文章：https://www.ibm.com/developerworks/cn/xml/x-javaxpathapi.html
    
    返回:
    
    XPath
  - getElementByXPath
```
public static Element getElementByXPath(String expression,
                                        Object source)
                                 throws IOException
```
    通过XPath方式读取XML节点等信息
    Xpath相关文章：https://www.ibm.com/developerworks/cn/xml/x-javaxpathapi.html
    
    参数:
    
    expression - XPath表达式
    
    source - 资源，可以是Docunent、Node节点等
    
    返回:
    
    匹配返回类型的值
    
    抛出:
    
    IOException
  - getNodeListByXPath
```
public static NodeList getNodeListByXPath(String expression,
                                          Object source)
                                   throws IOException
```
    通过XPath方式读取XML的NodeList
    Xpath相关文章：https://www.ibm.com/developerworks/cn/xml/x-javaxpathapi.html
    
    参数:
    
    expression - XPath表达式
    
    source - 资源，可以是Docunent、Node节点等
    
    返回:
    
    NodeList
    
    抛出:
    
    IOException
  - getNodeByXPath
```
public static Node getNodeByXPath(String expression,
                                  Object source)
                           throws IOException
```
    通过XPath方式读取XML节点等信息
    Xpath相关文章：https://www.ibm.com/developerworks/cn/xml/x-javaxpathapi.html
    
    参数:
    
    expression - XPath表达式
    
    source - 资源，可以是Docunent、Node节点等
    
    返回:
    
    匹配返回类型的值
    
    抛出:
    
    IOException
  - getByXPath
```
public static Object getByXPath(String expression,
                                Object source,
                                QName returnType)
                         throws IOException
```
    通过XPath方式读取XML节点等信息
    Xpath相关文章：https://www.ibm.com/developerworks/cn/xml/x-javaxpathapi.html
    
    参数:
    
    expression - XPath表达式
    
    source - 资源，可以是Docunent、Node节点等
    
    returnType - 返回类型，XPathConstants
    
    返回:
    
    匹配返回类型的值
    
    抛出:
    
    IOException
  - getByXPath
```
public static Object getByXPath(String expression,
                                Object source,
                                QName returnType,
                                NamespaceContext nsContext)
                         throws IOException
```
    通过XPath方式读取XML节点等信息
    Xpath相关文章：
    https://www.ibm.com/developerworks/cn/xml/x-javaxpathapi.html
    https://www.ibm.com/developerworks/cn/xml/x-nmspccontext/
    
    参数:
    
    expression - XPath表达式
    
    source - 资源，可以是Docunent、Node节点等
    
    returnType - 返回类型，XPathConstants
    
    nsContext - NamespaceContext
    
    返回:
    
    匹配返回类型的值
    
    抛出:
    
    IOException
  - escape
```
public static String escape(String string)
```
    转义XML特殊字符:
```
 & (ampersand) 替换为 &amp;
 < (小于) 替换为 &lt;
 > (大于) 替换为 &gt;
 " (双引号) 替换为 &quot;
 
```
    参数:
    
    string - 被替换的字符串
    
    返回:
    
    替换后的字符串
  - unescape
```
public static String unescape(String string)
```
    反转义XML特殊字符:
    
    参数:
    
    string - 被替换的字符串
    
    返回:
    
    替换后的字符串
  - xmlToMap
```
public static Map<String,Object> xmlToMap(String xmlStr)
                                   throws IOException
```
    XML格式字符串转换为Map
    
    参数:
    
    xmlStr - XML字符串
    
    返回:
    
    XML数据转换后的Map
    
    抛出:
    
    IOException
  - xmlToBean
```
public static <T> T xmlToBean(Node node,
                              Class<T> bean)
```
    XML转Java Bean
    
    类型参数:
    
    T - bean类型
    
    参数:
    
    node - XML节点
    
    bean - bean类
    
    返回:
    
    bean
  - xmlToMap
```
public static Map<String,Object> xmlToMap(Node node)
```
    XML格式字符串转换为Map
    
    参数:
    
    node - XML节点
    
    返回:
    
    XML数据转换后的Map
  - xmlToMap
```
public static Map<String,Object> xmlToMap(String xmlStr,
                                          Map<String,Object> result)
                                   throws IOException
```
    XML格式字符串转换为Map
    只支持第一级别的XML，不支持多级XML
    
    参数:
    
    xmlStr - XML字符串
    
    result - 结果Map类型
    
    返回:
    
    XML数据转换后的Map
    
    抛出:
    
    IOException
  - xmlToMap
```
public static Map<String,Object> xmlToMap(Node node,
                                          Map<String,Object> result)
```
    XML节点转换为Map
    
    参数:
    
    node - XML节点
    
    result - 结果Map类型
    
    返回:
    
    XML数据转换后的Map
  - mapToXmlStr
```
public static String mapToXmlStr(Map<?,?> data)
                          throws IOException
```
    将Map转换为XML格式的字符串
    
    参数:
    
    data - Map类型数据
    
    返回:
    
    XML格式的字符串
    
    抛出:
    
    IOException
  - mapToXmlStr
```
public static String mapToXmlStr(Map<?,?> data,
                                 boolean omitXmlDeclaration)
                          throws IOException
```
    将Map转换为XML格式的字符串
    
    参数:
    
    data - Map类型数据
    
    omitXmlDeclaration - 是否输出 xml Declaration
    
    返回:
    
    XML格式的字符串
    
    抛出:
    
    IOException
  - mapToXmlStr
```
public static String mapToXmlStr(Map<?,?> data,
                                 String rootName)
                          throws IOException
```
    将Map转换为XML格式的字符串
    
    参数:
    
    data - Map类型数据
    
    rootName - 根节点名
    
    返回:
    
    XML格式的字符串
    
    抛出:
    
    IOException
  - mapToXmlStr
```
public static String mapToXmlStr(Map<?,?> data,
                                 String rootName,
                                 String namespace)
                          throws IOException
```
    将Map转换为XML格式的字符串
    
    参数:
    
    data - Map类型数据
    
    rootName - 根节点名
    
    namespace - 命名空间，可以为null
    
    返回:
    
    XML格式的字符串
    
    抛出:
    
    IOException
  - mapToXmlStr
```
public static String mapToXmlStr(Map<?,?> data,
                                 String rootName,
                                 String namespace,
                                 boolean omitXmlDeclaration)
                          throws IOException
```
    将Map转换为XML格式的字符串
    
    参数:
    
    data - Map类型数据
    
    rootName - 根节点名
    
    namespace - 命名空间，可以为null
    
    omitXmlDeclaration - 是否输出 xml Declaration
    
    返回:
    
    XML格式的字符串
    
    抛出:
    
    IOException
  - mapToXmlStr
```
public static String mapToXmlStr(Map<?,?> data,
                                 String rootName,
                                 String namespace,
                                 boolean isPretty,
                                 boolean omitXmlDeclaration)
                          throws IOException
```
    将Map转换为XML格式的字符串
    
    参数:
    
    data - Map类型数据
    
    rootName - 根节点名
    
    namespace - 命名空间，可以为null
    
    isPretty - 是否格式化输出
    
    omitXmlDeclaration - 是否输出 xml Declaration
    
    返回:
    
    XML格式的字符串
    
    抛出:
    
    IOException
  - mapToXmlStr
```
public static String mapToXmlStr(Map<?,?> data,
                                 String rootName,
                                 String namespace,
                                 String charset,
                                 boolean isPretty,
                                 boolean omitXmlDeclaration)
                          throws IOException
```
    将Map转换为XML格式的字符串
    
    参数:
    
    data - Map类型数据
    
    rootName - 根节点名
    
    namespace - 命名空间，可以为null
    
    charset - 编码
    
    isPretty - 是否格式化输出
    
    omitXmlDeclaration - 是否输出 xml Declaration
    
    返回:
    
    XML格式的字符串
    
    抛出:
    
    IOException
  - mapToXml
```
public static Document mapToXml(Map<?,?> data,
                                String rootName)
                         throws IOException
```
    将Map转换为XML
    
    参数:
    
    data - Map类型数据
    
    rootName - 根节点名
    
    返回:
    
    XML
    
    抛出:
    
    IOException
  - mapToXml
```
public static Document mapToXml(Map<?,?> data,
                                String rootName,
                                String namespace)
                         throws IOException
```
    将Map转换为XML
    
    参数:
    
    data - Map类型数据
    
    rootName - 根节点名
    
    namespace - 命名空间，可以为null
    
    返回:
    
    XML
    
    抛出:
    
    IOException
  - beanToXml
```
public static Document beanToXml(Object bean)
                          throws IOException
```
    将Bean转换为XML
    
    参数:
    
    bean - Bean对象
    
    返回:
    
    XML
    
    抛出:
    
    IOException
  - beanToXml
```
public static Document beanToXml(Object bean,
                                 String namespace)
                          throws IOException
```
    将Bean转换为XML
    
    参数:
    
    bean - Bean对象
    
    namespace - 命名空间，可以为null
    
    返回:
    
    XML
    
    抛出:
    
    IOException
  - beanToXml
```
public static Document beanToXml(Object bean,
                                 String namespace,
                                 boolean ignoreNull)
                          throws IOException
```
    将Bean转换为XML
    
    参数:
    
    bean - Bean对象
    
    namespace - 命名空间，可以为null
    
    ignoreNull - 忽略值为null的属性
    
    返回:
    
    XML
    
    抛出:
    
    IOException
  - isElement
```
public static boolean isElement(Node node)
```
    给定节点是否为Element 类型节点
    
    参数:
    
    node - 节点
    
    返回:
    
    是否为Element 类型节点
  - appendChild
```
public static Element appendChild(Node node,
                                  String tagName)
```
    在已有节点上创建子节点
    
    参数:
    
    node - 节点
    
    tagName - 标签名
    
    返回:
    
    子节点
  - appendChild
```
public static Element appendChild(Node node,
                                  String tagName,
                                  String namespace)
```
    在已有节点上创建子节点
    
    参数:
    
    node - 节点
    
    tagName - 标签名
    
    namespace - 命名空间，无传null
    
    返回:
    
    子节点
  - appendText
```
public static Node appendText(Node node,
                              CharSequence text)
```
    创建文本子节点
    
    参数:
    
    node - 节点
    
    text - 文本
    
    返回:
    
    子节点
  - append
```
public static void append(Node node,
                          Object data)
```
    追加数据子节点，可以是Map、集合、文本
    
    参数:
    
    node - 节点
    
    data - 数据

类 Xml

嵌套类概要

字段概要

构造器概要

方法概要

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

字段详细资料

NBSP

AMP

QUOTE

APOS

LT

GT

INVALID_REGEX

COMMENT_REGEX

INDENT_DEFAULT

构造器详细资料

Xml

方法详细资料

disableDefaultDocumentBuilderFactory

setNamespaceAware

readXML

readXML

readXML

readXML

readXML

readBySax

readBySax

readBySax

readBySax

parseXml

toStr

toStr

toStr

toStr

toStr

toStr

toStr

format

format

toFile

toFile

write

write

write

write

transform

transform

createXml

createDocumentBuilder

createDocumentBuilderFactory

createXml

createXml

getRootElement

getOwnerDocument

cleanInvalid

cleanComment

getElements

getElement

elementText

elementText

transElements

transElements

writeObjectAsXml

createXPath

getElementByXPath

getNodeListByXPath

getNodeByXPath

getByXPath

getByXPath

escape

unescape

xmlToMap

xmlToBean

xmlToMap

xmlToMap

xmlToMap

mapToXmlStr

mapToXmlStr

mapToXmlStr