Skip to main content

open_net/api/ws/
request.rs

1use super::{Message, RequestId};
2use crate::Metadata;
3
4/// Business request to send, including an identifier, body, and metadata.
5#[derive(Clone, Debug)]
6pub struct Request {
7    /// Identifier used to correlate the business response.
8    id: RequestId,
9    /// Text or binary body sent on the wire.
10    message: Message,
11    /// Additional metadata; size validation occurs during send admission.
12    metadata: Metadata,
13}
14
15impl Request {
16    /// Creates a request with empty metadata.
17    pub fn new(id: RequestId, message: Message) -> Self {
18        Self {
19            id,
20            message,
21            metadata: Metadata::new(),
22        }
23    }
24
25    /// Replaces the request metadata.
26    pub fn with_metadata(mut self, metadata: Metadata) -> Self {
27        self.metadata = metadata;
28        self
29    }
30
31    /// Borrows the request identifier.
32    pub fn id(&self) -> &RequestId {
33        &self.id
34    }
35
36    /// Borrows the request body.
37    pub fn message(&self) -> &Message {
38        &self.message
39    }
40
41    /// Borrows request metadata.
42    pub fn metadata(&self) -> &Metadata {
43        &self.metadata
44    }
45
46    /// Consumes the request and returns its components.
47    pub fn into_parts(self) -> (RequestId, Message, Metadata) {
48        (self.id, self.message, self.metadata)
49    }
50}