3 * Laconica - a distributed open-source microblogging tool
4 * Copyright (C) 2008, 2009, Control Yourself, Inc.
6 * This program is free software: you can redistribute it and/or modify
7 * it under the terms of the GNU Affero General Public License as published by
8 * the Free Software Foundation, either version 3 of the License, or
9 * (at your option) any later version.
11 * This program is distributed in the hope that it will be useful,
12 * but WITHOUT ANY WARRANTY; without even the implied warranty of
13 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
14 * GNU Affero General Public License for more details.
16 * You should have received a copy of the GNU Affero General Public License
17 * along with this program. If not, see <http://www.gnu.org/licenses/>.
20 if (!defined('LACONICA')) { exit(1); }
22 require_once(INSTALLDIR.'/lib/daemon.php');
23 require_once(INSTALLDIR.'/classes/Queue_item.php');
24 require_once(INSTALLDIR.'/classes/Notice.php');
26 define('CLAIM_TIMEOUT', 1200);
27 define('QUEUE_HANDLER_MISS_IDLE', 10);
28 define('QUEUE_HANDLER_HIT_IDLE', 10);
30 class QueueHandler extends Daemon
34 function __construct($id=null, $daemonize=true)
36 parent::__construct($daemonize);
50 return ucfirst($this->transport()) . 'Handler';
55 return strtolower($this->class_name().'.'.$this->get_id());
81 function handle_notice($notice)
88 if (!$this->start()) {
92 $this->log(LOG_INFO, 'checking for queued notices');
94 $queue = $this->transport();
95 $timeout = $this->timeout();
97 $qm = QueueManager::get();
100 $this->log(LOG_DEBUG, 'Checking for notices...');
101 $notice = $qm->nextItem($queue, $timeout);
102 if (empty($notice)) {
103 $this->log(LOG_DEBUG, 'No notices waiting; idling.');
104 // Nothing in the queue. Do you
105 // have other tasks, like servicing your
106 // XMPP connection, to do?
107 $this->idle(QUEUE_HANDLER_MISS_IDLE);
109 $this->log(LOG_INFO, 'Got notice '. $notice->id);
111 if ($this->handle_notice($notice)) {
112 $this->log(LOG_INFO, 'Successfully handled notice '. $notice->id);
113 $qm->done($notice, $queue);
115 $this->log(LOG_INFO, 'Failed to handle notice '. $notice->id);
116 $qm->fail($notice, $queue);
118 // Chance to e.g. service your XMPP connection
119 $this->log(LOG_DEBUG, 'Idling after success.');
120 $this->idle(QUEUE_HANDLER_HIT_IDLE);
122 // XXX: when do we give up?
125 if (!$this->finish()) {
131 function idle($timeout=0)
138 function log($level, $msg)
140 common_log($level, $this->class_name() . ' ('. $this->get_id() .'): '.$msg);