How do you combine argument matchers with specific values in Mockito

Using Argument Matchers for All Arguments

If you want to use argument matchers, you should apply them to all arguments of the method you are stubbing or verifying. For example:

java
when(mockFoo.bool(anyString(), anyInt(), any(Object.class))).thenReturn(true);

In this case, `anyString()`, `anyInt()`, and `any(Object.class)` are used for all arguments.

Using Specific Values for All Arguments

Alternatively, you can use specific values for all arguments:

java
when(mockFoo.bool("specificString", 10, "specificObject")).thenReturn(true);

Here, `"specificString"`, `10`, and `"specificObject"` are specific values.

Using `eq()` for Specific Values

If you want to use a specific value for an argument while still using matchers for other arguments, you can use the `eq()` method provided by Mockito. This allows you to specify a specific value while still using matchers for other arguments:

java
when(mockFoo.bool(eq("specificString"), anyInt(), any(Object.class))).thenReturn(true);

In this example, `"specificString"` is a specific value wrapped in `eq()`, while `anyInt()` and `any(Object.class)` are matchers for the other arguments.

Important Considerations

- Consistency: Ensure that either all arguments use matchers or all use specific values (or `eq()` for specific values).
- `eq()` Usage: Use `eq()` to specify exact values when you need to mix specific values with matchers.
- Error Handling: Mixing matchers and raw values without `eq()` will result in an `InvalidUseOfMatchersException`.

By following these guidelines, you can effectively use argument matchers and specific values in your Mockito tests.