grokcore.annotation 3.0.1

内容

• Setting up ^{tt1}$
• Example
• API Overview
• Changes
  • 3.0.1 (2018-01-17)
  • 3.0.0 (2018-01-12)
  • 1.6 (2017-05-30)
  • 1.5.1 (2016-01-29)
  • 1.5 (2014-10-20)
  • 1.4 (2014-10-17)
  • 1.3 (2012-05-01)
  • 1.2 (2009-12-13)
  • 1.1 (2009-09-18)
  • 1.0.1 (2009-06-30)
  • 1.0 (2009-06-29)

Setting up ^{tt1}$

这个包的设置基本上类似于grokcore.component 包，请参阅其文档以了解详细信息。唯一的 您需要的额外ZCML线路是：

<include package="grokcore.annotation" />

把这个放在根zcml文件的顶部，但是在 包含grokcore.component配置的行。

Example

下面是一个使用注释的简单示例：

import grokcore.annotation
from zope import interface

# Create a model and an interface you want to adapt it to
# and an annotation class to implement the persistent adapter.
class Mammoth(grokcore.annotation.Model):
    pass

class ISerialBrand(interface.Interface):
    unique = interface.Attribute("Brands")

class Branding(grokcore.annotation.Annotation):
    grokcore.annotation.implements(ISerialBrand)
    unique = 0

# Grok the above code, then create some mammoths
manfred = Mammoth()
mumbles = Mammoth()

# creating Annotations work just like Adapters
livestock1 = ISerialBrand(manfred)
livestock2 = ISerialBrand(mumbles)

# except you can store data in them, this data will transparently persist
# in the database for as long as the object exists
livestock1.unique = 101
livestock2.unique = 102

# attributes not listed in the interface will also be persisted
# on the annotation
livestock2.foo = "something"

API Overview

基类

Annotation

注释的基类。继承自 持久类。

Model

要在其上使用批注的模型的基类。

queryAnnotation(model, interface)

查询给定模型上的注释 接口。如果找到，则返回注释，否则不返回。这个 不会进行任何写操作。

deleteAnnotation(model, interface)

查找给定注释并将其从模型中删除。

LazyAnnotation

注释的基类。它只在 显式设置惰性属性的值。

LazyAnnotationProperty

与LazyAnnotation一起工作的属性实现。

另外，grokcore.annotation包公开了 grokcore.component原料药。

Changes