plone.registry 2.0.1

创建记录

支持的字段类型位于 plone.registry.field 模块中。这些名称与 zope.schema 中等效的字段相同，并且具有相同的构造函数。在直接创建记录时，您必须使用这些字段之一

>>> from plone.registry import field
>>> age_field = field.Int(title=u"Age", min=0, default=18)

>>> from plone.registry import Record
>>> age_record = Record(age_field)

请注意，在这种情况下，我们没有提供值。因此，值将是字段的默认值

>>> age_record.value
18

我们可以在 Record 构造函数或通过 value 属性设置不同的值

>>> age_record.value = 2
>>> age_record.value
2

请注意，值将针对字段进行验证

>>> age_record.value = -1
Traceback (most recent call last):
...
zope.schema._bootstrapinterfaces.TooSmall: (-1, 0)

>>> age_record.value
2

现在我们可以将字段添加到注册表中。这是通过 record 字典完成的

>>> 'plone.registry.tests.age' in registry
False
>>> registry.records['plone.registry.tests.age'] = age_record

此时，记录将获得 __name__ 和 __parent__ 属性

>>> age_record.__name__
'plone.registry.tests.age'

>>> age_record.__parent__ is registry
True

带有初始值的记录创建

我们可以通过以下方式一次性简洁地创建记录：

1. 创建字段

2. 创建记录并设置其值

3. 将其分配给注册表

如下所示

>>> registry.records['plone.registry.tests.cms'] = \
...     Record(field.TextLine(title=u"CMS of choice"), u"Plone")

现在可以获取记录。请注意，它有一个漂亮的 __repr__ 帮助调试。

>>> registry.records['plone.registry.tests.cms']
<Record plone.registry.tests.cms>

访问和操作记录值

一旦创建并添加到注册表，您可以通过在注册表本身上进行类似于字典的操作来访问其值

>>> 'plone.registry.tests.cms' in registry
True

>>> registry['plone.registry.tests.cms']  # doctest: +IGNORE_U
u'Plone'

>>> registry['plone.registry.tests.cms'] = u"Plone 3.x"

再次提醒，值将进行验证

>>> registry['plone.registry.tests.cms'] = b'Joomla'
Traceback (most recent call last):
...
zope.schema._bootstrapinterfaces.WrongType: (b'Joomla', <class 'str'>, 'value')

还有一个 get() 方法

>>> registry.get('plone.registry.tests.cms')  # doctest: +IGNORE_U
u'Plone 3.x'
>>> registry.get('non-existent-key') is None
True

删除记录

可以从 records 属性中删除记录

>>> del registry.records['plone.registry.tests.cms']
>>> 'plone.registry.tests.cms' in registry.records
False
>>> 'plone.registry.tests.cms' in registry
False

访问原始接口

现在我们有了这些记录，我们可以查找原始接口。这不会打破黄金法则：在内部，我们只存储接口的名称，并在运行时解析。

了解接口的记录用 IInterfaceAwareRecord 标记，并有两个额外的属性： interface 和 fieldName

>>> from plone.registry.interfaces import IInterfaceAwareRecord
>>> IInterfaceAwareRecord.providedBy(age_record)
False
>>> IInterfaceAwareRecord.providedBy(sender_record)
True

>>> sender_record.interfaceName
'plone.registry.tests.IMailSettings'

>>> sender_record.interface is IMailSettings
True

使用记录代理

一旦创建了接口的记录，就可以获取一个提供给定接口的代理对象，但将其值读取和写入注册表。例如，使用 zope.formlib 或 z3c.form 创建表单时，这很有用，配置了基于接口的控件。或者简单地作为一个更方便的API，当处理多个相关设置时。

>>> proxy = registry.forInterface(IMailSettings)
>>> proxy
<RecordsProxy for plone.registry.tests.IMailSettings>

