Struct sf_api::session::CharacterSession

pub struct CharacterSession { /* private fields */ }

Implementations

impl CharacterSession

pub fn new(username: &str, password: &str, server: ServerConnection) -> Self

pub fn new_hashed( username: &str, pw_hash: PWHash, server: ServerConnection ) -> Self

pub fn server_url(&self) -> &Url

pub fn has_session_id(&self) -> bool

Checks if this session has ever been able to successfully login to the server to establish a session id. You should not need to check this, as login() should return error on unsuccessfull logins, but if you want to make sure, you can make sure here

pub async fn login(&mut self) -> Result<Response, SFError>

Clears the current session and sends a login request to the server. Returns the parsed response from the server.

pub async fn register( username: &str, password: &str, server: ServerConnection, gender: Gender, race: Race, class: Class ) -> Result<(Self, Response), SFError>

Registers a new character on the server. If everything works, the logged in character session and its login response will be returned

pub async fn send_command( &mut self, command: &Command ) -> Result<Response, SFError>

Encode and send a command to the server, decrypts and parses its response and returns the response. When this returns an error, the Session might be in an invalid state, so you should login again just to be safe

pub fn username(&self) -> &str

pub async fn renew_sso_creds(&mut self) -> Result<(), SFError>

Retrieves new sso credentials from its sf account. If the account already has new creds stored, these are read, otherwise the account will be logged in again

Trait Implementations

impl Clone for CharacterSession

fn clone(&self) -> CharacterSession

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for CharacterSession

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

Formats the value using the given formatter.