org.mockito.stubbing.Answer5 Maven / Gradle / Ivy

/*
 * Copyright (c) 2016 Mockito contributors
 * This program is made available under the terms of the MIT License.
 */
package org.mockito.stubbing;

/**
 * Generic interface to be used for configuring mock's answer for a five argument invocation.
 *
 * Answer specifies an action that is executed and a return value that is returned when you interact with the mock.
 * 
 * Example of stubbing a mock with this custom answer:
 *
 * 

 * import static org.mockito.AdditionalAnswers.answer;
 *
 * when(mock.someMethod(anyInt(), anyString(), anyChar(), any(), anyBoolean())).then(answer(
 *     new Answer5<StringBuilder, Integer, String, Character, Object, Boolean>() {
 *         public StringBuilder answer(Integer i, String s, Character c, Object o, Boolean isIt) {
 *             return new StringBuilder().append(i).append(s).append(c).append(o.hashCode()).append(isIt);
 *         }
 * }));
 *
 * //Following will print a string like "3xyz131635550true"
 * System.out.println(mock.someMethod(3, "xy", 'z', new Object(), true));
 * 
 *
 * @param  return type
 * @param  type of the first argument
 * @param  type of the second argument
 * @param  type of the third argument
 * @param  type of the fourth argument
 * @see Answer
 */
public interface Answer5 {
    /**
     * @param argument0 the first argument.
     * @param argument1 the second argument.
     * @param argument2 the third argument.
     * @param argument3 the fourth argument.
     * @param argument4 the fifth argument.
     *
     * @return the value to be returned.
     *
     * @throws Throwable the throwable to be thrown
     */
    T answer(A0 argument0, A1 argument1, A2 argument2, A3 argument3, A4 argument4) throws Throwable;
}