【xml_Class、xmlElementNode_Class 类】使用说明

xml_Class、xmlElementNode_Class这两个类是针对XML相关操作的类。

1、xml_Class类是针对XML文档操作的类

目录：

类型	原型	参数	返回	说明
Sub	Sub [obj].init(byVal param)	param [DOMDocument | XMLString | filePath] 参数类型可以是：DOMDocument实例、xml结构的字符串、XML文件的相对路径	-	初始化实例（可以使用DOMDocument实例 或者 xml结构的字符串 或者 XML文件的相对路径初始化类实例） 初始化出错时，输出错误！ 该过程整合了loadFile、loadXML、loadDocument三种过程。
Sub	Sub [obj].loadFile(byVal filePath)	filePath [String] XML文件的相对路径	-	用XML文件初始化类对象。初始化出错时，输出错误！
Sub	Sub [obj].loadXml(byVal xmlString)	xmlString [String] XML格式字符串(必须含有根节点)	-	用XML字符串初始化类对象。初始化出错时，输出错误！
Sub	Sub [obj].loadDocument(byVal DOMDocument)	DOMDocument [DOMDocument] XML的原生态文档对象	-	用DOMDocument实例初始化类对象。初始化出错时，输出错误！
属性	[obj].format = [True | False]	-	-	保存文件时是否格式化当前XML字符样式，默认值false
属性	Get [obj].xmlDoc	-	[DOMDocument]	获取实例的DOMDocument对象
属性	Get [obj].root	-	[xmlElementNode]	获取当前文档根节点的xmlElementNode实例
属性	Get [obj].getNode(byVal xPath)	-	[xmlElementNode | Nothing]	获取xPath匹配的第一个元素的xmlElementNode实例
属性	Get [obj].getNodes(byVal xPath)	-	[Array( xmlElementNode, xmlElementNode, ... )]	获取xPath匹配的所有元素的xmlElementNode实例数组
属性	Get item(byVal level, byVal index)	-	[xmlElementNode | Nothing]	获取指定级别、索引值的元素的xmlElementNode实例
方法	Function createNode(byVal nodeName, byVal nodeValue)	nodeName [String] 节点元素名称 nodeValue [String] 节点元素内容	[IXMLDOMElement] XML原生态节点元素实例	创建一个元素节点对象（此时并没有插入到类实例中,返回的对象供原生态的xml操作需要，这里做扩展）
方法	Function createCDATA(byVal text)	text [String] CDATA内容	[IXMLDOMCDATASection] XML原生态CDATA元素实例	创建一个CDATA节点对象（此时并没有插入到类实例中,返回的对象供原生态的xml操作需要，这里做扩展）
方法	Function createComment(byVal text)	text [String] 注释文本	[IXMLDOMComment] XML原生态注释元素实例	创建一个注释节点对象（此时并没有插入到类实例中,返回的对象供原生态的xml操作需要，这里做扩展）
方法	Function createAttr(byVal attrName, byVal attrValue)	attrName [String] 属性名 attrValue [String] 属性值	[IXMLDOMAttribute] XML原生态属性元素实例	创建一个属性对象（此时并没有插入到类实例中,返回的对象供原生态的xml操作需要，这里做扩展）
方法	Function checkXML(byVal xmlString)	xmlString [String] 待检测字符串	[Array] Array(0) [True | False] 检测结果 Array(1) [Empty | 错误描述]	检查字符串是否符合XML格式（必须含有根节点，注意含有&字符是不符合XML格式）
方法	Function checkXMLString(byVal xmlString)	xmlString [String] 待检测字符串	[Array] Array(0) [True | False] 检测结果 Array(1) [Empty | 错误描述]	检查字符串是否符合XML字符串格式（可以不包含有根节点的XML字符串，注意含有&字符是不符合XML格式）
过程	Sub save(byVal path)	path [String] 相对路径	-	将当前xml文档保存成文件

2、xmlElementNode_Class类是针对XML节点操作的类

目录:

类型	原型	参数	返回	说明
属性	[obj].format = [True | False]	-	-	保存节点或者输出XML字符串时，是否格式化XML样式
属性	Get [obj].node	-	[IXMLDOMElement]	获取当前节点的XML原生态实例
属性	Get [obj].xmlDoc	-	[IXMLDOMElement]	获取当前节点的XML原生态文档对象实例
属性	Get xmlClass()	-	[xml_Class]	获取当前节点所在文档的xml_Class实例
属性	Get name()	-	[String]	获取当前节点名称
属性	Get root()	-	[xmlElementNode]	获取节点所在文档的根元素的xmlElementNode实例
属性	Get parent()	-	[xmlElementNode | Nothing]	获取节点的父节点的xmlElementNode实例
属性	Get index()	-	[Number]	获取此节点在同胞节点中的索引值,值是>=0的整数
属性	Get level()	-	[Number]	获取此节点在xml树的所在级别值,值是>=1的整数
属性	Get xml()	-	[String]	获取节点的所有字符内容（节点名称+子节点）
属性	Get html()	-	[String]	返回节点内容（不包含节点本身）
属性	Get cdata()	-	[String | Empty]	返回节点第一个CDATA内容
属性	Get text()	-	[String]	返回节点去掉HTML标记的内容
属性	Get childNodeNums(byVal nodeTypeValue)	nodeTypeValue [Number] 节点类型 nodeTypeValue = 0 所有子节点数量 nodeTypeValue = 1 元素子节点数量 nodeTypeValue = 3 文本子节点数量 nodeTypeValue = 4 CDATA子节点数量 nodeTypeValue = 8 注释子节点数量	[Number] >=0的整数	返回当前节点下指定类型的子节点数量（第一级子节点，不含子节点的子节点）
属性	Get clone(byVal includeChind)	includeChind [True | False] 值true表示克隆时包含子节点	[xmlElementNode]	克隆当前节点
属性	Get attrNums()	-	[Number] >=0的整数	返回当前节点的属性数量
属性	Get attr(byVal attrName)	-	[String | Empty]	获取节点属性值
属性	Get arrAttr()	-	[Array( Array(attrName, attrValue), Array(attrName, attrValue) ... )]	获取当前节点的属性数组
属性	Get sibling(byval index)	index [Number] 兄弟节点所在序号值 index = 0 表示获取第一个兄弟节点 index = -1 表示获取最后一个兄弟节点	[xmlElementNode | Nothing]	获取当前节点的兄弟节点（只针对元素节点）
属性	Get preNode()	-	[xmlElementNode | Nothing]	获取当前节点的前一个节点实例
属性	Get nextNode()	-	[xmlElementNode | Nothing]	获取当前节点的后一个节点实例
属性	Get getNode(byVal xPath)	xPath [String]	[xmlElementNode | Nothing]	获取当前节点下xPath匹配的第一个元素
属性	Get getNodes(byVal xPath)	xPath [String]	Array(xmlElementNode, xmlElementNode, xmlElementNode, ...)	获取当前节点下xPath匹配的所有元素
属性	Get getChilds()	-	Array(xmlElementNode, xmlElementNode, xmlElementNode, ...)	获取当前实例下第一级元素子节点实例
属性	Get toJson(byVal method)	method [0|1] method = 0 表示仅将节点值转换成JSON实例 method = 1 表示包括节点一起转换成JSON实例	[JSON]	将当前节点转换成json格式数据
属性	Get toJsonString(byVal method)	method [0|1] method = 0 表示转换成字符串时不包含根节点信息 method = 1 表示连同根节点信息一并转换成字符串	[String]	将当前节点转换成json字符串 1、属性转换采用:  "@attrName" = "attrVaule" 2、混合XML结构时，文本转换采用: "#text" = "text"，比如： <sample long="100">1234</sample> 转换结果：{ "sample":{ "@long" : 100, "#text" : 1234 }} 3、忽略注释节点，将文本节点与CDATA合并，用\n分隔，比如： <sample><title>123456<!--这是一个注释-->abc</title></sample> 转换结果： { "sample":{ "title" : "123456\nabc" } } 4、同名元素（不区分大小写）子节点，转换成数组，键名强制变成小写，比如： <dl><dd>星期一</dd><dd>星期二</dd><dd>星期三</dd></dl> 转换结果： { "dl" : { "dd" : ["星期一", "星期二", "星期三"] } }
属性	[obj].html = [xmlString]	-	-	用一个XML格式字符串设置当前节点内容
属性	[obj].name = [String]	-	-	重命名当前节点名称
属性	[obj].text = [String]	-	-	设置当前节点的内容
属性	[obj].attr("[attrName]") = [attrValue]	-	-	添加或修改节点属性值
过程	Sub init(byVal param)	param [String] xml格式字符串，或者xml文件路径	-	用XML字符串或者XML文件来初始化节点实例
过程	Sub initNode(byVal docIndex, byVal xPath)	docIndex [Number] 当前实例位于全局变量public_array_xmlDoc的索引值 xPath [xPath] 当前实例位于XML文档中的路径	-	初始化当前节点实例
过程	Sub removeAttr(byVal attrName)	attrName [String] 属性名称	-	移除节点属性
过程	Sub removeAllAttr()	-	-	移除节点所有属性
过程	Sub appendAttr(byVal attrObj)	attrObj [IXMLDOMElement] XML原生态元素节点实例	-	用xml_Class.createAttr(byVal attrName, byVal attrValue)创建的属性对象添加新属性
过程	Sub remove()	-	-	将当前节点从对应的xmlDoc中移除
过程	Sub removeChild(byVal xPath)	xPath [String]	-	移除xPath匹配的第一个元素节点
过程	Sub removeChilds(byVal xPath)	xPath [String]	-	移除xPath匹配的所有元素节点
过程	Sub append(byVal xmlString)	xmlString [String] xmlString有两种形式： 1) 含有根节点的xml字符串：    此时追加成功之后，后面的操作不影响，格式：<a>aaaaa</a> 2) 不含根节点的xml字符串：   由于采用html追加方式，所以后面的操作会受到影响: 格式： <a>1</a><a>2</a>	-	在当前节点下追加xml内容
过程	Sub insertBefore(byVal xmlString)	xmlString [String]	-	在当前节点前插入xml字符串内容(根节点前插入时不提示出错，但插入不成功！)
过程	Sub insertLater(byVal xmlString)	xmlString [String]	-	在当前节点后插入xml字符串内容(根节点前插入时不提示出错，但插入不成功！)
过程	Sub reSet(byVal xmlString)	xmlString [String]	-	重置当前节点结构，包括当前节点名称、属性、子节点。
过程	Sub save(byVal path)	path [String] 保存相对路径	-	将当前节点保存到文件内