如果您在代码中使用可能在正常HTML渲染路径上遇到（例如在视图组件中）的注册值，您需要知道记录可能不存在或不有效。 forInterface() 在这种情况下将引发 KeyError

try:
    proxy = registry.forInterface(IMailSettings)
except KeyError:
    # Gracefully handled cases
    # when GenericSetup installer has not been run or rerun
    # e.g. by returning or using some default values
    pass

代理本身不是一个持久对象

>>> from persistent.interfaces import IPersistent
>>> IPersistent.providedBy(proxy)
False

然而，它确实提供了必要的接口

>>> IMailSettings.providedBy(proxy)
True

您可以通过检查 IRecordsProxy 标记接口来区分代理和“正常”对象

>>> from plone.registry.interfaces import IRecordsProxy
>>> IRecordsProxy.providedBy(proxy)
True

当我们设置值时，它将存储在注册表中

>>> proxy.smtp_host = 'http://mail.server.com'
>>> registry['plone.registry.tests.IMailSettings.smtp_host']
'http://mail.server.com'

>>> registry['plone.registry.tests.IMailSettings.smtp_host'] = 'smtp://mail.server.com'
>>> proxy.smtp_host
'smtp://mail.server.com'

不在接口中的值将引发 AttributeError

>>> proxy.age
Traceback (most recent call last):
...
AttributeError: age

请注意，默认情况下，forInterface() 方法将检查必要的记录是否已注册。例如，我们不能使用任何旧的接口

>>> registry.forInterface(IInterfaceAwareRecord)
Traceback (most recent call last):
...
KeyError: 'Interface `plone.registry.interfaces.IInterfaceAwareRecord` defines a field `...`, for which there is no record.'

默认情况下，我们也不能使用仅存在一些记录的接口

>>> registry.forInterface(IMailPreferences)
Traceback (most recent call last):
...
KeyError: 'Interface `plone.registry.tests.IMailPreferences` defines a field `settings`, for which there is no record.'

然而，可以禁用此检查。这将更有效一点

>>> registry.forInterface(IMailPreferences, check=False)
<RecordsProxy for plone.registry.tests.IMailPreferences>

更好的方法是明确声明一些字段被省略

>>> pref_proxy = registry.forInterface(IMailPreferences, omit=('settings',))

在这种情况下，省略的字段将默认为它们的“缺失”值

>>> pref_proxy.settings ==  IMailPreferences['settings'].missing_value
True

然而，尝试设置值将导致 AttributeError

>>> pref_proxy.settings = None
Traceback (most recent call last):
...
AttributeError: settings

要访问字段的另一个实例，提供前缀

>>> alt_proxy = registry.forInterface(IMailSettings,
...     prefix="plone.registry.tests.alternativesettings")
>>> alt_proxy.sender  # doctest: +IGNORE_U
u'alt@example.org'

记录代理的集合

可以使用 collectionOfInterface 访问记录集的集合

>>> collection = registry.collectionOfInterface(IMailSettings)

您可以创建一个新的记录集

>>> proxy = collection.setdefault('example')
>>> proxy.sender = u'collection@example.org'
>>> proxy.smtp_host = 'smtp://mail.example.org'

记录集基于前缀存储

>>> prefix = IMailSettings.__identifier__
>>> registry.records.values(prefix+'/', prefix+'0')
[<Record plone.registry.tests.IMailSettings/example.sender>,
 <Record plone.registry.tests.IMailSettings/example.smtp_host>]
>>> registry['plone.registry.tests.IMailSettings/example.sender']  # doctest: +IGNORE_U
u'collection@example.org'

可以从现有对象设置记录

>>> class MailSettings:
...     sender = u'someone@example.com'
...     smtp_host = 'smtp://mail.example.com'
>>> collection['example_com'] = MailSettings()
>>> registry.records.values(prefix+'/', prefix+'0')
[<Record plone.registry.tests.IMailSettings/example.sender>,
 <Record plone.registry.tests.IMailSettings/example.smtp_host>,
 <Record plone.registry.tests.IMailSettings/example_com.sender>,
 <Record plone.registry.tests.IMailSettings/example_com.smtp_host>]

