FlowWithContext

org.apache.pekko.stream.scaladsl.FlowWithContext
See theFlowWithContext companion object
final class FlowWithContext[-In, -CtxIn, +Out, +CtxOut, +Mat](delegate: Flow[(In, CtxIn), (Out, CtxOut), Mat]) extends FlowWithContextOps[Out, CtxOut, Mat]

A flow that provides operations which automatically propagate the context of an element. Only a subset of common operations from FlowOps is supported. As an escape hatch you can use FlowWithContextOps.via to manually provide the context propagation for otherwise unsupported operations.

An "empty" flow can be created by calling FlowWithContext[Ctx, T].

Attributes

Companion
object
Source
FlowWithContext.scala
Graph
Supertypes
trait FlowWithContextOps[Out, CtxOut, Mat]
trait Graph[FlowShape[(In, CtxIn), (Out, CtxOut)], Mat]
class Object
trait Matchable
class Any

Members list

Type members

Types

override type ReprMat[+O, +C, +M] = FlowWithContext[In, CtxIn, O, C, M]

Attributes

Source
FlowWithContext.scala

Inherited types

type Repr[+O, +C] = ReprMat[O, C, Mat]

Attributes

Inherited from:
FlowWithContextOps
Source
FlowWithContextOps.scala
type Shape = FlowShape[(In, CtxIn), (Out, CtxOut)]

Type-level accessor for the shape parameter of this graph.

Type-level accessor for the shape parameter of this graph.

Attributes

Inherited from:
Graph
Source
Graph.scala

Value members

Concrete methods

override def alsoTo(that: Graph[SinkShape[Out], _]): Repr[Out, CtxOut]
override def alsoToContext(that: Graph[SinkShape[CtxOut], _]): Repr[Out, CtxOut]

Attributes

See also
Since

1.1.0

Definition Classes
Source
FlowWithContext.scala
def asFlow: Flow[(In, CtxIn), (Out, CtxOut), Mat]

Attributes

Source
FlowWithContext.scala
def asJava[JIn <: In, JCtxIn <: CtxIn, JOut >: Out, JCtxOut >: CtxOut, JMat >: Mat]: FlowWithContext[JIn, JCtxIn, JOut, JCtxOut, JMat]

Attributes

Source
FlowWithContext.scala
def mapMaterializedValue[Mat2](f: Mat => Mat2): FlowWithContext[In, CtxIn, Out, CtxOut, Mat2]
override def unsafeDataVia[Out2, Mat2](viaFlow: Graph[FlowShape[Out, Out2], Mat2]): Repr[Out2, CtxOut]

Transform this flow by the regular flow. The given flow works on the data portion of the stream and ignores the context.

Transform this flow by the regular flow. The given flow works on the data portion of the stream and ignores the context.

The given flow must not re-order, drop or emit multiple elements for one incoming element, the sequence of incoming contexts is re-combined with the outgoing elements of the stream. If a flow not fulfilling this requirement is used the stream will not fail but continue running in a corrupt state and re-combine incorrect pairs of elements and contexts or deadlock.

For more background on these requirements see https://pekko.apache.org/docs/pekko/current/stream/stream-context.html.

Attributes

Definition Classes
Source
FlowWithContext.scala
override def via[Out2, Ctx2, Mat2](viaFlow: Graph[FlowShape[(Out, CtxOut), (Out2, Ctx2)], Mat2]): Repr[Out2, Ctx2]

Transform this flow by the regular flow. The given flow must support manual context propagation by taking and producing tuples of (data, context).

Transform this flow by the regular flow. The given flow must support manual context propagation by taking and producing tuples of (data, context).

It is up to the implementer to ensure the inner flow does not exhibit any behavior that is not expected by the downstream elements, such as reordering. For more background on these requirements see https://pekko.apache.org/docs/pekko/current/stream/stream-context.html.

This can be used as an escape hatch for operations that are not (yet) provided with automatic context propagation here.

Attributes

See also
Definition Classes
Source
FlowWithContext.scala
override def viaMat[Out2, Ctx2, Mat2, Mat3](flow: Graph[FlowShape[(Out, CtxOut), (Out2, Ctx2)], Mat2])(combine: (Mat, Mat2) => Mat3): FlowWithContext[In, CtxIn, Out2, Ctx2, Mat3]

Transform this flow by the regular flow. The given flow must support manual context propagation by taking and producing tuples of (data, context).

Transform this flow by the regular flow. The given flow must support manual context propagation by taking and producing tuples of (data, context).

It is up to the implementer to ensure the inner flow does not exhibit any behavior that is not expected by the downstream elements, such as reordering. For more background on these requirements see https://pekko.apache.org/docs/pekko/current/stream/stream-context.html.

This can be used as an escape hatch for operations that are not (yet) provided with automatic context propagation here.

The combine function is used to compose the materialized values of this flow and that flow into the materialized value of the resulting Flow.

Attributes

