z3c.language.negotiator 1.1.3

协商器

此包提供了在zope.i18n.interfaces中定义的INegotiator接口的本地实现。协商器实现提供了一些额外的有用属性，将在后面进行解释。此INegotiator也用于z3c.language.switch包。

让我们设置一个协商器

>>> from z3c.language.negotiator import app
>>> negotiator = app.Negotiator()

此类协商器提供以下接口

>>> from zope.i18n.interfaces import INegotiator
>>> from z3c.language.negotiator.interfaces import INegotiatorManager

>>> INegotiator.providedBy(negotiator)
True
>>>
>>> INegotiatorManager.providedBy(negotiator)
True
>>>

默认情况下，协商器具有以下值

>>> negotiator.policy
'session --> browser --> server'

>>> negotiator.serverLanguage
u'en'

>>> negotiator.offeredLanguages
[]

如果我们设置了一个具有错误值的策略，我们将得到一个ValueError

>>> negotiator.policy = u'wrong'
Traceback (most recent call last):
...
ValueError: ('Not a valid policy name.', u'wrong')

将协商器注册为全局实用工具

>>> import zope.component
>>> zope.component.provideUtility(negotiator, INegotiator)

现在我们可以使用词汇表并查看哪些提供的语言可用

>>> from z3c.language.negotiator import vocabulary
>>> vocab = vocabulary.OfferedLanguagesVocabulary(None)
>>> vocab
<z3c.language.negotiator.vocabulary.OfferedLanguagesVocabulary object at ...>

>>> vocab._terms
[]

添加一些提供的语言并再次检查词汇表

>>> negotiator.offeredLanguages = [u'de', u'fr']
>>> negotiator.offeredLanguages
[u'de', u'fr']

尝试获取实用工具并再次检查提供的语言

>>> util = zope.component.getUtility(INegotiator)
>>> util.offeredLanguages
[u'de', u'fr']

现在再次检查词汇表

>>> vocab = vocabulary.OfferedLanguagesVocabulary(None)
>>> vocab._terms[0].value
u'de'
>>> vocab._terms[0].token
'de'
>>> vocab._terms[0].title
u'de'
>>> vocab._terms[1].value
u'fr'
>>> vocab._terms[1].token
'fr'
>>> vocab._terms[1].title
u'fr'

请参阅tests.py以获取更多测试。

更改记录