Struct Request

pub struct Request {
    pub method: String,
    pub path: String,
    pub version: String,
}

Represents an HTTP request, containing the HTTP method, the requested path, and the HTTP version.

Fields

method: String

HTTP method of the request.

path: String

Requested path.

version: String

HTTP version of the request.

Implementations

impl Request

pub fn from_stream(stream: &TcpStream) -> Result<Self, ServerError>

Attempts to create a Request from the provided TCP stream by reading the first line.

This method reads the first line of an HTTP request from the given TCP stream, parses it, and constructs a Request instance if the input is valid.

Arguments

• stream - A reference to the TcpStream from which the request will be read.

Returns

• Ok(Request) - If the request is valid and successfully parsed.
• Err(ServerError) - If the request is malformed, cannot be read, or is invalid.

Errors

This function returns a ServerError::InvalidRequest error if:

• The request line is too long (exceeds MAX_REQUEST_LINE_LENGTH)
• The request line does not contain exactly three parts
• The HTTP method is not recognized
• The request path does not start with a forward slash
• The HTTP version is not supported (only HTTP/1.0 and HTTP/1.1 are accepted)

Examples

use std::net::TcpStream;
use http_handle::request::Request;

fn handle_client(stream: TcpStream) {
    match Request::from_stream(&stream) {
        Ok(request) => println!("Received request: {}", request),
        Err(e) => eprintln!("Error parsing request: {}", e),
    }
}

pub fn method(&self) -> &str

Returns the HTTP method of the request.

Returns

A string slice containing the HTTP method (e.g., “GET”, “POST”).

pub fn path(&self) -> &str

Returns the requested path of the request.

Returns

A string slice containing the requested path.

pub fn version(&self) -> &str

Returns the HTTP version of the request.

Returns

A string slice containing the HTTP version (e.g., “HTTP/1.1”).

Trait Implementations

impl Clone for Request

fn clone(&self) -> Request

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for Request

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

Formats the value using the given formatter.

impl Display for Request

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

Formats the value using the given formatter.

impl PartialEq for Request

fn eq(&self, other: &Request) -> 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 StructuralPartialEq for Request