Никита Ремизов - Drupal 7 - Работа с очередями Событие: DrupalCafe #3 Дата: 02.03.2013

1. Drupal 7
Работа с очередями

2. Зачем нужен Queue API
• Пакетная обработка
• Выполнение отложенных операции
предотвратить блокировку API сервисами
распределить нагрузку
• Импорт в определенной
последовательности

3. Где реализуется Queue API
Update Batch
module API
Queue
API
Aggregator
module Cron

4. Очередь
Queue table

5. Типы Очередей Reliable и Non Reliable
/modules/system/system.queue.inc
Reliable
место хранения: БД
время жизни: несколько запросов
class BatchQueue extends SystemQueue
class SystemQueue implements DrupalReliableQueueInterface
interface DrupalReliableQueueInterface extends DrupalQueueInterface
Non-Reliable
место хранения: память
время жизни: один запрос
class BatchMemoryQueue extends MemoryQueue
class MemoryQueue implements DrupalQueueInterface

6. Как работать с Queue API
public DrupalQueueInterface::createQueue() {…}
public DrupalQueue::get()
public DrupalQueueInterface {
public function createItem($data) {…}
public function claimItem ($lease_time = 3600) {…}
public function deleteItem($item) {…}
}

7. Queue example module
http://drupal.org/project/examples
Демонстрация:
http://localhost/tests/drupalcafe3/queue_example/insert_remove
Insert: $queue->createItem($form_state['values']['string_to_add']);
Claim: $item = $queue->claimItem($form_state['values']['claim_time']);
Delete: $queue->deleteItem($item);

8. Пример работы
function drupal_cron_run() {
module_invoke_all(‘cron_queue_info’);
module_implements(‘cron’); // and invoke Анкета
Проект
……………………. - Статус =
$queue = DrupalQueue::get($queue_name); - Факт
‘Сотрудник’
while (time() < $end && ($item = $queue->claimItem())) {
$function($item->data);
$queue->deleteItem($item);
}}
/** /**
* Implements hook_cron_queue_info(). * Implements hook_cron().
*/ */
function project_plans_cron_queue_info() { function project_plans_cron() {
$queues['update_project_staff_info'] = array( $interval = variable_get('project_plans_cron_interval', 60 * 60 * 24*14);
'worker callback' => 'update_project_staff_info', if (time() >= variable_get('project_plans_cron_next_ex', 0)) {
'time' => 15, $projects = project_api_projects_list();
); $queue = DrupalQueue::get('update_project_staff_info');
return $queues; foreach ($projects as $project_nid) {
} $result = project_api_project_i($project_nid);
$queue->createItem($result[$project_nid]);
}
variable_set('project_plans_cron_next_ex', time() + $interval);
}
}

9. function update_project_staff_info($project_info) {
$node = node_load($project_info->nid);
$node->project_m_plan[LANGUAGE_NONE][0]['value'] = $project_info->PLAN;
$node->project_m_fact[LANGUAGE_NONE][0]['value'] = $project_info->FACT;
$node->project_m_route[LANGUAGE_NONE][0]['value'] = $project_info->ROUTE;
// Make this change a new revision
$node->revision = 1;
$node->log = t('This node :node was programmatically updated at :date by project_plans module.
Staff fact number - :fact. Staff plan number - :plan. Roate of staff - :route', array(
':node' => $project_info->nid,
':date' => date('c'),
':plan' => $project_info->PLAN,
':fact' => $project_info->FACT,
':route' => $project_info->ROUTE,
));
node_save($node);
watchdog('content', '@type: for %title node(:nid) was created a new revision.', array('@type' => $node->type, ':nid' => $node-
>nid, '%title' => $node->title));
}

10. Демонстрация
http://erp.retail-spb.ru/project/geyzer-regiony

11. Queue API – Drupal 8
core/includes/common.inc
Queue()
Core/lib/Drupal/Core/Queue
Batch
BatchMemory
DatabaseQueue
Memory
QueueDatabaseFactory
QueueFactory
QueueInterface
ReliableQueueInterface

12. Спасибо за внимание
• http://www.ent.iastate.edu/it/Batch_and_Queue.pdf
• http://www.hashbangcode.com/blog/drupal-7-queues-api-579.html
• http://rbayliss.net/drupal-queue-api

13. Вопросы
public DrupalQueueInterface::createQueue()
public DrupalQueue::get()
public DrupalQueueInterface::createItem($data)
public DrupalQueueInterface::claimItem ($lease_time = 3600)
public DrupalQueueInterface::deleteItem($item)
hook_cron()
hook_cron_queue_info()