可以遍历集合

>>> for name in collection: print(name)
example
example_com

并且可以删除

>>> del collection['example_com']
>>> registry.records.values(prefix+'/', prefix+'0')
[<Record plone.registry.tests.IMailSettings/example.sender>,
 <Record plone.registry.tests.IMailSettings/example.smtp_host>]

字节

bytes 字段描述一个字节字符串

>>> f = field.Bytes(title=u"Test", min_length=0, max_length=10)
>>> isinstance(f, schema.Bytes)
True

>>> f.order
-1

>>> field.Bytes(title=u"Test", constraint=lambda x: True)
Traceback (most recent call last):
...
ValueError: Persistent fields does not support setting the `constraint` property

>>> f.constraint = lambda x: False
Traceback (most recent call last):
...
ValueError: Persistent fields does not support setting the `constraint` property

>>> f.constraint('ABC')
True

字节行

bytes 字段描述一个不允许换行的字节字符串

>>> f = field.BytesLine(title=u"Test", min_length=0, max_length=10)
>>> isinstance(f, schema.BytesLine)
True

>>> f.order
-1

>>> field.BytesLine(title=u"Test", constraint=lambda x: True)
Traceback (most recent call last):
...
ValueError: Persistent fields does not support setting the `constraint` property

>>> f.constraint = lambda x: False
Traceback (most recent call last):
...
ValueError: Persistent fields does not support setting the `constraint` property

>>> f.constraint(b'AB\nC')
False

ASCII

ASCII 字段描述一个仅包含 ASCII 字符的字符串

>>> f = field.ASCII(title=u"Test", min_length=0, max_length=10)
>>> isinstance(f, schema.ASCII)
True

>>> f.order
-1

>>> field.ASCII(title=u"Test", constraint=lambda x: True)
Traceback (most recent call last):
...
ValueError: Persistent fields does not support setting the `constraint` property

>>> f.constraint = lambda x: False
Traceback (most recent call last):
...
ValueError: Persistent fields does not support setting the `constraint` property

>>> f.constraint('ab\nc')
True

ASCII 行

ASCII 行字段描述一个仅包含 ASCII 字符并禁止换行的字符串

>>> f = field.ASCIILine(title=u"Test", min_length=0, max_length=10)
>>> isinstance(f, schema.ASCIILine)
True

>>> f.order
-1

>>> field.ASCIILine(title=u"Test", constraint=lambda x: True)
Traceback (most recent call last):
...
ValueError: Persistent fields does not support setting the `constraint` property

>>> f.constraint = lambda x: False
Traceback (most recent call last):
...
ValueError: Persistent fields does not support setting the `constraint` property

>>> f.constraint('ab\nc')
False

文本

text 字段描述一个 Unicode 字符串

>>> f = field.Text(title=u"Test", min_length=0, max_length=10)
>>> isinstance(f, schema.Text)
True

>>> f.order
-1

>>> field.Text(title=u"Test", constraint=lambda x: True)
Traceback (most recent call last):
...
ValueError: Persistent fields does not support setting the `constraint` property

>>> f.constraint = lambda x: False
Traceback (most recent call last):
...
ValueError: Persistent fields does not support setting the `constraint` property

>>> f.constraint(u'ab\nc')
True

文本行

text 行字段描述一个不允许换行的 Unicode 字符串

>>> f = field.TextLine(title=u"Test", min_length=0, max_length=10)
>>> isinstance(f, schema.TextLine)
True

>>> f.order
-1

>>> field.TextLine(title=u"Test", constraint=lambda x: True)
Traceback (most recent call last):
...
ValueError: Persistent fields does not support setting the `constraint` property

