Interface QueueFuseable<T>

    • Field Detail

      • SYNC

        static final int SYNC
        Request a synchronous fusion mode and can be returned by requestFusion(int) for an accepted mode.

        In synchronous fusion, all upstream values are either already available or is generated when SimpleQueue.poll() is called synchronously. When the SimpleQueue.poll() returns null, that is the indication if a terminated stream. In this mode, the upstream won't call the onXXX methods and callers of SimpleQueue.poll() should be prepared to catch exceptions. Note that SimpleQueue.poll() has to be called sequentially (from within a serializing drain-loop).

        See Also:
        Constant Field Values
      • ASYNC

        static final int ASYNC
        Request an asynchronous fusion mode and can be returned by requestFusion(int) for an accepted mode.

        In asynchronous fusion, upstream values may become available to SimpleQueue.poll() eventually. Upstream signals onError() and onComplete() as usual but onNext may not actually contain the upstream value but have null instead. Downstream should treat such onNext as indication that SimpleQueue.poll() can be called. Note that SimpleQueue.poll() has to be called sequentially (from within a serializing drain-loop). In addition, callers of SimpleQueue.poll() should be prepared to catch exceptions.

        See Also:
        Constant Field Values
      • BOUNDARY

        static final int BOUNDARY
        Used in binary or combination with the other constants as an input to requestFusion(int) indicating that the SimpleQueue.poll() will be called behind an asynchronous boundary and thus may change the non-trivial computation locations attached to the SimpleQueue.poll() chain of fused operators.

        For example, fusing map() and observeOn() may move the computation of the map's function over to the thread run after the observeOn(), which is generally unexpected.

        See Also:
        Constant Field Values
    • Method Detail

      • requestFusion

        int requestFusion​(int mode)
        Request a fusion mode from the upstream.

        This should be called before onSubscribe returns.

        Calling this method multiple times or after onSubscribe finished is not allowed and may result in undefined behavior.

        Parameters:
        mode - the requested fusion mode, allowed values are SYNC, ASYNC, ANY combined with BOUNDARY (e.g., requestFusion(SYNC | BOUNDARY)).
        Returns:
        the established fusion mode: NONE, SYNC, ASYNC.