Struct RequestHead 

pub struct RequestHead {
    pub id: usize,
    pub uri: Url,
    pub method: Method,
    pub version: Version,
    pub headers: HeaderMap,
    pub headers_vec: Vec<HeaderItem>,
    pub extensions: RefCell<Extensions>,
    /* private fields */
}

The parsed metadata for an HTTP request.

Fields

id: usize

Identifier of the connection that received the request.

uri: Url

Request URI.

method: Method

Request method.

version: Version

HTTP protocol version.

headers: HeaderMap

Parsed request headers.

headers_vec: Vec<HeaderItem>

Headers in their original order and with their original names.

This collection is populated only when HttpServiceConfig::set_headers_vec is enabled.

extensions: RefCell<Extensions>

Request-local type map.

Implementations

impl RequestHead

pub fn extensions(&self) -> Ref<'_, Extensions>

Returns the request extensions.

pub fn extensions_mut(&self) -> RefMut<'_, Extensions>

Returns mutable access to the request extensions.

pub fn headers(&self) -> &HeaderMap

Returns the request headers.

pub fn headers_mut(&mut self) -> &mut HeaderMap

Returns mutable access to the request headers.

pub fn headers_vec(&self) -> &[HeaderItem]

Returns headers preserved in their original order and casing.

pub fn set_connection_type(&mut self, ctype: ConnectionType)

Sets the request connection behavior.

Connection types are flags, and calling this method again does not clear a previously set type. When several are set, Close takes precedence over KeepAlive, which takes precedence over Upgrade.

pub fn connection_type(&self) -> ConnectionType

Returns the request connection behavior.

pub fn upgrade(&self) -> bool

Returns whether the request upgrades the connection.

pub fn expect(&self) -> bool

Returns whether the request contains Expect: 100-continue.

pub fn chunked(&self) -> bool

Returns whether chunked transfer encoding is allowed.

pub fn no_chunking(&mut self, val: bool)

Enables or disables chunked transfer encoding.

A streaming request body without chunked coding requires a Content-Length header.

pub fn peer_addr(&self) -> Option<SocketAddr>

Returns the peer socket address.

Peer address is actual socket address, if proxy is used in front of ntex http server, then peer address would be address of this proxy.

pub fn take_io(&self) -> Option<(IoBoxed, Codec)>

Takes ownership of the I/O stream and HTTP/1 codec for an upgrade.

The handle is installed only after an upgrade is acknowledged through the HTTP/1 control service. This is a one-shot operation: subsequent calls return None.

Trait Implementations

impl Debug for RequestHead

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

Formats the value using the given formatter.

impl Default for RequestHead

fn default() -> RequestHead

Returns the “default value” for a type.