09.处理实体关系
在Pony中,一个实体可以通过关系属性与其他实体建立关系,每个关系总是有两端,并且由两个实体属性定义。
class Person(db.Entity):
cars = Set('Car')
class Car(db.Entity):
owner = Optional(Person)
在上面的例子中,我们使用Person.car
和Car.owner
属性定义了Person
和Car
实体之间的一对多关系。
让我们再给实体添加一些数据属性:
from pony.orm import *
db = Database()
class Person(db.Entity):
name = Required(str)
cars = Set('Car')
class Car(db.Entity):
make = Required(str)
model = Required(str)
owner = Optional(Person)
db.bind('sqlite', ':memory:')
db.generate_mapping(create_tables=True)
现在让我们创建Person
和Car
实体的实例。
>>> p1 = Person(name='John')
>>> c1 = Car(make='Toyota', model='Camry')
>>> commit()
通常情况下,在你的程序中,你不需要手动调用函数commit(),因为它应该是由db_session()
自动调用的。
但是当你在交互式模式下工作时,你永远不会留下db_session()
,这就是为什么我们要在数据库中存储数据时需要手动提交的原因。
建立关系
就在我们创建了实例p1和c1之后,它们并没有建立关系。让我们检查一下关系属性的值。
>>> print(c1.owner)
None
>>> print(p1.cars)
CarSet([])
属性car有一个空集。
现在让我们来建立这两个实例之间的关系:
>>> c1.owner = p1
如果我们现在打印关系属性的值,那么我们会看到下面的内容。
>>> print c1.owner
Person[1]
>>> print p1.cars
CarSet([Car[1]])
当我们为Car实例分配了一个所有者,Person.car
关系属性立即反映了这一变化。
我们也可以通过在创建Car
实例时分配关系属性来建立关系:
>>> p1 = Person(name='John')
>>> c1 = Car(make='Toyota', model='Camry', owner=p1)
在我们的例子中,属性所有者是可选的,所以我们可以在创建Car
实例时或以后的任何时候给它分配一个值。
集合操作
属性Person.car
被表示为一个集合,因此我们可以使用适用于集合的常规操作:add(), remove(), in, len(), clear()
。
你可以使用Set.add()和Set.remove()方法来添加或删除关系:
>>> p1.cars.remove(Car[1])
>>> print p1.cars
CarSet([])
>>> p1.cars.add(Car[1])
>>> print p1.cars
CarSet([Car[1]])
你可以检查一个集合中是否包含一个元素。
>>> Car[1] in p1.cars
True
或者确认集合中没有这个元素。
>>> Car[1] not in p1.cars
False
检查集合长度。
>>> len(p1.cars)
1
如果你需要创建一个车的实例,并将其赋值给特定的人的实例,有几种方法可以实现,其中一种方法是调用集合属性的create()
方法:
>>> p1.cars.create(model='Toyota', make='Prius')
>>> commit()
现在,我们可以检查一个新的Car
实例是否被添加到Person.car
集合属性中:
>>> print p1.cars
CarSet([Car[2], Car[1]])
>>> p1.cars.count()
2
你可以对集合属性进行迭代:
>>> for car in p1.cars:
... print car.model
Toyota
Camry
属性的提升
在Pony中,集合属性提供了属性提升功能:集合获得子项的属性:
>>> show(Car)
class Car(Entity):
id = PrimaryKey(int, auto=True)
make = Required(str)
model = Required(str)
owner = Optional(Person)
>>> p1 = Person[1]
>>> print p1.cars.model
Multiset({u'Camry': 1, u'Prius': 1})
这里我们使用show()
函数打印出实体声明,然后打印出cars
关系属性中的model
属性的值。cars
属性包含了Car
实体的所有属性:id、make、model和owner
。
在Pony中,我们称之为Multiset
,它是用字典来实现的。
字典中的key代表属性的值--在我们的例子中是'Camry'和'Prius'。
而字典的值则显示了它在这个集合中遇到的次数:
>>> print p1.cars.make
Multiset({u'Toyota': 2})
Person[1]有两辆Toyotas。
我们可以在multiset
中进行迭代:
>>> for m in p1.cars.make:
... print m
...
Toyota
Toyota
集合属性参数
下面是你可以应用到集合属性的列表选项:
- cascade_delete
- columns
- lazy
- nplus1_threshold
- reverse
- reverse_columns
- table
例如:
class Photo(db.Entity):
tags = Set('Tag', table='photo_to_tag', column='tag_id')
class Tag(db.Entity):
photos = Set(Photo)
集合属性查询和其他方法
从0.6.1版本开始,Pony引入了关系属性的查询。
你可以使用以下关系属性的方法来检索 :
- Set.select()
- Set.random()
- Set.page()
- Set.order_by()
- Set.load()
- Set.filter()
更多细节请参见API参考中的Collection属性方法部分。
下面你可以找到几个使用这些方法的例子,我们将使用大学方案来显示这些查询,这里是python实体定义和实体关系图。
下面的例子选择了gpa>3并且在Group[101]的学生:
g = Group[101]
g.students.filter(lambda student: student.gpa > 3)[:]
这个查询可以用来显示Group[101]的第二页数据,按名字属性排序:
g.sudents.order_by(Student.name).page(2, pagesize=3)
同样的查询也可以写成下面的形式:
g.students.order_by(lambda s: s.name).limit(3, offset=3)
下面的查询返回两个Group[101]中的随机学生:
g.students.random(2)
再举一个例子,此查询返回Student[1]在第二学期所学课程的第1页,按课程名称排序。
s = Student[1]
s.course.select(lambda c: c.semester ==2).order_by(Course.name).page(1)