Struct ServiceKey 

pub struct ServiceKey(/* private fields */);

Key used by keyed registrations, including the AnyKey fallback sentinel. Key of a keyed service registration / resolution.

Construct a value key with ServiceKey::new (or From<&str>/From<String> for string keys), and the fallback sentinel with ServiceKey::any_key.

String keys

String-keyed registration APIs (keyed_singleton("name", …)) store the key as a String. Use ServiceKey::from("name") / "name".into() to build an equal key. ServiceKey::new("name") is a different key type (&str), because key equality includes the value type — use it only for intentional &'static str-typed keys.

Reading a requested key

AnyKey fallback factories receive &ServiceKey. The erased key exposes Debug/Display and equality/hash; there is intentionally no typed downcast accessor (operations must be expressible through the ServiceKey API itself, keeping the erased-key representation private).

Implementations

impl ServiceKey

pub fn new<T>(value: T) -> ServiceKey

where T: Any + Send + Sync + Eq + Hash + Debug + 'static,

Create a typed key value.

use rust_dix::ServiceKey;

#[derive(Debug, PartialEq, Eq, Hash)]
enum Db { Read, Write }

let key = ServiceKey::new(Db::Read);
assert_ne!(key, ServiceKey::new(Db::Write));

pub fn any_key() -> ServiceKey

The AnyKey fallback sentinel (MEDI KeyedService.AnyKey).

Registering a service under this key makes it a fallback for every key that has no exact registration. Resolving a single service with this sentinel is not allowed (use ServiceKey-keyed lookups or enumeration instead).

pub fn is_any(&self) -> bool

Whether this key is the ServiceKey::any_key sentinel.

pub fn as_str(&self) -> Option<&str>

Borrow the key as &str for string-like keys: String and &'static str (including ServiceKey::new("literal")). Returns None for other typed keys and the AnyKey sentinel.

This is the compatibility bridge used by the default IServiceResolver typed-key methods, which fall back to the legacy string methods. Note that the fallback maps a typed &'static str key to a String key; in fully typed containers those two keys are not equal, so typed-key consumers should use the *_key methods.

Trait Implementations

impl Clone for ServiceKey

fn clone(&self) -> ServiceKey

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ServiceKey

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

Formats the value using the given formatter.

impl Display for ServiceKey

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

Formats the value using the given formatter.

impl Eq for ServiceKey

impl From<&ServiceKey> for ServiceKey

fn from(value: &ServiceKey) -> ServiceKey

Converts to this type from the input type.

impl From<&String> for ServiceKey

fn from(value: &String) -> ServiceKey

Converts to this type from the input type.

impl From<&str> for ServiceKey

fn from(value: &str) -> ServiceKey

Converts to this type from the input type.

impl From<String> for ServiceKey

fn from(value: String) -> ServiceKey

Converts to this type from the input type.

impl Hash for ServiceKey

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

where H: Hasher,

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 ServiceKey

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

Equality operator ==.

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

Inequality operator !=.