See also
Definition Classes
Source
FlowWithContext.scala
override def wireTap(that: Graph[SinkShape[Out], _]): Repr[Out, CtxOut]
override def wireTapContext(that: Graph[SinkShape[CtxOut], _]): Repr[Out, CtxOut]

Attributes

See also
Since

1.1.0

Definition Classes
Source
FlowWithContext.scala
override def withAttributes(attr: Attributes): FlowWithContext[In, CtxIn, Out, CtxOut, Mat]

Context-preserving variant of pekko.stream.scaladsl.Flow.withAttributes.

Context-preserving variant of pekko.stream.scaladsl.Flow.withAttributes.

Attributes

See also
Definition Classes
Source
FlowWithContext.scala

Inherited methods

def addAttributes(attr: Attributes): Graph[FlowShape[(In, CtxIn), (Out, CtxOut)], Mat]

Add the given attributes to this Graph. If the specific attribute was already present on this graph this means the added attribute will be more specific than the existing one. If this Source is a composite of multiple graphs, new attributes on the composite will be less specific than attributes set directly on the individual graphs of the composite.

Add the given attributes to this Graph. If the specific attribute was already present on this graph this means the added attribute will be more specific than the existing one. If this Source is a composite of multiple graphs, new attributes on the composite will be less specific than attributes set directly on the individual graphs of the composite.

Attributes

Inherited from:
Graph
Source
Graph.scala
def async(dispatcher: String, inputBufferSize: Int): Graph[FlowShape[(In, CtxIn), (Out, CtxOut)], Mat]

Put an asynchronous boundary around this Graph

Put an asynchronous boundary around this Graph

Value parameters

dispatcher

Run the graph on this dispatcher

inputBufferSize

Set the input buffer to this size for the graph

Attributes

Inherited from:
Graph
Source
Graph.scala
def async(dispatcher: String): Graph[FlowShape[(In, CtxIn), (Out, CtxOut)], Mat]

Put an asynchronous boundary around this Graph

Put an asynchronous boundary around this Graph

Value parameters

dispatcher

Run the graph on this dispatcher

Attributes

Inherited from:
Graph
Source
Graph.scala
def async: Graph[FlowShape[(In, CtxIn), (Out, CtxOut)], Mat]

Put an asynchronous boundary around this Graph

Put an asynchronous boundary around this Graph

Attributes

Inherited from:
Graph
Source
Graph.scala
def collect[Out2](f: PartialFunction[Out, Out2]): Repr[Out2, CtxOut]

Context-preserving variant of pekko.stream.scaladsl.FlowOps.collect.

Context-preserving variant of pekko.stream.scaladsl.FlowOps.collect.

Note, that the context of elements that are filtered out is skipped as well.

Attributes

See also
Inherited from:
FlowWithContextOps
Source
FlowWithContextOps.scala
def filter(pred: Out => Boolean): Repr[Out, CtxOut]

Context-preserving variant of pekko.stream.scaladsl.FlowOps.filter.

Context-preserving variant of pekko.stream.scaladsl.FlowOps.filter.

Note, that the context of elements that are filtered out is skipped as well.

Attributes

See also
Inherited from:
FlowWithContextOps
Source
FlowWithContextOps.scala
def filterNot(pred: Out => Boolean): Repr[Out, CtxOut]

Context-preserving variant of pekko.stream.scaladsl.FlowOps.filterNot.

Context-preserving variant of pekko.stream.scaladsl.FlowOps.filterNot.

Note, that the context of elements that are filtered out is skipped as well.

Attributes

See also
Inherited from:
FlowWithContextOps
Source
FlowWithContextOps.scala

Attributes

Inherited from:
Graph
Source
Graph.scala
def grouped(n: Int): Repr[Seq[Out], Seq[CtxOut]]

Context-preserving variant of pekko.stream.scaladsl.FlowOps.grouped.

Context-preserving variant of pekko.stream.scaladsl.FlowOps.grouped.

Each output group will be associated with a Seq of corresponding context elements.

Attributes

See also
Inherited from:
FlowWithContextOps
Source
FlowWithContextOps.scala
def log(name: String, extract: Out => Any)(implicit log: LoggingAdapter): Repr[Out, CtxOut]

Context-preserving variant of pekko.stream.scaladsl.FlowOps.log.

Context-preserving variant of pekko.stream.scaladsl.FlowOps.log.

Attributes

See also
Inherited from:
FlowWithContextOps
Source
FlowWithContextOps.scala
def logWithMarker(name: String, marker: (Out, CtxOut) => LogMarker, extract: Out => Any)(implicit log: MarkerLoggingAdapter): Repr[Out, CtxOut]
def map[Out2](f: Out => Out2): Repr[Out2, CtxOut]

Context-preserving variant of pekko.stream.scaladsl.FlowOps.map.

Context-preserving variant of pekko.stream.scaladsl.FlowOps.map.

Attributes

