Struct arti_rpcserver::session::RpcSession

pub struct RpcSession {
    client: Arc<dyn Client>,
}

An authenticated RPC session: a capability through which most other RPC functionality is available

This relates to Connection as follows:

• A Connection exists prior to authentication; whereas an RpcSession comes into being as a result of authentication.

• The RpcSession is principally owned by the Connection’s object table.

• Typically, after authentication, there is one RpcSession for the Connection. But a client may authenticate more than once; each time produces a new RpcSession.

Fields

client: Arc<dyn Client>

An inner TorClient object that we use to implement remaining functionality.

Implementations

impl RpcSession

pub fn new_with_client<R: Runtime>(client: Arc<TorClient<R>>) -> Arc<Self>

Create a new session object containing a single client object.

fn client_as_conn_target(&self) -> Arc<dyn ClientConnectionTarget>

Return a view of the client associated with this session, as an Arc<dyn ClientConnectionTarget>.

Trait Implementations

impl ClientConnectionTarget for RpcSession

fn connect_with_prefs<'life0, 'life1, 'life2, 'async_trait>( &'life0 self, target: &'life1 TorAddr, prefs: &'life2 StreamPrefs ) -> Pin<Box<dyn Future<Output = ClientConnectionResult<DataStream>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait, 'life2: 'async_trait,

As [TorClient::connect_with_prefs].

fn resolve_with_prefs<'life0, 'life1, 'life2, 'async_trait>( &'life0 self, hostname: &'life1 str, prefs: &'life2 StreamPrefs ) -> Pin<Box<dyn Future<Output = ClientConnectionResult<Vec<IpAddr>>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait, 'life2: 'async_trait,

As [TorClient::resolve_with_prefs].

fn resolve_ptr_with_prefs<'life0, 'life1, 'async_trait>( &'life0 self, addr: IpAddr, prefs: &'life1 StreamPrefs ) -> Pin<Box<dyn Future<Output = ClientConnectionResult<Vec<String>>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

As [TorClient::resolve_ptr_with_prefs].

impl Object for RpcSession

where RpcSession: Send + Sync + 'static,

fn expose_outside_of_session(&self) -> bool

Return true if this object should be given an identifier that allows it to be used outside of the session that generated it.

fn get_cast_table(&self) -> &CastTable

Return a CastTable that can be used to downcast a dyn Object of this type into various kinds of dyn Trait references.