>>> f.constraint = lambda x: False
Traceback (most recent call last):
...
ValueError: Persistent fields does not support setting the `constraint` property

>>> f.constraint(u'ab\nc')
False

布尔值

bool 字段描述一个布尔值

>>> f = field.Bool(title=u"Test")
>>> isinstance(f, schema.Bool)
True

>>> f.order
-1

>>> field.Bool(title=u"Test", constraint=lambda x: True)
Traceback (most recent call last):
...
ValueError: Persistent fields does not support setting the `constraint` property

>>> f.constraint = lambda x: False
Traceback (most recent call last):
...
ValueError: Persistent fields does not support setting the `constraint` property

>>> f.constraint(False)
True

整型

int 字段描述一个整数或长整型

>>> f = field.Int(title=u"Test", min=-123, max=1234)
>>> isinstance(f, schema.Int)
True

>>> f.order
-1

>>> field.Int(title=u"Test", constraint=lambda x: True)
Traceback (most recent call last):
...
ValueError: Persistent fields does not support setting the `constraint` property

>>> f.constraint = lambda x: False
Traceback (most recent call last):
...
ValueError: Persistent fields does not support setting the `constraint` property

>>> f.constraint(123)
True

浮点型

float 字段描述一个浮点数

>>> f = field.Float(title=u"Test", min=-123.0, max=1234.0)
>>> isinstance(f, schema.Float)
True

>>> f.order
-1

>>> field.Float(title=u"Test", constraint=lambda x: True)
Traceback (most recent call last):
...
ValueError: Persistent fields does not support setting the `constraint` property

>>> f.constraint = lambda x: False
Traceback (most recent call last):
...
ValueError: Persistent fields does not support setting the `constraint` property

>>> f.constraint(123)
True

十进制

decimal 字段描述一个十进制数

>>> import decimal
>>> f = field.Decimal(title=u"Test", min=decimal.Decimal('-123.0'), max=decimal.Decimal('1234.0'))
>>> isinstance(f, schema.Decimal)
True

>>> f.order
-1

>>> field.Decimal(title=u"Test", constraint=lambda x: True)
Traceback (most recent call last):
...
ValueError: Persistent fields does not support setting the `constraint` property

>>> f.constraint = lambda x: False
Traceback (most recent call last):
...
ValueError: Persistent fields does not support setting the `constraint` property

>>> f.constraint(123)
True

密码

password 字段描述用于密码的 Unicode 字符串

>>> f = field.Password(title=u"Test", min_length=0, max_length=10)
>>> isinstance(f, schema.Password)
True

>>> f.order
-1

>>> field.Password(title=u"Test", constraint=lambda x: True)
Traceback (most recent call last):
...
ValueError: Persistent fields does not support setting the `constraint` property

>>> f.constraint = lambda x: False
Traceback (most recent call last):
...
ValueError: Persistent fields does not support setting the `constraint` property

>>> f.constraint(u'ab\nc')
False

源文本

source text 字段描述包含源代码的 Unicode 字符串

>>> f = field.SourceText(title=u"Test", min_length=0, max_length=10)
>>> isinstance(f, schema.SourceText)
True

>>> f.order
-1

>>> field.SourceText(title=u"Test", constraint=lambda x: True)
Traceback (most recent call last):
...
ValueError: Persistent fields does not support setting the `constraint` property

>>> f.constraint = lambda x: False
Traceback (most recent call last):
...
ValueError: Persistent fields does not support setting the `constraint` property

>>> f.constraint(u'ab\nc')
True

URI

URI 字段描述 URI 字符串

>>> f = field.URI(title=u"Test", min_length=0, max_length=10)
>>> isinstance(f, schema.URI)
True

>>> f.order
-1

>>> field.URI(title=u"Test", constraint=lambda x: True)
Traceback (most recent call last):
...
ValueError: Persistent fields does not support setting the `constraint` property

