Struct ruma_client_api::message::send_message_event::v3::Request

#[non_exhaustive]
pub struct Request<'a> {
    pub room_id: &'a RoomId,
    pub event_type: MessageLikeEventType,
    pub txn_id: &'a TransactionId,
    pub body: Raw<AnyMessageLikeEventContent>,
}

Data for a request to the create_message_event API endpoint.

Send a message event to a room.

Fields (Non-exhaustive)

Non-exhaustive structs could have additional fields added in future. Therefore, non-exhaustive structs cannot be constructed in external crates using the traditional Struct { .. } syntax; cannot be matched against without a wildcard ..; and struct update syntax will not work.

room_id: &'a RoomId

The room to send the event to.

event_type: MessageLikeEventType

The type of event to send.

txn_id: &'a TransactionId

The transaction ID for this event.

Clients should generate an ID unique across requests with the same access token; it will be used by the server to ensure idempotency of requests.

body: Raw<AnyMessageLikeEventContent>

The event content to send.

Implementations

impl<'a> Request<'a>

pub fn new<T>(
    room_id: &'a RoomId,
    txn_id: &'a TransactionId,
    content: &'a T
) -> Result<Self> where
    T: MessageLikeEventContent, 

Creates a new Request with the given room id, transaction id and event content.

Errors

Since Request stores the request body in serialized form, this function can fail if Ts Serialize implementation can fail.

pub fn new_raw(
    room_id: &'a RoomId,
    txn_id: &'a TransactionId,
    event_type: MessageLikeEventType,
    body: Raw<AnyMessageLikeEventContent>
) -> Self

Creates a new Request with the given room id, transaction id, event type and raw event content.

Trait Implementations

impl<'a> Clone for Request<'a>

fn clone(&self) -> Request<'a>

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<'a> Debug for Request<'a>

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

Formats the value using the given formatter.

impl<'a> OutgoingRequest for Request<'a>

type EndpointError = Error

A type capturing the expected error conditions the server can return.

type IncomingResponse = Response

Response type returned when the request is successful.

const METADATA: Metadata = self::METADATA

Metadata about the endpoint.

fn try_into_http_request<T: Default + BufMut>(
    self,
    base_url: &str,
    access_token: SendAccessToken<'_>,
    considering_versions: &[MatrixVersion]
) -> Result<Request<T>, IntoHttpError>

Tries to convert this request into an http::Request.