Struct Request 

#[non_exhaustive]
pub struct Request {
    pub pos: Option<String>,
    pub conn_id: Option<String>,
    pub txn_id: Option<String>,
    pub timeout: Option<Duration>,
    pub set_presence: PresenceState,
    pub lists: BTreeMap<String, List>,
    pub room_subscriptions: BTreeMap<OwnedRoomId, RoomSubscription>,
    pub extensions: Extensions,
}

Available on (crate features client or server) and crate feature unstable-msc4186 only.

Request type for the /sync endpoint.

Fields (Non-exhaustive)

Non-exhaustive structs could have additional fields added in future. Therefore, non-exhaustive structs cannot be constructed in external crates using the traditional Struct { .. } syntax; cannot be matched against without a wildcard ..; and struct update syntax will not work.

pos: Option<String>

A point in time to continue a sync from.

This is an opaque value taken from the pos field of a previous /sync response. A None value asks the server to start a new session (mind it can be costly)

conn_id: Option<String>

A unique string identifier for this connection to the server.

If this is missing, only one sliding sync connection can be made to the server at any one time. Clients need to set this to allow more than one connection concurrently, so the server can distinguish between connections. This must be provided with every request, if your client needs more than one concurrent connection.

Limitation: it must not contain more than 16 chars, due to it being required with every request.

txn_id: Option<String>

Allows clients to know what request params reached the server, functionally similar to txn IDs on /send for events.

timeout: Option<Duration>

The maximum time to poll before responding to this request.

None means no timeout, so virtually an infinite wait from the server.

set_presence: PresenceState

Controls whether the client is automatically marked as online by polling this API.

Defaults to PresenceState::Online.

lists: BTreeMap<String, List>

Lists of rooms we are interested by, represented by ranges.

room_subscriptions: BTreeMap<OwnedRoomId, RoomSubscription>

Specific rooms we are interested by.

It is useful to receive updates from rooms that are possibly out-of-range of all the lists (see Self::lists).

extensions: Extensions

Extensions.

Implementations

impl Request

pub fn new() -> Self

Creates an empty Request.

Trait Implementations

impl Clone for Request

fn clone(&self) -> Request

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Request

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for Request

fn default() -> Request

Returns the “default value” for a type.

impl IncomingRequest for Request

Available on crate feature server only.

type EndpointError = Error

A type capturing the error conditions that can be returned in the response.

type OutgoingResponse = Response

Response type to return when the request is successful.

fn try_from_http_request<B, S>( request: Request<B>, path_args: &[S], ) -> Result<Self, FromHttpRequestError>

where B: AsRef<[u8]>, S: AsRef<str>,

Tries to turn the given http::Request into this request type, together with the corresponding path arguments.

fn check_request_method(method: &Method) -> Result<(), FromHttpRequestError>

Check whether the given HTTP method from an incoming request is compatible with the expected METHOD of this endpoint.

impl Metadata for Request

const METHOD: Method = ::ruma_common::exports::http::Method::POST

The HTTP method used by this endpoint.

const RATE_LIMITED: bool = false

Whether or not this endpoint is rate limited by the server.

const PATH_BUILDER: VersionHistory

All info pertaining to an endpoint’s path.

type Authentication = AccessToken

What authentication scheme the server uses for this endpoint.

type PathBuilder = VersionHistory

The type used to build an endpoint’s path.

fn empty_request_body<B>() -> B

where B: Default + BufMut,

Returns an empty request body for this Matrix request.

fn make_endpoint_url( path_builder_input: <Self::PathBuilder as PathBuilder>::Input<'_>, base_url: &str, path_args: &[&dyn Display], query_string: &str, ) -> Result<String, IntoHttpError>

Generate the endpoint URL for this endpoint.

impl OutgoingRequest for Request

Available on crate feature client only.

type EndpointError = Error

A type capturing the expected error conditions the server can return.

type IncomingResponse = Response

Response type returned when the request is successful.

fn try_into_http_request<T: Default + BufMut + AsRef<[u8]>>( self, base_url: &str, authentication_input: <<Self as Metadata>::Authentication as AuthScheme>::Input<'_>, path_builder_input: <<Self as Metadata>::PathBuilder as PathBuilder>::Input<'_>, ) -> Result<Request<T>, IntoHttpError>

Tries to convert this request into an http::Request.