如引言里面描述的那样,xml_models2能够通过自定义model来序列化
xml,获取自己感兴趣的节点的内容。假如我们有如下一个xml:
<Person id="112">
<firstName>Chris</firstName>
<lastName>Tarttelin</lastName>
<occupation>Code Geek</occupation>
<contact-info>
<contact type="telephone">
<info>(555) 555-5555</info>
<description>Cell phone, but no calls during work hours</description>
</contact>
<contact type="email">
<description>Where possible, contact me by email</description>
</contact>
<contact type="telephone">
<info>1-800-555-5555</info>
<description>Toll free work number for during office hours.</description>
</contact>
</contact-info>
</Person>
为了获取相应的数据,我们就可以定义如下的model:
class Person(Model):
id = IntField(xpath="/Person/@id")
firstName = CharField(xpath="/Person/firstName")
lastName = CharField(xpath="/Person/lastName")
contacts = CollectionField(ContactInfo, order_by="contact_type", xpath="Person/contact-info/contact")
class ContactInfo(Model):
contact_type = CharField(xpath="/contact/@type")
info = CharField(xpath="/contact/info")
description = CharField(xpath="/contact/description", default="No description supplied")
Person和ContactInfo model继承自积累xml_models.Model,IntField,CharField,CollectionField等字段类型都是xml_models提供的字段类型,相信用过像比如SQLAlchemy或者Django ORM的童鞋应该不会陌生,只不过这里在使用这些字段的时候指定的值是一些xpath的值用来指定xml文件中相应节点的路径。定义好model之后,只要简单调用就能取到我们想要的数据:
>>> person = Person(xml_str)
>>> person.contacts[0].info
在解析xml的时候,嵌套重复有规则的xml数据可能会经常会用到CollectionField
,除了像上面定义model的方式指定集合,也能够直接在model里面指定collection_node
:
class SomeModel(Model):
fieldA = CharField(xpath="/some/node")
collection_node = 'collection'
data = SomeModel.objects.filter_custom(url_address_xxx).get()
获取直接能够通过rest api查询查询一些数据:
class Person(xml_models.Model:
...
finders = { (firstName, lastName): "http://person/firstName/%s/lastName/%s",
(id,): "http:xxxx//person/%s"}
>>> people = Person.objects.filter(firstName='Chris', lastName='Tarttelin')
>>> people.count()
1
>>> person = Person.objects.get(id=123)
>>> person.firstName
Chris
除了如上所示提到的这些,xml_models2还有一些比较好玩的功能:
to_xml()
: 将xml序列化之后,我们可能会做一些更改,更改之后调用这个api能够生成包含更改内容的xml;甚至能够先定义model,实例化自己的model实力然后生成xml。
validate_on_load()
: 在model中这个方法一个很好的“钩子”,方便我们在序列化的时候进行一些自定义的验证。
blablablanla...
这篇文章大部分部分的内容都是从文档搬来的,稍稍加了些自己的一些理解加以丰富,方便大家开始使用。