1 /*
2  * Copyright (c) 2016 Mockito contributors
3  * This program is made available under the terms of the MIT License.
4  */
5 package org.mockito.stubbing;
6 
7 import org.mockito.Incubating;
8 
9 /**
10  * Generic interface to be used for configuring mock's answer for a three argument invocation that returns nothing.
11  *
12  * Answer specifies an action that is executed when you interact with the mock.
13  * <p>
14  * Example of stubbing a mock with this custom answer:
15  *
16  * <pre class="code"><code class="java">
17  * import static org.mockito.AdditionalAnswers.answerVoid;
18  *
19  * doAnswer(answerVoid(
20  *     new VoidAnswer3&lt;String, Integer, String&gt;() {
21  *         public void answer(String msg, Integer count, String another) throws Exception {
22  *             throw new Exception(String.format(msg, another, count));
23  *         }
24  * })).when(mock).someMethod(anyString(), anyInt(), anyString());
25  *
26  * //Following will raise an exception with the message "ka-boom 3"
27  * mock.someMethod("%s-boom %d", 3, "ka");
28  * </code></pre>
29  *
30  * @param <A0> type of the first argument
31  * @param <A1> type of the second argument
32  * @param <A2> type of the third argument
33  * @see Answer
34  */
35 @Incubating
36 public interface VoidAnswer3<A0, A1, A2> {
37     /**
38      * @param argument0 the first argument.
39      * @param argument1 the second argument.
40      * @param argument2 the third argument.
41      *
42      * @throws Throwable the throwable to be thrown
43      */
answer(A0 argument0, A1 argument1, A2 argument2)44     void answer(A0 argument0, A1 argument1, A2 argument2) throws Throwable;
45 }
46