Enum VirtualConnectionType 

pub enum VirtualConnectionType {
    LocalGroupPeer {
        session_cid: u64,
        peer_cid: u64,
    },
    ExternalGroupPeer {
        session_cid: u64,
        interserver_cid: u64,
        peer_cid: u64,
    },
    LocalGroupServer {
        session_cid: u64,
    },
    ExternalGroupServer {
        session_cid: u64,
        interserver_cid: u64,
    },
}

Unified type representing all possible virtual connections.

This type is used throughout the protocol for packet routing and connection management. It covers both C2S and P2P connection scenarios.

Variants

C2S Connections

• LocalGroupServer: Client connected to their home server
• ExternalGroupServer: Client connected through federated network (future)

P2P Connections

• LocalGroupPeer: P2P where both peers share the same server
• ExternalGroupPeer: P2P across federated servers (future)

Variants

LocalGroupPeer

P2P connection on the same server.

Fields

session_cid: u64

This client’s session CID

peer_cid: u64

The peer’s CID

ExternalGroupPeer

P2P connection across federated servers.

Fields

session_cid: u64

This client’s session CID

interserver_cid: u64

The interserver connection identifier

peer_cid: u64

The peer’s CID on their home server

LocalGroupServer

Standard client-to-server connection.

Fields

session_cid: u64

The session CID

ExternalGroupServer

Client-to-server through federated network.

Fields

session_cid: u64

This client’s session CID

interserver_cid: u64

The interserver connection identifier

Implementations

impl VirtualConnectionType

pub fn serialize(&self) -> Vec<u8>

Serializes to bytes.

pub fn deserialize_from<'a, T>(this: T) -> Option<VirtualConnectionType>

where T: AsRef<[u8]> + 'a,

Deserializes from bytes.

pub fn get_target_cid(&self) -> u64

Gets the target CID, agnostic to connection type.

pub fn get_session_cid(&self) -> u64

Gets the session CID.

pub fn is_server_connection(&self) -> bool

Returns true if this is a C2S connection.

pub fn is_peer_connection(&self) -> bool

Returns true if this is a P2P connection.

pub fn try_as_peer_connection(&self) -> Option<PeerConnectionType>

Attempts to convert to a PeerConnectionType.

pub fn try_as_client_connection(&self) -> Option<ClientConnectionType>

Attempts to convert to a ClientConnectionType.

pub fn is_local_group(&self) -> bool

Returns true if this is a local group connection (same server).

pub fn is_external_group(&self) -> bool

Returns true if this is an external group connection (federated).

pub fn set_target_cid(&mut self, target_cid: u64)

Sets the target CID (for P2P connections only).

pub fn set_session_cid(&mut self, cid: u64)

Sets the session CID.

Trait Implementations

impl Clone for VirtualConnectionType

fn clone(&self) -> VirtualConnectionType

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for VirtualConnectionType

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for VirtualConnectionType

fn deserialize<__D>( __deserializer: __D, ) -> Result<VirtualConnectionType, <__D as Deserializer<'de>>::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Display for VirtualConnectionType

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

Formats the value using the given formatter.

impl From<ClientConnectionType> for VirtualConnectionType

fn from(client: ClientConnectionType) -> VirtualConnectionType

Converts to this type from the input type.

impl From<PeerConnectionType> for VirtualConnectionType

fn from(peer: PeerConnectionType) -> VirtualConnectionType

Converts to this type from the input type.

impl Hash for VirtualConnectionType

fn hash<__H>(&self, state: &mut __H)

where __H: Hasher,

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq for VirtualConnectionType

fn eq(&self, other: &VirtualConnectionType) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for VirtualConnectionType

fn serialize<__S>( &self, __serializer: __S, ) -> Result<<__S as Serializer>::Ok, <__S as Serializer>::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl Copy for VirtualConnectionType

impl Eq for VirtualConnectionType

impl StructuralPartialEq for VirtualConnectionType