Trait NetworkConnection 

pub trait NetworkConnection: Send + Sync {
    // Required methods
    fn compression(&self) -> Option<CompressionInfo>;
    fn send_encoded(&self, packet: EncodedPacket);
    fn send_encoded_bundle(&self, packets: Vec<EncodedPacket>);
    fn disconnect_with_reason(&self, reason: TextComponent);
    fn tick(&self);
    fn latency(&self) -> i32;
    fn close(&self);
    fn closed(&self) -> bool;
}

An object-safe trait for player connections.

This abstracts the connection layer so that:

• JavaConnection can handle real network traffic
• Test connections (like FlintConnection) can record events for assertions

Object Safety

This trait uses type erasure for packet sending - packets must be pre-encoded into EncodedPacket before being sent. The Player struct provides a generic send_packet<P: ClientPacket>() helper that handles encoding.

Required Methods

fn compression(&self) -> Option<CompressionInfo>

Returns compression info for packet encoding.

Returns None if compression is disabled (e.g., for test connections).

fn send_encoded(&self, packet: EncodedPacket)

Sends a pre-encoded packet.

This is the object-safe method that accepts already-encoded packets. Use Player::send_packet() for the generic version that handles encoding.

fn send_encoded_bundle(&self, packets: Vec<EncodedPacket>)

Sends multiple pre-encoded packets as an atomic bundle.

The implementation wraps the packets with bundle delimiter packets so the client processes them together in a single game tick. Use Player::send_bundle() for the generic version that handles encoding.

fn disconnect_with_reason(&self, reason: TextComponent)

Disconnects the player with a reason.

fn tick(&self)

Performs per-tick connection maintenance (e.g., keep-alive).

fn latency(&self) -> i32

Returns the current latency in milliseconds.

fn close(&self)

Closes the connection.

fn closed(&self) -> bool

Returns whether the connection is closed.

Trait Implementations

impl From<Box<dyn NetworkConnection>> for PlayerConnection

fn from(v: Box<dyn NetworkConnection>) -> PlayerConnection

Converts to this type from the input type.

impl NetworkConnection for Box<dyn NetworkConnection>

fn compression(&self) -> Option<CompressionInfo>

Returns compression info for packet encoding.

fn send_encoded(&self, packet: EncodedPacket)

Sends a pre-encoded packet.

fn send_encoded_bundle(&self, packets: Vec<EncodedPacket>)

Sends multiple pre-encoded packets as an atomic bundle.

fn disconnect_with_reason(&self, reason: TextComponent)

Disconnects the player with a reason.

fn tick(&self)

Performs per-tick connection maintenance (e.g., keep-alive).

fn latency(&self) -> i32

Returns the current latency in milliseconds.

fn close(&self)

Closes the connection.

fn closed(&self) -> bool

Returns whether the connection is closed.

impl TryInto<Box<dyn NetworkConnection>> for PlayerConnection

type Error = &'static str

The type returned in the event of a conversion error.

fn try_into( self, ) -> Result<Box<dyn NetworkConnection>, <Self as TryInto<Box<dyn NetworkConnection>>>::Error>

Performs the conversion.

Dyn Compatibility

This trait is dyn compatible.

In older versions of Rust, dyn compatibility was called "object safety".

Implementations on Foreign Types

impl NetworkConnection for Box<dyn NetworkConnection>

fn compression(&self) -> Option<CompressionInfo>

fn send_encoded(&self, packet: EncodedPacket)

fn send_encoded_bundle(&self, packets: Vec<EncodedPacket>)

fn disconnect_with_reason(&self, reason: TextComponent)

fn tick(&self)

fn latency(&self) -> i32

fn close(&self)

fn closed(&self) -> bool

Implementors

impl NetworkConnection for JavaConnection

impl NetworkConnection for PlayerConnection