Struct ServiceDefinition 

pub struct ServiceDefinition {
    pub service_name: String,
    pub binary_path: String,
    pub isolation: i32,
    pub explicit_instance: String,
    pub per_version_binary_dir: String,
    pub min_version: String,
    pub version_allow_list: Vec<String>,
    pub labels: HashMap<String, String>,
    pub http_server: Option<HttpServerCapability>,
}

v2 service definition envelope.

Carries the service identity, the launcher / isolation policy shared with v1, and the new v2-only capability fields. The fields shared with v1 (binary_path, isolation, etc.) intentionally use the same field numbers as broker_v1.ServiceDefinition (2–8) to keep the human-readable diff between the two messages obvious and to make the v1 → v2 migration a literal field-by-field move on the consumer side. New v2-only fields start at 10 (http_server) and grow upward.

Fields

service_name: String

[a-z0-9-]{1,64}; same validation rules as v1.

binary_path: String

Canonical path to the backend binary. v1: binary_path (field 2). Pre-#522 v2 brokers ignored this; consumers populating the field on a pre-#522 broker get the v2 envelope round-trip but the broker can’t launch from the path until upgraded.

isolation: i32

Broker isolation mode. v1: BrokerIsolation (field 3). Defaults to PRIVATE_BROKER (proto3 zero value) when absent.

explicit_instance: String

Used only when isolation == EXPLICIT_INSTANCE. v1: explicit_instance (field 4). Ignored for other isolation modes.

per_version_binary_dir: String

Canonicalized allow-list root for backends. v1: per_version_binary_dir (field 5). The broker refuses any binary_path that does not resolve under this directory.

min_version: String

Semver floor — broker refuses any Hello whose wanted_version is below this. v1: min_version (field 6). Empty => no floor.

version_allow_list: Vec<String>

Optional strict pin list. v1: version_allow_list (field 7). When non-empty, the broker refuses any Hello whose wanted_version is not in this list. Use sparingly — min_version is the common case.

labels: HashMap<String, String>

Arbitrary key/value labels (deployment hints, A/B routing tags, …). v1: labels (field 8). Broker does not interpret these; they are surfaced verbatim to consumers via the existing reflection APIs.

http_server: Option<HttpServerCapability>

Optional HTTP server capability. Absent => backend serves no HTTP. v2-only field; v1 has no HTTP-server concept.

Implementations

impl ServiceDefinition

pub fn isolation(&self) -> BrokerIsolation

Returns the enum value of isolation, or the default if the field is set to an invalid enum value.

pub fn set_isolation(&mut self, value: BrokerIsolation)

Sets isolation to the provided enum value.

Trait Implementations

impl Clone for ServiceDefinition

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ServiceDefinition

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

Formats the value using the given formatter.

impl Default for ServiceDefinition

fn default() -> Self

Returns the “default value” for a type.

impl Message for ServiceDefinition

fn encoded_len(&self) -> usize

Returns the encoded length of the message without a length delimiter.

fn clear(&mut self)

Clears the message, resetting all fields to their default.

fn encode(&self, buf: &mut impl BufMut) -> Result<(), EncodeError>

where Self: Sized,

Encodes the message to a buffer.

fn encode_to_vec(&self) -> Vec<u8>

where Self: Sized,

Encodes the message to a newly allocated buffer.

fn encode_length_delimited( &self, buf: &mut impl BufMut, ) -> Result<(), EncodeError>

where Self: Sized,

Encodes the message with a length-delimiter to a buffer.

fn encode_length_delimited_to_vec(&self) -> Vec<u8>

where Self: Sized,

Encodes the message with a length-delimiter to a newly allocated buffer.

fn decode(buf: impl Buf) -> Result<Self, DecodeError>

where Self: Default,

Decodes an instance of the message from a buffer.

fn decode_length_delimited(buf: impl Buf) -> Result<Self, DecodeError>

where Self: Default,

Decodes a length-delimited instance of the message from the buffer.

fn merge(&mut self, buf: impl Buf) -> Result<(), DecodeError>

where Self: Sized,

Decodes an instance of the message from a buffer, and merges it into self.

fn merge_length_delimited(&mut self, buf: impl Buf) -> Result<(), DecodeError>

where Self: Sized,

Decodes a length-delimited instance of the message from buffer, and merges it into self.

impl PartialEq for ServiceDefinition

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for ServiceDefinition