>>> f.constraint = lambda x: False
Traceback (most recent call last):
...
ValueError: Persistent fields does not support setting the `constraint` property

>>> f.constraint(u'abc')
True

标识符

id 字段描述 URI 字符串或点分名称

>>> f = field.Id(title=u"Test", min_length=0, max_length=10)
>>> isinstance(f, schema.Id)
True

>>> f.order
-1

>>> field.Id(title=u"Test", constraint=lambda x: True)
Traceback (most recent call last):
...
ValueError: Persistent fields does not support setting the `constraint` property

>>> f.constraint = lambda x: False
Traceback (most recent call last):
...
ValueError: Persistent fields does not support setting the `constraint` property

>>> f.constraint(u'abc')
True

点名称

点分名称字段描述 Python 点分名称

>>> f = field.DottedName(title=u"Test", min_length=0, max_length=10)
>>> isinstance(f, schema.DottedName)
True

>>> f.order
-1

>>> field.DottedName(title=u"Test", constraint=lambda x: True)
Traceback (most recent call last):
...
ValueError: Persistent fields does not support setting the `constraint` property

>>> f.constraint = lambda x: False
Traceback (most recent call last):
...
ValueError: Persistent fields does not support setting the `constraint` property

>>> f.constraint(u'abc')
True

日期时间

日期/时间字段描述 Python datetime 对象

>>> f = field.Datetime(title=u"Test")
>>> isinstance(f, schema.Datetime)
True

>>> f.order
-1

>>> field.Datetime(title=u"Test", constraint=lambda x: True)
Traceback (most recent call last):
...
ValueError: Persistent fields does not support setting the `constraint` property

>>> f.constraint = lambda x: False
Traceback (most recent call last):
...
ValueError: Persistent fields does not support setting the `constraint` property

>>> import datetime
>>> f.constraint(datetime.datetime.now())
True

日期

日期字段描述 Python 日期对象

>>> f = field.Date(title=u"Test")
>>> isinstance(f, schema.Date)
True

>>> f.order
-1

>>> field.Date(title=u"Test", constraint=lambda x: True)
Traceback (most recent call last):
...
ValueError: Persistent fields does not support setting the `constraint` property

>>> f.constraint = lambda x: False
Traceback (most recent call last):
...
ValueError: Persistent fields does not support setting the `constraint` property

>>> import datetime
>>> f.constraint(datetime.date.today())
True

时间差

时间差字段描述了一个Python timedelta对象

>>> f = field.Timedelta(title=u"Test")
>>> isinstance(f, schema.Timedelta)
True

>>> f.order
-1

>>> field.Timedelta(title=u"Test", constraint=lambda x: True)
Traceback (most recent call last):
...
ValueError: Persistent fields does not support setting the `constraint` property

>>> f.constraint = lambda x: False
Traceback (most recent call last):
...
ValueError: Persistent fields does not support setting the `constraint` property

>>> import datetime
>>> f.constraint(datetime.timedelta(1))
True

元组

元组字段描述了一个元组

>>> f = field.Tuple(title=u"Test", min_length=0, max_length=10,
...     value_type=field.TextLine(title=u"Value"))
>>> isinstance(f, schema.Tuple)
True

>>> f.order
-1

>>> field.Tuple(title=u"Test", min_length=0, max_length=10,
...     value_type=schema.TextLine(title=u"Value"))
Traceback (most recent call last):
...
ValueError: The property `value_type` may only contain objects providing `plone.registry.interfaces.IPersistentField`.

>>> f.value_type = schema.TextLine(title=u"Value")
Traceback (most recent call last):
...
ValueError: The property `value_type` may only contain objects providing `plone.registry.interfaces.IPersistentField`.

>>> field.Tuple(title=u"Test", constraint=lambda x: True)
Traceback (most recent call last):
...
ValueError: Persistent fields does not support setting the `constraint` property

>>> f.constraint = lambda x: False
Traceback (most recent call last):
...
ValueError: Persistent fields does not support setting the `constraint` property

