Struct Context 

pub struct Context {
    pub request: Request,
    pub response: Response,
    pub route_params: RouteParams,
    pub attributes: ThreadSafeAttributeStore,
}

Represents the internal state of the application context.

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

Fields

request: Request

The incoming HTTP request.

response: Response

The outgoing HTTP response.

route_params: RouteParams

Parameters extracted from the route path.

attributes: ThreadSafeAttributeStore

A collection of custom attributes for sharing data within the request lifecycle.

Implementations

impl Context

Implementation of methods for Context structure.

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

• T - 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

• T - 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, K>(&self, key: K) -> Option<V>

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

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

Arguments

• K - 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, K>(&self, key: K) -> V

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

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

Arguments

• K - The key of the attribute to retrieve.

Returns

• V - 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

• K - The key of the attribute to set.
• V - 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

• K - 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 set_task_panic(&mut self, panic_data: PanicData) -> &mut Self

Stores panic data for the current task context.

Arguments

• PanicData - The panic data specific to the current task.

Returns

• &mut Self - Reference to the modified context for method chaining.

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.

impl Context

pub fn get_request(&self) -> &Request

pub fn get_mut_request(&mut self) -> &mut Request

pub fn set_request(&mut self, val: Request) -> &mut Self

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_mut_route_params(&mut self) -> &mut RouteParams

pub fn set_route_params(&mut self, val: RouteParams) -> &mut Self

pub fn get_attributes(&self) -> &ThreadSafeAttributeStore

pub fn get_mut_attributes(&mut self) -> &mut ThreadSafeAttributeStore

pub fn set_attributes(&mut self, val: ThreadSafeAttributeStore) -> &mut Self

Trait Implementations

impl AsMut<Context> for Context

Implementation of AsMut trait for Context.

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

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

Returns

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

impl AsRef<Context> for Context

Implementation of AsRef trait for Context.

fn as_ref(&self) -> &Self

Converts &Context to &Context via memory address conversion.

Returns

• &Self - A reference to the Context instance.

impl Clone for Context

fn clone(&self) -> Self

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 struct fields as a debug struct, skipping excluded fields.

Arguments

• &mut std::fmt::Formatter<'_> - The formatter to write the representation into.

Returns

• std::fmt::Result - Success or failure of the formatting operation.

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 standard debug format.

Arguments

• &mut std::fmt::Formatter<'_> - The formatter to write the representation into.

Returns

• std::fmt::Result - Success or failure of the formatting operation.

impl Eq for Context

Implementation of Eq trait for Context.

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<&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<usize> for &'static Context

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

fn from(address: 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.

Safety

• The address is guaranteed to be a valid Context instance that was previously converted from a reference and is managed by the runtime.

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

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

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

Converts a memory address into a mutable reference to Context.

Arguments

• usize - The memory address of the Context instance.

Returns

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

Safety

• The address is guaranteed to be a valid Context instance that was previously converted from a reference and is managed by the runtime.

impl Lifetime for Context

Implementation of Lifetime trait for Context.

unsafe fn leak(&self) -> &'static Self

Converts a reference to the context into a 'static reference.

Returns

• &'static Self - A reference to the context with a 'static lifetime.

Safety

• The address is guaranteed to be a valid Self instance that was previously converted from a reference and is managed by the runtime.

unsafe fn leak_mut(&self) -> &'static mut Self

Converts a reference to the context into a 'static mutable reference.

Returns

• &'static mut Self - A mutable reference to the context with a 'static lifetime.

Safety

• The address is guaranteed to be a valid Self instance that was previously converted from a reference and is managed by the runtime.

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

Inequality operator !=.