Struct Context 

pub struct Context { /* private fields */ }

Represents the internal state of the application context.

This structure holds all the data associated with a single request-response cycle, including the stream, request, response, and any custom attributes.

Implementations

impl Context

Implementation of methods for Context structure.

pub async fn http_from_stream(&mut self) -> Result<Request, RequestError>

Reads an HTTP request from the underlying stream.

Returns

• Result<Request, RequestError> - The parsed request or error.

pub async fn ws_from_stream(&mut self) -> Result<Request, RequestError>

Reads a WebSocket frame from the underlying stream.

Returns

• Result<Request, RequestError> - The parsed frame or error.

pub fn is_terminated(&self) -> bool

Checks if the connection has been terminated (aborted or closed).

Returns

• bool - True if the connection is either aborted or closed, otherwise false.

pub fn try_get_route_param<T>(&self, name: T) -> Option<String>

where T: AsRef<str>,

Attempts to retrieve a specific route parameter by its name.

Arguments

• AsRef<str> - The name of the route parameter to retrieve.

Returns

• Option<String> - The value of the route parameter if it exists.

pub fn get_route_param<T>(&self, name: T) -> String

where T: AsRef<str>,

Retrieves a specific route parameter by its name, panicking if not found.

Arguments

• AsRef<str> - The name of the route parameter to retrieve.

Returns

• String - The value of the route parameter if it exists.

Panics

• If the route parameter is not found.

pub fn try_get_attribute<V>(&self, key: impl AsRef<str>) -> Option<V>

where V: AnySendSyncClone,

Attempts to retrieve a specific attribute by its key, casting it to the specified type.

Arguments

• AsRef<str> - The key of the attribute to retrieve.

Returns

• Option<V> - The attribute value if it exists and can be cast to the specified type.

pub fn get_attribute<V>(&self, key: impl AsRef<str>) -> V

where V: AnySendSyncClone,

Retrieves a specific attribute by its key, casting it to the specified type, panicking if not found.

Arguments

• AsRef<str> - The key of the attribute to retrieve.

Returns

• AnySendSyncClone - The attribute value if it exists and can be cast to the specified type.

Panics

• If the attribute is not found.

pub fn set_attribute<K, V>(&mut self, key: K, value: V) -> &mut Self

where K: AsRef<str>, V: AnySendSyncClone,

Sets an attribute in the context.

Arguments

• AsRef<str> - The key of the attribute to set.
• AnySendSyncClone - The value of the attribute.

Returns

• &mut Self - A reference to the modified context.

pub fn remove_attribute<K>(&mut self, key: K) -> &mut Self

where K: AsRef<str>,

Removes an attribute from the context.

Arguments

• AsRef<str> - The key of the attribute to remove.

Returns

• &mut Self - A reference to the modified context.

pub fn clear_attribute(&mut self) -> &mut Self

Clears all attributes from the context.

Returns

• &mut Self - A reference to the modified context.

pub fn try_get_task_panic_data(&self) -> Option<PanicData>

Retrieves panic data associated with the current task.

Returns

• Option<PanicData> - Task panic data if a panic was caught during execution.

pub fn get_task_panic_data(&self) -> PanicData

Retrieves panic data associated with the current task.

Returns

• PanicData - Task panic data if available.

Panics

• If no task panic data is found.

pub fn try_get_request_error_data(&self) -> Option<RequestError>

Retrieves request error information if an error occurred during handling.

Returns

• Option<RequestError> - The request error information if an error was caught.

pub fn get_request_error_data(&self) -> RequestError

Retrieves request error information if an error occurred during handling.

Returns

• RequestError - The request error information if an error was caught.

Panics

• If the request error information is not found.

pub async fn try_send(&mut self) -> Result<(), ResponseError>

Sends HTTP response data over the stream.

Returns

• Result<(), ResponseError> - Result indicating success or failure.

pub async fn send(&mut self)

Sends HTTP response data over the stream.

Panics

Panics if the write operation fails.

pub async fn try_send_body(&self) -> Result<(), ResponseError>

Sends HTTP response body.

Returns

• Result<(), ResponseError> - Result indicating success or failure.

pub async fn send_body(&self)

Sends HTTP response body.

Panics

Panics if the write operation fails.

pub async fn try_send_body_with_data<D>( &self, data: D, ) -> Result<(), ResponseError>

where D: AsRef<[u8]>,

Sends only the response body to the client with additional data.

This method is useful for streaming data or for responses where headers have already been sent.

Arguments

• AsRef<[u8]> - The additional data to send as the body.

Returns

• Result<(), ResponseError> - The result of the send operation.

pub async fn send_body_with_data<D>(&self, data: D)

where D: AsRef<[u8]>,

Sends HTTP response body.

Arguments

• AsRef<[u8]> - The response body data (must implement AsRef<u8>).

Panics

Panics if the write operation fails.

pub async fn try_send_body_list<I, D>( &self, data_iter: I, ) -> Result<(), ResponseError>

where I: IntoIterator<Item = D>, D: AsRef<[u8]>,

Sends multiple HTTP response bodies sequentially.

Arguments

• I: IntoIterator<Item = D>, D: AsRef<[u8]> - The response body data list to send.

Returns

• Result<(), ResponseError> - Result indicating success or failure.

pub async fn send_body_list<I, D>(&self, data_iter: I)

where I: IntoIterator<Item = D>, D: AsRef<[u8]>,

Sends multiple HTTP response bodies sequentially.

Arguments

• I: IntoIterator<Item = D>, D: AsRef<[u8]> - The response body data list to send.

Panics

