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

io.joynr.provider.AbstractDeferred Maven / Gradle / Ivy

package io.joynr.provider;

/*
 * #%L
 * %%
 * Copyright (C) 2011 - 2015 BMW Car IT GmbH
 * %%
 * 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.
 * #L%
 */

import io.joynr.exceptions.JoynrException;

import java.util.ArrayList;
import java.util.List;

import javax.annotation.Nullable;

import edu.umd.cs.findbugs.annotations.SuppressFBWarnings;
import joynr.exceptions.ProviderRuntimeException;

public abstract class AbstractDeferred {
    private enum State {
        PENDING, FULFILLED, REJECTED
    };

    private State state = State.PENDING;
    private JoynrException error = null;
    private Object[] values = null;

    private List listeners = new ArrayList();

    public AbstractDeferred() {
    }

    /**
     * Resolves the promise. NOTE: The thread resolving the promise will be
     * used to execute waiting listeners.
     * @param values the result which resolves the Deferred.
     * @return true if the promise is resolved; false in case the promise is
     *      already settled.
     */
    protected synchronized boolean resolve(Object... values) {
        if (isSettled()) {
            return false;
        }
        this.values = values;
        state = State.FULFILLED;
        notifyListeners();
        return true;
    }

    /**
     * Rejects the promise. NOTE: The thread rejecting the promise will be used
     * to execute waiting listeners.
     * @param error the reason that caused the rejection.
     * @return true if the promise is rejected; false in case the promise is
     *      already settled.
     */
    protected synchronized boolean reject(JoynrException error) {
        if (isSettled()) {
            return false;
        }
        state = State.REJECTED;
        this.error = error;
        notifyListeners();
        return true;
    }

    /**
     * Rejects the promise. NOTE: The thread rejecting the promise will be used
     * to execute waiting listeners.
     * @param error the reason that caused the rejection.
     * @return true if the promise is rejected; false in case the promise is
     *      already settled.
     */
    public synchronized boolean reject(ProviderRuntimeException error) {
        return this.reject((JoynrException) error);
    }

    /**
     * @return the error that caused the rejection of the deferred; null if the
     *      deferred is not in rejected state.
     */
    @Nullable
    public JoynrException getError() {
        return error;
    }

    /**
     * @return the values that caused the fulfillment of the deferred; null if
     *      the deferred is not in fulfilled state.
     */
    @Nullable
    @SuppressFBWarnings(value = "EI_EXPOSE_REP", justification = "This is only accessed internally by the promise.")
    public Object[] getValues() {
        return values;
    }

    private void notifyListeners() {
        for (DeferredListener listener : listeners) {
            listener.onSettlement();
        }
    }

    /**
     * Adds a listener that is called once the deferred is settled. NOTE: If the
     * deferred is already settled when adding the listener, the thread adding
     * the listener will be used to execute the listener.
     * @param listener the listener to add.
     */
    public synchronized void addListener(DeferredListener listener) {
        listeners.add(listener);
        if (isSettled()) {
            listener.onSettlement();
        }
    }

    public boolean isFulfilled() {
        return state == State.FULFILLED;
    }

    public boolean isRejected() {
        return state == State.REJECTED;
    }

    /**
     * @return true if the promise is fulfilled or rejected; false if the
     *      promise is pending.
     */
    public boolean isSettled() {
        return state == State.FULFILLED || state == State.REJECTED;
    }
}




© 2015 - 2025 Weber Informatics LLC | Privacy Policy