Принцип действия

Компонент ng.app.objectqueue ассоциируется с любым объектом как аннотация или регистрируется как утилита в сайт-менеджере (в последнем случае ее действие распространяется на весь сайт). Специальный диспетчер перехватывает события, связанные с созданием, удалением или модификацией объектов и диспетчеризует их для всех компонентов ng.app.objectqueue, которые должны его учесть. Порядок обхода диспетчером очередей имеет большое значение, так как для любой очереди можно установить флаг islast и прервать таким образом процедуру обхода. Первыми обходятся очереди в контейнерах, от вложенных к облегающим, затем - утилиты в сайтменеджерах, также, от вложенных к облегающим.

Каждый компонент ng.app.objectqueue ведет небольшой перечень вложенных объектов, основанный на утилите IIntIds, что позволяет сэкономить ресурс обслуживания очередей.

Требования к установке и настройке

Обратите внимание, для полноценной работы ng.app.objectqueue, необходима установка продукта ng.utility, компонент которого, ng.utility.objecteventchanel, преобразует события (добавления, удаления и др) в понятный хендлерам ng.app.objectqueue. Использование ng.utility.objecteventchannel намного более эффективно, чем явная проверка в хендлере на наличие интерфейса.

Возможны два варианта установки: установка для сайта и установка для отдельного контейнера (компонента). В любом случае, до начала работ с ng.app.objectqueue, в сайт-менеджере должна быть зарегистрирована утилита IIntIds, кроме того, компонент ng.app.objectqueue ведет очередь только тех компонентов, которые предоставляют интерфейс:

ng.app.objectqueue.interfaces.IObjectQueueAble

поэтому нужно установить этот интерфейс для всех компонентов, обслуживаемых очередью. Статическая установка проводится указанием следующей директивы ZCML:

<class class="zope.app.file.file.File">
  <implements interface="ng.app.objectqueue.interfaces.IObjectQueueAble" />
</class>

Для динамической установки можно использовать продукт ng.schema.interfaceswitcher.

ng.app.objectqueue.objectqueueannotation.interfaces.IObjectQueueAnnotable

<class class="zope.app.folder.folder.Folder">
  <implements
      interface="ng.app.objectqueue.objectqueueannotation.interfaces.IObjectQueueAnnotable"
      />
</class>

Использование ng.app.objectqueue

Самый простой способ использования ng.app.objectqueue - это воспользоваться готовым продуктом, таким как ng.app.rss - компонентом публикации Atom-фидов. Возможен и непосредственный вызов, например, в темплейте:

<tal:block
    repeat="item context/++nsinterface++ng.app.objectqueue.interfaces.IObjectQueue.values()">
    <a tal:content="item/title" tal:attributes="href item/@@absolute_url"/>
</tal:block>

В этом случае будет выведен список ссылок на новые поступления в текущем контейнере и (зависит от настроек) вложенных в него контейнеров, что, как нетрудно заметить, намного быстрее просмотра всего содержимого контейнера.

Заключение

Использование ng.app.objectqueue предполагает некоторое разумное соглашение между экономией на скорости просмотра вложенных контейнеров при частом обращении и экономии на скорости внесения и удаления новых объектов при редактировании. Необходимо отметить, что хотя результат просмотра вложенных контейнеров также может быть запомнен и сохранен, все-таки использование ng.app.objectqueue обладает тем неоспоримым преимуществом, что происходит активация существенно меньшего количества объектов (в условиях реальных сайтов - одного-четырех), что значительно менее ресурсоемко по сравнению с просмотром.

Другое возможное решение - использование специальных индексов поискового каталога - отличается меньшей устойчивостью к конфликтам, хотя и дает большую гибкость.