Session

grammers_session

Trait Session 

Source 
pub trait Session: Send + Sync {
    // Required methods
    fn home_dc_id(&self) -> i32;
    fn set_home_dc_id(&self, dc_id: i32);
    fn dc_option(&self, dc_id: i32) -> Option<DcOption>;
    fn set_dc_option(&self, dc_option: &DcOption);
    fn peer(&self, peer: PeerId) -> Option<PeerInfo>;
    fn cache_peer(&self, peer: &PeerInfo);
    fn updates_state(&self) -> UpdatesState;
    fn set_update_state(&self, update: UpdateState);
}
Expand description

The main interface to interact with the different crate::storages.

All methods are synchronous and currently infallible because clients are not equipped to deal with the arbitrary errors that a dynamic Session could produce. This may change in the future.

A newly-created storage should return the same values that crate::SessionData::default would produce.

Required Methods§

Source

fn home_dc_id(&self) -> i32

Datacenter that is “home” to the user authorized by this session.

If not known, the ID of the closest datacenter should be returned instead. Note that incorrect guesses are allowed, and the user may need to migrate.

This method should be cheap to call, because it is used on every request.

Source

fn set_home_dc_id(&self, dc_id: i32)

Changes the Session::home_dc_id after finding out the actual datacenter to which main queries should be executed against.

Source

fn dc_option(&self, dc_id: i32) -> Option<DcOption>

Query a single datacenter option.

If no up-to-date option has been Session::set_dc_option yet, a statically-known option must be returned.

None may only be returned on invalid DC IDs or DCs that are not yet known.

This method should be cheap to call, because it is used on every request.

Source

fn set_dc_option(&self, dc_option: &DcOption)

Update the previously-known Session::dc_option with new values.

Should also be used after generating permanent authentication keys to a datacenter.

Source

fn peer(&self, peer: PeerId) -> Option<PeerInfo>

Query a peer by its identity.

Querying for PeerId::self_user can be used as a way to determine whether the authentication key has a logged-in user bound (i.e. signed in).

Source

fn cache_peer(&self, peer: &PeerInfo)

Cache a peer’s basic information for Session::peer to be able to query them later.

This method may not necessarily remember the peers forever, except for users where PeerInfo::User::is_self is Some(true).

Source

fn updates_state(&self) -> UpdatesState

Loads the entire updates state.

Source

fn set_update_state(&self, update: UpdateState)

Update the state for one or all updates.

Implementors§