Panics if any write operation fails.

pub async fn try_send_body_list_with_data<I, D>( &self, data_iter: I, ) -> Result<(), ResponseError>

where I: IntoIterator<Item = D>, D: AsRef<[u8]>,

Sends a list of response bodies to the client with additional data.

This is useful for streaming multiple data chunks or for responses where headers have already been sent.

Arguments

• I: IntoIterator<Item = D>, D: AsRef<[u8]> - The additional data to send as a list of bodies.

Returns

• Result<(), ResponseError> - The result of the send operation.

pub async fn send_body_list_with_data<I, D>(&self, data_iter: I)

where I: IntoIterator<Item = D>, D: AsRef<[u8]>,

Sends a list of response bodies to the client with additional data.

Arguments

• I: IntoIterator<Item = D>, D: AsRef<[u8]> - The additional data to send as a list of bodies.

Panics

Panics if any write operation fails.

pub async fn try_flush(&self) -> Result<(), ResponseError>

Flushes the underlying network stream, ensuring all buffered data is sent.

Returns

• Result<(), ResponseError> - The result of the flush operation.

pub async fn flush(&self)

Flushes all buffered data to the stream.

Panics

Panics if the flush operation fails.

impl Context

pub fn get_aborted(&self) -> bool

pub fn get_mut_aborted(&mut self) -> &mut bool

pub fn set_aborted(&mut self, val: bool) -> &mut Self

pub fn get_closed(&self) -> bool

pub fn get_mut_closed(&mut self) -> &mut bool

pub fn set_closed(&mut self, val: bool) -> &mut Self

pub fn get_stream(&self) -> ArcRwLockStream

pub fn try_get_stream(&self) -> &Option<ArcRwLockStream>

pub fn get_request(&self) -> &Request

pub fn get_response(&self) -> &Response

pub fn get_mut_response(&mut self) -> &mut Response

pub fn set_response(&mut self, val: Response) -> &mut Self

pub fn get_route_params(&self) -> &RouteParams

pub fn get_attributes(&self) -> &ThreadSafeAttributeStore

pub fn get_server(&self) -> &&'static Server

Trait Implementations

impl AsMut<Context> for Context

Implementation of AsMut trait for Context.

fn as_mut(&mut self) -> &mut Context

Converts &mut Context to &mut Context via memory address conversion.

Returns

• &mut Context - A mutable reference to the Context instance.

impl AsRef<Context> for Context

Implementation of AsRef trait for Context.

fn as_ref(&self) -> &Context

Converts &Context to &Context via memory address conversion.

Returns

• &Context - A reference to the Context instance.

impl Clone for Context

fn clone(&self) -> Context

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Context

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

Formats the value using the given formatter.

impl Default for Context

Implementation of Default trait for Context.

fn default() -> Self

Creates a default Context instance.

Returns

• Context - A new context with default values and a static default server.

impl Display for Context

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

Formats the value using the given formatter.

impl From<&ArcRwLockStream> for Context

Implementation of From trait for converting &ArcRwLockStream into Context.

fn from(stream: &ArcRwLockStream) -> Self

Converts a reference to a network stream into a Context with default request.

Arguments

• &ArcRwLockStream - The network stream reference to convert.

Returns

• Context - The newly created context instance.

impl From<&Context> for usize

Implementation of From trait for converting &Context into usize address.

fn from(ctx: &Context) -> Self

Converts a reference to Context into its memory address.

Arguments

• &Context - The reference to the Context instance.

Returns

• usize - The memory address of the Context instance.

impl From<&'static Server> for Context

Implementation of From trait for Context from &'static Server.

fn from(server: &'static Server) -> Self

Converts a &'static Server into a Context with default request and response.

Arguments

• &'static Server - The server reference to convert.

Returns

• Context - The newly created context instance.

impl From<&mut Context> for usize

Implementation of From trait for converting &mut Context into usize address.

fn from(ctx: &mut Context) -> Self

Converts a mutable reference to Context into its memory address.

Arguments

• &mut Context - The mutable reference to the Context instance.

Returns

• usize - The memory address of the Context instance.

impl From<ArcRwLockStream> for Context

Implementation of From trait for converting ArcRwLockStream into Context.

fn from(stream: ArcRwLockStream) -> Self

Converts a network stream into a Context with default request.

Arguments

• ArcRwLockStream - The network stream to convert.

Returns

• Context - The newly created context instance.

impl From<usize> for &'static Context

Implementation of From trait for converting usize address into &Context.

fn from(addr: usize) -> &'static Context

Converts a memory address into a reference to Context.

Arguments

• usize - The memory address of the Context instance.

Returns

• &'static Context - A reference to the Context at the given address.

impl<'a> From<usize> for &'a mut Context

Implementation of From trait for converting usize address into &mut Context.

fn from(addr: usize) -> &'a mut Context

Converts a memory address into a mutable reference to Context.

Arguments

• usize - The memory address of the Context instance.

Returns

• &mut Context - A mutable reference to the Context at the given address.

impl From<usize> for Context

Implementation of From trait for converting usize address into Context.

fn from(addr: usize) -> Self

Converts a memory address into an owned Context by cloning from the reference.

Arguments

• usize - The memory address of the Context instance.

Returns

• Context - A cloned Context instance from the given address.

impl PartialEq for Context

Implementation of PartialEq trait for Context.

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

Compares two Context instances for equality.

Arguments

• &Self - The first Context instance.
• &Self - The second Context instance.

Returns

• bool - True if the instances are equal, otherwise false.

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 Eq for Context

Implementation of Eq trait for Context.