Usando o método genérico “any ()” do Mockito

Eu tenho uma interface com um método que espera uma matriz de Foo:

public interface IBar {
  void doStuff(Foo[] arr);
}

Estou zombando dessa interface usando o Mockito e gostaria de afirmar que doStuff()é chamado, mas não quero validar qual argumento é passado - "não me importo".

Como escrevo o código a seguir usando any()o método genérico em vez de anyObject()?

IBar bar = mock(IBar.class);
...
verify(bar).doStuff((Foo[]) anyObject());

Desde o Java 8, você pode usar o anymétodo sem argumento e o argumento type será inferido pelo compilador:

verify(bar).doStuff(any());

Explicação

A novidade no Java 8 é que o tipo de destino de uma expressão será usado para inferir parâmetros de tipo de suas subexpressões. Antes do Java 8, apenas argumentos para métodos eram usados ​​para inferência de parâmetro de tipo (na maioria das vezes).

Nesse caso, o tipo de parâmetro de doStuffserá o tipo de destino any()e o tipo de valor de retorno any()será escolhido para corresponder a esse tipo de argumento.

Esse mecanismo foi adicionado no Java 8 principalmente para poder compilar expressões lambda, mas melhora as inferências de tipo em geral.

Tipos primitivos

Isso não funciona com tipos primitivos, infelizmente:

public interface IBar {
    void doPrimitiveStuff(int i);
}

verify(bar).doPrimitiveStuff(any()); // Compiles but throws NullPointerException
verify(bar).doPrimitiveStuff(anyInt()); // This is what you have to do instead

O problema é que o compilador inferirá Integercomo o valor de retorno de any(). O Mockito não estará ciente disso (devido ao apagamento do tipo) e retornará o valor padrão para os tipos de referência, que é null. O tempo de execução tentará desmarcar o valor de retorno chamando o intValuemétodo antes de passá-lo para doStuff, e a exceção será lançada.

Isso deve funcionar

import static org.mockito.ArgumentMatchers.any;
import static org.mockito.Mockito.verify;

verify(bar).DoStuff(any(Foo[].class));

Você pode usar Mockito.isA()para isso:

import static org.mockito.Matchers.isA;
import static org.mockito.Mockito.verify;

verify(bar).doStuff(isA(Foo[].class));

http://site.mockito.org/mockito/docs/current/org/mockito/Matchers.html#isA(java.lang.Class)

Como eu precisava usar esse recurso para o meu projeto mais recente (a certa altura atualizamos a partir de 1.10.19), apenas para manter os usuários (que já estão usando a versão 2.1.0 ou superior do mockito-core ) atualizados, o static Os métodos das respostas acima devem ser retirados da ArgumentMatchersclasse:

import static org.mockito.ArgumentMatchers.isA;
import static org.mockito.ArgumentMatchers.any;

Lembre-se disso se você planeja manter seus artefatos do Mockito atualizados, pois possivelmente a partir da versão 3, essa classe pode não existir mais:

Conforme 2.1.0 e acima, o Javadoc do org.mockito.Matchers declara:

Use org.mockito.ArgumentMatchers. Esta classe está agora obsoleta para evitar um conflito de nome com a org.hamcrest.Matchers classe Hamcrest * . Essa classe provavelmente será removida na versão 3.0.

Eu escrevi um pequeno artigo sobre curingas mockito se você quiser ler mais.