Struct AttachedBackend 

pub struct AttachedBackend { /* private fields */ }

Implementations

impl AttachedBackend

pub fn new(kind: BackendKind, base: &str, token: &str) -> Result<Self>

base is the server’s origin. The spec prefix and sliding sync are asked of the server.

pub fn with_prefix( kind: BackendKind, base: &str, token: &str, keep_prefix: bool, ) -> Result<Self>

No network at all: keep_prefix says whether the server serves the paths under /_matrix, and sliding sync stays off.

pub fn without_sliding_sync(self) -> Self

Plain /sync v3 only.

pub fn uses_sliding_sync(&self) -> bool

Trait Implementations

impl Backend for AttachedBackend

fn kind(&self) -> BackendKind

fn capabilities(&self) -> Capabilities

fn server_ref(&self) -> &str

The normalized server base URL this backend talks to (the identity is bound to it).

fn ensure_session( &self, _: &IdentityStore, _: &mut SessionIdentity, _: Option<&str>, ) -> Result<Session>

A live session for id. First time: redeems the operator’s invite (enroll the public key, proving possession of the private one); afterwards: logs in by signing a fresh challenge. Reuses the stored token while the server still accepts it. Persists what it learns.

fn execute(&self, request: &OutgoingRequest) -> Result<HttpResponseDescriptor>

Performs one request of the engine as this session (bearer added, token refreshed once by signature if the server forgot it). Callable from any thread. Needs ensure_session first.

fn whoami(&self) -> Result<(String, String)>

(user_id, device_id) of the session (what the engine needs to open a core).

fn keep_prefix(&self) -> bool

Whether this server serves the Matrix paths under /_matrix (found out, not assumed).

fn wait_for_news(&self, timeout: Duration) -> Result<News>

Waits up to timeout for news for this session: room events pushed on the server’s push socket, or Idle (timeout, or the server has no push channel and the sync long poll is the wait).

fn frozen(&self) -> Option<Arc<dyn Backend>>

A copy of this backend whose routing choices are frozen now, for a request that will run later on a worker (a long poll started for a local exchange must stay local). None: the backend has no such choices.