Struct SplitSegment 

pub struct SplitSegment {
    pub splitter: SplitExpression,
    pub body: OutcomeSegment,
    pub parallel: bool,
    pub parallel_limit: Option<usize>,
    pub stop_on_exception: bool,
    pub aggregation: AggregationStrategy,
}

Outcome-aware structural EIP segment for the Split pattern.

Splits an incoming exchange into fragments, processes each fragment through body, and aggregates the results. Supports sequential and parallel modes.

In sequential mode, fragments are processed in order. A Stopped or Failed outcome from any fragment halts processing immediately and propagates.

In parallel mode, all fragments are spawned as tokio tasks. The first Stopped outcome (lowest fragment index wins via CAS) propagates as the outer Stopped. In-flight tasks run to completion (spec §5.6: no abrupt abort — child sub-pipelines may have HTTP/SQL side effects). Tasks that have not started yet are short-circuited via a pre-start gate.

Unlike SplitterService (which operates at the Tower layer and cannot preserve Stopped(ex) with mutations), SplitSegment operates at the PipelineOutcome layer and preserves the exchange including all mutations at the Stop point.

Fields

splitter: SplitExpression

Splits an exchange into fragment exchanges.

body: OutcomeSegment

The sub-pipeline executed for each fragment.

parallel: bool

Whether to process fragments in parallel.

parallel_limit: Option<usize>

Maximum number of concurrent fragments in parallel mode (None = unlimited).

stop_on_exception: bool

Whether to stop processing on the first exception.

When true, a Failed outcome from any fragment halts processing immediately. When false, the error is collected and processing continues; the last-seen error is propagated (last-wins, matching legacy multicast.rs::process_parallel) is propagated after all fragments complete.

Stopped outcomes always propagate immediately regardless of this flag (per ADR-0025 §7 — Stop is successful control flow).

aggregation: AggregationStrategy

Strategy for aggregating fragment results.

Trait Implementations

impl Clone for SplitSegment

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl OutcomePipeline for SplitSegment

fn clone_box(&self) -> Box<dyn OutcomePipeline>

Clone the segment into a new boxed instance. Required because Box<dyn OutcomePipeline> cannot directly derive Clone.

fn run<'a>( &'a mut self, exchange: Exchange, ) -> Pin<Box<dyn Future<Output = PipelineOutcome> + Send + 'a>>

Execute the segment against exchange, returning a PipelineOutcome.