See also
Inherited from:
FlowWithContextOps
Source
FlowWithContextOps.scala
def mapAsync[Out2](parallelism: Int)(f: Out => Future[Out2]): Repr[Out2, CtxOut]

Context-preserving variant of pekko.stream.scaladsl.FlowOps.mapAsync.

Context-preserving variant of pekko.stream.scaladsl.FlowOps.mapAsync.

Attributes

See also
Inherited from:
FlowWithContextOps
Source
FlowWithContextOps.scala
def mapAsyncPartitioned[Out2, P](parallelism: Int)(partitioner: Out => P)(f: (Out, P) => Future[Out2]): Repr[Out2, CtxOut]
def mapAsyncPartitionedUnordered[Out2, P](parallelism: Int)(partitioner: Out => P)(f: (Out, P) => Future[Out2]): Repr[Out2, CtxOut]
def mapConcat[Out2](f: Out => IterableOnce[Out2]): Repr[Out2, CtxOut]

Context-preserving variant of pekko.stream.scaladsl.FlowOps.mapConcat.

Context-preserving variant of pekko.stream.scaladsl.FlowOps.mapConcat.

The context of the input element will be associated with each of the output elements calculated from this input element.

Example:

def dup(element: String) = Seq(element, element)

Input:

("a", 1)
("b", 2)

inputElements.mapConcat(dup)

Output:

("a", 1)
("a", 1)
("b", 2)
("b", 2)

Attributes

See also
Inherited from:
FlowWithContextOps
Source
FlowWithContextOps.scala
def mapContext[Ctx2](f: CtxOut => Ctx2): Repr[Out, Ctx2]

Apply the given function to each context element (leaving the data elements unchanged).

Apply the given function to each context element (leaving the data elements unchanged).

Attributes

Inherited from:
FlowWithContextOps
Source
FlowWithContextOps.scala
def mapError(pf: PartialFunction[Throwable, Throwable]): Repr[Out, CtxOut]

Context-preserving variant of pekko.stream.scaladsl.FlowOps.mapError.

Context-preserving variant of pekko.stream.scaladsl.FlowOps.mapError.

Attributes

See also
Inherited from:
FlowWithContextOps
Source
FlowWithContextOps.scala
def named(name: String): Graph[FlowShape[(In, CtxIn), (Out, CtxOut)], Mat]

Specifies the name of the Graph. If the name is null or empty the name is ignored, i.e. Attributes.none is returned.

Specifies the name of the Graph. If the name is null or empty the name is ignored, i.e. Attributes.none is returned.

Attributes

Inherited from:
Graph
Source
Graph.scala
final override def shape: FlowShape[(In, CtxIn), (Out, CtxOut)]

The shape of a graph is all that is externally visible: its inlets and outlets.

The shape of a graph is all that is externally visible: its inlets and outlets.

Attributes

Definition Classes
GraphDelegate -> Graph
Inherited from:
GraphDelegate (hidden)
Source
Graph.scala
def sliding(n: Int, step: Int): Repr[Seq[Out], Seq[CtxOut]]

Context-preserving variant of pekko.stream.scaladsl.FlowOps.sliding.

Context-preserving variant of pekko.stream.scaladsl.FlowOps.sliding.

Each output group will be associated with a Seq of corresponding context elements.

Attributes

See also
Inherited from:
FlowWithContextOps
Source
FlowWithContextOps.scala
def throttle(cost: Int, per: FiniteDuration, maximumBurst: Int, costCalculation: Out => Int, mode: ThrottleMode): Repr[Out, CtxOut]

Context-preserving variant of pekko.stream.scaladsl.FlowOps.throttle.

Context-preserving variant of pekko.stream.scaladsl.FlowOps.throttle.

Attributes

See also
Inherited from:
FlowWithContextOps
Source
FlowWithContextOps.scala
def throttle(cost: Int, per: FiniteDuration, costCalculation: Out => Int): Repr[Out, CtxOut]

Context-preserving variant of pekko.stream.scaladsl.FlowOps.throttle.

Context-preserving variant of pekko.stream.scaladsl.FlowOps.throttle.

Attributes

See also
Inherited from:
FlowWithContextOps
Source
FlowWithContextOps.scala
def throttle(elements: Int, per: FiniteDuration, maximumBurst: Int, mode: ThrottleMode): Repr[Out, CtxOut]

Context-preserving variant of pekko.stream.scaladsl.FlowOps.throttle.

Context-preserving variant of pekko.stream.scaladsl.FlowOps.throttle.

Attributes

See also
Inherited from:
FlowWithContextOps
Source
FlowWithContextOps.scala
def throttle(elements: Int, per: FiniteDuration): Repr[Out, CtxOut]

Context-preserving variant of pekko.stream.scaladsl.FlowOps.throttle.

Context-preserving variant of pekko.stream.scaladsl.FlowOps.throttle.

Attributes

See also
Inherited from:
FlowWithContextOps
Source
FlowWithContextOps.scala