>>> f.constraint((1,2))
True

列表

列表字段描述了一个元组

>>> f = field.List(title=u"Test", min_length=0, max_length=10,
...     value_type=field.TextLine(title=u"Value"))
>>> isinstance(f, schema.List)
True

>>> f.order
-1

>>> field.List(title=u"Test", min_length=0, max_length=10,
...     value_type=schema.TextLine(title=u"Value"))
Traceback (most recent call last):
...
ValueError: The property `value_type` may only contain objects providing `plone.registry.interfaces.IPersistentField`.

>>> f.value_type = schema.TextLine(title=u"Value")
Traceback (most recent call last):
...
ValueError: The property `value_type` may only contain objects providing `plone.registry.interfaces.IPersistentField`.

>>> field.List(title=u"Test", constraint=lambda x: True)
Traceback (most recent call last):
...
ValueError: Persistent fields does not support setting the `constraint` property

>>> f.constraint = lambda x: False
Traceback (most recent call last):
...
ValueError: Persistent fields does not support setting the `constraint` property

>>> f.constraint([1,2])
True

集合

集合字段描述了一个集合

>>> f = field.Set(title=u"Test", min_length=0, max_length=10,
...     value_type=field.TextLine(title=u"Value"))
>>> isinstance(f, schema.Set)
True

>>> f.order
-1

>>> field.Set(title=u"Test", min_length=0, max_length=10,
...     value_type=schema.TextLine(title=u"Value"))
Traceback (most recent call last):
...
ValueError: The property `value_type` may only contain objects providing `plone.registry.interfaces.IPersistentField`.

>>> f.value_type = schema.TextLine(title=u"Value")
Traceback (most recent call last):
...
ValueError: The property `value_type` may only contain objects providing `plone.registry.interfaces.IPersistentField`.

>>> field.Set(title=u"Test", constraint=lambda x: True)
Traceback (most recent call last):
...
ValueError: Persistent fields does not support setting the `constraint` property

>>> f.constraint = lambda x: False
Traceback (most recent call last):
...
ValueError: Persistent fields does not support setting the `constraint` property

>>> f.constraint(set([1,2]))
True

冻结集合

集合字段描述了一个frozenset

>>> f = field.FrozenSet(title=u"Test", min_length=0, max_length=10,
...     value_type=field.TextLine(title=u"Value"))
>>> isinstance(f, schema.FrozenSet)
True

>>> f.order
-1

>>> field.FrozenSet(title=u"Test", min_length=0, max_length=10,
...     value_type=schema.TextLine(title=u"Value"))
Traceback (most recent call last):
...
ValueError: The property `value_type` may only contain objects providing `plone.registry.interfaces.IPersistentField`.

>>> f.value_type = schema.TextLine(title=u"Value")
Traceback (most recent call last):
...
ValueError: The property `value_type` may only contain objects providing `plone.registry.interfaces.IPersistentField`.

>>> field.FrozenSet(title=u"Test", constraint=lambda x: True)
Traceback (most recent call last):
...
ValueError: Persistent fields does not support setting the `constraint` property

>>> f.constraint = lambda x: False
Traceback (most recent call last):
...
ValueError: Persistent fields does not support setting the `constraint` property

>>> f.constraint(frozenset([1,2]))
True

字典

集合字段描述了一个字典

>>> f = field.Dict(title=u"Test", min_length=0, max_length=10,
...     key_type=field.ASCII(title=u"Key"),
...     value_type=field.TextLine(title=u"Value"))
>>> isinstance(f, schema.Dict)
True

>>> f.order
-1

>>> field.Dict(title=u"Test", min_length=0, max_length=10,
...     key_type=schema.ASCII(title=u"Key"),
...     value_type=field.TextLine(title=u"Value"))
Traceback (most recent call last):
...
ValueError: The property `key_type` may only contain objects providing `plone.registry.interfaces.IPersistentField`.

