Class Balance$

java.lang.Object
org.apache.pekko.stream.javadsl.Balance$

public class Balance$ extends Object
Fan-out the stream to several streams. Each upstream element is emitted to the first available downstream consumer. It will not shutdown until the subscriptions for at least two downstream subscribers have been established.

'''Emits when''' any of the outputs stops backpressuring; emits the element to the first available output

'''Backpressures when''' all of the outputs backpressure

'''Completes when''' upstream completes

'''Cancels when''' If eagerCancel is enabled: when any downstream cancels; otherwise: when all downstreams cancel

  • Field Details

    • MODULE$

      public static final Balance$ MODULE$
      Static reference to the singleton instance of this Scala object.
  • Constructor Details

    • Balance$

      public Balance$()
  • Method Details

    • create

      public <T> Graph<UniformFanOutShape<T,T>,NotUsed> create(int outputCount, boolean waitForAllDownstreams)
      Create a new Balance operator with the specified input type, eagerCancel is false.

      Parameters:
      outputCount - number of output ports
      waitForAllDownstreams - if true it will not start emitting elements to downstream outputs until all of them have requested at least one element
    • create

      public <T> Graph<UniformFanOutShape<T,T>,NotUsed> create(int outputCount, boolean waitForAllDownstreams, boolean eagerCancel)
      Create a new Balance operator with the specified input type.

      Parameters:
      outputCount - number of output ports
      waitForAllDownstreams - if true it will not start emitting elements to downstream outputs until all of them have requested at least one element
      eagerCancel - if true, balance cancels upstream if any of its downstreams cancel, if false, when all have cancelled.
    • create

      public <T> Graph<UniformFanOutShape<T,T>,NotUsed> create(int outputCount)
      Create a new Balance operator with the specified input type, both waitForAllDownstreams and eagerCancel are false.

      Parameters:
      outputCount - number of output ports
    • create

      public <T> Graph<UniformFanOutShape<T,T>,NotUsed> create(Class<T> clazz, int outputCount)
      Create a new Balance operator with the specified input type, both waitForAllDownstreams and eagerCancel are false.

      Parameters:
      clazz - a type hint for this method
      outputCount - number of output ports
    • create

      public <T> Graph<UniformFanOutShape<T,T>,NotUsed> create(Class<T> clazz, int outputCount, boolean waitForAllDownstreams)
      Create a new Balance operator with the specified input type, eagerCancel is false.

      Parameters:
      clazz - a type hint for this method
      outputCount - number of output ports
      waitForAllDownstreams - if true it will not start emitting elements to downstream outputs until all of them have requested at least one element
    • create

      public <T> Graph<UniformFanOutShape<T,T>,NotUsed> create(Class<T> clazz, int outputCount, boolean waitForAllDownstreams, boolean eagerCancel)
      Create a new Balance operator with the specified input type.

      Parameters:
      clazz - a type hint for this method
      outputCount - number of output ports
      waitForAllDownstreams - if true it will not start emitting elements to downstream outputs until all of them have requested at least one element
      eagerCancel - if true, balance cancels upstream if any of its downstreams cancel, if false, when all have cancelled.