org.apache.sshd.common.util.io.functors.Invoker Maven / Gradle / Ivy

Show more of this group Show more artifacts with this name
Show all versions of wildfly-elytron
WildFly Security SPIs
There is a newer version: 2.4.1.Final
/*
 * Licensed to the Apache Software Foundation (ASF) under one
 * or more contributor license agreements. See the NOTICE file
 * distributed with this work for additional information
 * regarding copyright ownership. The ASF licenses this file
 * to you 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 org.apache.sshd.common.util.io.functors;

import java.util.AbstractMap.SimpleImmutableEntry;
import java.util.Collection;
import java.util.Map;

import org.apache.sshd.common.util.ExceptionUtils;
import org.apache.sshd.common.util.GenericUtils;

/**
 * The complement to the {@code Callable} interface - accepts one argument and possibly throws something
 *
 * @param   Argument type
 * @param   Return type
 * @author       Apache MINA SSHD Project
 */
@FunctionalInterface
public interface Invoker {
    RET invoke(ARG arg) throws Throwable;

    /**
     * Wraps a bunch of {@link Invoker}-s that return no value into one that invokes them in the same order as
     * they appear. Note: all invokers are used and any thrown exceptions are accumulated and
     * thrown as a single exception at the end of invoking all of them.
     *
     * @param      The argument type
     * @param  invokers The invokers to wrap - ignored if {@code null}/empty
     * @return          The wrapper
     * @see             #invokeAll(Object, Collection) invokeAll
     */
    static  Invoker wrapAll(
            Collection> invokers) {
        return arg -> {
            invokeAll(arg, invokers);
            return null;
        };
    }

    /**
     * Invokes all the instances ignoring the return value. Any intermediate exceptions are accumulated and
     * thrown at the end.
     *
     * @param       Argument type
     * @param  arg       The argument to pass to the {@link #invoke(Object)} method
     * @param  invokers  The invokers to scan - ignored if {@code null}/empty (also ignores {@code null} members)
     * @throws Throwable If invocation failed
     */
    static  void invokeAll(
            ARG arg, Collection> invokers)
            throws Throwable {
        if (GenericUtils.isEmpty(invokers)) {
            return;
        }

        Throwable err = null;
        for (Invoker i : invokers) {
            if (i == null) {
                continue;
            }

            try {
                i.invoke(arg);
            } catch (Throwable t) {
                err = ExceptionUtils.accumulateException(err, t);
            }
        }

        if (err != null) {
            throw err;
        }
    }

    /**
     * Wraps a bunch of {@link Invoker}-s that return no value into one that invokes them in the same order as
     * they appear. Note: stops when first invoker throws an exception (otherwise invokes all)
     *
     * @param      The argument type
     * @param  invokers The invokers to wrap - ignored if {@code null}/empty
     * @return          The wrapper
     * @see             #invokeTillFirstFailure(Object, Collection) invokeTillFirstFailure
     */
    static  Invoker wrapFirst(
            Collection> invokers) {
        return arg -> {
            Map.Entry, Throwable> result = invokeTillFirstFailure(arg, invokers);
            if (result != null) {
                throw result.getValue();
            }
            return null;
        };
    }

    /**
     * Invokes all instances until 1st failure (if any)
     *
     * @param      Argument type
     * @param  arg      The argument to pass to the {@link #invoke(Object)} method
     * @param  invokers The invokers to scan - ignored if {@code null}/empty (also ignores {@code null} members)
     * @return          A {@link SimpleImmutableEntry} representing the first failed invocation - {@code null} if
     *                  all were successful (or none invoked).
     */
    static  SimpleImmutableEntry, Throwable> invokeTillFirstFailure(
            ARG arg, Collection> invokers) {
        if (GenericUtils.isEmpty(invokers)) {
            return null;
        }

        for (Invoker i : invokers) {
            if (i == null) {
                continue;
            }

            try {
                i.invoke(arg);
            } catch (Throwable t) {
                return new SimpleImmutableEntry<>(i, t);
            }
        }

        return null;
    }
}