485 lines
15 KiB
Python
485 lines
15 KiB
Python
# -*- coding: utf-8 -*-
|
|
# Copyright 2014, 2015 OpenMarket Ltd
|
|
#
|
|
# Licensed under the Apache License, Version 2.0 (the "License");
|
|
# you may not use this file except in compliance with the License.
|
|
# You may obtain a copy of the License at
|
|
#
|
|
# http://www.apache.org/licenses/LICENSE-2.0
|
|
#
|
|
# Unless required by applicable law or agreed to in writing, software
|
|
# distributed under the License is distributed on an "AS IS" BASIS,
|
|
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
# See the License for the specific language governing permissions and
|
|
# limitations under the License.
|
|
|
|
from twisted.internet import defer
|
|
|
|
from synapse.util.logutils import log_function
|
|
from synapse.types import StreamToken
|
|
import synapse.metrics
|
|
|
|
import logging
|
|
|
|
|
|
logger = logging.getLogger(__name__)
|
|
|
|
metrics = synapse.metrics.get_metrics_for(__name__)
|
|
|
|
notified_events_counter = metrics.register_counter("notified_events")
|
|
|
|
|
|
# TODO(paul): Should be shared somewhere
|
|
def count(func, l):
|
|
"""Return the number of items in l for which func returns true."""
|
|
n = 0
|
|
for x in l:
|
|
if func(x):
|
|
n += 1
|
|
return n
|
|
|
|
|
|
class _NotificationListener(object):
|
|
""" This represents a single client connection to the events stream.
|
|
|
|
The events stream handler will have yielded to the deferred, so to
|
|
notify the handler it is sufficient to resolve the deferred.
|
|
|
|
This listener will also keep track of which rooms it is listening in
|
|
so that it can remove itself from the indexes in the Notifier class.
|
|
"""
|
|
|
|
def __init__(self, user, rooms, from_token, limit, timeout, deferred,
|
|
appservice=None):
|
|
self.user = user
|
|
self.appservice = appservice
|
|
self.from_token = from_token
|
|
self.limit = limit
|
|
self.timeout = timeout
|
|
self.deferred = deferred
|
|
self.rooms = rooms
|
|
self.timer = None
|
|
|
|
def notified(self):
|
|
return self.deferred.called
|
|
|
|
def notify(self, notifier, events, start_token, end_token):
|
|
""" Inform whoever is listening about the new events. This will
|
|
also remove this listener from all the indexes in the Notifier
|
|
it knows about.
|
|
"""
|
|
|
|
result = (events, (start_token, end_token))
|
|
|
|
try:
|
|
self.deferred.callback(result)
|
|
notified_events_counter.inc_by(len(events))
|
|
except defer.AlreadyCalledError:
|
|
pass
|
|
|
|
# Should the following be done be using intrusively linked lists?
|
|
# -- erikj
|
|
|
|
for room in self.rooms:
|
|
lst = notifier.room_to_listeners.get(room, set())
|
|
lst.discard(self)
|
|
|
|
notifier.user_to_listeners.get(self.user, set()).discard(self)
|
|
|
|
if self.appservice:
|
|
notifier.appservice_to_listeners.get(
|
|
self.appservice, set()
|
|
).discard(self)
|
|
|
|
# Cancel the timeout for this notifer if one exists.
|
|
if self.timer is not None:
|
|
try:
|
|
notifier.clock.cancel_call_later(self.timer)
|
|
except:
|
|
logger.warn("Failed to cancel notifier timer")
|
|
|
|
|
|
class Notifier(object):
|
|
""" This class is responsible for notifying any listeners when there are
|
|
new events available for it.
|
|
|
|
Primarily used from the /events stream.
|
|
"""
|
|
|
|
def __init__(self, hs):
|
|
self.hs = hs
|
|
|
|
self.room_to_listeners = {}
|
|
self.user_to_listeners = {}
|
|
self.appservice_to_listeners = {}
|
|
|
|
self.event_sources = hs.get_event_sources()
|
|
|
|
self.clock = hs.get_clock()
|
|
|
|
hs.get_distributor().observe(
|
|
"user_joined_room", self._user_joined_room
|
|
)
|
|
|
|
# This is not a very cheap test to perform, but it's only executed
|
|
# when rendering the metrics page, which is likely once per minute at
|
|
# most when scraping it.
|
|
def count_listeners():
|
|
all_listeners = set()
|
|
|
|
for x in self.room_to_listeners.values():
|
|
all_listeners |= x
|
|
for x in self.user_to_listeners.values():
|
|
all_listeners |= x
|
|
for x in self.appservice_to_listeners.values():
|
|
all_listeners |= x
|
|
|
|
return len(all_listeners)
|
|
metrics.register_callback("listeners", count_listeners)
|
|
|
|
metrics.register_callback(
|
|
"rooms",
|
|
lambda: count(bool, self.room_to_listeners.values()),
|
|
)
|
|
metrics.register_callback(
|
|
"users",
|
|
lambda: count(bool, self.user_to_listeners.values()),
|
|
)
|
|
metrics.register_callback(
|
|
"appservices",
|
|
lambda: count(bool, self.appservice_to_listeners.values()),
|
|
)
|
|
|
|
@log_function
|
|
@defer.inlineCallbacks
|
|
def on_new_room_event(self, event, extra_users=[]):
|
|
""" Used by handlers to inform the notifier something has happened
|
|
in the room, room event wise.
|
|
|
|
This triggers the notifier to wake up any listeners that are
|
|
listening to the room, and any listeners for the users in the
|
|
`extra_users` param.
|
|
"""
|
|
# poke any interested application service.
|
|
self.hs.get_handlers().appservice_handler.notify_interested_services(
|
|
event
|
|
)
|
|
|
|
room_id = event.room_id
|
|
|
|
room_source = self.event_sources.sources["room"]
|
|
|
|
room_listeners = self.room_to_listeners.get(room_id, set())
|
|
|
|
_discard_if_notified(room_listeners)
|
|
|
|
listeners = room_listeners.copy()
|
|
|
|
for user in extra_users:
|
|
user_listeners = self.user_to_listeners.get(user, set())
|
|
|
|
_discard_if_notified(user_listeners)
|
|
|
|
listeners |= user_listeners
|
|
|
|
for appservice in self.appservice_to_listeners:
|
|
# TODO (kegan): Redundant appservice listener checks?
|
|
# App services will already be in the room_to_listeners set, but
|
|
# that isn't enough. They need to be checked here in order to
|
|
# receive *invites* for users they are interested in. Does this
|
|
# make the room_to_listeners check somewhat obselete?
|
|
if appservice.is_interested(event):
|
|
app_listeners = self.appservice_to_listeners.get(
|
|
appservice, set()
|
|
)
|
|
|
|
_discard_if_notified(app_listeners)
|
|
|
|
listeners |= app_listeners
|
|
|
|
logger.debug("on_new_room_event listeners %s", listeners)
|
|
|
|
# TODO (erikj): Can we make this more efficient by hitting the
|
|
# db once?
|
|
|
|
@defer.inlineCallbacks
|
|
def notify(listener):
|
|
events, end_key = yield room_source.get_new_events_for_user(
|
|
listener.user,
|
|
listener.from_token.room_key,
|
|
listener.limit,
|
|
)
|
|
|
|
if events:
|
|
end_token = listener.from_token.copy_and_replace(
|
|
"room_key", end_key
|
|
)
|
|
|
|
listener.notify(
|
|
self, events, listener.from_token, end_token
|
|
)
|
|
|
|
def eb(failure):
|
|
logger.exception("Failed to notify listener", failure)
|
|
|
|
yield defer.DeferredList(
|
|
[notify(l).addErrback(eb) for l in listeners],
|
|
consumeErrors=True,
|
|
)
|
|
|
|
@defer.inlineCallbacks
|
|
@log_function
|
|
def on_new_user_event(self, users=[], rooms=[]):
|
|
""" Used to inform listeners that something has happend
|
|
presence/user event wise.
|
|
|
|
Will wake up all listeners for the given users and rooms.
|
|
"""
|
|
# TODO(paul): This is horrible, having to manually list every event
|
|
# source here individually
|
|
presence_source = self.event_sources.sources["presence"]
|
|
typing_source = self.event_sources.sources["typing"]
|
|
|
|
listeners = set()
|
|
|
|
for user in users:
|
|
user_listeners = self.user_to_listeners.get(user, set())
|
|
|
|
_discard_if_notified(user_listeners)
|
|
|
|
listeners |= user_listeners
|
|
|
|
for room in rooms:
|
|
room_listeners = self.room_to_listeners.get(room, set())
|
|
|
|
_discard_if_notified(room_listeners)
|
|
|
|
listeners |= room_listeners
|
|
|
|
@defer.inlineCallbacks
|
|
def notify(listener):
|
|
presence_events, presence_end_key = (
|
|
yield presence_source.get_new_events_for_user(
|
|
listener.user,
|
|
listener.from_token.presence_key,
|
|
listener.limit,
|
|
)
|
|
)
|
|
typing_events, typing_end_key = (
|
|
yield typing_source.get_new_events_for_user(
|
|
listener.user,
|
|
listener.from_token.typing_key,
|
|
listener.limit,
|
|
)
|
|
)
|
|
|
|
if presence_events or typing_events:
|
|
end_token = listener.from_token.copy_and_replace(
|
|
"presence_key", presence_end_key
|
|
).copy_and_replace(
|
|
"typing_key", typing_end_key
|
|
)
|
|
|
|
listener.notify(
|
|
self,
|
|
presence_events + typing_events,
|
|
listener.from_token,
|
|
end_token
|
|
)
|
|
|
|
def eb(failure):
|
|
logger.error(
|
|
"Failed to notify listener",
|
|
exc_info=(
|
|
failure.type,
|
|
failure.value,
|
|
failure.getTracebackObject())
|
|
)
|
|
|
|
yield defer.DeferredList(
|
|
[notify(l).addErrback(eb) for l in listeners],
|
|
consumeErrors=True,
|
|
)
|
|
|
|
@defer.inlineCallbacks
|
|
def wait_for_events(self, user, rooms, filter, timeout, callback):
|
|
"""Wait until the callback returns a non empty response or the
|
|
timeout fires.
|
|
"""
|
|
|
|
deferred = defer.Deferred()
|
|
|
|
from_token = StreamToken("s0", "0", "0")
|
|
|
|
listener = [_NotificationListener(
|
|
user=user,
|
|
rooms=rooms,
|
|
from_token=from_token,
|
|
limit=1,
|
|
timeout=timeout,
|
|
deferred=deferred,
|
|
)]
|
|
|
|
if timeout:
|
|
self._register_with_keys(listener[0])
|
|
|
|
result = yield callback()
|
|
timer = [None]
|
|
|
|
if timeout:
|
|
timed_out = [False]
|
|
|
|
def _timeout_listener():
|
|
timed_out[0] = True
|
|
timer[0] = None
|
|
listener[0].notify(self, [], from_token, from_token)
|
|
|
|
# We create multiple notification listeners so we have to manage
|
|
# canceling the timeout ourselves.
|
|
timer[0] = self.clock.call_later(timeout/1000., _timeout_listener)
|
|
|
|
while not result and not timed_out[0]:
|
|
yield deferred
|
|
deferred = defer.Deferred()
|
|
listener[0] = _NotificationListener(
|
|
user=user,
|
|
rooms=rooms,
|
|
from_token=from_token,
|
|
limit=1,
|
|
timeout=timeout,
|
|
deferred=deferred,
|
|
)
|
|
self._register_with_keys(listener[0])
|
|
result = yield callback()
|
|
|
|
if timer[0] is not None:
|
|
try:
|
|
self.clock.cancel_call_later(timer[0])
|
|
except:
|
|
logger.exception("Failed to cancel notifer timer")
|
|
|
|
defer.returnValue(result)
|
|
|
|
def get_events_for(self, user, rooms, pagination_config, timeout):
|
|
""" For the given user and rooms, return any new events for them. If
|
|
there are no new events wait for up to `timeout` milliseconds for any
|
|
new events to happen before returning.
|
|
"""
|
|
deferred = defer.Deferred()
|
|
|
|
self._get_events(
|
|
deferred, user, rooms, pagination_config.from_token,
|
|
pagination_config.limit, timeout
|
|
).addErrback(deferred.errback)
|
|
|
|
return deferred
|
|
|
|
@defer.inlineCallbacks
|
|
def _get_events(self, deferred, user, rooms, from_token, limit, timeout):
|
|
if not from_token:
|
|
from_token = yield self.event_sources.get_current_token()
|
|
|
|
appservice = yield self.hs.get_datastore().get_app_service_by_user_id(
|
|
user.to_string()
|
|
)
|
|
|
|
listener = _NotificationListener(
|
|
user,
|
|
rooms,
|
|
from_token,
|
|
limit,
|
|
timeout,
|
|
deferred,
|
|
appservice=appservice
|
|
)
|
|
|
|
def _timeout_listener():
|
|
# TODO (erikj): We should probably set to_token to the current
|
|
# max rather than reusing from_token.
|
|
# Remove the timer from the listener so we don't try to cancel it.
|
|
listener.timer = None
|
|
listener.notify(
|
|
self,
|
|
[],
|
|
listener.from_token,
|
|
listener.from_token,
|
|
)
|
|
|
|
if timeout:
|
|
self._register_with_keys(listener)
|
|
|
|
yield self._check_for_updates(listener)
|
|
|
|
if not timeout:
|
|
_timeout_listener()
|
|
else:
|
|
# Only add the timer if the listener hasn't been notified
|
|
if not listener.notified():
|
|
listener.timer = self.clock.call_later(
|
|
timeout/1000.0, _timeout_listener
|
|
)
|
|
return
|
|
|
|
@log_function
|
|
def _register_with_keys(self, listener):
|
|
for room in listener.rooms:
|
|
s = self.room_to_listeners.setdefault(room, set())
|
|
s.add(listener)
|
|
|
|
self.user_to_listeners.setdefault(listener.user, set()).add(listener)
|
|
|
|
if listener.appservice:
|
|
self.appservice_to_listeners.setdefault(
|
|
listener.appservice, set()
|
|
).add(listener)
|
|
|
|
@defer.inlineCallbacks
|
|
@log_function
|
|
def _check_for_updates(self, listener):
|
|
# TODO (erikj): We need to think about limits across multiple sources
|
|
events = []
|
|
|
|
from_token = listener.from_token
|
|
limit = listener.limit
|
|
|
|
# TODO (erikj): DeferredList?
|
|
for name, source in self.event_sources.sources.items():
|
|
keyname = "%s_key" % name
|
|
|
|
stuff, new_key = yield source.get_new_events_for_user(
|
|
listener.user,
|
|
getattr(from_token, keyname),
|
|
limit,
|
|
)
|
|
|
|
events.extend(stuff)
|
|
|
|
from_token = from_token.copy_and_replace(keyname, new_key)
|
|
|
|
end_token = from_token
|
|
|
|
if events:
|
|
listener.notify(self, events, listener.from_token, end_token)
|
|
|
|
defer.returnValue(listener)
|
|
|
|
def _user_joined_room(self, user, room_id):
|
|
new_listeners = self.user_to_listeners.get(user, set())
|
|
|
|
listeners = self.room_to_listeners.setdefault(room_id, set())
|
|
listeners |= new_listeners
|
|
|
|
for l in new_listeners:
|
|
l.rooms.add(room_id)
|
|
|
|
|
|
def _discard_if_notified(listener_set):
|
|
"""Remove any 'stale' listeners from the given set.
|
|
"""
|
|
to_discard = set()
|
|
for l in listener_set:
|
|
if l.notified():
|
|
to_discard.add(l)
|
|
|
|
listener_set -= to_discard
|