Struct ConfigSections 

pub struct ConfigSections { /* private fields */ }

The sections a request reads, and how to read each one.

Built once, at startup, and handed to the framework adapter. Each entry is a closure the adapter calls when a request begins — never during it, which is what makes the reads agree.

Implementations

impl Sections

pub fn new() -> Sections

An empty list.

pub fn section<T, F>(self, read: F) -> Sections

where T: Any + Send + Sync, F: Fn() -> Option<Arc<T>> + Send + Sync + 'static,

Adds one section, read by read.

let sections = Sections::new().section(try_current);

In a service read is || Database::try_current(), or move || handle.current() for a Dynamic<T>.

Registering the same type twice keeps the last reader, so a composed list can override one entry without rebuilding it.

pub fn section_with_generation<T, F, G>( self, read: F, generation: G, ) -> Sections

where T: Any + Send + Sync, F: Fn() -> Option<Arc<T>> + Send + Sync + 'static, G: Fn() -> u64 + Send + Sync + 'static,

Adds one section, with the install counter that says when it moved.

What sections! uses. The counter lets take tell a snapshot that straddled a reload from one that did not; a section registered through section has none, and a list containing one cannot make that check.

pub fn is_consistent(&self) -> bool

Whether every section can say when it last moved.

false when any was registered through section, which takes a reader and nothing else — take then reads once without checking.

pub fn take(&self) -> Snapshot

Reads every section once.

Called by the adapter when a request begins. A section that has not loaded is left out rather than failing the request: the handler that asks for it gets NotInScope::NotLoaded, and a handler that does not ask is unaffected.

pub fn len(&self) -> usize

How many sections are registered.

pub fn is_empty(&self) -> bool

Whether nothing is registered.

pub fn names(&self) -> Vec<&'static str>

The registered type names, in order.

Trait Implementations

impl Debug for Sections

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

Formats the value using the given formatter.

impl Default for Sections

fn default() -> Sections

Returns the “default value” for a type.