Struct RegistryKey 

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

A typed routing key for the ProcessRegistry.

Using a newtype instead of a bare &str prevents accidental key-format mismatches (e.g. mixing conversation_id and correlation_id keys at different call sites) and makes the key derivation convention explicit at the type level.

Named constructors

Constructor	Use case
Constructor	Use case
—	—
from_conversation_and_sender	Route inbound APERAK by UTILMD conversation ID + sender GLN
from_correlation	Route follow-up messages by root correlation
from_process	Direct lookup by process instance
parse	Primary validated constructor for runtime-derived keys
from_static	Infallible constructor for compile-time-known string literals

Implementations

impl RegistryKey

pub fn from_conversation_and_sender( id: ConversationId, sender_gln: &str, ) -> Self

Key derived from a conversation ID and sender GLN.

This is the correct constructor for UTILMD ↔ APERAK routing in multi-market-participant deployments.

Why sender is required

EDIFACT conversation IDs are assigned by the sender within their own numbering space. Two senders may independently assign the same conversation-ID string, which would collide if keyed on conversation alone. Including the sender GLN as a discriminator makes the key globally unique within the tenant’s namespace.

Key format

"{sender_gln}:{conversation_id}" — stable, URL-safe, human-readable.

pub fn from_correlation(id: CorrelationId) -> Self

Key derived from a correlation ID (route all messages in the same root trace).

pub fn from_process(id: ProcessId) -> Self

Key derived from a process ID (direct process lookup).

pub fn parse(s: &str) -> Result<Self, EngineError>

Primary validated constructor for runtime-derived keys.

Returns EngineError::Registry when s contains a NUL byte or exceeds MAX_REGISTRY_KEY_LEN bytes. Use this for all keys derived from untrusted input (e.g. EDIFACT MessageId, AS4 conversation_id, or user-supplied strings).

Errors

• EngineError::Registry when s contains \0.
• EngineError::Registry when s.len() > MAX_REGISTRY_KEY_LEN.

pub fn from_static(s: &'static str) -> Self

Infallible constructor for compile-time-known string literals.

Panics at runtime if s contains a NUL byte or exceeds MAX_REGISTRY_KEY_LEN — but since this is only correct to call with string literals, any violation would be caught immediately in tests.

Panics

Panics when s contains a NUL byte or exceeds MAX_REGISTRY_KEY_LEN bytes. Only use this with string literals. Use parse for any value that may be runtime-derived.

pub fn as_str(&self) -> &str

The raw key string.

Trait Implementations

impl Clone for RegistryKey

fn clone(&self) -> RegistryKey

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for RegistryKey

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for RegistryKey

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Display for RegistryKey

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

Formats the value using the given formatter.

impl Eq for RegistryKey

impl FromStr for RegistryKey

type Err = EngineError

The associated error which can be returned from parsing.

fn from_str(s: &str) -> Result<Self, Self::Err>

Parses a string s to return a value of this type.

impl Hash for RegistryKey

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 RegistryKey

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

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for RegistryKey

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for RegistryKey