All Downloads are FREE. Search and download functionalities are using the official Maven repository.

io.reactivex.observable.internal.disposables.EmptyDisposable Maven / Gradle / Ivy

/**
 * 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.observable.internal.disposables;

import io.reactivex.common.annotations.Nullable;
import io.reactivex.observable.*;
import io.reactivex.observable.extensions.QueueDisposable;

/**
 * Represents a stateless empty Disposable that reports being always
 * empty and disposed.
 * 

It is also async-fuseable but empty all the time. *

Since EmptyDisposable implements QueueDisposable and is empty, * don't use it in tests and then signal onNext with it; * use Disposables.empty() instead. */ public enum EmptyDisposable implements QueueDisposable { /** * Since EmptyDisposable implements QueueDisposable and is empty, * don't use it in tests and then signal onNext with it; * use Disposables.empty() instead. */ INSTANCE, /** * An empty disposable that returns false for isDisposed. */ NEVER ; @Override public void dispose() { // no-op } @Override public boolean isDisposed() { return this == INSTANCE; } public static void complete(Observer s) { s.onSubscribe(INSTANCE); s.onComplete(); } public static void complete(MaybeObserver s) { s.onSubscribe(INSTANCE); s.onComplete(); } public static void error(Throwable e, Observer s) { s.onSubscribe(INSTANCE); s.onError(e); } public static void complete(CompletableObserver s) { s.onSubscribe(INSTANCE); s.onComplete(); } public static void error(Throwable e, CompletableObserver s) { s.onSubscribe(INSTANCE); s.onError(e); } public static void error(Throwable e, SingleObserver s) { s.onSubscribe(INSTANCE); s.onError(e); } public static void error(Throwable e, MaybeObserver s) { s.onSubscribe(INSTANCE); s.onError(e); } @Override public boolean offer(Object value) { throw new UnsupportedOperationException("Should not be called!"); } @Override public boolean offer(Object v1, Object v2) { throw new UnsupportedOperationException("Should not be called!"); } @Nullable @Override public Object poll() throws Exception { return null; // always empty } @Override public boolean isEmpty() { return true; // always empty } @Override public void clear() { // nothing to do } @Override public int requestFusion(int mode) { return mode & ASYNC; } }