Skip to main content

EventRouter

Struct EventRouter 

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

Routes events from HTTP callbacks to a channel.

The EventRouter maintains a set of active subscription IDs. When an event is received via HTTP callback, the router checks if the subscription is registered and sends the notification payload to the configured channel.

Events for unregistered SIDs are buffered briefly and replayed when register() is called, preventing the race between SUBSCRIBE response and initial UPnP NOTIFY delivery.

Implementations§

Source§

impl EventRouter

Source

pub fn new(event_sender: UnboundedSender<NotificationPayload>) -> Self

Create a new event router.

§Arguments
  • event_sender - Channel for sending notification payloads
§Example
use tokio::sync::mpsc;
use callback_server::router::{EventRouter, NotificationPayload};

let (tx, mut rx) = mpsc::unbounded_channel::<NotificationPayload>();
let router = EventRouter::new(tx);
Source

pub async fn register(&self, subscription_id: String)

Register a subscription ID for event routing.

Adds the SID to the active set and replays any buffered events that arrived before registration (the SUBSCRIBE/NOTIFY race window). Also cleans up stale buffer entries older than BUFFER_TTL.

Source

pub async fn unregister(&self, subscription_id: &str)

Unregister a subscription ID.

Removes the SID from the active set and drains any buffered events for it, preventing stale replays on future re-registration.

Source

pub async fn route_event(&self, subscription_id: String, event_xml: String)

Route an incoming event to the unified event stream.

If the subscription is registered, the event is sent immediately. If not, the event is buffered for replay when register() is called. The caller should always return HTTP 200 OK — buffered events are accepted for processing, not rejected.

Trait Implementations§

Source§

impl Clone for EventRouter

Source§

fn clone(&self) -> EventRouter

Returns a duplicate of the value. Read more
1.0.0 · Source§

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

Performs copy-assignment from source. Read more

Auto Trait Implementations§

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> CloneToUninit for T
where T: Clone,

Source§

unsafe fn clone_to_uninit(&self, dest: *mut u8)

🔬This is a nightly-only experimental API. (clone_to_uninit)
Performs copy-assignment from self to dest. 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> ToOwned for T
where T: Clone,

Source§

type Owned = T

The resulting type after obtaining ownership.
Source§

fn to_owned(&self) -> T

Creates owned data from borrowed data, usually by cloning. Read more
Source§

fn clone_into(&self, target: &mut T)

Uses borrowed data to replace owned data, usually by cloning. Read more
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