dolmen.forms.crud 1.0

创建

添加表单实现与添加视图紧密相关。由于添加表单的行为在上述内容中已经基本覆盖，我们只需测试表单本身的字段和标签是否存在

>>> addform = addingview.traverse('fremen', [])
>>> addform
<dolmen.forms.crud.tests.AddForm object at ...>

>>> print addform.label
Add: Fremen Warrior

>>> addform.fields.keys()
['title', 'water']

>>> addform.updateForm()
>>> for action in addform.actions: print action
<AddAction Add>
<CancelAction Cancel>

>>> security.endInteraction()

值现在应该已设置

更新

>>> class EditForm(crud.Edit):
...     '''Generic edit form.
...     '''

>>> grokcore.component.testing.grok_component('editform', EditForm)
True

可以通过从 Edit 基类派生来简单地注册一个编辑表单

>>> grokcore.component.name.bind().get(EditForm)
'edit'

默认情况下，注册的 Edit 表单名称为‘edit’

>>> post = TestRequest(form={
...     'form.field.water': '25',
...     'form.field.title': u'Stilgar',
...     'form.action.update': u'Update'},
...     REQUEST_METHOD='POST',
...     )

>>> security.newInteraction(post)

>>> editform = getMultiAdapter((naib, post), name='edit')
>>> editform
<dolmen.forms.crud.tests.EditForm object at ...>

>>> editform.updateForm()
>>> for action in editform.actions: print action
<UpdateAction Update>
<CancelAction Cancel>

>>> editform.fields.keys()
['title', 'water']

注册此表单后，我们可以检查所有字段是否已准备好编辑

>>> naib.title
u'Stilgar'
>>> naib.water
25

>>> security.endInteraction()

读取

一种特殊的表单允许您显示内容

>>> class DefaultView(crud.Display):
...     '''Generic display form.
...     '''

>>> grokcore.component.testing.grok_component('display', DefaultView)
True

>>> security.newInteraction(TestRequest())

>>> view = getMultiAdapter((naib, request), name='defaultview')
>>> view
<dolmen.forms.crud.tests.DefaultView object at ...>

显示表单从字段列表中删除了‘title’。该特定属性直接由模板使用

>>> view.fields.keys()
['water']

显示表单没有操作

>>> len(view.actions)
0

dolmen.forms.crud 为该表单提供了一个非常基本的模板。正如我们所看到的，标题属性用作页面的HTML标题（h1）

>>> print view()
<form action="http://127.0.0.1" method="post"
      enctype="multipart/form-data">
  <h1>Stilgar</h1>
  <div class="fields">
    <div class="field">
        <label class="field-label" for="form-field-water">Number water gallons owned</label>
        <span class="field-required">(required)</span>
        <br />
      25
    </div>
  </div>
</form>

>>> security.endInteraction()

删除

删除表单是一个简单的表单，没有字段，只提供“确认”操作

>>> class DeleteForm(crud.Delete):
...     '''Generic delete form.
...     '''

>>> grokcore.component.testing.grok_component('delete_form', DeleteForm)
True

>>> deleteform = getMultiAdapter((naib, request), name='deleteform')
>>> deleteform
<dolmen.forms.crud.tests.DeleteForm object at ...>

>>> deleteform.updateForm()
>>> for action in deleteform.actions: print action
<DeleteAction Delete>
<CancelAction Cancel>

>>> len(deleteform.fields)
0

确认后，表单将尝试删除对象

>>> post = TestRequest(form={
...     'form.action.delete': u'Delete'},
...     REQUEST_METHOD='POST',
...     )

>>> security.newInteraction(post)

>>> list(sietch.keys())
[u'Fremen']

>>> deleteform = getMultiAdapter((naib, post), name='deleteform')
>>> deleteform.updateForm()

>>> from zope.i18n import translate
>>> translate(deleteform.status, context=post)
u'The object has been deleted.'

>>> list(sietch.keys())
[]

>>> deleteform.response.getStatus()
302
>>> deleteform.response.getHeader('location')
'http://127.0.0.1/sietch'

>>> security.endInteraction()

创建

编辑事件

让我们用同样的检查方法来检查编辑表单

>>> logger = []

我们提供更新所需的数据

>>> request = TestRequest(form={
...     'form.field.water': '10',
...     'form.field.title': u'Sihaya',
...     'form.action.update': u'Update'},
...     REQUEST_METHOD='POST',
...     )

>>> security.newInteraction(request)

>>> chani = Fremen()
>>> root['chani'] = chani

>>> editform = getMultiAdapter((chani, request), name='edit')
>>> editform.updateForm()

我们检查触发的事件

>>> for event in logger: print event
<...ObjectModifiedEvent object at ...>

深入来看，我们可以检查更新后的字段是否在事件描述中正确设置

>>> for desc in logger[0].descriptions:
...   print "%r: %s" % (desc.interface, desc.attributes)
<InterfaceClass dolmen.forms.crud.tests.IDesertWarrior>: ('water', 'title')

>>> chani.title
u'Sihaya'
>>> chani.water
10

>>> security.endInteraction()

字段更新

