mirror of
https://mau.dev/maunium/synapse.git
synced 2024-10-01 01:36:05 -04:00
c66a06ac6b
This is in preparation for having multiple data stores that offer different functionality, e.g. splitting out state or event storage.
112 lines
3.2 KiB
Python
112 lines
3.2 KiB
Python
# -*- coding: utf-8 -*-
|
|
# Copyright 2019 New Vector 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
|
|
|
|
import attr
|
|
|
|
from synapse.api.errors import SynapseError
|
|
|
|
logger = logging.getLogger(__name__)
|
|
|
|
|
|
@attr.s
|
|
class PaginationChunk(object):
|
|
"""Returned by relation pagination APIs.
|
|
|
|
Attributes:
|
|
chunk (list): The rows returned by pagination
|
|
next_batch (Any|None): Token to fetch next set of results with, if
|
|
None then there are no more results.
|
|
prev_batch (Any|None): Token to fetch previous set of results with, if
|
|
None then there are no previous results.
|
|
"""
|
|
|
|
chunk = attr.ib()
|
|
next_batch = attr.ib(default=None)
|
|
prev_batch = attr.ib(default=None)
|
|
|
|
def to_dict(self):
|
|
d = {"chunk": self.chunk}
|
|
|
|
if self.next_batch:
|
|
d["next_batch"] = self.next_batch.to_string()
|
|
|
|
if self.prev_batch:
|
|
d["prev_batch"] = self.prev_batch.to_string()
|
|
|
|
return d
|
|
|
|
|
|
@attr.s(frozen=True, slots=True)
|
|
class RelationPaginationToken(object):
|
|
"""Pagination token for relation pagination API.
|
|
|
|
As the results are in topological order, we can use the
|
|
`topological_ordering` and `stream_ordering` fields of the events at the
|
|
boundaries of the chunk as pagination tokens.
|
|
|
|
Attributes:
|
|
topological (int): The topological ordering of the boundary event
|
|
stream (int): The stream ordering of the boundary event.
|
|
"""
|
|
|
|
topological = attr.ib()
|
|
stream = attr.ib()
|
|
|
|
@staticmethod
|
|
def from_string(string):
|
|
try:
|
|
t, s = string.split("-")
|
|
return RelationPaginationToken(int(t), int(s))
|
|
except ValueError:
|
|
raise SynapseError(400, "Invalid token")
|
|
|
|
def to_string(self):
|
|
return "%d-%d" % (self.topological, self.stream)
|
|
|
|
def as_tuple(self):
|
|
return attr.astuple(self)
|
|
|
|
|
|
@attr.s(frozen=True, slots=True)
|
|
class AggregationPaginationToken(object):
|
|
"""Pagination token for relation aggregation pagination API.
|
|
|
|
As the results are order by count and then MAX(stream_ordering) of the
|
|
aggregation groups, we can just use them as our pagination token.
|
|
|
|
Attributes:
|
|
count (int): The count of relations in the boundar group.
|
|
stream (int): The MAX stream ordering in the boundary group.
|
|
"""
|
|
|
|
count = attr.ib()
|
|
stream = attr.ib()
|
|
|
|
@staticmethod
|
|
def from_string(string):
|
|
try:
|
|
c, s = string.split("-")
|
|
return AggregationPaginationToken(int(c), int(s))
|
|
except ValueError:
|
|
raise SynapseError(400, "Invalid token")
|
|
|
|
def to_string(self):
|
|
return "%d-%d" % (self.count, self.stream)
|
|
|
|
def as_tuple(self):
|
|
return attr.astuple(self)
|