Struct Negotiate 

pub struct Negotiate<T> {
    pub data: T,
    pub format: OutputFormat,
}

Content-negotiated response wrapper

Automatically serializes to JSON or TOON based on the client’s Accept header. If the client prefers TOON (Accept: application/toon), returns TOON format. Otherwise, defaults to JSON.

Example

use rustapi_rs::prelude::*;
use rustapi_rs::toon::{Negotiate, AcceptHeader};

#[derive(Serialize)]
struct User {
    id: u64,
    name: String,
}

// Automatic negotiation via extractor
async fn get_user(accept: AcceptHeader) -> Negotiate<User> {
    Negotiate::new(
        User { id: 1, name: "Alice".to_string() },
        accept.preferred,
    )
}

// Or explicitly choose format
async fn get_user_toon() -> Negotiate<User> {
    Negotiate::toon(User { id: 1, name: "Alice".to_string() })
}

Fields

data: T

The data to serialize

format: OutputFormat

The output format to use

Implementations

impl<T> Negotiate<T>

pub fn new(data: T, format: OutputFormat) -> Self

Create a new negotiated response with the specified format

pub fn json(data: T) -> Self

Create a JSON response

pub fn toon(data: T) -> Self

Create a TOON response

pub fn format(&self) -> OutputFormat

Get the output format

Trait Implementations

impl<T: Clone> Clone for Negotiate<T>

fn clone(&self) -> Negotiate<T>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<T: Debug> Debug for Negotiate<T>

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

Formats the value using the given formatter.

impl<T: Serialize> IntoResponse for Negotiate<T>

fn into_response(self) -> Response

Convert self into a Response

impl<T: Send> OperationModifier for Negotiate<T>

fn update_operation(_op: &mut Operation)

Update the operation

impl<T: Serialize> ResponseModifier for Negotiate<T>

fn update_response(op: &mut Operation)

Update the operation with response information