Next

Struct Next 

Source
pub struct Next { /* private fields */ }
Expand description

Represents the next middleware or handler in the chain.

Next is used to pass control to the next step in the middleware pipeline. When a middleware calls next.run(), it invokes the next middleware or, if there are no more middleware, the final handler.

§Examples

use wsforge::prelude::*;
use async_trait::async_trait;

struct MyMiddleware;

#[async_trait]
impl Middleware for MyMiddleware {
    async fn handle(
        &self,
        message: Message,
        conn: Connection,
        state: AppState,
        extensions: Extensions,
        mut next: Next,
    ) -> Result<Option<Message>> {
        println!("Before next");

        // Call the next middleware/handler
        let response = next.run(message, conn, state, extensions).await?;

        println!("After next");
        Ok(response)
    }
}

Implementations§

Source§

impl Next

Source

pub fn new(chain: Arc<MiddlewareChain>, index: usize) -> Self

Creates a new Next instance.

§Arguments
  • chain - The middleware chain to execute
  • index - Current position in the chain
Source

pub async fn run( self, message: Message, conn: Connection, state: AppState, extensions: Extensions, ) -> Result<Option<Message>>

Call the next middleware in the chain.

This method executes the next middleware in the sequence. If all middleware have been executed, it calls the final handler.

§Arguments
  • message - The WebSocket message being processed
  • conn - The connection that sent the message
  • state - Application state
  • extensions - Request-scoped extension data
§Returns

Returns the response from the next middleware or handler, or None if no response should be sent.

§Examples
use wsforge::prelude::*;
use async_trait::async_trait;

struct TimingMiddleware;

#[async_trait]
impl Middleware for TimingMiddleware {
    async fn handle(
        &self,
        message: Message,
        conn: Connection,
        state: AppState,
        extensions: Extensions,
        mut next: Next,
    ) -> Result<Option<Message>> {
        let start = std::time::Instant::now();

        let response = next.run(message, conn, state, extensions).await?;

        let duration = start.elapsed();
        println!("Request took: {:?}", duration);

        Ok(response)
    }
}

Auto Trait Implementations§

§

impl Freeze for Next

§

impl !RefUnwindSafe for Next

§

impl Send for Next

§

impl Sync for Next

§

impl Unpin for Next

§

impl !UnwindSafe for Next

Blanket Implementations§

Source§

impl<T> Any for T
where T: 'static + ?Sized,

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

impl<T> Borrow<T> for T
where T: ?Sized,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

Source§

impl<T> Instrument for T

Source§

fn instrument(self, span: Span) -> Instrumented<Self>

Instruments this type with the provided Span, returning an Instrumented wrapper. Read more
Source§

fn in_current_span(self) -> Instrumented<Self>

Instruments this type with the current Span, returning an Instrumented wrapper. Read more
Source§

impl<T, U> Into<U> for T
where U: From<T>,

Source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

Source§

impl<T> Same for T

Source§

type Output = T

Should always be Self
Source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = Infallible

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
Source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.
Source§

impl<V, T> VZip<V> for T
where V: MultiLane<T>,

Source§

fn vzip(self) -> V

Source§

impl<T> WithSubscriber for T

Source§

fn with_subscriber<S>(self, subscriber: S) -> WithDispatch<Self>
where S: Into<Dispatch>,

Attaches the provided Subscriber to this type, returning a WithDispatch wrapper. Read more
Source§

fn with_current_subscriber(self) -> WithDispatch<Self>

Attaches the current default Subscriber to this type, returning a WithDispatch wrapper. Read more