MoreAnswers.java

  1. /*
  2.  * *********************************************************************************************************************
  3.  *
  4.  * TheseFoolishThings: Miscellaneous utilities
  5.  * http://tidalwave.it/projects/thesefoolishthings
  6.  *
  7.  * Copyright (C) 2009 - 2023 by Tidalwave s.a.s. (http://tidalwave.it)
  8.  *
  9.  * *********************************************************************************************************************
  10.  *
  11.  * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with
  12.  * the License. You may obtain a copy of the License at
  13.  *
  14.  *     http://www.apache.org/licenses/LICENSE-2.0
  15.  *
  16.  * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
  17.  * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.  See the License for the
  18.  * specific language governing permissions and limitations under the License.
  19.  *
  20.  * *********************************************************************************************************************
  21.  *
  22.  * git clone https://bitbucket.org/tidalwave/thesefoolishthings-src
  23.  * git clone https://github.com/tidalwave-it/thesefoolishthings-src
  24.  *
  25.  * *********************************************************************************************************************
  26.  */
  27. package it.tidalwave.util.test;

  28. import lombok.experimental.UtilityClass;
  29. import org.mockito.stubbing.Answer;
  30. import static org.mockito.Answers.RETURNS_DEFAULTS;

  31. /***********************************************************************************************************************
  32.  *
  33.  * A repository of reusable {@link Answer}s for Mockito.
  34.  *
  35.  * @author  Fabrizio Giudici
  36.  * @since   3.2-ALPHA-8
  37.  *
  38.  **********************************************************************************************************************/
  39. @UtilityClass
  40. public class MoreAnswers
  41.   {
  42.     /*******************************************************************************************************************
  43.      *
  44.      * An {@link Answer} that calls default methods of an interface. To be used as: {@code Foo foo = mock(Foo.class,
  45.      * MoreAnswers.CALLS_DEFAULT_METNODS);}.
  46.      *
  47.      * Mockito's {@link org.mockito.Answers#CALLS_REAL_METHODS} actually behaves the same when used with interfaces,
  48.      * but it has been designed for mixed mocking, which is a practice that is supposed to be used only with corner
  49.      * cases a legacy stuff.
  50.      *
  51.      * @it.tidalwave.javadoc.experimental
  52.      *
  53.      ******************************************************************************************************************/
  54.     public static final Answer<?> CALLS_DEFAULT_METHODS = invocation ->
  55.             invocation.getMethod().isDefault() ? invocation.callRealMethod()
  56.                                                : RETURNS_DEFAULTS.answer(invocation);
  57.   }