Struct RequestId 

pub struct RequestId { /* private fields */ }

A request’s reference: shown on error pages and carried by every event, so a visitor’s report finds the log line.

It displays as 16 hexadecimal digits, a keyed hash of the connection id and the request’s number with a key made at start-up: the same request always shows the same reference in one process, and two references say nothing about how much traffic came between them (the raw counters would). connection and seq give the raw values for the logs. Not a security token.

use web_net::{App, get};

let app = App::builder().route(get("/", |cx| cx.text(200, &cx.id().to_string()))).build()?;
let r = serve_net::testing::respond(&app, b"GET / HTTP/1.1\r\nHost: localhost\r\n\r\n");
assert_eq!(r.text().len(), 16);

Implementations

impl RequestId

pub const fn connection(&self) -> u64

The connection id.

use web_net::{App, get};

let app = App::builder()
    .route(get("/", |cx| {
        let connection = cx.id().connection().to_string();
        cx.text(200, &connection)
    }))
    .build()?;
let r = serve_net::testing::respond(&app, b"GET / HTTP/1.1\r\nHost: localhost\r\n\r\n");
assert!(r.text().parse::<u64>().is_ok());

pub const fn seq(&self) -> u32

The request’s number on its connection.

use web_net::{App, get};

let app = App::builder()
    .route(get("/", |cx| {
        let seq = cx.id().seq().to_string();
        cx.text(200, &seq)
    }))
    .build()?;
let r = serve_net::testing::respond(&app, b"GET / HTTP/1.1\r\nHost: localhost\r\n\r\n");
assert_eq!(r.text(), "1"); // the first request on its connection

Trait Implementations

impl Clone for RequestId

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for RequestId

impl Debug for RequestId

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

Formats the value using the given formatter.

impl Display for RequestId

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

Formats the value using the given formatter.

impl Eq for RequestId

impl Hash for RequestId

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq for RequestId

fn eq(&self, other: &Self) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl StructuralPartialEq for RequestId