>>> f.key_type = schema.ASCII(title=u"Key")
Traceback (most recent call last):
...
ValueError: The property `key_type` may only contain objects providing `plone.registry.interfaces.IPersistentField`.

>>> field.Dict(title=u"Test", min_length=0, max_length=10,
...     key_type=field.ASCII(title=u"Key"),
...     value_type=schema.TextLine(title=u"Value"))
Traceback (most recent call last):
...
ValueError: The property `value_type` may only contain objects providing `plone.registry.interfaces.IPersistentField`.

>>> f.value_type = schema.TextLine(title=u"Value")
Traceback (most recent call last):
...
ValueError: The property `value_type` may only contain objects providing `plone.registry.interfaces.IPersistentField`.

>>> field.Dict(title=u"Test", constraint=lambda x: True)
Traceback (most recent call last):
...
ValueError: Persistent fields does not support setting the `constraint` property

>>> f.constraint = lambda x: False
Traceback (most recent call last):
...
ValueError: Persistent fields does not support setting the `constraint` property

>>> f.constraint(dict())
True

选择

选择字段代表从词汇表中选择。对于持久字段，词汇表不能是源或任何类型的对象：它必须是一个原语列表，或者是一个命名的词汇表

>>> f = field.Choice(title=u"Test", values=[1,2,3])
>>> isinstance(f, schema.Choice)
True

>>> f.order
-1

给定一个值列表，vocabulary属性会根据值动态构建一个词汇表，并且vocabularyName为None

>>> f.vocabulary
<zope.schema.vocabulary.SimpleVocabulary object at ...>

>>> f.vocabularyName is None
True

如果我们使用除了原语以外的任何东西，将会得到一个错误

>>> f = field.Choice(title=u"Test", values=[object(), object()])
Traceback (most recent call last):
...
ValueError: Vocabulary values may only contain primitive values.

如果给出了词汇名称，它将被存储在vocabularyName中，并且vocabulary属性返回None

>>> f = field.Choice(title=u"Test", vocabulary='my.vocab')
>>> f.vocabulary is None
True

>>> f.vocabularyName
'my.vocab'

现在允许其他组合，例如指定没有词汇

>>> field.Choice(title=u"Test")
Traceback (most recent call last):
...
AssertionError: You must specify either values or vocabulary.

或者指定两种类型

>>> field.Choice(title=u"Test", values=[1,2,3], vocabulary='my.vocab')
Traceback (most recent call last):
...
AssertionError: You cannot specify both values and vocabulary.

或者指定对象源

>>> from zope.schema.vocabulary import SimpleVocabulary
>>> dummy_vocabulary = SimpleVocabulary.fromValues([1,2,3])
>>> field.Choice(title=u"Test", source=dummy_vocabulary)
Traceback (most recent call last):
...
ValueError: Persistent fields do not support sources, only named vocabularies or vocabularies based on simple value sets.

或者指定对象词汇

>>> field.Choice(title=u"Test", vocabulary=dummy_vocabulary)
Traceback (most recent call last):
...
ValueError: Persistent fields only support named vocabularies or vocabularies based on simple value sets.

与其他字段一样，您也不能设置约束

>>> field.Choice(title=u"Test", values=[1,2,3], constraint=lambda x: True)
Traceback (most recent call last):
...
ValueError: Persistent fields does not support setting the `constraint` property

>>> f.constraint = lambda x: False
Traceback (most recent call last):
...
ValueError: Persistent fields does not support setting the `constraint` property

>>> f.constraint('ABC')
True

JSON 字段

集合字段描述了一个JSONField

>>> import plone.schema
>>> f = field.JSONField(title=u"Test")
>>> isinstance(f, plone.schema.JSONField)
True

>>> f.order
-1

2.0.1 (2024-01-22)

内部

