CheckedBiConsumer.java

1
/*-
2
 * #%L
3
 * io.earcam.unexceptional
4
 * %%
5
 * Copyright (C) 2016 - 2017 earcam
6
 * %%
7
 * SPDX-License-Identifier: (BSD-3-Clause OR EPL-1.0 OR Apache-2.0 OR MIT)
8
 * 
9
 * You <b>must</b> choose to accept, in full - any individual or combination of 
10
 * the following licenses:
11
 * <ul>
12
 * 	<li><a href="https://opensource.org/licenses/BSD-3-Clause">BSD-3-Clause</a></li>
13
 * 	<li><a href="https://www.eclipse.org/legal/epl-v10.html">EPL-1.0</a></li>
14
 * 	<li><a href="https://www.apache.org/licenses/LICENSE-2.0">Apache-2.0</a></li>
15
 * 	<li><a href="https://opensource.org/licenses/MIT">MIT</a></li>
16
 * </ul>
17
 * #L%
18
 */
19
package io.earcam.unexceptional;
20
21
import java.util.Objects;
22
23
/**
24
 * A checked parallel of {@link java.util.function.BiConsumer}
25
 * 
26
 * @param <T> first argument type
27
 * @param <U> second argument type
28
 * @param <E> the type of Throwable declared
29
 * 
30
 * @since 0.2.0
31
 * 
32
 * @see java.util.function.BiConsumer
33
 */
34
@FunctionalInterface
35
public interface CheckedBiConsumer<T, U, E extends Throwable> {
36
37
	/**
38
	 * See {@link java.util.function.BiConsumer#accept(Object, Object)}
39
	 * 
40
	 * @param t first argument
41
	 * @param u second argument
42
	 * @throws Throwable a possible checked exception
43
	 */
44
	public abstract void accept(T t, U u) throws E;
45
46
47
	/**
48
	 * See {@link java.util.function.BiConsumer#andThen(java.util.function.BiConsumer)}
49
	 * 
50
	 * @param after the bi-consumer to accept sequentially <i>after</i> {@code this}
51
	 * @return the composite {@link CheckedBiConsumer}
52
	 * @throws NullPointerException if {@code after} is {@code null}
53
	 */
54
	@SuppressWarnings("squid:S1905") // SonarQube false positives
55
	public default CheckedBiConsumer<T, U, E> andThen(CheckedBiConsumer<? super T, ? super U, ? extends E> after)
56
	{
57
		Objects.requireNonNull(after);
58
59 1 1. andThen : mutated return of Object value for io/earcam/unexceptional/CheckedBiConsumer::andThen to ( if (x != null) null else throw new RuntimeException ) → KILLED
		return (CheckedBiConsumer<T, U, E> & java.io.Serializable) (l, r) -> {
60 1 1. lambda$andThen$fc7f4c26$1 : removed call to io/earcam/unexceptional/CheckedBiConsumer::accept → KILLED
			accept(l, r);
61 1 1. lambda$andThen$fc7f4c26$1 : removed call to io/earcam/unexceptional/CheckedBiConsumer::accept → KILLED
			after.accept(l, r);
62
		};
63
	}
64
}

Mutations

59

1.1
Location : andThen
Killed by : io.earcam.unexceptional.CheckedBiConsumerTest.andThenShortcircuitsOnFirstCheckedExceptionRaised()
mutated return of Object value for io/earcam/unexceptional/CheckedBiConsumer::andThen to ( if (x != null) null else throw new RuntimeException ) → KILLED

60

1.1
Location : lambda$andThen$fc7f4c26$1
Killed by : io.earcam.unexceptional.CheckedBiConsumerTest.andThenShortcircuitsOnFirstCheckedExceptionRaised()
removed call to io/earcam/unexceptional/CheckedBiConsumer::accept → KILLED

61

1.1
Location : lambda$andThen$fc7f4c26$1
Killed by : io.earcam.unexceptional.CheckedBiConsumerTest.andThenShortcircuitsOnFirstCheckedExceptionRaised()
removed call to io/earcam/unexceptional/CheckedBiConsumer::accept → KILLED

Active mutators

Tests examined


Report generated by PIT 1.4.0