zeam.utils.batch 1.1

示例

这是一个非常直接的示例。我们需要定义一个工作上下文

>>> import grokcore.view as grok
>>> from persistent import Persistent
>>> from zope.component import queryMultiAdapter
>>> from zeam.utils.batch import Batch
>>> from zeam.utils.batch.interfaces import IBatching

>>> class Content(Persistent):
...     pass

现在，您可以定义一个使用批量并渲染它的视图

>>> class MyViewClass(grok.View):
...     grok.context(Content)
...
...     def update(self):
...          fulllist = [1, 2, 3, 4, 5, 6, 7, 8, 9]
...          self.myitems = Batch(
...                 fulllist , count=3, name='nbs', request=self.request,
...                 factory=lambda x: str(x))
...
...          self.batch = queryMultiAdapter(
...                 (self, self.myitems, self.request),
...                     IBatching)()
...
...     template = grok.PageTemplate('''
...     <tal:navigation tal:replace="structure view/batch" />
...     <span tal:content="item" tal:repeat="item view/myitems" />
...     <tal:navigation tal:replace="structure view/batch" />
...     ''')

这将生效

>>> from grokcore.component import testing
>>> testing.grok_component("view", MyViewClass)
True

>>> from zope.publisher.browser import TestRequest
>>> request = TestRequest()

>>> root = getRootFolder()
>>> root['myObject'] = Content()
>>> myobj = root['myObject']

>>> view = queryMultiAdapter((myobj, request), name="myviewclass")
>>> "batchNav" in view()
True

API

批量

此对象实现了批量。

批量对象使用以下参数实例化

• 要批量的对象列表

• 请求

• 每页项目数（作为count，默认为10）

• 名称（可选）

• 一个工厂，它将在每个迭代之前传递给每个项目（可选）

批量是一个可迭代的对象，其行为类似于列表。它仅提供对当前页面的对象集的访问。

它提供了生成的页数和当前位置。请参阅接口，获取更多信息。

一个多适配器提供 IBatching 可以渲染批次。它适应上下文、批次对象和请求。此组件的 __call__ 方法将返回包含您批次的基本控件（如下一页和上一页链接以及直接访问其他页面的链接）的 HTML 片段。

DateBatch

该对象实现了一个日期范围的批次。它与常规批次具有相同的 API，除了

• 对象列表被一个可调用的函数替换，该函数接收一个 datetime 值作为参数，并返回给定周期内的对象列表

• 计数选项已更改为使用 BATCH_DAY 或 BATCH_MONTH 标记对象。

变更日志