Struct QueryBuilder

pub struct QueryBuilder { /* private fields */ }

Builds a query DNS message.

You can create a new query from a given question using the new function. The add_opt method provides the means to add an OPT record to the additional section. The entire additional section can later be removed through the revert_additional function.

Once you are happy with your query, you can turn it into a QueryMessage through the freeze method.

Implementations

impl QueryBuilder

pub fn new<N: ToDname, Q: Into<Question<N>>>(question: Q) -> Self

Creates a new query builder.

The query will contain one question built from question. It will have a random ID. The RD bit will not be set. If you desire recursion, you can enable it via the set_rd method.

pub fn header(&self) -> &Header

Returns a reference to the header of the query.

pub fn header_mut(&mut self) -> &mut Header

Returns a mutable reference to the header of the query.

pub fn set_rd(&mut self, value: bool)

Sets the ‘recursion desired’ (RD) bit to the given value.

This is a shortcut to self.header_mut().set_rd(value).

By default, this bit is not set.

pub fn add_opt<F>(&mut self, op: F)

where F: FnOnce(&mut OptBuilder<'_>),

Adds an OPT record to the additional section.

The content of the record can be manipulated in the closure provided as an argument. This closure receives a mutable reference to an OptBuilder which will allow access to the OPT record’s header as well as allow adding options.

pub fn revert_additional(&mut self)

Removes all records from the additional section.

Afterwards, only the single question will remain in the message.

pub fn freeze(self) -> QueryMessage

Freezes the query builder into a query message.

Trait Implementations

impl Clone for QueryBuilder

fn clone(&self) -> QueryBuilder

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for QueryBuilder

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

Formats the value using the given formatter.