学步园

XML文档是用来组织和展示有结构的数据的文档格式，Matlab本身有两个函数支持对XML文档的读取和写入，使用起来很方便，没有难度；难度在于如何使用函数返回的变量。两个XML读写的函数是：xmlread，xmlwrite。这两个函数是基于DOM（Document Object Model）的，xmlread的输出变量和xmlwrite的输入变量都是DOM的node。DOM是一种基于Java的对象，对象都是有属性和方法的，本篇文章主要是介绍这些属性和方法，在介绍之前，先介绍下两个函数的使用方法，再具体介绍DOM的相关细节。

1 XML的读写

语法：

DOMnode= xmlread(filename)

str = xmlwrite(DOMnode)

xmlwrite(filename,DOMnode)

通过其语法规则可以很方便的读写XML，但是要进一步使用读入的结果，就要进一步了解DOM的细节。

2 XML DOM

在DOM中，XML中的每个元素都被看做一个节点（node），访问该节点的属性和方法服从一定的标准，将在下一节讲到。下面通过实例来说明节点的类型：

<productinfo
  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
  xsi:noNamespaceSchemaLocation="http://www.mathworks.com/namespace/info/v1/info.xsd">

<!-- This is a sample info.xml file. -->

<list>

<listitem>
<label>Import Wizard</label>
<callback>uiimport</callback>
<icon>ApplicationIcon.GENERIC_GUI</icon>
</listitem>

<listitem>
<label>Profiler</label>
<callback>profile viewer</callback>
<icon>ApplicationIcon.PROFILER</icon>
</listitem>

</list>
</productinfo>

（1）Element nodes： 对应于标签（tag）的名称。如上例中的productinfo、list、listitem、label、callback、icon。

（2）Text nodes：element nodes中所包含的value。如上例中第一个element node label所包含的“ Import
Wizard”，即是一个text node。

（3）Attribute nodes：标签的一对前括号中所包含的名字和值。如上例中的“xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance”，xmlns：xsi是该attribute
node的名字，http://www.w3.org/2001/XMLSchema-instance是该node的值。

（4）Comment nodes：xml文档中其他的文本，如<!-- This is a sample info.xml file. -->

（5）Document nodes：对应整个xml文档，这种节点可以产生新的、以上所有的节点。

3 DOM的属性与方法

    DOM中包含了不同的接口对象，用以描述不同的数据，摘要如下：

由于DOM对象太多，只简单介绍常用的几种，其余可以参考文献3。

（1）Node对象（继承自DOM的最原始的Parent：IIOMetadataNode）是整个DOM的superinterface，很多对象都是从Node继承而来，包含了Node的基本属性（Field）和方法（method）：

Field:

• static shrot COMMENT_NODE : 表示Comment node
• static shrot DOCUMENT_NODE:表示Document node
  
• static shrot ELEMENT_NODE:    表示Element node
  
• static shrot TEXT_NODE:            表示Text node
  

Method:

• Node  getFirstChild()：  得到该节点的第一个child，返回类型为Node
• Node  getLastChild()：  得到该节点的最后一个child，返回类型为Node
• String getNodeName()：获取节点名字，返回类型为string
• short  getNodeType()： 获取该节点的类型
• String getTextContent()： 获取该节点下包括的所有Text节点的value
• boolean hasAttributes()： 检查该节点（必须是Element node）是否有属性
• boolean hasChildNodes() 检车该节点是否有子节点

（2）Document对象（继承自Node）用来表示整个文档，是整个xml文档树形结构的根节点（root），提供了访问给文档的入口，是xmlread返回的对象类型：

• DocumentType getDoctype(): 返回DTD定义的文档类型
• NodeList    getElementsByTagName(String tagname): 返回所有标签名字是tagname的Element nodes

（3）NodeList对象（继承自DOM的最原始的Parent：IIOMetadataNode）包含多个nodes，相当于一种容器：

• int  getLength():NodeList列表中Nodes的数目
• Node item(int index):返回第index个node，从0开始计数

4 范例

function theStruct = parseXML(filename)
% PARSEXML Convert XML file to a MATLAB structure.
try
   tree = xmlread(filename);
catch
   error('Failed to read XML file %s.',filename);
end

% Recurse over child nodes. This could run into problems 
% with very deeply nested trees.
try
   theStruct = parseChildNodes(tree);
catch
   error('Unable to parse XML file %s.',filename);
end


% ----- Subfunction PARSECHILDNODES -----
function children = parseChildNodes(theNode)
% Recurse over node children.
children = [];
if theNode.hasChildNodes
   childNodes = theNode.getChildNodes;
   numChildNodes = childNodes.getLength;
   allocCell = cell(1, numChildNodes);

   children = struct(             ...
      'Name', allocCell, 'Attributes', allocCell,    ...
      'Data', allocCell, 'Children', allocCell);

    for count = 1:numChildNodes
        theChild = childNodes.item(count-1);
        children(count) = makeStructFromNode(theChild);
    end
end

% ----- Subfunction MAKESTRUCTFROMNODE -----
function nodeStruct = makeStructFromNode(theNode)
% Create structure of node info.

nodeStruct = struct(                        ...
   'Name', char(theNode.getNodeName),       ...
   'Attributes', parseAttributes(theNode),  ...
   'Data', '',                              ...
   'Children', parseChildNodes(theNode));

if any(strcmp(methods(theNode), 'getData'))
   nodeStruct.Data = char(theNode.getData); 
else
   nodeStruct.Data = '';
end

% ----- Subfunction PARSEATTRIBUTES -----
function attributes = parseAttributes(theNode)
% Create attributes structure.

attributes = [];
if theNode.hasAttributes
   theAttributes = theNode.getAttributes;
   numAttributes = theAttributes.getLength;
   allocCell = cell(1, numAttributes);
   attributes = struct('Name', allocCell, 'Value', ...
                       allocCell);

   for count = 1:numAttributes
      attrib = theAttributes.item(count-1);
      attributes(count).Name = char(attrib.getName);
      attributes(count).Value = char(attrib.getValue);
   end
end

参考：

    1 matlab help

    2 http://www.academictutorials.com/xml-dom/xmldom-introduction.asp

    3 http://download.oracle.com/javase/6/docs/api/