分类： Python/Ruby
2009-06-27 01:12:44
（这是07年刚刚进公司刚刚学习Python时写的学习笔记。）
1 xml规则概述
以下是一个博客网站的xml的例子：
http://blog.xxx.com
http://blog.xxx.com/e_42678.html
http://blog.xxx.com/e_39749.html
其中，第一行为文档声明，它向解析器提供了关于文档的基本信息。建议使用 XML 声明，但它不是必需的。如果有的话，那么它一定是文档的第一样东
西。
声明最多可以包含三个名称-值对。version 是使用的 XML 版本；目前该值必须是 1.0。encoding
是该文档所使用的字符集。如没有指定 encoding，XML 解析器会假定字符在 UTF-8
字符集中。最后，还有一个standalone（可以是 yes 或 no）
定义了是否可以在不读取任何其它文件的情况下处理该文档。例如，如果 XML 文档没有引用任何其它文件，则可以指定standalone="yes"。如果 XML 文档引用其它描述该文档的文件，则可以指定 standalone="no"。
standalone="no" 是缺省值。
例：
接下来，定义了xml文档的根元素，一个xml文档必须包含在一个单一的根元素中，在本例中元素标签名为rss，它包含文档中所有文本和所有其它元
素。version是rss元素的一个属性，其值为字符串"2.0"。属性必须有用引号括起的值，可以是单引号或双引号。是rss元素结束
标志，每个元素的结束标记是必须的。如果元素没有子节点，可以结束标记和开始标记合二为一：
xml元素不能重叠，xml区分大小写。
三种 XML 文档：
* 无效文档没有遵守 XML 规范定义的语法规则。如果开发人员已经在 DTD 或模式中定义了文档能够包含什么，而某个文档没有遵守那些规
则，那么这个文档也是无效的。（请参阅定义文档内容以获得对 XML 文档 的 DTD 和模式的专门介绍。）
* 有效文档既遵守 XML 语法规则也遵守在其 DTD 或模式中定义的规则。
* 格式良好的文档遵守 XML 语法，但没有 DTD 或模式。
2 解析器种类
要让计算机读懂xml文档，就需要解析器(parser)。
有不同的方法来划分解析器种类：
1.验证或非验证解析器
2.支持 Document Object Model (DOM) 的解析器
3.支持 Simple API for XML (SAX) 的解析器
4.特定语言编写的解析器 (Java, C++, Perl 等)
如我们在前面所提及的，XML 文档如果使用一个 DTD 并符合 DTD中的规则将被称为有效文档(valid
document)。符合基本标记规则的 XML 文档被称为格式正确文档(well-formed document)。XML
规范要求所有的解析器当其发现一个文档不是格式正确时要报错。
验证解析器(Validating parser)在解析 XML
文档同时进行验证（检查是否是有效文档）。非验证解析器(Non-validating parser) 忽略所有的验证错误。换而言之，如果一个
XML 文档是格式正确的时，一个非验证解析器并不关注文档是否符合其对应 DTD 所指定的规则(如果有的话)。
文档对象模型(Document Object Model)是 World Wide Web Consortium(W3C)的正式推荐。它定义了一个接口使得程序可以存取和更新 XML 文档的风格、结构和内容。支持 DOM 的 XML 解析器实现该接口。
一个 DOM 的解析器在解析一个 XML 文档时，一次性读取整个文档，把文档中所有元素保存在内存中的一个树结构里，之后你可以利用DOM 提供的不同的函数来读取或修改文档的内容和结构，也可以把修改过的内容写入xml文件。
SAX API 是另一种处理 XML 文档内容的方法。一个既成事实的标准，它由David Megginson 和 XML-Dev 邮件列表
其它成员所开发。不同于DOM，SAX不是一次性读取整个文档，而是以数据流的形式处理文档，解析器在文档的不同处将产生事件。由您来决定对每个事件如
何处理。
DOM解析器适合处理短小的文档，并且适合对文档进行随机访问和修改，SAX适合按顺序读取大型文档。用SAX修改文档是很麻烦的。
3 DOM与 python 库xml.dom.minidom
DOM把xml每个元素、属性、文本等信息储存在称为节点的数据类型中，xml.dom中Node（节点）是xml文档中每一个component
的父类。XML 中最常见的节点类型包括：
*元素：元素是 XML 的基本构造模块。通常，元素拥有子元素、文本节点，或两者的组合。元素节点也是能够拥有属性的唯一节点类型。
*属性：属性节点包含关于元素节点的信息，但是并不实际认为是元素的孩子，比如在下面的例子中：
*文本：文本节点就是名副其实的文本。它可以由更多信息组成，也可以只包含空白。
*文档：文档节点是文档中其他所有节点的父亲。
其他节点类型不太常用，但是在某些场合下仍然是必需的。它们包括：
*CDATA：
字符数据（Character
Data）的缩写，这是一个特殊的节点，它包含不应该被解析器分析的信息。相反，它包含的信息应该以纯文本传递。例如，可能会为了特殊目的而存储
HTML 标签。在通常情形下，处理器可能尝试为所存储的每个标签创建元素，而这样可能导致文档不是格式良好
的。这些问题可用通过使用 CDATA 节（section）来避免。这些节使用特殊的符号来编写：
<[CDATA[
Important: Please keep head and hands inside ride at all
times.
]]>
*注释：注释包括关于数据的信息，通常被应用程序忽略。它们写为如下形式：
*处理指令：处理指令是专门针对应用程序的信息。其中一些例子包括要执行的代码或者关于从何处寻找样式表的信息。例如：
python xml.dom中节点类型由节点中nodeType属性得到，该属性取如下值：ELEMENT_NODE,
ATTRIBUTE_NODE, TEXT_NODE, CDATA_SECTION_NODE, ENTITY_NODE,
PROCESSING_INSTRUCTION_NODE, COMMENT_NODE, DOCUMENT_NODE,
DOCUMENT_TYPE_NODE, NOTATION_NODE
示例：把上面的xml例子保存为test-utf8.xml，一定用utf8的编码保存。然后在python提示符下输入：
>>> from xml.dom import minidom
>>> xmldoc=minidom.parse('test-utf8.xml')
得到一个Document类型变量xmldoc, 它是一个保存文档所有信息的树结构。用Node的toxml()函数可以得到节点中保存的xml字符串。因为Document是Node的子类，所以可以应用toxml函数：
>>> print xmldoc.toxml()
http://blog.xxx.com
http://blog.xxx.com/e_42678.html
http://blog.xxx.com/e_39749.html
要得到文档的根节点，用Document的documentElement属性：
>>> root=xmldoc.documentElement
>>> root
>>> print root.toxml()
http://blog.xxx.com
http://blog.xxx.com/e_42678.html
http://blog.xxx.com/e_39749.html
root有一个子元素channel，这些子元素由root的childNodes保存，其中第一个子节点由root.firstChild引用，最后一个子节点由root.lastChild引用：
>>> print root.firstChild.toxml()
>>> print root.lastChild.toxml()
>>> print root.childNodes[1].toxml()
http://blog.xxx.com
http://blog.xxx.com/e_42678.html
http://blog.xxx.com/e_39749.html
因为firstChild和lastChild是由channel前后的空白和换行形成的文本型节点，所以会打印出空行。
访问xmldoc:
xml各部分与minidom关系对应：
Node.childNodes保存个子节点，第一个节点Node.firstChild，最后一个Node.lastChild，可以像list一样使用。
修改xmldoc:
添加节点：首先创建节点：Document.createElement(tagName)
Document.createTextNode(data)再把节点添加到Node下面：Node.appendChild()
node.insertBefore(new,ref)
删除节点Node.removeChild()
替换节点 Node.replaceChild(new,old)
添加删除属性 更改属性
Element.setAttribute(name,value) Element.removeAttribute(name) 也可以用
Element.attributes['key']=value来直接指定，value是unicode字符串。
4 例子
dir2xml.py是由目录结构生成xml文件的例子，xml2dir.py是根据生成的xml文件内容重建目录，当然建立出的文件都是没有内容的空文件。
文件dir2xml.py:
#!/usr/bin/env python
#-*- coding: gbk -*-
"""遍历目录，根据目录结构生成xml文件。
dir2xml dirname xmlfilename
"""
import os
from xml.dom import minidom as pydom
import sys
def usage():
print "usage:",sys.argv[0],"dirname xmlfilename"
def dir2xml(dirname):
"""遍历目录，根据目录内容生成xml Document对象
dirname是路径名，必须是标准的路径名，前后没有空格，后面不带/或\\。
"""
impl=pydom.getDOMImplementation()
newdoc=impl.createDocument(None,"dir",None)
rootdir=newdoc.documentElement
rootdir.attributes['name']=os.path.basename(dirname)
def walkdir(dirname,node,document): #对目录递归遍历，这里用os.path.walk更简单
for file in os.listdir(dirname):
if os.path.isfile(os.path.join(dirname,file)):
newFileEl=document.createElement('file')
newFileEl.attributes['name']=file.encode('utf8')
node.appendChild(newFileEl)
elif os.path.isdir(os.path.join(dirname,file)):
newFileEl=document.createElement('dir')
newFileEl.attributes['name']=file.encode('utf8')
node.appendChild(newFileEl)
walkdir(os.path.join(dirname,file),newFileEl,document)
walkdir(dirname,rootdir,newdoc)
return newdoc
if __name__ == '__main__':
if len(sys.argv)<3:
usage()
sys.exit()
if not os.path.isdir(sys.argv[1]):
print 'Error:',sys.argv[1],'is not a directory.'
sys.exit()
xmlfile=file(sys.argv[2],'w')
newdoc=dir2xml(unicode(os.path.normpath(sys.argv[1].strip()),'gb2312'))
newdoc.writexml(xmlfile,'\n',' ')
xmlfile.close()
文件xml2dir.py:
#!/usr/bin/env python
# -*- coding: cp936 -*-
"""由xml文档生成目录
xml2dir xmlfilename dirname
"""
import os
from xml.dom import minidom as pydom
import sys
def usage():
print "usage:",sys.argv[0],"dirname xmlfilename"
def xml2dir(xmlElement,dirname):
"""由xml文档生成目录
xml2dir(xmlElement,dirname)
xmlElement是xml文档元素，标签名file表示文件，dir表示目录。属性name表示文件或目录名
dirname是保存xmlElement整个节点的目录名，将在dirname目录中开始建立xmlElement目录树。"""
if not os.path.exists(dirname):
os.mkdir(dirname)
cwd=os.getcwd()
os.chdir(dirname)
for childNode in xmlElement.childNodes:
if childNode.nodeType not in
(childNode.ELEMENT_NODE,childNode.DOCUMENT_NODE):
continue
if childNode.tagName == u'file':
file(childNode.attributes['name'].value,'w').close()
elif childNode.tagName == u'dir':
if not os.path.exists(childNode.attributes['name'].value):
os.mkdir(childNode.getAttribute('name'))
xml2dir(childNode,childNode.getAttribute('name'))
os.chdir(cwd)
if __name__ == '__main__':
if len(sys.argv)<3:
usage()
sys.exit()
try:
xmlfile=file(sys.argv[1],'r')
except:
sys.stderr.write("XML file not found or cannot access.")
sys.exit()
xmldoc=pydom.parse(xmlfile)
xml2dir(xmldoc,os.path.normpath(sys.argv[2].strip()))
xmlfile.close()
