/* * Copyright (c) 2016-present, RxJava Contributors. * * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in * compliance with the License. You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software distributed under the License is * distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See * the License for the specific language governing permissions and limitations under the License. */ package io.reactivex.rxjava3.internal.fuseable; import io.reactivex.rxjava3.annotations.NonNull; import io.reactivex.rxjava3.core.Flowable; /** * Interface indicating a operator implementation can be macro-fused back to Flowable in case * the operator goes from Flowable to some other reactive type and then the sequence calls * for toFlowable again: *
 * {@code
 * Single single = Flowable.range(1, 10).reduce((a, b) -> a + b);
 * Flowable flowable = single.toFlowable();
 * }
 * 
* * The {@code Single.toFlowable()} will check for this interface and call the {@link #fuseToFlowable()} * to return a Flowable which could be the Flowable-specific implementation of reduce(BiFunction). *

* This causes a slight overhead in assembly time (1 instanceof check, 1 operator allocation and 1 dropped * operator) but does not incur the conversion overhead at runtime. * * @param the value type */ public interface FuseToFlowable<@NonNull T> { /** * Returns a (direct) Flowable for the operator. *

The implementation should handle the necessary RxJavaPlugins wrapping. * @return the Flowable instance */ @NonNull Flowable fuseToFlowable(); }