Struct lib3h::gateway::P2pGateway

pub struct P2pGateway<T: Transport, D: Dht> { /* fields omitted */ }

Gateway to a P2P network. Combines a transport and a DHT. Tracks distributed data for that P2P network in a DHT. P2pGateway should not post() & process() its inner transport but call it synchrounously.

Methods

impl<T: Transport, D: Dht> P2pGateway<T, D>

Public interface

pub fn identifier(&self) -> &str

This Gateway's identifier

pub fn post_dht(&mut self, cmd: DhtCommand) -> Lib3hResult<()>

TODO #179 - using an explicit post for dht because of dumb rust compiler

impl<T: Transport, D: Dht> P2pGateway<T, D>

any Transport Constructor

pub fn new(
    identifier: &str,
    inner_transport: Rc<RefCell<T>>,
    dht_factory: DhtFactory<D>,
    dht_config: &DhtConfig
) -> Self

Constructor Bind and set advertise on construction by using the name as URL.

impl<T: Transport, D: Dht> P2pGateway<P2pGateway<T, D>, D>

P2pGateway Constructor

pub fn new_with_space(
    network_gateway: Rc<RefCell<P2pGateway<T, D>>>,
    space_address: &Address,
    dht_factory: DhtFactory<D>,
    dht_config: &DhtConfig
) -> Self

Constructors

Trait Implementations

impl<T: Transport, D: Dht> Dht for P2pGateway<T, D>

Compose DHT

fn get_peer_list(&self) -> Vec<PeerData>

Peer info

fn get_peer(&self, peer_address: &str) -> Option<PeerData>

fn this_peer(&self) -> &PeerData

fn get_entry_address_list(&self) -> Vec<&Address>

Entry

fn get_aspects_of(&self, entry_address: &Address) -> Option<Vec<Address>>

fn post(&mut self, cmd: DhtCommand) -> Lib3hResult<()>

Processing

fn process(&mut self) -> Lib3hResult<(DidWork, Vec<DhtEvent>)>

impl<T: Transport, D: Dht> Transport for P2pGateway<T, D>

Compose Transport

fn connect(&mut self, uri: &Url) -> TransportResult<ConnectionId>

establish a connection to a remote node

fn close(&mut self, id: &ConnectionIdRef) -> TransportResult<()>

close an existing open connection

fn close_all(&mut self) -> TransportResult<()>

close all existing open connections

fn send(
    &mut self,
    dht_id_list: &[&ConnectionIdRef],
    payload: &[u8]
) -> TransportResult<()>

id_list =

• Network : transportId
• space : agentId

fn send_all(&mut self, payload: &[u8]) -> TransportResult<()>

fn bind(&mut self, url: &Url) -> TransportResult<Url>

fn post(&mut self, command: TransportCommand) -> TransportResult<()>

fn process(&mut self) -> TransportResult<(DidWork, Vec<TransportEvent>)>

Handle TransportEvents directly

fn connection_id_list(&self) -> TransportResult<Vec<ConnectionId>>

A Gateway uses its inner_dht's peerData.peer_address as connectionId

fn get_uri(&self, id: &ConnectionIdRef) -> Option<Url>

TODO: return a higher-level uri instead