de.cosmocode.commons.concurrent.Runnables.java Source code

Introduction

Here is the source code for de.cosmocode.commons.concurrent.Runnables.java

Source

/**
 * Copyright 2010 - 2013 CosmoCode 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.
 */
package de.cosmocode.commons.concurrent;

import com.google.common.base.Preconditions;
import com.google.common.collect.Lists;

import java.util.Arrays;

/**
 * Utility class for {@link Runnable}s.
 *
 * @author Willi Schoenborn
 */
public final class Runnables {

    private Runnables() {

    }

    /**
     * Chains multiple {@link Runnable}s together.
     * 
     * @param first the first Runnable
     * @param rest zero or more additional Runnables
     * @return a Runnable which runs all given Runnables in a sequence
     * @throws NullPointerException if first or rest is null
     */
    public static Runnable chain(Runnable first, Runnable... rest) {
        Preconditions.checkNotNull(first, "First");
        Preconditions.checkNotNull(rest, "Rest");
        return chain(Lists.asList(first, rest));
    }

    /**
     * Chains multiple {@link Runnable}s together.
     * 
     * @param first the first Runnable
     * @param second the second Runnable
     * @param rest zero or more additional Runnables
     * @return a Runnable which runs all given Runnables in a sequence
     * @throws NullPointerException if first, second or rest is null
     */
    public static Runnable chain(Runnable first, Runnable second, Runnable... rest) {
        Preconditions.checkNotNull(first, "First");
        Preconditions.checkNotNull(second, "Second");
        Preconditions.checkNotNull(rest, "Rest");
        return chain(Lists.asList(first, second, rest));
    }

    /**
     * Chains multiple {@link Runnable}s together.
     * 
     * @param runnables zero or more additional Runnables
     * @return a Runnable which runs all given Runnables in a sequence
     * @throws NullPointerException if runnables is null
     */
    public static Runnable chain(Runnable... runnables) {
        Preconditions.checkNotNull(runnables, "Runnables");
        return chain(Arrays.asList(runnables));
    }

    /**
     * Chains multiple {@link Runnable}s together.
     * 
     * @param runnables zero or more additional Runnables
     * @return a Runnable which runs all given Runnables in a sequence
     * @throws NullPointerException if runnables is null
     */
    public static Runnable chain(Iterable<Runnable> runnables) {
        return new ChainedRunnable(runnables);
    }

}