com.github.tadukoo.util.functional.consumer.ThrowingConsumer Maven / Gradle / Ivy

Go to download

Show more of this group Show more artifacts with this name
Show all versions of TadukooFunctions Show documentation

There is a newer version: 0.6.1-Beta

package com.github.tadukoo.util.functional.consumer;

import java.util.function.Consumer;

/**
 * A better version of Java's {@link Consumer} interface that 
 * allows for the consumers to throw whatever {@link Throwable}
 * is specified.
 *
 * @param  The input argument type to be consumed
 * @param  The type of {@link Throwable} thrown by the consumer
 * 
 * @author Logan Ferree (Tadukoo)
 * @version 0.1-Alpha-SNAPSHOT
 */
@FunctionalInterface
public interface ThrowingConsumer{
	
	/**
	 * Takes a single argument and consumes it.
	 * 
	 * @param a The argument
	 * @throws T Determined by the consumer, not required
	 */
	void accept(A a) throws T;
	
	/**
	 * Creates a ThrowingConsumer that runs this ThrowingConsumer and then also runs the 
	 * given ThrowingConsumer on the same argument.
	 * 
	 * @param after A 2nd ThrowingConsumer to run the argument on after this one
	 * @return The ThrowingConsumer made from composing this one and the given one
	 */
	default ThrowingConsumer andThen(ThrowingConsumer after){
		return a -> {
						this.accept(a);
						after.accept(a);
					};
	}
}