Struct ResponseBuilder 

pub struct ResponseBuilder { /* private fields */ }

Builds a response.

Implementations

impl ResponseBuilder

pub fn new( status: StatusCode, reason: impl Into<Bytes>, ) -> Result<Self, BuildError>

Start a response.

The reason phrase is checked: it is the one field on a start line that carries free text, which makes it the obvious place to try to inject a line break.

pub fn to_request( request: &Request, status: StatusCode, reason: impl Into<Bytes>, ) -> Result<Self, BuildError>

Start a response to a request, copying the headers RFC 3261 §8.2.6.2 requires.

Via is copied in order and in full: the response finds its way back by walking that list, and reordering or deduplicating it strands the response. From, To, Call-ID and CSeq are copied verbatim, which also means a request whose To was unparseable still gets a well-formed response — the point of copying rather than re-deriving.

pub fn header( self, name: HeaderName, value: impl Into<Bytes>, ) -> Result<Self, BuildError>

Append a header, rejecting a value that could inject a line break.

pub fn set_header( self, name: &HeaderName, value: impl Into<Bytes>, ) -> Result<Self, BuildError>

Replace every header of this name with one carrying this value.

pub fn body(self, body: impl Into<Bytes>) -> Self

Set the body and its Content-Length.

pub fn build(self) -> Response

Finish.

Trait Implementations

impl Debug for ResponseBuilder

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

Formats the value using the given formatter.