Struct ServerSocket 

pub struct ServerSocket { /* private fields */ }

ServerSocket struct is used as an abstraction layer for a server Socket. This struct is used for abstraction of single socket communication.

Example

use std::net::{SocketAddr, UdpSocket};
use std::str::FromStr;
use tftpd::{Socket, ServerSocket, Packet};
use std::time::Duration;

let socket = ServerSocket::new(
    UdpSocket::bind("127.0.0.1:0").unwrap(),
    SocketAddr::from_str("127.0.0.1:50000").unwrap(),
    Duration::from_secs(3)
);
socket.send(&Packet::Ack(1)).unwrap();

Implementations

impl ServerSocket

pub fn new(socket: UdpSocket, remote: SocketAddr, timeout: Duration) -> Self

Creates a new ServerSocket from a UdpSocket and a remote SocketAddr.

pub fn sender(&self) -> Sender<Packet>

Returns a Sender for sending Packets to the remote Socket.

Trait Implementations

impl Socket for ServerSocket

fn send(&self, packet: &Packet) -> Result<(), Box<dyn Error>>

Sends a Packet to the socket’s connected remote Socket.

fn send_to( &self, packet: &Packet, to: &SocketAddr, ) -> Result<(), Box<dyn Error>>

Sends a Packet to the specified remote Socket.

fn recv_with_size(&self, _size: usize) -> Result<Packet, Box<dyn Error>>

Receives a data packet from the socket’s connected remote, and returns the parsed Packet. The received packet can actually be of any type, however, this function also allows supplying the buffer size for an incoming request.

fn recv_from_with_size( &self, _size: usize, ) -> Result<(Packet, SocketAddr), Box<dyn Error>>

Receives a data packet from any incoming remote request, and returns the parsed Packet and the requesting SocketAddr. The received packet can actually be of any type, however, this function also allows supplying the buffer size for an incoming request.

fn remote_addr(&self) -> Result<SocketAddr, Box<dyn Error>>

Returns the remote SocketAddr if it exists.

fn set_read_timeout(&mut self, dur: Duration) -> Result<(), Box<dyn Error>>

Sets the read timeout for the Socket.

fn set_write_timeout(&mut self, dur: Duration) -> Result<(), Box<dyn Error>>

Sets the write timeout for the Socket.

fn set_nonblocking(&mut self, nonblocking: bool) -> Result<(), Box<dyn Error>>

Sets the Socket as blocking or not.

fn recv(&self) -> Result<Packet, Box<dyn Error>>

Receives a Packet from the socket’s connected remote Socket. This function cannot handle large data packets due to the limited buffer size, so it is intended for only accepting incoming requests. For handling data packets, see Socket::recv_with_size().

fn recv_from(&self) -> Result<(Packet, SocketAddr), Box<dyn Error>>

Receives a Packet from any remote Socket and returns the SocketAddr of the remote Socket. This function cannot handle large data packets due to the limited buffer size, so it is intended for only accepting incoming requests. For handling data packets, see Socket::recv_from_with_size().