dolmen.forms.base提供了一个新组件的描述，可以用于原子化对象的更新过程：IFieldUpdate。在dolmen.forms.crud中有一个实现，使用事件处理器，监听ObjectModifiedEvent和ObjectCreatedEvent。

>>> updates = []

>>> from zope.schema import TextLine
>>> from zope.component import adapter, provideAdapter
>>> from zope.interface import implementer
>>> from dolmen.forms.base import IFieldUpdate

>>> @implementer(IFieldUpdate)
... @adapter(Fremen, TextLine)
... def updated_textfield(context, field):
...    updates.append((context, field))

>>> provideAdapter(updated_textfield, name="updatetext")

在使用添加表单时，IFieldUpdate适配器应该在对象创建期间被调用

>>> request = TestRequest(form={
...     'form.field.title': u'Liet',
...     'form.action.add': u'Add'},
...     REQUEST_METHOD='POST',
...     )

>>> request.setPrincipal(manager)
>>> interaction = security.newInteraction(request)

>>> desert = root['desert'] = dolmen.content.Container()
>>> addingview = getMultiAdapter((desert, request), name='add')
>>> addform = addingview.traverse('fremen', [])
>>> addform.updateForm()

>>> kynes = desert['Fremen']
>>> kynes
<dolmen.forms.crud.tests.Fremen object at ...>
>>> kynes.title
u'Liet'

>>> print updates
[(<dolmen.forms.crud.tests.Fremen object at ...>,
<zope.schema._bootstrapfields.TextLine object at ...>)]

>>> security.endInteraction()

我们也可以为编辑表单做同样的事情

>>> updates = []

>>> request = TestRequest(form={
...     'form.field.water': '50',
...     'form.field.title': u'Imperial weather specialist',
...     'form.action.update': u'Update'},
...     REQUEST_METHOD='POST',
...     )

>>> request.setPrincipal(manager)
>>> security.newInteraction(request)

>>> editform = getMultiAdapter((kynes, request), name='edit')
>>> editform.updateForm()

>> kynes.title
u'Imperial weather specialist'

>>> updates
[(<dolmen.forms.crud.tests.Fremen object at ...>, <zope.schema._bootstrapfields.TextLine object at ...>)]

如果没有注册IFieldUpdate适配器，更新字段不应该做任何事情

>>> updates = []

 >>> request = TestRequest(form={
 ...     'form.field.water': '40',
 ...     'form.action.update': u'Update'},
 ...     REQUEST_METHOD='POST',
 ...     )

 >>> editform = getMultiAdapter((kynes, request), name='edit')
 >>> editform.updateForm()

 >>> updates
 []

1.0 (2012-10-24)

• 修复了依赖和测试，反映了相关包中的更改。

1.0b5 (2011-02-16)

• 我们现在使用来自dolmen.content的新get_schema实用函数来获取schema值。这允许以标准化的方式处理schema检索。

1.0b4 (2011-02-16)

• 修复了如果IContent对象没有定义schema时触发事件会失败的问题。

1.0b3 (2011-02-14)

• 添加了一个实用函数，它根据表单、上下文和省略的字段名称列表返回一个Fields实例。

• 现在支持没有schema的对象或类。

• 我们现在使用表单的< cite >getContent方法来获取编辑、显示、删除表单的上下文。

1.0b2 (2011-02-14)

• 适应了最新的dolmen.content更改。

• 标题现在是通过来自zope.dublincore的DCDescriptiveProperties获得的（用于标签）。

• 适应了最新的zeam.form.base更改的测试。

1.0b1 (2010-07-13)

• 使用最新的dolmen.content更改，以显示合理的表单标签。

• 添加了正确的翻译。

• 表单模式现在使用模式标记。

1.0a3 (2010-06-25)

• 添加了缺少的翻译（法语）

• 操作现在使用表单的< cite >getContent方法，以获取适当的形式内容。此外，现在测试内容，以处理DataManagers。导入修复：删除操作现在表现正确。

• 使用最新的dolmen.forms.base版本，改进了错误处理和数据处理以及通知。

1.0a2 (2010-06-05)

• 向输入表单添加了取消操作。

• 修复了提交失败时错误设置不正确的错误。

1.0a1 (2010-06-03)

• 该包现在使用< cite >zeam.form而不是< cite >z3c.form。

• 添加了国际化（法语，英语）

• IObjectInitializedEvent已被移除，因为我们现在使用dolmen.content >= 0.3.1。它已被简单的IObjectAddedEvent所取代。IFieldUpdate触发器相应地进行了修改。

0.4.0 (2010-02-22)

• 清理了依赖和测试。该包现在是100% zope.app免费的。

0.3.0 (2009-11-02)

• 移除了对zope.app.container的依赖。

• 升级到使用ZTK版本（1.0dev）。

0.2.1 (2009-11-02)

• 删除表单现在使用类级别消息来处理成功和失败。

• 更新了测试以覆盖删除错误。

• 在删除操作后更正了重定向URL。

0.2.0 (2009-11-02)

• 添加了DeleteForm

• 为所有表单添加了标题

• 更正了EditForm中的双重nextURL方法。

0.1.0 (2009-10-26)

• 初始发布