3 * StatusNet - the distributed open-source microblogging tool
4 * Copyright (C) 2010, StatusNet, 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('STATUSNET')) {
25 * Prepare PuSH and Salmon distributions for an outgoing message.
27 * @package OStatusPlugin
28 * @author Brion Vibber <brion@status.net>
30 class OStatusQueueHandler extends QueueHandler
32 // If we have more than this many subscribing sites on a single feed,
33 // break up the PuSH distribution into smaller batches which will be
34 // rolled into the queue progressively. This reduces disruption to
35 // other, shorter activities being enqueued while we work.
36 const MAX_UNBATCHED = 50;
38 // Each batch (a 'hubprep' entry) will have this many items.
39 // Selected to provide a balance between queue packet size
40 // and number of batches that will end up getting processed.
41 // For 20,000 target sites, 1000 should work acceptably.
42 const BATCH_SIZE = 1000;
49 function handle($notice)
51 assert($notice instanceof Notice);
53 $this->notice = $notice;
54 $this->user = User::staticGet('id', $notice->profile_id);
58 foreach ($notice->getGroups() as $group) {
59 $oprofile = Ostatus_profile::staticGet('group_id', $group->id);
61 $this->pingReply($oprofile);
63 $this->pushGroup($group->id);
67 foreach ($notice->getReplies() as $profile_id) {
68 $oprofile = Ostatus_profile::staticGet('profile_id', $profile_id);
70 $this->pingReply($oprofile);
74 if (!empty($this->notice->reply_to)) {
75 $replyTo = Notice::staticGet('id', $this->notice->reply_to);
76 if (!empty($replyTo)) {
77 foreach($replyTo->getReplies() as $profile_id) {
78 $oprofile = Ostatus_profile::staticGet('profile_id', $profile_id);
80 $this->pingReply($oprofile);
86 foreach ($notice->getProfileTags() as $ptag) {
87 $oprofile = Ostatus_profile::staticGet('peopletag_id', $ptag->id);
89 $this->pushPeopletag($ptag);
99 // For local posts, ping the PuSH hub to update their feed.
100 // http://identi.ca/api/statuses/user_timeline/1.atom
101 $feed = common_local_url('ApiTimelineUser',
102 array('id' => $this->user->id,
103 'format' => 'atom'));
104 $this->pushFeed($feed, array($this, 'userFeedForNotice'));
108 function pushGroup($group_id)
110 // For a local group, ping the PuSH hub to update its feed.
111 // Updates may come from either a local or a remote user.
112 $feed = common_local_url('ApiTimelineGroup',
113 array('id' => $group_id,
114 'format' => 'atom'));
115 $this->pushFeed($feed, array($this, 'groupFeedForNotice'), $group_id);
118 function pushPeopletag($ptag)
120 // For a local people tag, ping the PuSH hub to update its feed.
121 // Updates may come from either a local or a remote user.
122 $feed = common_local_url('ApiTimelineList',
123 array('id' => $ptag->id,
124 'user' => $ptag->tagger,
125 'format' => 'atom'));
126 $this->pushFeed($feed, array($this, 'peopletagFeedForNotice'), $ptag);
129 function pingReply($oprofile)
132 // For local posts, send a Salmon ping to the mentioned
133 // remote user or group.
134 // @fixme as an optimization we can skip this if the
135 // remote profile is subscribed to the author.
136 $oprofile->notifyDeferred($this->notice, $this->user);
141 * @param string $feed URI to the feed
142 * @param callable $callback function to generate Atom feed update if needed
143 * any additional params are passed to the callback.
145 function pushFeed($feed, $callback)
147 $hub = common_config('ostatus', 'hub');
149 $this->pushFeedExternal($feed, $hub);
155 $args = array_slice(func_get_args(), 2);
156 $atom = call_user_func_array($callback, $args);
157 $this->pushFeedInternal($atom, $sub);
159 common_log(LOG_INFO, "No PuSH subscribers for $feed");
165 * Ping external hub about this update.
166 * The hub will pull the feed and check for new items later.
167 * Not guaranteed safe in an environment with database replication.
169 * @param string $feed feed topic URI
170 * @param string $hub PuSH hub URI
171 * @fixme can consolidate pings for user & group posts
173 function pushFeedExternal($feed, $hub)
175 $client = new HTTPClient();
177 $data = array('hub.mode' => 'publish',
179 $response = $client->post($hub, array(), $data);
180 if ($response->getStatus() == 204) {
181 common_log(LOG_INFO, "PuSH ping to hub $hub for $feed ok");
184 common_log(LOG_ERR, "PuSH ping to hub $hub for $feed failed with HTTP " .
185 $response->getStatus() . ': ' .
186 $response->getBody());
188 } catch (Exception $e) {
189 common_log(LOG_ERR, "PuSH ping to hub $hub for $feed failed: " . $e->getMessage());
195 * Queue up direct feed update pushes to subscribers on our internal hub.
196 * If there are a large number of subscriber sites, intermediate bulk
197 * distribution triggers may be queued.
199 * @param string $atom update feed, containing only new/changed items
200 * @param HubSub $sub open query of subscribers
202 function pushFeedInternal($atom, $sub)
204 common_log(LOG_INFO, "Preparing $sub->N PuSH distribution(s) for $sub->topic");
207 while ($sub->fetch()) {
209 if ($n < self::MAX_UNBATCHED) {
210 $sub->distribute($atom);
212 $batch[] = $sub->callback;
213 if (count($batch) >= self::BATCH_SIZE) {
214 $sub->bulkDistribute($atom, $batch);
219 if (count($batch) >= 0) {
220 $sub->bulkDistribute($atom, $batch);
225 * Build a single-item version of the sending user's Atom feed.
228 function userFeedForNotice()
230 $atom = new AtomUserNoticeFeed($this->user);
231 $atom->addEntryFromNotice($this->notice);
232 $feed = $atom->getString();
237 function groupFeedForNotice($group_id)
239 $group = User_group::staticGet('id', $group_id);
241 $atom = new AtomGroupNoticeFeed($group);
242 $atom->addEntryFromNotice($this->notice);
243 $feed = $atom->getString();
248 function peopletagFeedForNotice($ptag)
250 $atom = new AtomListNoticeFeed($ptag);
251 $atom->addEntryFromNotice($this->notice);
252 $feed = $atom->getString();