dolmen.relations 0.5

关系目录

dolmen.relations 提供了一个名为 RelationCatalog 的组件，负责注册关系和查找它们

>>> from dolmen.relations import RelationCatalog, ICatalog
>>> sm.registerUtility(RelationCatalog(), ICatalog)

关系容器

为了存储关系并触发所需的事件，dolmen.relations 提供了一个 btree 容器

>>> from dolmen.relations import RelationsContainer
>>> relations = herd['_relations'] = RelationsContainer()

内容

现在，我们需要一些内容来开始。测试模块定义了一个Mammoth持久对象，我们将在这里使用它

>>> from dolmen.relations.tests import Mammoth

>>> manfred = herd['manfred'] = Mammoth()
>>> gunther = herd['gunther'] = Mammoth()

为了确保我们的对象将被持久化并将被赋予一个整数id，我们提交

>>> import transaction
>>> transaction.commit()

简单关系

最简单的关系类型是 RelationValue。这种关系使用源ID和目标ID创建。

>>> relations["simple"] = values.RelationValue(gunther_id, manfred_id)

您可以通过提供目标ID和/或源ID来查询关系。

>>> found = list(rcatalog.findRelations({'target_id': manfred_id}))
>>> found
[<dolmen.relations.values.RelationValue object at ...>]

关系具有用于解决源或目标的属性。

>>> relation = found.pop()
>>> relation
<dolmen.relations.values.RelationValue object at ...>
>>> relation.source
<Mammoth gunther>
>>> relation.target
<Mammoth manfred>

标记关系

第二种关系类型是 TaggedRelationValue。它允许我们在源-目标对中添加一个标签列表，该列表为Unicode字符串列表。

>>> relations["tagged"] = values.TaggedRelationValue(
...           gunther_id, manfred_id, tags=[u'grok', u'dolmen'])

关系仍然可以通过基本查询检索。

>>> found = list(rcatalog.findRelations({'target_id': manfred_id}))
>>> found
[<dolmen.relations.values.RelationValue object at ...>, <dolmen.relations.values.TaggedRelationValue object at ...>]

现在，也可以使用标签值进行查询。

>>> found = list(rcatalog.findRelations({'tag': any('grok')}))
>>> found
[<dolmen.relations.values.TaggedRelationValue object at ...>]

>>> found = list(rcatalog.findRelations({'tag': any('drupal')}))
>>> found
[]

状态关系

第三种关系类型是 StatefulRelationValue。它向源-目标对添加状态信息，状态信息为Unicode字符串。

>>> relations["stateful"] = values.StatefulRelationValue(
...           gunther_id, manfred_id, state=u"private")

关系仍然可以通过基本查询检索。

>>> found = list(rcatalog.findRelations({'target_id': manfred_id}))
>>> found
[<dolmen.relations.values.RelationValue object at ...>, <dolmen.relations.values.TaggedRelationValue object at ...>, <dolmen.relations.values.StatefulRelationValue object at ...>]

现在也可以使用状态字符串进行查询。

>>> found = list(rcatalog.findRelations({'state': any('private')}))
>>> found
[<dolmen.relations.values.StatefulRelationValue object at ...>]

>>> found = list(rcatalog.findRelations({'state': any('public')}))
>>> found
[]

0.5 (2011-11-08)

• 在ID被删除时捕获intids的错误。在这种情况下返回None。

0.4 (2010-03-15)

• 当关系由于组件被删除而删除时添加事件。

• 修复在关系容器中删除不存在的关系的组件[reference_id]时的错误（您应该只得到一个KeyError）。

0.3 (2010-03-10)

• 修复包上的zip-safe标志。

• 通过使用register而不是getId IntIds方法来修复潜在的非Yet错误。

• 修复没有关系目录可用时的事件。

0.2 (2009-12-26)

• ZTK兼容性导入更改。

0.1 (2009-10-20)

• 初始版本