# -*- coding: utf-8 -*- # Copyright 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. import logging from twisted.internet import defer from ._base import SQLBaseStore logger = logging.getLogger(__name__) # XXX: This feels like it should belong in a "models" module, not storage. class ApplicationService(object): """Defines an application service. Provides methods to check if this service is "interested" in events. """ def __init__(self, token, url=None, namespaces=None): self.token = token if url: self.url = url if namespaces: self._set_namespaces(namespaces) def _set_namespaces(self, namespaces): # Sanity check that it is of the form: # { # users: ["regex",...], # aliases: ["regex",...], # rooms: ["regex",...], # } for ns in ["users", "rooms", "aliases"]: if type(namespaces[ns]) != list: raise ValueError("Bad namespace value for '%s'", ns) for regex in namespaces[ns]: if not isinstance(regex, basestring): raise ValueError("Expected string regex for ns '%s'", ns) self.namespaces = namespaces def is_interested(self, event): """Check if this service is interested in this event. Args: event(Event): The event to check. Returns: bool: True if this service would like to know about this event. """ # NB: This does not check room alias regex matches because that requires # more context that an Event can provide. Room alias matches are checked # in the ApplicationServiceHandler. # TODO check if event.room_id regex matches # TODO check if event.user_id regex matches (or m.room.member state_key) return True def __str__(self): return "ApplicationService: %s" % (self.__dict__,) class ApplicationServiceCache(object): """Caches ApplicationServices and provides utility functions on top. This class is designed to be invoked on incoming events in order to avoid hammering the database every time to extract a list of application service regexes. """ def __init__(self): self.services = [] def get_services_for_event(self, event): """Retrieve a list of application services interested in this event. Args: event(Event): The event to check. Returns: list: A list of services interested in this event based on the service regex. """ interested_list = [ s for s in self.services if s.is_event_claimed(event) ] return interested_list class ApplicationServiceStore(SQLBaseStore): def __init__(self, hs): super(ApplicationServiceStore, self).__init__(hs) self.cache = ApplicationServiceCache() self._populate_cache() def unregister_app_service(self, token): """Unregisters this service. This removes all AS specific regex and the base URL. The token is the only thing preserved for future registration attempts. """ # TODO: DELETE FROM application_services_regex WHERE id=this service # TODO: SET url=NULL WHERE token=token # TODO: Update cache pass def update_app_service(self, service): """Update an application service, clobbering what was previously there. Args: service(ApplicationService): The updated service. """ # NB: There is no "insert" since we provide no public-facing API to # allocate new ASes. It relies on the server admin inserting the AS # token into the database manually. # TODO: UPDATE application_services, SET url WHERE token=service.token # TODO: DELETE FROM application_services_regex WHERE id=this service # TODO: INSERT INTO application_services_regex # TODO: Update cache pass def get_services_for_event(self, event): return self.cache.get_services_for_event(event) def get_app_service(self, token, from_cache=True): """Get the application service with the given token. Args: token (str): The application service token. from_cache (bool): True to get this service from the cache, False to check the database. Raises: StoreError if there was a problem retrieving this service. """ if from_cache: for service in self.cache.services: if service.token == token: return service return None # TODO: The from_cache=False impl # TODO: This should be JOINed with the application_services_regex table. @defer.inlineCallbacks def _populate_cache(self): """Populates the ApplicationServiceCache from the database.""" sql = ("SELECT * FROM application_services LEFT JOIN " "application_services_regex ON application_services.id = " "application_services_regex.as_id") namespace_enum = [ "users", # 0 "aliases", # 1 "rooms" # 2 ] # SQL results in the form: # [ # { # 'regex': "something", # 'url': "something", # 'namespace': enum, # 'as_id': 0, # 'token': "something", # 'id': 0 # } # ] services = {} results = yield self._execute_and_decode(sql) for res in results: as_token = res["token"] if as_token not in services: # add the service services[as_token] = { "url": res["url"], "token": as_token, "namespaces": { "users": [], "aliases": [], "rooms": [] } } # add the namespace regex if one exists ns_int = res["namespace"] if ns_int is None: continue try: services[as_token]["namespaces"][namespace_enum[ns_int]].append( res["regex"] ) except IndexError: logger.error("Bad namespace enum '%s'. %s", ns_int, res) for service in services.values(): logger.info("Found application service: %s", service) self.cache.services.append(ApplicationService( service["token"], service["url"], service["namespaces"] ))