xml.dom.minidom
— 最小 DOM (文档对象模型) 实现
¶
源代码：
Lib/xml/dom/minidom.py
xml.dom.minidom
is a minimal implementation of the Document Object Model interface, with an API similar to that in other languages. It is intended to be simpler than the full DOM and also significantly smaller. Users who are not already proficient with the DOM should consider using the
xml.etree.ElementTree
module for their XML processing instead.
警告
The
xml.dom.minidom
module is not secure against maliciously constructed data. If you need to parse untrusted or unauthenticated data see
XML vulnerabilities
.
DOM applications typically start by parsing some XML into a DOM. With
xml.dom.minidom
, this is done through the parse functions:
from xml.dom.minidom import parse, parseString
dom1 = parse('c:\\temp\\mydata.xml') # parse an XML file by name
datasource = open('c:\\temp\\mydata.xml')
dom2 = parse(datasource) # parse an open file
dom3 = parseString('<myxml>Some data<empty/> some more data</myxml>')
The
parse()
function can take either a filename or an open file object.
-
xml.dom.minidom.
parse
(
filename_or_file
,
parser
=
None
,
bufsize
=
None
)
¶
-
返回
Document
from the given input.
filename_or_file
may be either a file name, or a file-like object.
parser
, if given, must be a SAX2 parser object. This function will change the document handler of the parser and activate namespace support; other parser configuration (like setting an entity resolver) must have been done in advance.
If you have XML in a string, you can use the
parseString()
function instead:
-
xml.dom.minidom.
parseString
(
string
,
parser
=
None
)
¶
-
返回
Document
表示
string
. This method creates an
io.StringIO
object for the string and passes that on to
parse()
.
Both functions return a
Document
object representing the content of the document.
What the
parse()
and
parseString()
functions do is connect an XML parser with a “DOM builder” that can accept parse events from any SAX parser and convert them into a DOM tree. The name of the functions are perhaps misleading, but are easy to grasp when learning the interfaces. The parsing of the document will be completed before these functions return; it’s simply that these functions do not provide a parser implementation themselves.
You can also create a
Document
by calling a method on a “DOM Implementation” object. You can get this object either by calling the
getDOMImplementation()
function in the
xml.dom
package or the
xml.dom.minidom
module. Once you have a
Document
, you can add child nodes to it to populate the DOM:
from xml.dom.minidom import getDOMImplementation
impl = getDOMImplementation()
newdoc = impl.createDocument(None, "some_tag", None)
top_element = newdoc.documentElement
text = newdoc.createTextNode('Some textual content.')
top_element.appendChild(text)
