第十四章 XML获取当前节点信息

DOM节点类型

%XML.Document和%XML.Node类识别以下DOM节点类型：

Element ($$$xmlELEMENTNODE)

请注意，这些宏在%xml.DOM.inc包含文件中定义。

Text ($$$xmlTEXTNODE)
Whitespace ($$$xmlWHITESPACENODE).

其他类型的DOM节点被简单地忽略。

请以下XML文档：

<?xml version="1.0"?>
<team>
<member id="alpha">Jack O'Neill</member>
<member id="beta">Samantha Carter</member>
<member id="gamma">Daniel Jackson</member>
</team>

当作为DOM查看时，该文档由以下节点组成：

文档节点示例

NodeID	NodeType	LocalName	Notes
0,29	`$$$xmlELEMENTNODE`	team
1,29	`$$$xmlWHITESPACENODE`		该节点是`<team>`节点的子节点
1,23	`$$$xmlELEMENTNODE`	member	该节点是`<team>`节点的子节点
2,45	`$$$xmlTEXTNODE`	Jack O'Neill	该节点是第一个`<member>`节点的子节点
1,37	`$$$xmlWHITESPACENODE`		该节点是`<team>`节点的子节点
1,41	`$$$xmlELEMENTNODE`	member	该节点是`<team>`节点的子节点
3,45	`$$$xmlTEXTNODE`	Samantha Carter	该节点是第二个`<member>`节点的子节点
1,45	`$$$xmlWHITESPACENODE`		该节点是`<team>`节点的子节点
1,49	`$$$xmlELEMENTNODE`	member	该节点是`<team>`节点的子节点
4,45	`$$$xmlTEXTNODE`	Daniel Jackson	该节点是第三个`<member>`节点的子节点
1,53	`$$$xmlWHITESPACENODE`		该节点是`<team>`节点的子节点

获取当前节点信息

%XML.Node的以下字符串属性。提供关于当前节点的信息。
在所有情况下，如果没有当前节点，将抛出一个错误。

LocalName

当前元素节点的本地名称。如果访问其他类型节点的此属性，则会引发错误。

Namespace

当前元素节点的命名空间URI。如果尝试访问其他类型节点的此属性，则会引发错误。

NamespaceIndex

当前元素节点的命名空间的索引。

当InterSystems IRIS读取XML文档并创建DOM时，它会标识文档中使用的所有名称空间，并为每个名称空间分配一个索引号。

如果尝试访问其他类型节点的此属性，则会引发错误。

Nil

如果xsi：nil或xsi：null为true，则等于true；如果此元素节点为1，则等于1。否则，此属性等于False。

NodeData

字符节点的值。

NodeId

当前节点ID。
可以设置此属性以导航到另一个节点。

NodeType

当前节点的类型，如前一节所述。

QName

元素节点的Q名称。仅当前缀对文档有效时才用于输出为XML。

以下方法提供有关当前节点的其他信息：

GetText()

method GetText(ByRef text) as %Boolean

获取元素节点的文本内容。如果返回文本，则此方法返回TRUE；在本例中，实际文本被追加到第一个参数后，该参数通过引用返回。

HasChildNodes()

method HasChildNodes(skipWhitespace As %Boolean = 0) as %Boolean

如果当前节点有子节点，则返回True；否则返回False。

GetNumberAttributes()

method GetNumberAttributes() as %Integer

方法GetNumberAttributes()为%Integer

示例

下面的示例方法编写一个报告，提供有关当前节点的信息：

ClassMethod ShowNode(node As %XML.Node)
{
    w !,"LocalName=" _ node.LocalName
    if node.NodeType=$$$xmlELEMENTNODE  {
        w !,"Namespace=" _ node.Namespace
    }
    if node.NodeType = $$$xmlELEMENTNODE {
        w !,"NamespaceIndex=" _ node.NamespaceIndex
    }
    w !,"Nil=" _ node.Nil
    w !,"NodeData=" _ node.NodeData
    w !,"NodeId=" _ node.NodeId
    w !,"NodeType=" _ node.NodeType
    w !,"QName=" _ node.QName
    w !,"HasChildNodes returns " _ node.HasChildNodes()
    w !,"GetNumberAttributes returns " _ node.GetNumberAttributes()
    s status = node.GetText(.text)
    if status {
        w !, "该节点的文本为 "_text
    } else {
        w !, "GetText不返回文本"
    }
}

示例输出可能如下所示：

LocalName=update
Namespace=
NamespaceIndex=
Nil=0
NodeData=update
NodeId=0,29
NodeType=0
QName=update
HasChildNodes returns 1
GetNumberAttributes returns 0
GetText不返回文本
文档中的命名空间数: 1
Namespace 1 is http://www.w3.org/2001/XMLSchema-instance

DHC-APP>