• 更新配置文件。[plone开发者] (6e36bcc4, 7723aeaf)

2.0.0 (2023-04-26)

破坏性更改

• 移除python 2.7兼容性。[gforcada] (#1)

内部

• 更新配置文件。[plone开发者] (a864b30f)

1.2.1 (2021-06-14)

错误修复

• 修复注册密钥验证正则表达式。[jensens] (#23)

1.2.0 (2021-04-23)

新特性

• 允许plone.schema.JSONField存储在注册表中（作为字典类似物）。

  [sneridagh] (#719)

1.1.6 (2020-04-22)

错误修复

• 小的打包更新。(#1)

1.1.5 (2018-12-14)

错误修复

• 避免在Python 3.8上变成错误的弃用警告。[gforcada]

1.1.4 (2018-11-04)

错误修复

• 适配测试以适应zope4中的更改对象字段。[pbauer]

1.1.3 (2018-06-22)

错误修复

• 提高RecordsProxy.__iter__的性能，现在在核心Plone中作为requireJS配置的一部分调用得更多。[MatthewWilkes]

1.1.2 (2016-12-06)

错误修复

• 修复测试以在Python 3.5上通过。[datakurre]

1.1.1 (2016-11-19)

错误修复

• 修复从损坏的记录代理对象获取值时的无限递归。[tomgross]

1.1.0 (2016-07-05)

新特性

• 为了使RecordsProxy成为良好的Zope公民，给它一个__parent__（即注册表）。这有助于在z3cform绑定程序和其他类似情况下，其中记录代理作为上下文使用。[jensens]

1.0.4 (2016-06-12)

修复

• 更多的清理：PEP8，isort，可读性。[jensens]

1.0.3 (2016-02-26)

修复

• 将已过时的 zope.testing.doctestunit 导入替换为stdlib中的 doctest 模块。[thet]

• 清理：Pep8，utf8头，空白修复，可读性，ReST修复，文档风格等。[jensens]

1.0.2 (2014-09-11)

• 选择字段构造与基于字符串选择的简单词汇表兼容，这些选择在构造时转换为值。这为plone.registry/plone.app.registry与plone.supermodel >= 1.2.5的集成提供兼容性。[seanupton]

1.0.1 (2013-01-13)

1.0 - 2011-05-13

• 1.0版最终发布 [esteele]

• 添加MANIFEST.in。[WouterVH]

1.0b5 - 2011-04-06

• 通过forInterface和collectionOfInterface的factory参数使RecordsProxy类型可定制。[elro]

• 向注册表中添加collectionOfInterface支持。[elro]

• 修复了注册表忽略前缀的bug。[elro]

• 为_Records的键/值/项目添加可选的最小/最大参数。[elro]

1.0b4 - 2011-02-04

• 添加了对字段引用的支持，通过FieldRef类。有关详细信息，请参阅registry.txt。[optilude]

• 更改内部持久结构以提高效率。API保持不变。旧注册表将在首次访问时迁移。警告：这可能会导致在使用注册表的第一次请求中出现“写时读”的情况。[optilude]

1.0b3 - 2011-01-03

• 为forInterface添加前缀选项（如添加到registerInterface）[garbas]

1.0b2 - 2010-04-21

• 添加了对Decimal字段的支持 [optilude]

• 将registerInterface添加前缀选项，允许将接口用作一系列值的模板，而不是单次使用。[MatthewWilkes]

1.0b1 - 2009-08-02

• 修复了Choice字段的bind()中的bug。[optilude]

1.0a2 - 2009-07-12

• 将API方法和参数更改为mixedCase，以与Zope的其余部分保持一致。这是一个非向后兼容的更改。我们深表歉意，但现在或永不。[optilude]

  如果您发现代码中存在导入错误或未知的关键字参数，请将名称从foo_bar更改为fooBar，例如，for_interface()变为forInterface()。[optilude]

1.0a1 - 2009-04-17

• 初始发布