Mockito文档-单元测试技术

偏执的太偏执、 2021-12-13 23:47 516阅读 0赞

<table style="color:#333333;font-family:Helvetica, Arial, sans-serif;font-size:14px;line-height:18px;"> 
 <tbody> 
  <tr> 
   <td colspan="2"><a style="color:#16569a;" rel="nofollow"></a> 
    <table> 
     <tbody> 
      <tr> 
       <td><a style="text-decoration:none;color:#cc3300;" href="http://docs.mockito.googlecode.com/hg/overview-summary.html" rel="nofollow"><span><strong>Overview</strong></span></a>&nbsp;</td> 
       <td><a style="text-decoration:none;color:#cc3300;" href="http://docs.mockito.googlecode.com/hg/org/mockito/package-summary.html" rel="nofollow"><span><strong>Package</strong></span></a>&nbsp;</td> 
       <td style="color:#ffffff;">&nbsp;<span><strong>Class</strong></span>&nbsp;</td> 
       <td><a style="text-decoration:none;color:#cc3300;" href="http://docs.mockito.googlecode.com/hg/org/mockito/class-use/Mockito.html" rel="nofollow"><span><strong>Use</strong></span></a>&nbsp;</td> 
       <td><a style="text-decoration:none;color:#cc3300;" href="http://docs.mockito.googlecode.com/hg/org/mockito/package-tree.html" rel="nofollow"><span><strong>Tree</strong></span></a>&nbsp;</td> 
       <td><a style="text-decoration:none;color:#cc3300;" href="http://docs.mockito.googlecode.com/hg/deprecated-list.html" rel="nofollow"><span><strong>Deprecated</strong></span></a>&nbsp;</td> 
       <td><a style="text-decoration:none;color:#cc3300;" href="http://docs.mockito.googlecode.com/hg/index-all.html" rel="nofollow"><span><strong>Index</strong></span></a>&nbsp;</td> 
       <td><a style="text-decoration:none;color:#cc3300;" href="http://docs.mockito.googlecode.com/hg/help-doc.html" rel="nofollow"><span><strong>Help</strong></span></a>&nbsp;</td> 
      </tr> 
     </tbody> 
    </table></td> 
   <td align="right">&nbsp;</td> 
  </tr> 
  <tr> 
   <td style="color:#000000;"><span style="font-size:.8em;">&nbsp;<a style="text-decoration:none;color:#cc3300;" title="annotation in org.mockito" href="http://docs.mockito.googlecode.com/hg/org/mockito/Mock.html" rel="nofollow"><strong>PREV CLASS</strong></a>&nbsp; &nbsp;<a style="text-decoration:none;color:#cc3300;" title="class in org.mockito" href="http://docs.mockito.googlecode.com/hg/org/mockito/MockitoAnnotations.html" rel="nofollow"><strong>NEXT CLASS</strong></a></span></td> 
   <td style="color:#000000;"><span style="font-size:.8em;"><a style="text-decoration:none;color:#cc3300;" href="http://docs.mockito.googlecode.com/hg/index.html?org/mockito/Mockito.html" rel="nofollow"><strong>FRAMES</strong></a>&nbsp;&nbsp; &nbsp;<a style="text-decoration:none;color:#cc3300;" href="http://docs.mockito.googlecode.com/hg/org/mockito/Mockito.html" rel="nofollow"><strong>NO FRAMES</strong></a>&nbsp;&nbsp; &nbsp;<a style="text-decoration:none;color:#cc3300;" href="http://docs.mockito.googlecode.com/hg/allclasses-noframe.html" rel="nofollow"><strong>All Classes</strong></a></span></td> 
  </tr> 
  <tr> 
   <td style="color:#000000;"><span style="font-size:.8em;">SUMMARY:&nbsp;NESTED&nbsp;|&nbsp;<a style="text-decoration:none;color:#cc3300;" href="http://docs.mockito.googlecode.com/hg/org/mockito/Mockito.html#field_summary" rel="nofollow">FIELD</a>&nbsp;|&nbsp;<a style="text-decoration:none;color:#cc3300;" href="http://docs.mockito.googlecode.com/hg/org/mockito/Mockito.html#constructor_summary" rel="nofollow">CONSTR</a>&nbsp;|&nbsp;<a style="text-decoration:none;color:#cc3300;" href="http://docs.mockito.googlecode.com/hg/org/mockito/Mockito.html#method_summary" rel="nofollow">METHOD</a></span></td> 
   <td style="color:#000000;"><span style="font-size:.8em;">DETAIL:&nbsp;<a style="text-decoration:none;color:#cc3300;" href="http://docs.mockito.googlecode.com/hg/org/mockito/Mockito.html#field_detail" rel="nofollow">FIELD</a>&nbsp;|&nbsp;<a style="text-decoration:none;color:#cc3300;" href="http://docs.mockito.googlecode.com/hg/org/mockito/Mockito.html#constructor_detail" rel="nofollow">CONSTR</a>&nbsp;|&nbsp;<a style="text-decoration:none;color:#cc3300;" href="http://docs.mockito.googlecode.com/hg/org/mockito/Mockito.html#method_detail" rel="nofollow">METHOD</a></span></td> 
  </tr> 
 </tbody> 
</table>

--------------------

## org.mockito    Class Mockito ##

java.lang.Object

![extended by][]

org.mockito.Matchers

![extended by][]

org.mockito.Mockito

**Direct Known Subclasses:**

[BDDMockito][]

--------------------

public class Mockito
         extends 
         Matchers

![logo.jpg][]

Mockito library enables mocks creation, verification and stubbing.

This javadoc content is also available on the [http://mockito.org][http_mockito.org] web page. All documentation is kept in javadocs because it guarantees consistency between what's on the web and what's in the source code. Also, it makes possible to access documentation straight from the IDE even if you work offline.

# Contents #

[1. Let's verify some behaviour! ][1. Let_s verify some behaviour]  
[2. How about some stubbing? ][2. How about some stubbing]  
[3. Argument matchers ][3. Argument matchers]  
[4. Verifying exact number of invocations / at least once / never ][4. Verifying exact number of invocations _ at least once _ never]  
[5. Stubbing void methods with exceptions ][5. Stubbing void methods with exceptions]  
[6. Verification in order ][6. Verification in order]  
[7. Making sure interaction(s) never happened on mock ][7. Making sure interaction_s_ never happened on mock]  
[8. Finding redundant invocations ][8. Finding redundant invocations]  
[9. Shorthand for mocks creation - @Mock annotation ][9. Shorthand for mocks creation - _Mock annotation]  
[10. Stubbing consecutive calls (iterator-style stubbing) ][10. Stubbing consecutive calls _iterator-style stubbing]  
[11. Stubbing with callbacks ][11. Stubbing with callbacks]  
[12. doThrow()|doAnswer()|doNothing()|doReturn() family of methods mostly for stubbing voids ][12. doThrow_doAnswer_doNothing_doReturn_ family of methods mostly for stubbing voids]  
[13. Spying on real objects ][13. Spying on real objects]  
[14. Changing default return values of unstubbed invocations (Since 1.7) ][14. Changing default return values of unstubbed invocations _Since 1.7]  
[15. Capturing arguments for further assertions (Since 1.8.0) ][15. Capturing arguments for further assertions _Since 1.8.0]  
[16. Real partial mocks (Since 1.8.0) ][16. Real partial mocks _Since 1.8.0]  
[17. Resetting mocks (Since 1.8.0) ][17. Resetting mocks _Since 1.8.0]  
[18. Troubleshooting & validating framework usage (Since 1.8.0) ][18. Troubleshooting _ validating framework usage _Since 1.8.0]  
[19. Aliases for behavior driven development (Since 1.8.0) ][19. Aliases for behavior driven development _Since 1.8.0]  
[20. Serializable mocks (Since 1.8.1) ][20. Serializable mocks _Since 1.8.1]  
[21. New annotations: @Captor, @Spy, @InjectMocks (Since 1.8.3) ][21. New annotations_ _Captor_ _Spy_ _InjectMocks _Since 1.8.3]  
[22. (\*\*New\*\*) Verification with timeout (Since 1.8.5) ][22. _New_ Verification with timeout _Since 1.8.5]

Following examples mock a List, because everyone knows its interface (methods like add(), get(), clear() will be used).   
You probably wouldn't mock List class 'in real'.

### 1. Let's verify some behaviour! ###

//Let's import Mockito statically so that the code looks clearer
     import static org.mockito.Mockito.*;
     
     //mock creation
     List mockedList = mock(List.class);
    
     //using mock object
     mockedList.add("one");
     mockedList.clear();
    
     //verification
     verify(mockedList).add("one");
     verify(mockedList).clear();

Once created, mock will remember all interactions. Then you can selectively verify whatever interaction you are interested in.

### 2. How about some stubbing? ###

//You can mock concrete classes, not only interfaces
     LinkedList mockedList = mock(LinkedList.class);
     
     //stubbing
     when(mockedList.get(0)).thenReturn("first");
     when(mockedList.get(1)).thenThrow(new RuntimeException());
     
     //following prints "first"
     System.out.println(mockedList.get(0));
     
     //following throws runtime exception
     System.out.println(mockedList.get(1));
     
     //following prints "null" because get(999) was not stubbed
     System.out.println(mockedList.get(999));
      
     //Although it is possible to verify a stubbed invocation, usually it's just redundant
     //If your code cares what get(0) returns then something else breaks (often before even verify() gets executed).
     //If your code doesn't care what get(0) returns then it should not be stubbed. Not convinced? See here.
     verify(mockedList).get(0);

*  By default, for all methods that return value, mock returns null, an empty collection or appropriate primitive/primitive wrapper value (e.g: 0, false, ... for int/Integer, boolean/Boolean, ...).
 *  Stubbing can be overridden: for example common stubbing can go to fixture setup but the test methods can override it. Please note that overridding stubbing is a potential code smell that points out too much stubbing
 *  Once stubbed, the method will always return stubbed value regardless of how many times it is called.
 *  Last stubbing is more important - when you stubbed the same method with the same arguments many times.

### 3. Argument matchers ###

Mockito verifies argument values in natural java style: by using an equals() method. Sometimes, when extra flexibility is required then you might use argument matchers:

//stubbing using built-in anyInt() argument matcher
     when(mockedList.get(anyInt())).thenReturn("element");
     
     //stubbing using hamcrest (let's say isValid() returns your own hamcrest matcher):
     when(mockedList.contains(argThat(isValid()))).thenReturn("element");
     
     //following prints "element"
     System.out.println(mockedList.get(999));
     
     //you can also verify using an argument matcher
     verify(mockedList).get(anyInt());

Argument matchers allow flexible verification or stubbing. [`Click here to see`][Click here to see] more built-in matchers and examples of **custom argument matchers / hamcrest matchers**.

For information solely on **custom argument matchers** check out javadoc for [`ArgumentMatcher`][ArgumentMatcher] class.

Be reasonable with using complicated argument matching. The natural matching style using equals() with occasional anyX() matchers tend to give clean & simple tests. Sometimes it's just better to refactor the code to allow equals() matching or even implement equals() method to help out with testing.

Also, read [section 15][15. Capturing arguments for further assertions _Since 1.8.0] or javadoc for [`ArgumentCaptor`][ArgumentCaptor] class. [`ArgumentCaptor`][ArgumentCaptor] is a special implementation of an argument matcher that captures argument values for further assertions.

**Warning on argument matchers:**

If you are using argument matchers, **all arguments** have to be provided by matchers.

E.g: (example shows verification but the same applies to stubbing):

verify(mock).someMethod(anyInt(), anyString(), eq("third argument"));
       //above is correct - eq() is also an argument matcher
       
       verify(mock).someMethod(anyInt(), anyString(), "third argument");
       //above is incorrect - exception will be thrown because third argument is given without an argument matcher.

### 4. Verifying exact number of invocations / at least x / never ###

//using mock 
     mockedList.add("once");
     
     mockedList.add("twice");
     mockedList.add("twice");
     
     mockedList.add("three times");
     mockedList.add("three times");
     mockedList.add("three times");
     
     //following two verifications work exactly the same - times(1) is used by default
     verify(mockedList).add("once");
     verify(mockedList, times(1)).add("once");
     
     //exact number of invocations verification
     verify(mockedList, times(2)).add("twice");
     verify(mockedList, times(3)).add("three times");
     
     //verification using never(). never() is an alias to times(0)
     verify(mockedList, never()).add("never happened");
     
     //verification using atLeast()/atMost()
     verify(mockedList, atLeastOnce()).add("three times");
     verify(mockedList, atLeast(2)).add("five times");
     verify(mockedList, atMost(5)).add("three times");

**times(1) is the default.** Therefore using times(1) explicitly can be omitted.

### 5. Stubbing void methods with exceptions ###

doThrow(new RuntimeException()).when(mockedList).clear();
       
       //following throws RuntimeException:
       mockedList.clear();

Read more about doThrow|doAnswer family of methods in paragraph 12.

Initially, [`stubVoid(Object)`][stubVoid_Object] was used for stubbing voids. Currently stubVoid() is deprecated in favor of [`doThrow(Throwable)`][doThrow_Throwable]. This is because of improved readability and consistency with the family of [`doAnswer(Answer)`][doAnswer_Answer] methods.

### 6. Verification in order ###

List firstMock = mock(List.class);
     List secondMock = mock(List.class);
     
     //using mocks
     firstMock.add("was called first");
     secondMock.add("was called second");
     
     //create inOrder object passing any mocks that need to be verified in order
     InOrder inOrder = inOrder(firstMock, secondMock);
     
     //following will make sure that firstMock was called before secondMock
     inOrder.verify(firstMock).add("was called first");
     inOrder.verify(secondMock).add("was called second");

Verification in order is flexible -  you don't have to verify all interactions  one-by-one but only those that you are interested in testing in order.

Also, you can create InOrder object passing only mocks that are relevant for in-order verification.

### 7. Making sure interaction(s) never happened on mock ###

//using mocks - only mockOne is interacted
     mockOne.add("one");
     
     //ordinary verification
     verify(mockOne).add("one");
     
     //verify that method was never called on a mock
     verify(mockOne, never()).add("two");
     
     //verify that other mocks were not interacted
     verifyZeroInteractions(mockTwo, mockThree);

### 8. Finding redundant invocations ###

//using mocks
     mockedList.add("one");
     mockedList.add("two");
     
     verify(mockedList).add("one");
     
     //following verification will fail 
     verifyNoMoreInteractions(mockedList);

A word of  warning : Some users who did a lot of classic, expect-run-verify mocking tend to use verifyNoMoreInteractions() very often, even in every test method. verifyNoMoreInteractions() is not recommended to use in every test method. verifyNoMoreInteractions() is a handy assertion from the interaction testing toolkit. Use it only when it's relevant. Abusing it leads to overspecified, less maintainable tests. You can find further reading  [here][] .

See also [`never()`][never] - it is more explicit and communicates the intent well.

### 9. Shorthand for mocks creation - @Mock annotation ###

*  Minimizes repetitive mock creation code.
 *  Makes the test class more readable.
 *  Makes the verification error easier to read because the **field name** is used to identify the mock.

public class ArticleManagerTest { 
         
           @Mock private ArticleCalculator calculator;
           @Mock private ArticleDatabase database;
           @Mock private UserProvider userProvider;
         
           private ArticleManager manager;

Important!  This needs to be somewhere in the base class or a test runner:

MockitoAnnotations.initMocks(testClass);

You can use built-in runner:  [`MockitoJUnitRunner`][MockitoJUnitRunner] .

Read more here: [`MockitoAnnotations`][MockitoAnnotations]

### 10. Stubbing consecutive calls (iterator-style stubbing) ###

Sometimes we need to stub with different return value/exception for the same method call. Typical use case could be mocking iterators. Original version of Mockito did not have this feature to promote simple mocking. For example, instead of iterators one could use  `Iterable`  or simply collections. Those offer natural ways of stubbing (e.g. using real collections). In rare scenarios stubbing consecutive calls could be useful, though:

when(mock.someMethod("some arg"))
       .thenThrow(new RuntimeException())
       .thenReturn("foo");
     
     //First call: throws runtime exception:
     mock.someMethod("some arg");
     
     //Second call: prints "foo"
     System.out.println(mock.someMethod("some arg"));
     
     //Any consecutive call: prints "foo" as well (last stubbing wins). 
     System.out.println(mock.someMethod("some arg"));

Alternative, shorter version of consecutive stubbing:

when(mock.someMethod("some arg"))
       .thenReturn("one", "two", "three");

### 11. Stubbing with callbacks ###

Allows stubbing with generic  [`Answer`][Answer]  interface.

Yet another controversial feature which was not included in Mockito originally. We recommend using simple stubbing with thenReturn() or thenThrow() only. Those two should be **just enough** to test/test-drive any clean & simple code.

when(mock.someMethod(anyString())).thenAnswer(new Answer() {
         Object answer(InvocationOnMock invocation) {
             Object[] args = invocation.getArguments();
             Object mock = invocation.getMock();
             return "called with arguments: " + args;
         }
     });
     
     //Following prints "called with arguments: foo"
     System.out.println(mock.someMethod("foo"));

### 12. doThrow()|doAnswer()|doNothing()|doReturn() family of methods for stubbing voids (mostly) ###

Stubbing voids requires different approach from  [`when(Object)`][when_Object]  because the compiler does not like void methods inside brackets...

[`doThrow(Throwable)`][doThrow_Throwable] replaces the [`stubVoid(Object)`][stubVoid_Object] method for stubbing voids. The main reason is improved readability and consistency with the family of doAnswer() methods.

Use doThrow() when you want to stub a void method with an exception:

doThrow(new RuntimeException()).when(mockedList).clear();
       
       //following throws RuntimeException:
       mockedList.clear();

Read more about other methods:

[`doThrow(Throwable)`][doThrow_Throwable]

[`doAnswer(Answer)`][doAnswer_Answer]

[`doNothing()`][doNothing]

[`doReturn(Object)`][doReturn_Object]

### 13. Spying on real objects ###

You can create spies of real objects. When you use the spy then the  real  methods are called (unless a method was stubbed).

Real spies should be used **carefully and occasionally**, for example when dealing with legacy code.

Spying on real objects can be associated with "partial mocking" concept. **Before the release 1.8**, Mockito spies were not real partial mocks. The reason was we thought partial mock is a code smell. At some point we found legitimate use cases for partial mocks (3rd party interfaces, interim refactoring of legacy code, the full article is [here][here 1])

List list = new LinkedList();
       List spy = spy(list);
     
       //optionally, you can stub out some methods:
       when(spy.size()).thenReturn(100);
     
       //using the spy calls real methods
       spy.add("one");
       spy.add("two");
     
       //prints "one" - the first element of a list
       System.out.println(spy.get(0));
     
       //size() method was stubbed - 100 is printed
       System.out.println(spy.size());
     
       //optionally, you can verify
       verify(spy).add("one");
       verify(spy).add("two");

#### Important gotcha on spying real objects! ####

1. Sometimes it's impossible to use  [`when(Object)`][when_Object]  for stubbing spies. Example:

List list = new LinkedList();
       List spy = spy(list);
       
       //Impossible: real method is called so spy.get(0) throws IndexOutOfBoundsException (the list is yet empty)
       when(spy.get(0)).thenReturn("foo");
       
       //You have to use doReturn() for stubbing
       doReturn("foo").when(spy).get(0);

2. Watch out for final methods. Mockito doesn't mock final methods so the bottom line is: when you spy on real objects + you try to stub a final method = trouble. What will happen is the real method will be called \*on mock\* but \*not on the real instance\* you passed to the spy() method. Typically you may get a NullPointerException because mock instances don't have fields initiated.

### 14. Changing default return values of unstubbed invocations (Since 1.7) ###

You can create a mock with specified strategy for its return values. It's quite advanced feature and typically you don't need it to write decent tests. However, it can be helpful for working with  legacy systems .

It is the default answer so it will be used **only when you don't** stub the method call.

Foo mock = mock(Foo.class, Mockito.RETURNS_SMART_NULLS);
       Foo mockTwo = mock(Foo.class, new YourOwnAnswer());

Read more about this interesting implementation of *Answer*: [`RETURNS_SMART_NULLS`][RETURNS_SMART_NULLS]

### 15. Capturing arguments for further assertions (Since 1.8.0) ###

Mockito verifies argument values in natural java style: by using an equals() method. This is also the recommended way of matching arguments because it makes tests clean & simple. In some situations though, it is helpful to assert on certain arguments after the actual verification. For example:

ArgumentCaptor<Person> argument = ArgumentCaptor.forClass(Person.class);
       verify(mock).doSomething(argument.capture());
       assertEquals("John", argument.getValue().getName());

Warning:  it is recommended to use ArgumentCaptor with verification  but not  with stubbing. Using ArgumentCaptor with stubbing may decrease test readability because captor is created outside of assert (aka verify or 'then') block. Also it may reduce defect localization because if stubbed method was not called then no argument is captured.

In a way ArgumentCaptor is related to custom argument matchers (see javadoc for [`ArgumentMatcher`][ArgumentMatcher] class). Both techniques can be used for making sure certain arguments where passed to mocks. However, ArgumentCaptor may be a better fit if:

*  custom argument matcher is not likely to be reused
 *  you just need it to assert on argument values to complete verification

Custom argument matchers via  [`ArgumentMatcher`][ArgumentMatcher]  are usually better for stubbing.

### 16. Real partial mocks (Since 1.8.0) ###

Finally, after many internal debates & discussions on the mailing list, partial mock support was added to Mockito. Previously we considered partial mocks as code smells. However, we found a legitimate use case for partial mocks - more reading:  [here][here 1]

**Before release 1.8** spy() was not producing real partial mocks and it was confusing for some users. Read more about spying: [here][13. Spying on real objects] or in javadoc for [`spy(Object)`][spy_Object] method.

//you can create partial mock with spy() method:    
        List list = spy(new LinkedList());
        
        //you can enable partial mock capabilities selectively on mocks:
        Foo mock = mock(Foo.class);
        //Be sure the real implementation is 'safe'.
        //If real implementation throws exceptions or depends on specific state of the object then you're in trouble.
        when(mock.someMethod()).thenCallRealMethod();

As usual you are going to read  the partial mock warning : Object oriented programming is more less tackling complexity by dividing the complexity into separate, specific, SRPy objects. How does partial mock fit into this paradigm? Well, it just doesn't... Partial mock usually means that the complexity has been moved to a different method on the same object. In most cases, this is not the way you want to design your application.

However, there are rare cases when partial mocks come handy: dealing with code you cannot change easily (3rd party interfaces, interim refactoring of legacy code etc.) However, I wouldn't use partial mocks for new, test-driven & well-designed code.

### 17. Resetting mocks (Since 1.8.0) ###

Smart Mockito users hardly use this feature because they know it could be a sign of poor tests. Normally, you don't need to reset your mocks, just create new mocks for each test method.

Instead of reset() please consider writing simple, small and focused test methods over lengthy, over-specified tests. **First potential code smell is reset() in the middle of the test method.** This probably means you're testing too much. Follow the whisper of your test methods: "Please keep us small & focused on single behavior". There are several threads about it on mockito mailing list.

The only reason we added reset() method is to make it possible to work with container-injected mocks. See issue 55 ([here][here 2]) or FAQ ([here][here 3]).

**Don't harm yourself.** reset() in the middle of the test method is a code smell (you're probably testing too much).

List mock = mock(List.class);
       when(mock.size()).thenReturn(10);
       mock.add(1);
       
       reset(mock);
       //at this point the mock forgot any interactions & stubbing

### 18. Troubleshooting & validating framework usage (Since 1.8.0) ###

First of all, in case of any trouble, I encourage you to read the Mockito FAQ:  [http://code.google.com/p/mockito/wiki/FAQ][here 3]

In case of questions you may also post to mockito mailing list: [http://groups.google.com/group/mockito][http_groups.google.com_group_mockito]

Next, you should know that Mockito validates if you use it correctly **all the time**. However, there's a gotcha so please read the javadoc for [`validateMockitoUsage()`][validateMockitoUsage]

### 19. Aliases for behavior driven development (Since 1.8.0) ###

Behavior Driven Development style of writing tests uses  //given //when //then  comments as fundamental parts of your test methods. This is exactly how we write our tests and we warmly encourage you to do so!

Start learning about BDD here: [http://en.wikipedia.org/wiki/Behavior\_Driven\_Development][http_en.wikipedia.org_wiki_Behavior_Driven_Development]

The problem is that current stubbing api with canonical role of **when** word does not integrate nicely with **//given //when //then** comments. It's because stubbing belongs to **given** component of the test and not to the **when** component of the test. Hence [`BDDMockito`][BDDMockito] class introduces an alias so that you stub method calls with [`BDDMockito.given(Object)`][BDDMockito.given_Object] method. Now it really nicely integrates with the **given** component of a BDD style test!

Here is how the test might look like:

import static org.mockito.BDDMockito.*;
     
     Seller seller = mock(Seller.class);
     Shop shop = new Shop(seller);
     
     public void shouldBuyBread() throws Exception {
       //given  
       given(seller.askForBread()).willReturn(new Bread());
       
       //when
       Goods goods = shop.buyBread();
       
       //then
       assertThat(goods, containBread());
     }

### 20. (\*\*New\*\*) Serializable mocks (Since 1.8.1) ###

Mocks can be made serializable. With this feature you can use a mock in a place that requires dependencies to be serializable.

WARNING: This should be rarely used in unit testing.

The behaviour was implemented for a specific use case of a BDD spec that had an unreliable external dependency. This was in a web environment and the objects from the external dependency were being serialized to pass between layers.

To create serializable mock use [`MockSettings.serializable()`][MockSettings.serializable]:

List serializableMock = mock(List.class, withSettings().serializable());

The mock can be serialized assuming all the normal [serialization requirements][] are met by the class.

Making a real object spy serializable is a bit more effort as the spy(...) method does not have an overloaded version which accepts MockSettings. No worries, you will hardly ever use it.

List<Object> list = new ArrayList<Object>();
     List<Object> spy = mock(ArrayList.class, withSettings()
                     .spiedInstance(list)
                     .defaultAnswer(CALLS_REAL_METHODS)
                     .serializable());

### 21. (\*\*New\*\*) New annotations: @Captor, @Spy, @InjectMocks (Since 1.8.3) ###

Release 1.8.3 brings new annotations that may be helpful on occasion:

*  @[`Captor`][Captor] simplifies creation of [`ArgumentCaptor`][ArgumentCaptor] - useful when the argument to capture is a nasty generic class and you want to avoid compiler warnings
 *  @[`Spy`][Spy] - you can use it instead [`spy(Object)`][spy_Object].
 *  @[`InjectMocks`][InjectMocks] - injects mocks into tested object automatically.

All new annotations are \*only\* processed on [`MockitoAnnotations.initMocks(Object)`][MockitoAnnotations.initMocks_Object]

### 22. (\*\*New\*\*) Verification with timeout (Since 1.8.5) ###

Allows verifying with timeout. May be useful for testing in concurrent conditions.

It feels this feature should be used rarely - figure out a better way of testing your multi-threaded system.

Not yet implemented to work with InOrder verification.

Examples:

//passes when someMethod() is called within given time span 
       verify(mock, timeout(100)).someMethod();
       //above is an alias to:
       verify(mock, timeout(100).times(1)).someMethod();
       
       //passes when someMethod() is called *exactly* 2 times within given time span
       verify(mock, timeout(100).times(2)).someMethod();
    
       //passes when someMethod() is called *at lest* 2 times within given time span
       verify(mock, timeout(100).atLeast(2)).someMethod();
       
       //verifies someMethod() within given time span using given verification mode
       //useful only if you have your own custom verification modes.
       verify(mock, new Timeout(100, yourOwnVerificationMode)).someMethod();

--------------------

<table style="border:1px solid #dddddd;color:#333333;font-family:Helvetica, Arial, sans-serif;font-size:14px;line-height:18px;"> 
 <tbody> 
  <tr style="color:#444444;"> 
   <th style="border:1px solid #dddddd;" colspan="2" align="left"><span style="font-size:1.4em;line-height:1.3em;"><strong>Method Summary</strong></span></th> 
  </tr> 
  <tr style="color:#666666;font-size:.95em;"> 
   <td style="border:1px solid #dddddd;" align="right"> <span style="font-size:.85em;line-height:1.5em;"><code style="color:#000000;line-height:1.286em;font-family:Consolas, 'Lucida Console', 'Droid Sans Mono', 'Andale Mono', Monaco, 'Lucida Sans Typewriter';">static&nbsp;<a style="text-decoration:none;color:#cc3300;" title="interface in org.mockito.verification" href="http://docs.mockito.googlecode.com/hg/org/mockito/verification/VerificationMode.html" rel="nofollow">VerificationMode</a></code></span></td> 
   <td style="border:1px solid #dddddd;"><code style="color:#000000;line-height:1.286em;font-family:Consolas, 'Lucida Console', 'Droid Sans Mono', 'Andale Mono', Monaco, 'Lucida Sans Typewriter';"><strong><a style="text-decoration:none;color:#cc3300;" href="http://docs.mockito.googlecode.com/hg/org/mockito/Mockito.html#atLeast%28int%29" rel="nofollow">atLeast</a></strong>(int&nbsp;minNumberOfInvocations)</code>&nbsp;<br> &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Allows at-least-x verification.</td> 
  </tr> 
  <tr style="color:#666666;font-size:.95em;"> 
   <td style="border:1px solid #dddddd;" align="right"> <span style="font-size:.85em;line-height:1.5em;"><code style="color:#000000;line-height:1.286em;font-family:Consolas, 'Lucida Console', 'Droid Sans Mono', 'Andale Mono', Monaco, 'Lucida Sans Typewriter';">static&nbsp;<a style="text-decoration:none;color:#cc3300;" title="interface in org.mockito.verification" href="http://docs.mockito.googlecode.com/hg/org/mockito/verification/VerificationMode.html" rel="nofollow">VerificationMode</a></code></span></td> 
   <td style="border:1px solid #dddddd;"><code style="color:#000000;line-height:1.286em;font-family:Consolas, 'Lucida Console', 'Droid Sans Mono', 'Andale Mono', Monaco, 'Lucida Sans Typewriter';"><strong><a style="text-decoration:none;color:#cc3300;" href="http://docs.mockito.googlecode.com/hg/org/mockito/Mockito.html#atLeastOnce%28%29" rel="nofollow">atLeastOnce</a></strong>()</code>&nbsp;<br> &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Allows at-least-once verification.</td> 
  </tr> 
  <tr style="color:#666666;font-size:.95em;"> 
   <td style="border:1px solid #dddddd;" align="right"> <span style="font-size:.85em;line-height:1.5em;"><code style="color:#000000;line-height:1.286em;font-family:Consolas, 'Lucida Console', 'Droid Sans Mono', 'Andale Mono', Monaco, 'Lucida Sans Typewriter';">static&nbsp;<a style="text-decoration:none;color:#cc3300;" title="interface in org.mockito.verification" href="http://docs.mockito.googlecode.com/hg/org/mockito/verification/VerificationMode.html" rel="nofollow">VerificationMode</a></code></span></td> 
   <td style="border:1px solid #dddddd;"><code style="color:#000000;line-height:1.286em;font-family:Consolas, 'Lucida Console', 'Droid Sans Mono', 'Andale Mono', Monaco, 'Lucida Sans Typewriter';"><strong><a style="text-decoration:none;color:#cc3300;" href="http://docs.mockito.googlecode.com/hg/org/mockito/Mockito.html#atMost%28int%29" rel="nofollow">atMost</a></strong>(int&nbsp;maxNumberOfInvocations)</code>&nbsp;<br> &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Allows at-most-x verification.</td> 
  </tr> 
  <tr style="color:#666666;font-size:.95em;"> 
   <td style="border:1px solid #dddddd;" align="right"> <span style="font-size:.85em;line-height:1.5em;"><code style="color:#000000;line-height:1.286em;font-family:Consolas, 'Lucida Console', 'Droid Sans Mono', 'Andale Mono', Monaco, 'Lucida Sans Typewriter';">static&nbsp;<a style="text-decoration:none;color:#cc3300;" title="interface in org.mockito.stubbing" href="http://docs.mockito.googlecode.com/hg/org/mockito/stubbing/Stubber.html" rel="nofollow">Stubber</a></code></span></td> 
   <td style="border:1px solid #dddddd;"><code style="color:#000000;line-height:1.286em;font-family:Consolas, 'Lucida Console', 'Droid Sans Mono', 'Andale Mono', Monaco, 'Lucida Sans Typewriter';"><strong><a style="text-decoration:none;color:#cc3300;" href="http://docs.mockito.googlecode.com/hg/org/mockito/Mockito.html#doAnswer%28org.mockito.stubbing.Answer%29" rel="nofollow">doAnswer</a></strong>(<a style="text-decoration:none;color:#cc3300;" title="interface in org.mockito.stubbing" href="http://docs.mockito.googlecode.com/hg/org/mockito/stubbing/Answer.html" rel="nofollow">Answer</a>&nbsp;answer)</code>&nbsp;<br> &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Use doAnswer() when you want to stub a void method with generic&nbsp;<a style="text-decoration:none;color:#cc3300;" title="interface in org.mockito.stubbing" href="http://docs.mockito.googlecode.com/hg/org/mockito/stubbing/Answer.html" rel="nofollow"><code style="color:#000000;line-height:1.286em;font-family:Consolas, 'Lucida Console', 'Droid Sans Mono', 'Andale Mono', Monaco, 'Lucida Sans Typewriter';">Answer</code></a>.</td> 
  </tr> 
  <tr style="color:#666666;font-size:.95em;"> 
   <td style="border:1px solid #dddddd;" align="right"> <span style="font-size:.85em;line-height:1.5em;"><code style="color:#000000;line-height:1.286em;font-family:Consolas, 'Lucida Console', 'Droid Sans Mono', 'Andale Mono', Monaco, 'Lucida Sans Typewriter';">static&nbsp;<a style="text-decoration:none;color:#cc3300;" title="interface in org.mockito.stubbing" href="http://docs.mockito.googlecode.com/hg/org/mockito/stubbing/Stubber.html" rel="nofollow">Stubber</a></code></span></td> 
   <td style="border:1px solid #dddddd;"><code style="color:#000000;line-height:1.286em;font-family:Consolas, 'Lucida Console', 'Droid Sans Mono', 'Andale Mono', Monaco, 'Lucida Sans Typewriter';"><strong><a style="text-decoration:none;color:#cc3300;" href="http://docs.mockito.googlecode.com/hg/org/mockito/Mockito.html#doCallRealMethod%28%29" rel="nofollow">doCallRealMethod</a></strong>()</code>&nbsp;<br> &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Use doCallRealMethod() when you want to call the real implementation of a method.</td> 
  </tr> 
  <tr style="color:#666666;font-size:.95em;"> 
   <td style="border:1px solid #dddddd;" align="right"> <span style="font-size:.85em;line-height:1.5em;"><code style="color:#000000;line-height:1.286em;font-family:Consolas, 'Lucida Console', 'Droid Sans Mono', 'Andale Mono', Monaco, 'Lucida Sans Typewriter';">static&nbsp;<a style="text-decoration:none;color:#cc3300;" title="interface in org.mockito.stubbing" href="http://docs.mockito.googlecode.com/hg/org/mockito/stubbing/Stubber.html" rel="nofollow">Stubber</a></code></span></td> 
   <td style="border:1px solid #dddddd;"><code style="color:#000000;line-height:1.286em;font-family:Consolas, 'Lucida Console', 'Droid Sans Mono', 'Andale Mono', Monaco, 'Lucida Sans Typewriter';"><strong><a style="text-decoration:none;color:#cc3300;" href="http://docs.mockito.googlecode.com/hg/org/mockito/Mockito.html#doNothing%28%29" rel="nofollow">doNothing</a></strong>()</code>&nbsp;<br> &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Use doNothing() for setting void methods to do nothing.</td> 
  </tr> 
  <tr style="color:#666666;font-size:.95em;"> 
   <td style="border:1px solid #dddddd;" align="right"> <span style="font-size:.85em;line-height:1.5em;"><code style="color:#000000;line-height:1.286em;font-family:Consolas, 'Lucida Console', 'Droid Sans Mono', 'Andale Mono', Monaco, 'Lucida Sans Typewriter';">static&nbsp;<a style="text-decoration:none;color:#cc3300;" title="interface in org.mockito.stubbing" href="http://docs.mockito.googlecode.com/hg/org/mockito/stubbing/Stubber.html" rel="nofollow">Stubber</a></code></span></td> 
   <td style="border:1px solid #dddddd;"><code style="color:#000000;line-height:1.286em;font-family:Consolas, 'Lucida Console', 'Droid Sans Mono', 'Andale Mono', Monaco, 'Lucida Sans Typewriter';"><strong><a style="text-decoration:none;color:#cc3300;" href="http://docs.mockito.googlecode.com/hg/org/mockito/Mockito.html#doReturn%28java.lang.Object%29" rel="nofollow">doReturn</a></strong>(java.lang.Object&nbsp;toBeReturned)</code>&nbsp;<br> &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Use doReturn() in those rare occasions when you cannot use&nbsp;<a style="text-decoration:none;color:#cc3300;" href="http://docs.mockito.googlecode.com/hg/org/mockito/Mockito.html#when%28T%29" rel="nofollow"><code style="color:#000000;line-height:1.286em;font-family:Consolas, 'Lucida Console', 'Droid Sans Mono', 'Andale Mono', Monaco, 'Lucida Sans Typewriter';">when(Object)</code></a>.</td> 
  </tr> 
  <tr style="color:#666666;font-size:.95em;"> 
   <td style="border:1px solid #dddddd;" align="right"> <span style="font-size:.85em;line-height:1.5em;"><code style="color:#000000;line-height:1.286em;font-family:Consolas, 'Lucida Console', 'Droid Sans Mono', 'Andale Mono', Monaco, 'Lucida Sans Typewriter';">static&nbsp;<a style="text-decoration:none;color:#cc3300;" title="interface in org.mockito.stubbing" href="http://docs.mockito.googlecode.com/hg/org/mockito/stubbing/Stubber.html" rel="nofollow">Stubber</a></code></span></td> 
   <td style="border:1px solid #dddddd;"><code style="color:#000000;line-height:1.286em;font-family:Consolas, 'Lucida Console', 'Droid Sans Mono', 'Andale Mono', Monaco, 'Lucida Sans Typewriter';"><strong><a style="text-decoration:none;color:#cc3300;" href="http://docs.mockito.googlecode.com/hg/org/mockito/Mockito.html#doThrow%28java.lang.Throwable%29" rel="nofollow">doThrow</a></strong>(java.lang.Throwable&nbsp;toBeThrown)</code>&nbsp;<br> &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Use doThrow() when you want to stub the void method with an exception.</td> 
  </tr> 
  <tr style="color:#666666;font-size:.95em;"> 
   <td style="border:1px solid #dddddd;" align="right"> <span style="font-size:.85em;line-height:1.5em;"><code style="color:#000000;line-height:1.286em;font-family:Consolas, 'Lucida Console', 'Droid Sans Mono', 'Andale Mono', Monaco, 'Lucida Sans Typewriter';">static&nbsp;<a style="text-decoration:none;color:#cc3300;" title="interface in org.mockito" href="http://docs.mockito.googlecode.com/hg/org/mockito/InOrder.html" rel="nofollow">InOrder</a></code></span></td> 
   <td style="border:1px solid #dddddd;"><code style="color:#000000;line-height:1.286em;font-family:Consolas, 'Lucida Console', 'Droid Sans Mono', 'Andale Mono', Monaco, 'Lucida Sans Typewriter';"><strong><a style="text-decoration:none;color:#cc3300;" href="http://docs.mockito.googlecode.com/hg/org/mockito/Mockito.html#inOrder%28java.lang.Object...%29" rel="nofollow">inOrder</a></strong>(java.lang.Object...&nbsp;mocks)</code>&nbsp;<br> &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Creates InOrder object that allows verifying mocks in order.</td> 
  </tr> 
  <tr style="color:#666666;font-size:.95em;"> 
   <td style="border:1px solid #dddddd;" align="right"> <span style="font-size:.85em;line-height:1.5em;"><code style="color:#000000;line-height:1.286em;font-family:Consolas, 'Lucida Console', 'Droid Sans Mono', 'Andale Mono', Monaco, 'Lucida Sans Typewriter';">static</code></span> 
    <table> 
     <tbody> 
      <tr> 
       <td style="border:1px solid #dddddd;"><span style="font-size:.85em;line-height:1.5em;"><code style="line-height:1.286em;font-family:Consolas, 'Lucida Console', 'Droid Sans Mono', 'Andale Mono', Monaco, 'Lucida Sans Typewriter';">&lt;T&gt; T</code></span></td> 
      </tr> 
     </tbody> 
    </table></td> 
   <td style="border:1px solid #dddddd;"><code style="color:#000000;line-height:1.286em;font-family:Consolas, 'Lucida Console', 'Droid Sans Mono', 'Andale Mono', Monaco, 'Lucida Sans Typewriter';"><strong><a style="text-decoration:none;color:#cc3300;" href="http://docs.mockito.googlecode.com/hg/org/mockito/Mockito.html#mock%28java.lang.Class%29" rel="nofollow">mock</a></strong>(java.lang.Class&lt;T&gt;&nbsp;classToMock)</code>&nbsp;<br> &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Creates mock object of given class or interface.</td> 
  </tr> 
  <tr style="color:#666666;font-size:.95em;"> 
   <td style="border:1px solid #dddddd;" align="right"> <span style="font-size:.85em;line-height:1.5em;"><code style="color:#000000;line-height:1.286em;font-family:Consolas, 'Lucida Console', 'Droid Sans Mono', 'Andale Mono', Monaco, 'Lucida Sans Typewriter';">static</code></span> 
    <table> 
     <tbody> 
      <tr> 
       <td style="border:1px solid #dddddd;"><span style="font-size:.85em;line-height:1.5em;"><code style="line-height:1.286em;font-family:Consolas, 'Lucida Console', 'Droid Sans Mono', 'Andale Mono', Monaco, 'Lucida Sans Typewriter';">&lt;T&gt; T</code></span></td> 
      </tr> 
     </tbody> 
    </table></td> 
   <td style="border:1px solid #dddddd;"><code style="color:#000000;line-height:1.286em;font-family:Consolas, 'Lucida Console', 'Droid Sans Mono', 'Andale Mono', Monaco, 'Lucida Sans Typewriter';"><strong><a style="text-decoration:none;color:#cc3300;" href="http://docs.mockito.googlecode.com/hg/org/mockito/Mockito.html#mock%28java.lang.Class,%20org.mockito.stubbing.Answer%29" rel="nofollow">mock</a></strong>(java.lang.Class&lt;T&gt;&nbsp;classToMock,&nbsp;<a style="text-decoration:none;color:#cc3300;" title="interface in org.mockito.stubbing" href="http://docs.mockito.googlecode.com/hg/org/mockito/stubbing/Answer.html" rel="nofollow">Answer</a>&nbsp;defaultAnswer)</code>&nbsp;<br> &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Creates mock with a specified strategy for its answers to interactions.</td> 
  </tr> 
  <tr style="color:#666666;font-size:.95em;"> 
   <td style="border:1px solid #dddddd;" align="right"> <span style="font-size:.85em;line-height:1.5em;"><code style="color:#000000;line-height:1.286em;font-family:Consolas, 'Lucida Console', 'Droid Sans Mono', 'Andale Mono', Monaco, 'Lucida Sans Typewriter';">static</code></span> 
    <table> 
     <tbody> 
      <tr> 
       <td style="border:1px solid #dddddd;"><span style="font-size:.85em;line-height:1.5em;"><code style="line-height:1.286em;font-family:Consolas, 'Lucida Console', 'Droid Sans Mono', 'Andale Mono', Monaco, 'Lucida Sans Typewriter';">&lt;T&gt; T</code></span></td> 
      </tr> 
     </tbody> 
    </table></td> 
   <td style="border:1px solid #dddddd;"><code style="color:#000000;line-height:1.286em;font-family:Consolas, 'Lucida Console', 'Droid Sans Mono', 'Andale Mono', Monaco, 'Lucida Sans Typewriter';"><strong><a style="text-decoration:none;color:#cc3300;" href="http://docs.mockito.googlecode.com/hg/org/mockito/Mockito.html#mock%28java.lang.Class,%20org.mockito.MockSettings%29" rel="nofollow">mock</a></strong>(java.lang.Class&lt;T&gt;&nbsp;classToMock,&nbsp;<a style="text-decoration:none;color:#cc3300;" title="interface in org.mockito" href="http://docs.mockito.googlecode.com/hg/org/mockito/MockSettings.html" rel="nofollow">MockSettings</a>&nbsp;mockSettings)</code>&nbsp;<br> &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Creates a mock with some non-standard settings.</td> 
  </tr> 
  <tr style="color:#666666;font-size:.95em;"> 
   <td style="border:1px solid #dddddd;" align="right"> <span style="font-size:.85em;line-height:1.5em;"><code style="color:#000000;line-height:1.286em;font-family:Consolas, 'Lucida Console', 'Droid Sans Mono', 'Andale Mono', Monaco, 'Lucida Sans Typewriter';">static</code></span> 
    <table> 
     <tbody> 
      <tr> 
       <td style="border:1px solid #dddddd;"><span style="font-size:.85em;line-height:1.5em;"><code style="line-height:1.286em;font-family:Consolas, 'Lucida Console', 'Droid Sans Mono', 'Andale Mono', Monaco, 'Lucida Sans Typewriter';">&lt;T&gt; T</code></span></td> 
      </tr> 
     </tbody> 
    </table></td> 
   <td style="border:1px solid #dddddd;"><code style="color:#000000;line-height:1.286em;font-family:Consolas, 'Lucida Console', 'Droid Sans Mono', 'Andale Mono', Monaco, 'Lucida Sans Typewriter';"><strong><a style="text-decoration:none;color:#cc3300;" href="http://docs.mockito.googlecode.com/hg/org/mockito/Mockito.html#mock%28java.lang.Class,%20org.mockito.ReturnValues%29" rel="nofollow">mock</a></strong>(java.lang.Class&lt;T&gt;&nbsp;classToMock,&nbsp;<a style="text-decoration:none;color:#cc3300;" title="interface in org.mockito" href="http://docs.mockito.googlecode.com/hg/org/mockito/ReturnValues.html" rel="nofollow">ReturnValues</a>&nbsp;returnValues)</code>&nbsp;<br> &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<strong>Deprecated.</strong>&nbsp;<em><strong>Please use mock(Foo.class, defaultAnswer);</strong></em> <p>See&nbsp;<a style="text-decoration:none;color:#cc3300;" href="http://docs.mockito.googlecode.com/hg/org/mockito/Mockito.html#mock%28java.lang.Class,%20org.mockito.stubbing.Answer%29" rel="nofollow"><code style="color:#000000;line-height:1.286em;font-family:Consolas, 'Lucida Console', 'Droid Sans Mono', 'Andale Mono', Monaco, 'Lucida Sans Typewriter';">mock(Class, Answer)</code></a></p> <p>Why it is deprecated? ReturnValues is being replaced by Answer for better consistency &amp; interoperability of the framework. Answer interface has been in Mockito for a while and it has the same responsibility as ReturnValues. There's no point in mainting exactly the same interfaces.</p> <p>Creates mock with a specified strategy for its return values. It's quite advanced feature and typically you don't need it to write decent tests. However it can be helpful when working with legacy systems.</p> <p>Obviously return values are used only when you don't stub the method call.</p> <pre>   Foo mock = mock(Foo.class, Mockito.RETURNS_SMART_NULLS);
   Foo mockTwo = mock(Foo.class, new YourOwnReturnValues()); 
 </pre> <p>See examples in javadoc for&nbsp;<a style="text-decoration:none;color:#cc3300;" title="class in org.mockito" href="http://docs.mockito.googlecode.com/hg/org/mockito/Mockito.html" rel="nofollow"><code style="color:#000000;line-height:1.286em;font-family:Consolas, 'Lucida Console', 'Droid Sans Mono', 'Andale Mono', Monaco, 'Lucida Sans Typewriter';">Mockito</code></a>&nbsp;class</p> </td> 
  </tr> 
  <tr style="color:#666666;font-size:.95em;"> 
   <td style="border:1px solid #dddddd;" align="right"><span style="font-size:.85em;line-height:1.5em;"><code style="color:#000000;line-height:1.286em;font-family:Consolas, 'Lucida Console', 'Droid Sans Mono', 'Andale Mono', Monaco, 'Lucida Sans Typewriter';">static</code></span> 
    <table> 
     <tbody> 
      <tr> 
       <td style="border:1px solid #dddddd;"><span style="font-size:.85em;line-height:1.5em;"><code style="line-height:1.286em;font-family:Consolas, 'Lucida Console', 'Droid Sans Mono', 'Andale Mono', Monaco, 'Lucida Sans Typewriter';">&lt;T&gt; T</code></span></td> 
      </tr> 
     </tbody> 
    </table></td> 
   <td style="border:1px solid #dddddd;"><code style="color:#000000;line-height:1.286em;font-family:Consolas, 'Lucida Console', 'Droid Sans Mono', 'Andale Mono', Monaco, 'Lucida Sans Typewriter';"><strong><a style="text-decoration:none;color:#cc3300;" href="http://docs.mockito.googlecode.com/hg/org/mockito/Mockito.html#mock%28java.lang.Class,%20java.lang.String%29" rel="nofollow">mock</a></strong>(java.lang.Class&lt;T&gt;&nbsp;classToMock, java.lang.String&nbsp;name)</code>&nbsp;<br> &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Specifies mock name.</td> 
  </tr> 
  <tr style="color:#666666;font-size:.95em;"> 
   <td style="border:1px solid #dddddd;" align="right"> <span style="font-size:.85em;line-height:1.5em;"><code style="color:#000000;line-height:1.286em;font-family:Consolas, 'Lucida Console', 'Droid Sans Mono', 'Andale Mono', Monaco, 'Lucida Sans Typewriter';">static&nbsp;<a style="text-decoration:none;color:#cc3300;" title="interface in org.mockito.verification" href="http://docs.mockito.googlecode.com/hg/org/mockito/verification/VerificationMode.html" rel="nofollow">VerificationMode</a></code></span></td> 
   <td style="border:1px solid #dddddd;"><code style="color:#000000;line-height:1.286em;font-family:Consolas, 'Lucida Console', 'Droid Sans Mono', 'Andale Mono', Monaco, 'Lucida Sans Typewriter';"><strong><a style="text-decoration:none;color:#cc3300;" href="http://docs.mockito.googlecode.com/hg/org/mockito/Mockito.html#never%28%29" rel="nofollow">never</a></strong>()</code>&nbsp;<br> &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Alias to times(0), see&nbsp;<a style="text-decoration:none;color:#cc3300;" href="http://docs.mockito.googlecode.com/hg/org/mockito/Mockito.html#times%28int%29" rel="nofollow"><code style="color:#000000;line-height:1.286em;font-family:Consolas, 'Lucida Console', 'Droid Sans Mono', 'Andale Mono', Monaco, 'Lucida Sans Typewriter';">times(int)</code></a></td> 
  </tr> 
  <tr style="color:#666666;font-size:.95em;"> 
   <td style="border:1px solid #dddddd;" align="right"> <span style="font-size:.85em;line-height:1.5em;"><code style="color:#000000;line-height:1.286em;font-family:Consolas, 'Lucida Console', 'Droid Sans Mono', 'Andale Mono', Monaco, 'Lucida Sans Typewriter';">static&nbsp;<a style="text-decoration:none;color:#cc3300;" title="interface in org.mockito.verification" href="http://docs.mockito.googlecode.com/hg/org/mockito/verification/VerificationMode.html" rel="nofollow">VerificationMode</a></code></span></td> 
   <td style="border:1px solid #dddddd;"><code style="color:#000000;line-height:1.286em;font-family:Consolas, 'Lucida Console', 'Droid Sans Mono', 'Andale Mono', Monaco, 'Lucida Sans Typewriter';"><strong><a style="text-decoration:none;color:#cc3300;" href="http://docs.mockito.googlecode.com/hg/org/mockito/Mockito.html#only%28%29" rel="nofollow">only</a></strong>()</code>&nbsp;<br> &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Allows checking if given method was the only one invoked.</td> 
  </tr> 
  <tr style="color:#666666;font-size:.95em;"> 
   <td style="border:1px solid #dddddd;" align="right"> <span style="font-size:.85em;line-height:1.5em;"><code style="color:#000000;line-height:1.286em;font-family:Consolas, 'Lucida Console', 'Droid Sans Mono', 'Andale Mono', Monaco, 'Lucida Sans Typewriter';">static</code></span> 
    <table> 
     <tbody> 
      <tr> 
       <td style="border:1px solid #dddddd;"><span style="font-size:.85em;line-height:1.5em;"><code style="line-height:1.286em;font-family:Consolas, 'Lucida Console', 'Droid Sans Mono', 'Andale Mono', Monaco, 'Lucida Sans Typewriter';">&lt;T&gt; void</code></span></td> 
      </tr> 
     </tbody> 
    </table></td> 
   <td style="border:1px solid #dddddd;"><code style="color:#000000;line-height:1.286em;font-family:Consolas, 'Lucida Console', 'Droid Sans Mono', 'Andale Mono', Monaco, 'Lucida Sans Typewriter';"><strong><a style="text-decoration:none;color:#cc3300;" href="http://docs.mockito.googlecode.com/hg/org/mockito/Mockito.html#reset%28T...%29" rel="nofollow">reset</a></strong>(T...&nbsp;mocks)</code>&nbsp;<br> &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Smart Mockito users hardly use this feature because they know it could be a sign of poor tests.</td> 
  </tr> 
  <tr style="color:#666666;font-size:.95em;"> 
   <td style="border:1px solid #dddddd;" align="right"> <span style="font-size:.85em;line-height:1.5em;"><code style="color:#000000;line-height:1.286em;font-family:Consolas, 'Lucida Console', 'Droid Sans Mono', 'Andale Mono', Monaco, 'Lucida Sans Typewriter';">static</code></span> 
    <table> 
     <tbody> 
      <tr> 
       <td style="border:1px solid #dddddd;"><span style="font-size:.85em;line-height:1.5em;"><code style="line-height:1.286em;font-family:Consolas, 'Lucida Console', 'Droid Sans Mono', 'Andale Mono', Monaco, 'Lucida Sans Typewriter';">&lt;T&gt; T</code></span></td> 
      </tr> 
     </tbody> 
    </table></td> 
   <td style="border:1px solid #dddddd;"><code style="color:#000000;line-height:1.286em;font-family:Consolas, 'Lucida Console', 'Droid Sans Mono', 'Andale Mono', Monaco, 'Lucida Sans Typewriter';"><strong><a style="text-decoration:none;color:#cc3300;" href="http://docs.mockito.googlecode.com/hg/org/mockito/Mockito.html#spy%28T%29" rel="nofollow">spy</a></strong>(T&nbsp;object)</code>&nbsp;<br> &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Creates a spy of the real object.</td> 
  </tr> 
  <tr style="color:#666666;font-size:.95em;"> 
   <td style="border:1px solid #dddddd;" align="right"> <span style="font-size:.85em;line-height:1.5em;"><code style="color:#000000;line-height:1.286em;font-family:Consolas, 'Lucida Console', 'Droid Sans Mono', 'Andale Mono', Monaco, 'Lucida Sans Typewriter';">static</code></span> 
    <table> 
     <tbody> 
      <tr> 
       <td style="border:1px solid #dddddd;"><span style="font-size:.85em;line-height:1.5em;"><code style="line-height:1.286em;font-family:Consolas, 'Lucida Console', 'Droid Sans Mono', 'Andale Mono', Monaco, 'Lucida Sans Typewriter';">&lt;T&gt;&nbsp;<a style="text-decoration:none;color:#cc3300;" title="interface in org.mockito.stubbing" href="http://docs.mockito.googlecode.com/hg/org/mockito/stubbing/DeprecatedOngoingStubbing.html" rel="nofollow">DeprecatedOngoingStubbing</a>&lt;T&gt;</code></span></td> 
      </tr> 
     </tbody> 
    </table></td> 
   <td style="border:1px solid #dddddd;"><code style="color:#000000;line-height:1.286em;font-family:Consolas, 'Lucida Console', 'Droid Sans Mono', 'Andale Mono', Monaco, 'Lucida Sans Typewriter';"><strong><a style="text-decoration:none;color:#cc3300;" href="http://docs.mockito.googlecode.com/hg/org/mockito/Mockito.html#stub%28T%29" rel="nofollow">stub</a></strong>(T&nbsp;methodCall)</code>&nbsp;<br> &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Stubs a method call with return value or an exception.</td> 
  </tr> 
  <tr style="color:#666666;font-size:.95em;"> 
   <td style="border:1px solid #dddddd;" align="right"> <span style="font-size:.85em;line-height:1.5em;"><code style="color:#000000;line-height:1.286em;font-family:Consolas, 'Lucida Console', 'Droid Sans Mono', 'Andale Mono', Monaco, 'Lucida Sans Typewriter';">static</code></span> 
    <table> 
     <tbody> 
      <tr> 
       <td style="border:1px solid #dddddd;"><span style="font-size:.85em;line-height:1.5em;"><code style="line-height:1.286em;font-family:Consolas, 'Lucida Console', 'Droid Sans Mono', 'Andale Mono', Monaco, 'Lucida Sans Typewriter';">&lt;T&gt;&nbsp;<a style="text-decoration:none;color:#cc3300;" title="interface in org.mockito.stubbing" href="http://docs.mockito.googlecode.com/hg/org/mockito/stubbing/VoidMethodStubbable.html" rel="nofollow">VoidMethodStubbable</a>&lt;T&gt;</code></span></td> 
      </tr> 
     </tbody> 
    </table></td> 
   <td style="border:1px solid #dddddd;"><code style="color:#000000;line-height:1.286em;font-family:Consolas, 'Lucida Console', 'Droid Sans Mono', 'Andale Mono', Monaco, 'Lucida Sans Typewriter';"><strong><a style="text-decoration:none;color:#cc3300;" href="http://docs.mockito.googlecode.com/hg/org/mockito/Mockito.html#stubVoid%28T%29" rel="nofollow">stubVoid</a></strong>(T&nbsp;mock)</code>&nbsp;<br> &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<strong>Deprecated.</strong>&nbsp;<em>Use&nbsp;<a style="text-decoration:none;color:#cc3300;" href="http://docs.mockito.googlecode.com/hg/org/mockito/Mockito.html#doThrow%28java.lang.Throwable%29" rel="nofollow"><code style="color:#000000;line-height:1.286em;font-family:Consolas, 'Lucida Console', 'Droid Sans Mono', 'Andale Mono', Monaco, 'Lucida Sans Typewriter';">doThrow(Throwable)</code></a>&nbsp;method for stubbing voids</em></td> 
  </tr> 
  <tr style="color:#666666;font-size:.95em;"> 
   <td style="border:1px solid #dddddd;" align="right"> <span style="font-size:.85em;line-height:1.5em;"><code style="color:#000000;line-height:1.286em;font-family:Consolas, 'Lucida Console', 'Droid Sans Mono', 'Andale Mono', Monaco, 'Lucida Sans Typewriter';">static&nbsp;<a style="text-decoration:none;color:#cc3300;" title="interface in org.mockito.verification" href="http://docs.mockito.googlecode.com/hg/org/mockito/verification/VerificationWithTimeout.html" rel="nofollow">VerificationWithTimeout</a></code></span></td> 
   <td style="border:1px solid #dddddd;"><code style="color:#000000;line-height:1.286em;font-family:Consolas, 'Lucida Console', 'Droid Sans Mono', 'Andale Mono', Monaco, 'Lucida Sans Typewriter';"><strong><a style="text-decoration:none;color:#cc3300;" href="http://docs.mockito.googlecode.com/hg/org/mockito/Mockito.html#timeout%28int%29" rel="nofollow">timeout</a></strong>(int&nbsp;millis)</code>&nbsp;<br> &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Allows verifying with timeout.</td> 
  </tr> 
  <tr style="color:#666666;font-size:.95em;"> 
   <td style="border:1px solid #dddddd;" align="right"> <span style="font-size:.85em;line-height:1.5em;"><code style="color:#000000;line-height:1.286em;font-family:Consolas, 'Lucida Console', 'Droid Sans Mono', 'Andale Mono', Monaco, 'Lucida Sans Typewriter';">static&nbsp;<a style="text-decoration:none;color:#cc3300;" title="interface in org.mockito.verification" href="http://docs.mockito.googlecode.com/hg/org/mockito/verification/VerificationMode.html" rel="nofollow">VerificationMode</a></code></span></td> 
   <td style="border:1px solid #dddddd;"><code style="color:#000000;line-height:1.286em;font-family:Consolas, 'Lucida Console', 'Droid Sans Mono', 'Andale Mono', Monaco, 'Lucida Sans Typewriter';"><strong><a style="text-decoration:none;color:#cc3300;" href="http://docs.mockito.googlecode.com/hg/org/mockito/Mockito.html#times%28int%29" rel="nofollow">times</a></strong>(int&nbsp;wantedNumberOfInvocations)</code>&nbsp;<br> &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Allows verifying exact number of invocations.</td> 
  </tr> 
  <tr style="color:#666666;font-size:.95em;"> 
   <td style="border:1px solid #dddddd;" align="right"> <span style="font-size:.85em;line-height:1.5em;"><code style="color:#000000;line-height:1.286em;font-family:Consolas, 'Lucida Console', 'Droid Sans Mono', 'Andale Mono', Monaco, 'Lucida Sans Typewriter';">static&nbsp;void</code></span></td> 
   <td style="border:1px solid #dddddd;"><code style="color:#000000;line-height:1.286em;font-family:Consolas, 'Lucida Console', 'Droid Sans Mono', 'Andale Mono', Monaco, 'Lucida Sans Typewriter';"><strong><a style="text-decoration:none;color:#cc3300;" href="http://docs.mockito.googlecode.com/hg/org/mockito/Mockito.html#validateMockitoUsage%28%29" rel="nofollow">validateMockitoUsage</a></strong>()</code>&nbsp;<br> &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;First of all, in case of any trouble, I encourage you to read the Mockito FAQ:&nbsp;<a style="text-decoration:none;color:#cc3300;" href="http://code.google.com/p/mockito/wiki/FAQ" rel="nofollow">http://code.google.com/p/mockito/wiki/FAQ</a></td> 
  </tr> 
  <tr style="color:#666666;font-size:.95em;"> 
   <td style="border:1px solid #dddddd;" align="right"> <span style="font-size:.85em;line-height:1.5em;"><code style="color:#000000;line-height:1.286em;font-family:Consolas, 'Lucida Console', 'Droid Sans Mono', 'Andale Mono', Monaco, 'Lucida Sans Typewriter';">static</code></span> 
    <table> 
     <tbody> 
      <tr> 
       <td style="border:1px solid #dddddd;"><span style="font-size:.85em;line-height:1.5em;"><code style="line-height:1.286em;font-family:Consolas, 'Lucida Console', 'Droid Sans Mono', 'Andale Mono', Monaco, 'Lucida Sans Typewriter';">&lt;T&gt; T</code></span></td> 
      </tr> 
     </tbody> 
    </table></td> 
   <td style="border:1px solid #dddddd;"><code style="color:#000000;line-height:1.286em;font-family:Consolas, 'Lucida Console', 'Droid Sans Mono', 'Andale Mono', Monaco, 'Lucida Sans Typewriter';"><strong><a style="text-decoration:none;color:#cc3300;" href="http://docs.mockito.googlecode.com/hg/org/mockito/Mockito.html#verify%28T%29" rel="nofollow">verify</a></strong>(T&nbsp;mock)</code>&nbsp;<br> &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Verifies certain behavior&nbsp;<strong>happened once</strong></td> 
  </tr> 
  <tr style="color:#666666;font-size:.95em;"> 
   <td style="border:1px solid #dddddd;" align="right"> <span style="font-size:.85em;line-height:1.5em;"><code style="color:#000000;line-height:1.286em;font-family:Consolas, 'Lucida Console', 'Droid Sans Mono', 'Andale Mono', Monaco, 'Lucida Sans Typewriter';">static</code></span> 
    <table> 
     <tbody> 
      <tr> 
       <td style="border:1px solid #dddddd;"><span style="font-size:.85em;line-height:1.5em;"><code style="line-height:1.286em;font-family:Consolas, 'Lucida Console', 'Droid Sans Mono', 'Andale Mono', Monaco, 'Lucida Sans Typewriter';">&lt;T&gt; T</code></span></td> 
      </tr> 
     </tbody> 
    </table></td> 
   <td style="border:1px solid #dddddd;"><code style="color:#000000;line-height:1.286em;font-family:Consolas, 'Lucida Console', 'Droid Sans Mono', 'Andale Mono', Monaco, 'Lucida Sans Typewriter';"><strong><a style="text-decoration:none;color:#cc3300;" href="http://docs.mockito.googlecode.com/hg/org/mockito/Mockito.html#verify%28T,%20org.mockito.verification.VerificationMode%29" rel="nofollow">verify</a></strong>(T&nbsp;mock,&nbsp;<a style="text-decoration:none;color:#cc3300;" title="interface in org.mockito.verification" href="http://docs.mockito.googlecode.com/hg/org/mockito/verification/VerificationMode.html" rel="nofollow">VerificationMode</a>&nbsp;mode)</code>&nbsp;<br> &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Verifies certain behavior happened at least once / exact number of times / never.</td> 
  </tr> 
  <tr style="color:#666666;font-size:.95em;"> 
   <td style="border:1px solid #dddddd;" align="right"> <span style="font-size:.85em;line-height:1.5em;"><code style="color:#000000;line-height:1.286em;font-family:Consolas, 'Lucida Console', 'Droid Sans Mono', 'Andale Mono', Monaco, 'Lucida Sans Typewriter';">static&nbsp;void</code></span></td> 
   <td style="border:1px solid #dddddd;"><code style="color:#000000;line-height:1.286em;font-family:Consolas, 'Lucida Console', 'Droid Sans Mono', 'Andale Mono', Monaco, 'Lucida Sans Typewriter';"><strong><a style="text-decoration:none;color:#cc3300;" href="http://docs.mockito.googlecode.com/hg/org/mockito/Mockito.html#verifyNoMoreInteractions%28java.lang.Object...%29" rel="nofollow">verifyNoMoreInteractions</a></strong>(java.lang.Object...&nbsp;mocks)</code>&nbsp;<br> &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Checks if any of given mocks has any unverified interaction.</td> 
  </tr> 
  <tr style="color:#666666;font-size:.95em;"> 
   <td style="border:1px solid #dddddd;" align="right"> <span style="font-size:.85em;line-height:1.5em;"><code style="color:#000000;line-height:1.286em;font-family:Consolas, 'Lucida Console', 'Droid Sans Mono', 'Andale Mono', Monaco, 'Lucida Sans Typewriter';">static&nbsp;void</code></span></td> 
   <td style="border:1px solid #dddddd;"><code style="color:#000000;line-height:1.286em;font-family:Consolas, 'Lucida Console', 'Droid Sans Mono', 'Andale Mono', Monaco, 'Lucida Sans Typewriter';"><strong><a style="text-decoration:none;color:#cc3300;" href="http://docs.mockito.googlecode.com/hg/org/mockito/Mockito.html#verifyZeroInteractions%28java.lang.Object...%29" rel="nofollow">verifyZeroInteractions</a></strong>(java.lang.Object...&nbsp;mocks)</code>&nbsp;<br> &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Verifies that no interactions happened on given mocks.</td> 
  </tr> 
  <tr style="color:#666666;font-size:.95em;"> 
   <td style="border:1px solid #dddddd;" align="right"> <span style="font-size:.85em;line-height:1.5em;"><code style="color:#000000;line-height:1.286em;font-family:Consolas, 'Lucida Console', 'Droid Sans Mono', 'Andale Mono', Monaco, 'Lucida Sans Typewriter';">static</code></span> 
    <table> 
     <tbody> 
      <tr> 
       <td style="border:1px solid #dddddd;"><span style="font-size:.85em;line-height:1.5em;"><code style="line-height:1.286em;font-family:Consolas, 'Lucida Console', 'Droid Sans Mono', 'Andale Mono', Monaco, 'Lucida Sans Typewriter';">&lt;T&gt;&nbsp;<a style="text-decoration:none;color:#cc3300;" title="interface in org.mockito.stubbing" href="http://docs.mockito.googlecode.com/hg/org/mockito/stubbing/OngoingStubbing.html" rel="nofollow">OngoingStubbing</a>&lt;T&gt;</code></span></td> 
      </tr> 
     </tbody> 
    </table></td> 
   <td style="border:1px solid #dddddd;"><code style="color:#000000;line-height:1.286em;font-family:Consolas, 'Lucida Console', 'Droid Sans Mono', 'Andale Mono', Monaco, 'Lucida Sans Typewriter';"><strong><a style="text-decoration:none;color:#cc3300;" href="http://docs.mockito.googlecode.com/hg/org/mockito/Mockito.html#when%28T%29" rel="nofollow">when</a></strong>(T&nbsp;methodCall)</code>&nbsp;<br> &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Enables stubbing methods.</td> 
  </tr> 
  <tr style="color:#666666;font-size:.95em;"> 
   <td style="border:1px solid #dddddd;" align="right"> <span style="font-size:.85em;line-height:1.5em;"><code style="color:#000000;line-height:1.286em;font-family:Consolas, 'Lucida Console', 'Droid Sans Mono', 'Andale Mono', Monaco, 'Lucida Sans Typewriter';">static&nbsp;<a style="text-decoration:none;color:#cc3300;" title="interface in org.mockito" href="http://docs.mockito.googlecode.com/hg/org/mockito/MockSettings.html" rel="nofollow">MockSettings</a></code></span></td> 
   <td style="border:1px solid #dddddd;"><code style="color:#000000;line-height:1.286em;font-family:Consolas, 'Lucida Console', 'Droid Sans Mono', 'Andale Mono', Monaco, 'Lucida Sans Typewriter';"><strong><a style="text-decoration:none;color:#cc3300;" href="http://docs.mockito.googlecode.com/hg/org/mockito/Mockito.html#withSettings%28%29" rel="nofollow">withSettings</a></strong>()</code>&nbsp;<br> &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Allows mock creation with additional mock settings.</td> 
  </tr> 
 </tbody> 
</table>

<table style="border:1px solid #dddddd;color:#333333;font-family:Helvetica, Arial, sans-serif;font-size:14px;line-height:18px;"> 
 <tbody> 
  <tr style="color:#444444;"> 
   <th style="border:1px solid #dddddd;" align="left"><strong>Methods inherited from class org.mockito.<a style="text-decoration:none;color:#cc3300;" title="class in org.mockito" href="http://docs.mockito.googlecode.com/hg/org/mockito/Matchers.html" rel="nofollow">Matchers</a></strong></th> 
  </tr> 
  <tr style="color:#666666;font-size:.95em;"> 
   <td style="border:1px solid #dddddd;"><code style="color:#000000;line-height:1.286em;font-family:Consolas, 'Lucida Console', 'Droid Sans Mono', 'Andale Mono', Monaco, 'Lucida Sans Typewriter';"><a style="text-decoration:none;color:#cc3300;" href="http://docs.mockito.googlecode.com/hg/org/mockito/Matchers.html#any%28%29" rel="nofollow">any</a>,&nbsp;<a style="text-decoration:none;color:#cc3300;" href="http://docs.mockito.googlecode.com/hg/org/mockito/Matchers.html#any%28java.lang.Class%29" rel="nofollow">any</a>,&nbsp;<a style="text-decoration:none;color:#cc3300;" href="http://docs.mockito.googlecode.com/hg/org/mockito/Matchers.html#anyBoolean%28%29" rel="nofollow">anyBoolean</a>,&nbsp;<a style="text-decoration:none;color:#cc3300;" href="http://docs.mockito.googlecode.com/hg/org/mockito/Matchers.html#anyByte%28%29" rel="nofollow">anyByte</a>,&nbsp;<a style="text-decoration:none;color:#cc3300;" href="http://docs.mockito.googlecode.com/hg/org/mockito/Matchers.html#anyChar%28%29" rel="nofollow">anyChar</a>,&nbsp;<a style="text-decoration:none;color:#cc3300;" href="http://docs.mockito.googlecode.com/hg/org/mockito/Matchers.html#anyCollection%28%29" rel="nofollow">anyCollection</a>,&nbsp;<a style="text-decoration:none;color:#cc3300;" href="http://docs.mockito.googlecode.com/hg/org/mockito/Matchers.html#anyCollectionOf%28java.lang.Class%29" rel="nofollow">anyCollectionOf</a>,&nbsp;<a style="text-decoration:none;color:#cc3300;" href="http://docs.mockito.googlecode.com/hg/org/mockito/Matchers.html#anyDouble%28%29" rel="nofollow">anyDouble</a>,&nbsp;<a style="text-decoration:none;color:#cc3300;" href="http://docs.mockito.googlecode.com/hg/org/mockito/Matchers.html#anyFloat%28%29" rel="nofollow">anyFloat</a>,&nbsp;<a style="text-decoration:none;color:#cc3300;" href="http://docs.mockito.googlecode.com/hg/org/mockito/Matchers.html#anyInt%28%29" rel="nofollow">anyInt</a>,&nbsp;<a style="text-decoration:none;color:#cc3300;" href="http://docs.mockito.googlecode.com/hg/org/mockito/Matchers.html#anyList%28%29" rel="nofollow">anyList</a>,&nbsp;<a style="text-decoration:none;color:#cc3300;" href="http://docs.mockito.googlecode.com/hg/org/mockito/Matchers.html#anyListOf%28java.lang.Class%29" rel="nofollow">anyListOf</a>,&nbsp;<a style="text-decoration:none;color:#cc3300;" href="http://docs.mockito.googlecode.com/hg/org/mockito/Matchers.html#anyLong%28%29" rel="nofollow">anyLong</a>,&nbsp;<a style="text-decoration:none;color:#cc3300;" href="http://docs.mockito.googlecode.com/hg/org/mockito/Matchers.html#anyMap%28%29" rel="nofollow">anyMap</a>,&nbsp;<a style="text-decoration:none;color:#cc3300;" href="http://docs.mockito.googlecode.com/hg/org/mockito/Matchers.html#anyObject%28%29" rel="nofollow">anyObject</a>,&nbsp;<a style="text-decoration:none;color:#cc3300;" href="http://docs.mockito.googlecode.com/hg/org/mockito/Matchers.html#anySet%28%29" rel="nofollow">anySet</a>,&nbsp;<a style="text-decoration:none;color:#cc3300;" href="http://docs.mockito.googlecode.com/hg/org/mockito/Matchers.html#anySetOf%28java.lang.Class%29" rel="nofollow">anySetOf</a>,<a style="text-decoration:none;color:#cc3300;" href="http://docs.mockito.googlecode.com/hg/org/mockito/Matchers.html#anyShort%28%29" rel="nofollow">anyShort</a>,&nbsp;<a style="text-decoration:none;color:#cc3300;" href="http://docs.mockito.googlecode.com/hg/org/mockito/Matchers.html#anyString%28%29" rel="nofollow">anyString</a>,&nbsp;<a style="text-decoration:none;color:#cc3300;" href="http://docs.mockito.googlecode.com/hg/org/mockito/Matchers.html#anyVararg%28%29" rel="nofollow">anyVararg</a>,&nbsp;<a style="text-decoration:none;color:#cc3300;" href="http://docs.mockito.googlecode.com/hg/org/mockito/Matchers.html#argThat%28org.hamcrest.Matcher%29" rel="nofollow">argThat</a>,&nbsp;<a style="text-decoration:none;color:#cc3300;" href="http://docs.mockito.googlecode.com/hg/org/mockito/Matchers.html#booleanThat%28org.hamcrest.Matcher%29" rel="nofollow">booleanThat</a>,&nbsp;<a style="text-decoration:none;color:#cc3300;" href="http://docs.mockito.googlecode.com/hg/org/mockito/Matchers.html#byteThat%28org.hamcrest.Matcher%29" rel="nofollow">byteThat</a>,&nbsp;<a style="text-decoration:none;color:#cc3300;" href="http://docs.mockito.googlecode.com/hg/org/mockito/Matchers.html#charThat%28org.hamcrest.Matcher%29" rel="nofollow">charThat</a>,&nbsp;<a style="text-decoration:none;color:#cc3300;" href="http://docs.mockito.googlecode.com/hg/org/mockito/Matchers.html#contains%28java.lang.String%29" rel="nofollow">contains</a>,&nbsp;<a style="text-decoration:none;color:#cc3300;" href="http://docs.mockito.googlecode.com/hg/org/mockito/Matchers.html#doubleThat%28org.hamcrest.Matcher%29" rel="nofollow">doubleThat</a>,&nbsp;<a style="text-decoration:none;color:#cc3300;" href="http://docs.mockito.googlecode.com/hg/org/mockito/Matchers.html#endsWith%28java.lang.String%29" rel="nofollow">endsWith</a>,&nbsp;<a style="text-decoration:none;color:#cc3300;" href="http://docs.mockito.googlecode.com/hg/org/mockito/Matchers.html#eq%28boolean%29" rel="nofollow">eq</a>,&nbsp;<a style="text-decoration:none;color:#cc3300;" href="http://docs.mockito.googlecode.com/hg/org/mockito/Matchers.html#eq%28byte%29" rel="nofollow">eq</a>,&nbsp;<a style="text-decoration:none;color:#cc3300;" href="http://docs.mockito.googlecode.com/hg/org/mockito/Matchers.html#eq%28char%29" rel="nofollow">eq</a>,&nbsp;<a style="text-decoration:none;color:#cc3300;" href="http://docs.mockito.googlecode.com/hg/org/mockito/Matchers.html#eq%28double%29" rel="nofollow">eq</a>,&nbsp;<a style="text-decoration:none;color:#cc3300;" href="http://docs.mockito.googlecode.com/hg/org/mockito/Matchers.html#eq%28float%29" rel="nofollow">eq</a>,&nbsp;<a style="text-decoration:none;color:#cc3300;" href="http://docs.mockito.googlecode.com/hg/org/mockito/Matchers.html#eq%28int%29" rel="nofollow">eq</a>,&nbsp;<a style="text-decoration:none;color:#cc3300;" href="http://docs.mockito.googlecode.com/hg/org/mockito/Matchers.html#eq%28long%29" rel="nofollow">eq</a>,&nbsp;<a style="text-decoration:none;color:#cc3300;" href="http://docs.mockito.googlecode.com/hg/org/mockito/Matchers.html#eq%28short%29" rel="nofollow">eq</a>,&nbsp;<a style="text-decoration:none;color:#cc3300;" href="http://docs.mockito.googlecode.com/hg/org/mockito/Matchers.html#eq%28T%29" rel="nofollow">eq</a>,&nbsp;<a style="text-decoration:none;color:#cc3300;" href="http://docs.mockito.googlecode.com/hg/org/mockito/Matchers.html#floatThat%28org.hamcrest.Matcher%29" rel="nofollow">floatThat</a>,&nbsp;<a style="text-decoration:none;color:#cc3300;" href="http://docs.mockito.googlecode.com/hg/org/mockito/Matchers.html#intThat%28org.hamcrest.Matcher%29" rel="nofollow">intThat</a>,&nbsp;<a style="text-decoration:none;color:#cc3300;" href="http://docs.mockito.googlecode.com/hg/org/mockito/Matchers.html#isA%28java.lang.Class%29" rel="nofollow">isA</a>,<a style="text-decoration:none;color:#cc3300;" href="http://docs.mockito.googlecode.com/hg/org/mockito/Matchers.html#isNotNull%28%29" rel="nofollow">isNotNull</a>,&nbsp;<a style="text-decoration:none;color:#cc3300;" href="http://docs.mockito.googlecode.com/hg/org/mockito/Matchers.html#isNull%28%29" rel="nofollow">isNull</a>,&nbsp;<a style="text-decoration:none;color:#cc3300;" href="http://docs.mockito.googlecode.com/hg/org/mockito/Matchers.html#longThat%28org.hamcrest.Matcher%29" rel="nofollow">longThat</a>,&nbsp;<a style="text-decoration:none;color:#cc3300;" href="http://docs.mockito.googlecode.com/hg/org/mockito/Matchers.html#matches%28java.lang.String%29" rel="nofollow">matches</a>,&nbsp;<a style="text-decoration:none;color:#cc3300;" href="http://docs.mockito.googlecode.com/hg/org/mockito/Matchers.html#notNull%28%29" rel="nofollow">notNull</a>,&nbsp;<a style="text-decoration:none;color:#cc3300;" href="http://docs.mockito.googlecode.com/hg/org/mockito/Matchers.html#refEq%28T,%20java.lang.String...%29" rel="nofollow">refEq</a>,&nbsp;<a style="text-decoration:none;color:#cc3300;" href="http://docs.mockito.googlecode.com/hg/org/mockito/Matchers.html#same%28T%29" rel="nofollow">same</a>,&nbsp;<a style="text-decoration:none;color:#cc3300;" href="http://docs.mockito.googlecode.com/hg/org/mockito/Matchers.html#shortThat%28org.hamcrest.Matcher%29" rel="nofollow">shortThat</a>,&nbsp;<a style="text-decoration:none;color:#cc3300;" href="http://docs.mockito.googlecode.com/hg/org/mockito/Matchers.html#startsWith%28java.lang.String%29" rel="nofollow">startsWith</a></code></td> 
  </tr> 
 </tbody> 
</table>

<table style="border:1px solid #dddddd;color:#333333;font-family:Helvetica, Arial, sans-serif;font-size:14px;line-height:18px;"> 
 <tbody> 
  <tr style="color:#444444;"> 
   <th style="border:1px solid #dddddd;" align="left"><strong>Methods inherited from class java.lang.Object</strong></th> 
  </tr> 
  <tr style="color:#666666;font-size:.95em;"> 
   <td style="border:1px solid #dddddd;"><code style="color:#000000;line-height:1.286em;font-family:Consolas, 'Lucida Console', 'Droid Sans Mono', 'Andale Mono', Monaco, 'Lucida Sans Typewriter';">clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait</code></td> 
  </tr> 
 </tbody> 
</table>

### RETURNS\_DEFAULTS ###

public static final Answer<java.lang.Object> RETURNS_DEFAULTS

The default Answer of every mock  **if** the mock was not stubbed. Typically it just returns some empty value.

[`Answer`][Answer] can be used to define the return values of unstubbed invocations.

This implementation first tries the global configuration. If there is no global configuration then it uses [`ReturnsEmptyValues`][ReturnsEmptyValues] (returns zeros, empty collections, nulls, etc.)

--------------------

### RETURNS\_SMART\_NULLS ###

public static final Answer<java.lang.Object> RETURNS_SMART_NULLS

Optional Answer to be used with  [`mock(Class, Answer)`][mock_Class_ Answer]

[`Answer`][Answer] can be used to define the return values of unstubbed invocations.

This implementation can be helpful when working with legacy code. Unstubbed methods often return null. If your code uses the object returned by an unstubbed call you get a NullPointerException. This implementation of Answer **returns SmartNull instead of null**. SmartNull gives nicer exception message than NPE because it points out the line where unstubbed method was called. You just click on the stack trace.

ReturnsSmartNulls first tries to return ordinary return values (see [`ReturnsMoreEmptyValues`][ReturnsMoreEmptyValues]) then it tries to return SmartNull. If the return type is final then plain null is returned.

ReturnsSmartNulls will be probably the default return values strategy in Mockito 2.0

Example:

Foo mock = (Foo.class, RETURNS_SMART_NULLS);
       
       //calling unstubbed method here:
       Stuff stuff = mock.getStuff();
       
       //using object returned by unstubbed call:
       stuff.doSomething();
       
       //Above doesn't yield NullPointerException this time!
       //Instead, SmartNullPointerException is thrown. 
       //Exception's cause links to unstubbed mock.getStuff() - just click on the stack trace.

--------------------

### RETURNS\_MOCKS ###

public static final Answer<java.lang.Object> RETURNS_MOCKS

Optional Answer to be used with  [`mock(Class, Answer)`][mock_Class_ Answer]

[`Answer`][Answer] can be used to define the return values of unstubbed invocations.

This implementation can be helpful when working with legacy code.

ReturnsMocks first tries to return ordinary return values (see [`ReturnsMoreEmptyValues`][ReturnsMoreEmptyValues]) then it tries to return mocks. If the return type cannot be mocked (e.g. is final) then plain null is returned.

--------------------

### RETURNS\_DEEP\_STUBS ###

public static final Answer<java.lang.Object> RETURNS_DEEP_STUBS

Optional Answer to be used with  [`mock(Class, Answer)`][mock_Class_ Answer]

Example that shows how deep stub works:

Foo mock = mock(Foo.class, RETURNS_DEEP_STUBS);
    
       // note that we're stubbing a chain of methods here: getBar().getName()
       when(mock.getBar().getName()).thenReturn("deep");
    
       // note that we're chaining method calls: getBar().getName()
       assertEquals("deep", mock.getBar().getName());

**Verification API does not support 'chaining'** so deep stub doesn't change how you do verification.

**WARNING: **This feature should rarely be required for regular clean code! Leave it for legacy code. Mocking a mock to return a mock, to return a mock, (...), to return something meaningful hints at violation of Law of Demeter or mocking a value object (a well known anti-pattern).

Good quote I've seen one day on the web: **every time a mock returns a mock a fairy dies**.

How deep stub work internally?

//this:
       Foo mock = mock(Foo.class, RETURNS_DEEP_STUBS);
       when(mock.getBar().getName(), "deep");
    
       //is equivalent of
       Foo foo = mock(Foo.class);
       Bar bar = mock(Bar.class);
       when(foo.getBar()).thenReturn(bar);
       when(bar.getName()).thenReturn("deep");

This feature will not work when any return type of methods included in the chain cannot be mocked (for example: is a primitive or a final class). This is because of java type system.

--------------------

### CALLS\_REAL\_METHODS ###

public static final Answer<java.lang.Object> CALLS_REAL_METHODS

Optional Answer to be used with  [`mock(Class, Answer)`][mock_Class_ Answer]

[`Answer`][Answer] can be used to define the return values of unstubbed invocations.

This implementation can be helpful when working with legacy code. When this implementation is used, unstubbed methods will delegate to the real implementation. This is a way to create a partial mock object that calls real methods by default.

As usual you are going to read **the partial mock warning**: Object oriented programming is more less tackling complexity by dividing the complexity into separate, specific, SRPy objects. How does partial mock fit into this paradigm? Well, it just doesn't... Partial mock usually means that the complexity has been moved to a different method on the same object. In most cases, this is not the way you want to design your application.

Example:

Foo mock = mock(Foo.class, CALLS_REAL_METHODS);
    
     // this calls the real implementation of Foo.getSomething()
     value = mock.getSomething();
    
     when(mock.getSomething()).thenReturn(fakeValue);
    
     // now fakeValue is returned
     value = mock.getSomething();

### Mockito ###

public Mockito()

### mock ###

public static <T> T mock(java.lang.Class<T> classToMock)

Creates mock object of given class or interface.

See examples in javadoc for [`Mockito`][Mockito] class

**Parameters:**

`classToMock` - class or interface to mock

**Returns:**

mock object

--------------------

### mock ###

public static <T> T mock(java.lang.Class<T> classToMock,
                             java.lang.String name)

Specifies mock name. Naming mocks can be helpful for debugging - the name is used in all verification errors.

Beware that naming mocks is not a solution for complex code which uses too many mocks or collaborators. **If you have too many mocks then refactor the code** so that it's easy to test/debug without necessity of naming mocks.

**If you use @Mock annotation then you've got naming mocks for free!** @Mock uses field name as mock name. [`Read more.`][Read more.]

See examples in javadoc for [`Mockito`][Mockito] class

**Parameters:**

`classToMock` - class or interface to mock

`name` - of the mock

**Returns:**

mock object

--------------------

### mock ###

@Deprecated
    public static <T> T mock(java.lang.Class<T> classToMock,
                                        ReturnValues returnValues)

**Deprecated.**  ***Please use mock(Foo.class, defaultAnswer);***

See [`mock(Class, Answer)`][mock_Class_ Answer]

Why it is deprecated? ReturnValues is being replaced by Answer for better consistency & interoperability of the framework. Answer interface has been in Mockito for a while and it has the same responsibility as ReturnValues. There's no point in mainting exactly the same interfaces.

Creates mock with a specified strategy for its return values. It's quite advanced feature and typically you don't need it to write decent tests. However it can be helpful when working with legacy systems.

Obviously return values are used only when you don't stub the method call.

Foo mock = mock(Foo.class, Mockito.RETURNS_SMART_NULLS);
       Foo mockTwo = mock(Foo.class, new YourOwnReturnValues());

See examples in javadoc for [`Mockito`][Mockito] class

**Parameters:**

`classToMock` - class or interface to mock

`returnValues` - default return values for unstubbed methods

**Returns:**

mock object

--------------------

### mock ###

public static <T> T mock(java.lang.Class<T> classToMock,
                             Answer defaultAnswer)

Creates mock with a specified strategy for its answers to interactions. It's quite advanced feature and typically you don't need it to write decent tests. However it can be helpful when working with legacy systems.

It is the default answer so it will be used **only when you don't** stub the method call.

Foo mock = mock(Foo.class, RETURNS_SMART_NULLS);
       Foo mockTwo = mock(Foo.class, new YourOwnAnswer());

See examples in javadoc for [`Mockito`][Mockito] class

**Parameters:**

`classToMock` - class or interface to mock

`defaultAnswer` - default answer for unstubbed methods

**Returns:**

mock object

--------------------

### mock ###

public static <T> T mock(java.lang.Class<T> classToMock,
                             MockSettings mockSettings)

Creates a mock with some non-standard settings.

The number of configuration points for a mock grows so we need a fluent way to introduce new configuration without adding more and more overloaded Mockito.mock() methods. Hence[`MockSettings`][MockSettings].

Listener mock = mock(Listener.class, withSettings()
         .name("firstListner").defaultBehavior(RETURNS_SMART_NULLS));
       );

**Use it carefully and occasionally**. What might be reason your test needs non-standard mocks? Is the code under test so complicated that it requires non-standard mocks? Wouldn't you prefer to refactor the code under test so it is testable in a simple way?

See also [`withSettings()`][withSettings]

See examples in javadoc for [`Mockito`][Mockito] class

**Parameters:**

`classToMock` - class or interface to mock

`mockSettings` - additional mock settings

**Returns:**

mock object

--------------------

### spy ###

public static <T> T spy(T object)

Creates a spy of the real object. The spy calls  **real** methods unless they are stubbed.

Real spies should be used **carefully and occasionally**, for example when dealing with legacy code.

Example:

#### Important gotcha on spying real objects! ####

1. Sometimes it's impossible to use  [`when(Object)`][when_Object] for stubbing spies. Example:

See examples in javadoc for [`Mockito`][Mockito] class

**Parameters:**

`object` - to spy on

**Returns:**

a spy of the real object

--------------------

### stub ###

public static <T> DeprecatedOngoingStubbing<T> stub(T methodCall)

Stubs a method call with return value or an exception. E.g:

stub(mock.someMethod()).toReturn(10);
    
     //you can use flexible argument matchers, e.g:
     stub(mock.someMethod(anyString())).toReturn(10);
    
     //setting exception to be thrown:
     stub(mock.someMethod("some arg")).toThrow(new RuntimeException());
    
     //you can stub with different behavior for consecutive method calls.
     //Last stubbing (e.g: toReturn("foo")) determines the behavior for further consecutive calls.
     stub(mock.someMethod("some arg"))
      .toThrow(new RuntimeException())
      .toReturn("foo");

Some users find stub() confusing therefore [`when(Object)`][when_Object] is recommended over stub()

//Instead of:
       stub(mock.count()).toReturn(10);
     
       //You can do:
       when(mock.count()).thenReturn(10);

For stubbing void methods with throwables see:  [`doThrow(Throwable)`][doThrow_Throwable]

Stubbing can be overridden: for example common stubbing can go to fixture setup but the test methods can override it. Please note that overridding stubbing is a potential code smell that points out too much stubbing.

Once stubbed, the method will always return stubbed value regardless of how many times it is called.

Last stubbing is more important - when you stubbed the same method with the same arguments many times.

Although it is possible to verify a stubbed invocation, usually **it's just redundant**. Let's say you've stubbed foo.bar(). If your code cares what foo.bar() returns then something else breaks(often before even verify() gets executed). If your code doesn't care what get(0) returns then it should not be stubbed. Not convinced? See [here][here 4].

**Parameters:**

`methodCall` - method call

**Returns:**

DeprecatedOngoingStubbing object to set stubbed value/exception

--------------------

### when ###

public static <T> OngoingStubbing<T> when(T methodCall)

Enables stubbing methods. Use it when you want the mock to return particular value when particular method is called.

Simply put: "**When** the x method is called **then** return y".

**when() is a successor of deprecated [`stub(Object)`][stub_Object]**

Examples:

when(mock.someMethod()).thenReturn(10);
    
     //you can use flexible argument matchers, e.g:
     when(mock.someMethod(anyString())).thenReturn(10);
    
     //setting exception to be thrown:
     when(mock.someMethod("some arg")).thenThrow(new RuntimeException());
    
     //you can set different behavior for consecutive method calls.
     //Last stubbing (e.g: thenReturn("foo")) determines the behavior of further consecutive calls.
     when(mock.someMethod("some arg"))
      .thenThrow(new RuntimeException())
      .thenReturn("foo");
      
     //Alternative, shorter version for consecutive stubbing:
     when(mock.someMethod("some arg"))
      .thenReturn("one", "two");
     //is the same as:
     when(mock.someMethod("some arg"))
      .thenReturn("one")
      .thenReturn("two");
    
     //shorter version for consecutive method calls throwing exceptions:
     when(mock.someMethod("some arg"))
      .thenThrow(new RuntimeException(), new NullPointerException();

For stubbing void methods with throwables see:  [`doThrow(Throwable)`][doThrow_Throwable]

Once stubbed, the method will always return stubbed value regardless of how many times it is called.

Last stubbing is more important - when you stubbed the same method with the same arguments many times.

See examples in javadoc for [`Mockito`][Mockito] class

**Parameters:**

`methodCall` - method to be stubbed

--------------------

### verify ###

public static <T> T verify(T mock)

Verifies certain behavior  **happened once**

Alias to `verify(mock, times(1))` E.g:

verify(mock).someMethod("some arg");

Above is equivalent to:

verify(mock, times(1)).someMethod("some arg");

Arguments passed are compared using equals() method. Read about [`ArgumentCaptor`][ArgumentCaptor] or [`ArgumentMatcher`][ArgumentMatcher] to find out other ways of matching / asserting arguments passed.

See examples in javadoc for [`Mockito`][Mockito] class

**Parameters:**

`mock` - to be verified

**Returns:**

mock object itself

--------------------

### verify ###

public static <T> T verify(T mock,
                               VerificationMode mode)

Verifies certain behavior happened at least once / exact number of times / never. E.g:

verify(mock, times(5)).someMethod("was called five times");
    
       verify(mock, atLeast(2)).someMethod("was called at least two times");
    
       //you can use flexible argument matchers, e.g:
       verify(mock, atLeastOnce()).someMethod(anyString());

**times(1) is the default** and can be omitted

**Parameters:**

`mock` - to be verified

`mode` - times(x), atLeastOnce() or never()

**Returns:**

mock object itself

--------------------

### reset ###

public static <T> void reset(T... mocks)

Smart Mockito users hardly use this feature because they know it could be a sign of poor tests. Normally, you don't need to reset your mocks, just create new mocks for each test method.

Instead of reset() please consider writing simple, small and focused test methods over lengthy, over-specified tests. **First potential code smell is reset() in the middle of the test method.**This probably means you're testing too much. Follow the whisper of your test methods: "Please keep us small & focused on single behavior". There are several threads about it on mockito mailing list.

The only reason we added reset() method is to make it possible to work with container-injected mocks. See issue 55 ([here][here 2]) or FAQ ([here][here 3]).

**Don't harm yourself.** reset() in the middle of the test method is a code smell (you're probably testing too much).

List mock = mock(List.class);
       when(mock.size()).thenReturn(10);
       mock.add(1);
    
       reset(mock);
       //at this point the mock forgot any interactions & stubbing

**Type Parameters:**

`T` -

**Parameters:**

`mocks` - to be reset

--------------------

### verifyNoMoreInteractions ###

public static void verifyNoMoreInteractions(java.lang.Object... mocks)

Checks if any of given mocks has any unverified interaction.

You can use this method after you verified your mocks - to make sure that nothing else was invoked on your mocks.

See also [`never()`][never] - it is more explicit and communicates the intent well.

Stubbed invocations (if called) are also treated as interactions.

A word of **warning**: Some users who did a lot of classic, expect-run-verify mocking tend to use verifyNoMoreInteractions() very often, even in every test method. verifyNoMoreInteractions() is not recommended to use in every test method. verifyNoMoreInteractions() is a handy assertion from the interaction testing toolkit. Use it only when it's relevant. Abusing it leads to overspecified, less maintainable tests. You can find further reading [here][].

This method will also detect unverified invocations that occurred before the test method, for example: in setUp(), @Before method or in constructor. Consider writing nice code that makes interactions only in test methods.

Example:

//interactions
     mock.doSomething();
     mock.doSomethingUnexpected();
     
     //verification
     verify(mock).doSomething();
     
     //following will fail because 'doSomethingUnexpected()' is unexpected
     verifyNoMoreInteractions(mock);

See examples in javadoc for  [`Mockito`][Mockito] class

**Parameters:**

`mocks` - to be verified

--------------------

### verifyZeroInteractions ###

public static void verifyZeroInteractions(java.lang.Object... mocks)

Verifies that no interactions happened on given mocks.

verifyZeroInteractions(mockOne, mockTwo);

This method will also detect invocations that occurred before the test method, for example: in setUp(), @Before method or in constructor. Consider writing nice code that makes interactions only in test methods.

See also [`never()`][never] - it is more explicit and communicates the intent well.

See examples in javadoc for [`Mockito`][Mockito] class

**Parameters:**

`mocks` - to be verified

--------------------

### stubVoid ###

public static <T> VoidMethodStubbable<T> stubVoid(T mock)

**Deprecated.**  *Use [`doThrow(Throwable)`][doThrow_Throwable] method for stubbing voids*

//Instead of:
       stubVoid(mock).toThrow(e).on().someVoidMethod();
     
       //Please do:
       doThrow(e).when(mock).someVoidMethod();

doThrow() replaces stubVoid() because of improved readability and consistency with the family of doAnswer() methods.

Originally, stubVoid() was used for stubbing void methods with exceptions. E.g:

stubVoid(mock).toThrow(new RuntimeException()).on().someMethod();
     
     //you can stub with different behavior for consecutive calls.
     //Last stubbing (e.g. toReturn()) determines the behavior for further consecutive calls.   
     stubVoid(mock)
       .toThrow(new RuntimeException())
       .toReturn()
       .on().someMethod();

See examples in javadoc for  [`Mockito`][Mockito] class

**Parameters:**

`mock` - to stub

**Returns:**

stubbable object that allows stubbing with throwable

--------------------

### doThrow ###

public static Stubber doThrow(java.lang.Throwable toBeThrown)

Use doThrow() when you want to stub the void method with an exception.

Stubbing voids requires different approach from [`when(Object)`][when_Object] because the compiler does not like void methods inside brackets...

Example:

doThrow(new RuntimeException()).when(mock).someVoidMethod();

**Parameters:**

`toBeThrown` - to be thrown when the stubbed method is called

**Returns:**

stubber - to select a method for stubbing

--------------------

### doCallRealMethod ###

public static Stubber doCallRealMethod()

Use doCallRealMethod() when you want to call the real implementation of a method.

See also javadoc [`spy(Object)`][spy_Object] to find out more about partial mocks. **Mockito.spy() is a recommended way of creating partial mocks.** The reason is it guarantees real methods are called against correctly constructed object because you're responsible for constructing the object passed to spy() method.

Example:

Foo mock = mock(Foo.class);
       doCallRealMethod().when(mock).someVoidMethod();
    
       // this will call the real implementation of Foo.someVoidMethod()
       mock.someVoidMethod();

See examples in javadoc for [`Mockito`][Mockito] class

**Returns:**

stubber - to select a method for stubbing

--------------------

### doAnswer ###

public static Stubber doAnswer(Answer answer)

Use doAnswer() when you want to stub a void method with generic  [`Answer`][Answer].

Stubbing voids requires different approach from [`when(Object)`][when_Object] because the compiler does not like void methods inside brackets...

Example:

doAnswer(new Answer() {
          public Object answer(InvocationOnMock invocation) {
              Object[] args = invocation.getArguments();
              Mock mock = invocation.getMock();
              return null;
          }})
      .when(mock).someMethod();

See examples in javadoc for [`Mockito`][Mockito] class

**Parameters:**

`answer` - to answer when the stubbed method is called

**Returns:**

stubber - to select a method for stubbing

--------------------

### doNothing ###

public static Stubber doNothing()

Use doNothing() for setting void methods to do nothing.  **Beware that void methods on mocks do nothing by default!** However, there are rare situations when doNothing() comes handy:

1. Stubbing consecutive calls on a void method:

doNothing().
       doThrow(new RuntimeException())
       .when(mock).someVoidMethod();
       
       //does nothing the first time:
       mock.someVoidMethod();
       
       //throws RuntimeException the next time:
       mock.someVoidMethod();

2. When you spy real objects and you want the void method to do nothing:

List list = new LinkedList();
       List spy = spy(list);
       
       //let's make clear() do nothing
       doNothing().when(spy).clear();
       
       spy.add("one");
       
       //clear() does nothing, so the list still contains "one"
       spy.clear();

See examples in javadoc for [`Mockito`][Mockito] class

**Returns:**

stubber - to select a method for stubbing

--------------------

### doReturn ###

public static Stubber doReturn(java.lang.Object toBeReturned)

Use doReturn() in those rare occasions when you cannot use  [`when(Object)`][when_Object].

**Beware that [`when(Object)`][when_Object] is always recommended for stubbing because it is argument type-safe and more readable** (especially when stubbing consecutive calls).

Here are those rare occasions when doReturn() comes handy:

1. When spying real objects and calling real methods on a spy brings side effects

2. Overriding a previous exception-stubbing:

when(mock.foo()).thenThrow(new RuntimeException());
       
       //Impossible: the exception-stubbed foo() method is called so RuntimeException is thrown. 
       when(mock.foo()).thenReturn("bar");
       
       //You have to use doReturn() for stubbing:
       doReturn("bar").when(mock).foo();

Above scenarios shows a tradeoff of Mockito's ellegant syntax. Note that the scenarios are very rare, though. Spying should be sporadic and overriding exception-stubbing is very rare. Not to mention that in general overridding stubbing is a potential code smell that points out too much stubbing.

See examples in javadoc for [`Mockito`][Mockito] class

**Parameters:**

`toBeReturned` - to be returned when the stubbed method is called

**Returns:**

stubber - to select a method for stubbing

--------------------

### inOrder ###

public static InOrder inOrder(java.lang.Object... mocks)

Creates InOrder object that allows verifying mocks in order.

InOrder inOrder = inOrder(firstMock, secondMock);
       
       inOrder.verify(firstMock).add("was called first");
       inOrder.verify(secondMock).add("was called second");

Verification in order is flexible -  **you don't have to verify all interactions** one-by-one but only those that you are interested in testing in order.

Also, you can create InOrder object passing only mocks that are relevant for in-order verification.

InOrder verification is 'greedy'. You will hardly every notice it but if you want to find out more search for 'greedy' on the Mockito [wiki pages][].

As of Mockito 1.8.4 you can verifyNoMoreInvocations() in order-sensitive way. Read more: [`InOrder.verifyNoMoreInteractions()`][InOrder.verifyNoMoreInteractions]

See examples in javadoc for [`Mockito`][Mockito] class

**Parameters:**

`mocks` - to be verified in order

**Returns:**

InOrder object to be used to verify in order

--------------------

### times ###

public static VerificationMode times(int wantedNumberOfInvocations)

Allows verifying exact number of invocations. E.g:

verify(mock, times(2)).someMethod("some arg");

See examples in javadoc for  [`Mockito`][Mockito] class

**Parameters:**

`wantedNumberOfInvocations` - wanted number of invocations

**Returns:**

verification mode

--------------------

### never ###

public static VerificationMode never()

Alias to times(0), see  [`times(int)`][times_int]

Verifies that interaction did not happen. E.g:

verify(mock, never()).someMethod();

If you want to verify there were NO interactions with the mock check out [`verifyZeroInteractions(Object...)`][verifyZeroInteractions_Object...] or [`verifyNoMoreInteractions(Object...)`][verifyNoMoreInteractions_Object...]

See examples in javadoc for [`Mockito`][Mockito] class

**Returns:**

verification mode

--------------------

### atLeastOnce ###

public static VerificationMode atLeastOnce()

Allows at-least-once verification. E.g:

verify(mock, atLeastOnce()).someMethod("some arg");

Alias to atLeast(1)

See examples in javadoc for [`Mockito`][Mockito] class

**Returns:**

verification mode

--------------------

### atLeast ###

public static VerificationMode atLeast(int minNumberOfInvocations)

Allows at-least-x verification. E.g:

verify(mock, atLeast(3)).someMethod("some arg");

See examples in javadoc for  [`Mockito`][Mockito] class

**Parameters:**

`minNumberOfInvocations` - minimum number of invocations

**Returns:**

verification mode

--------------------

### atMost ###

public static VerificationMode atMost(int maxNumberOfInvocations)

Allows at-most-x verification. E.g:

verify(mock, atMost(3)).someMethod("some arg");

See examples in javadoc for  [`Mockito`][Mockito] class

**Parameters:**

`maxNumberOfInvocations` - max number of invocations

**Returns:**

verification mode

--------------------

### only ###

public static VerificationMode only()

Allows checking if given method was the only one invoked. E.g:

verify(mock, only()).someMethod();
       //above is a shorthand for following 2 lines of code:
       verify(mock).someMethod();
       verifyNoMoreInvocations(mock);

See also [`verifyNoMoreInteractions(Object...)`][verifyNoMoreInteractions_Object...]

See examples in javadoc for [`Mockito`][Mockito] class

**Returns:**

verification mode

--------------------

### timeout ###

public static VerificationWithTimeout timeout(int millis)

Allows verifying with timeout. May be useful for testing in concurrent conditions.

It feels this feature should be used rarely - figure out a better way of testing your multi-threaded system

Not yet implemented to work with InOrder verification.

See examples in javadoc for  [`Mockito`][Mockito] class

**Parameters:**

`millis` - - time span in millis

**Returns:**

verification mode

--------------------

### validateMockitoUsage ###

public static void validateMockitoUsage()

First of all, in case of any trouble, I encourage you to read the Mockito FAQ:  [http://code.google.com/p/mockito/wiki/FAQ][here 3]

In case of questions you may also post to mockito mailing list: [http://groups.google.com/group/mockito][http_groups.google.com_group_mockito]

validateMockitoUsage() **explicitly validates** the framework state to detect invalid use of Mockito. However, this feature is optional **because Mockito validates the usage all the time...** but there is a gotcha so read on.

Examples of incorrect use:

//Oups, someone forgot thenReturn() part:
     when(mock.get());
     
     //Oups, someone put the verified method call inside verify() where it should be outside:
     verify(mock.execute());
     
     //Oups, someone has used EasyMock for too long and forgot to specify the method to verify:
     verify(mock);

Mockito throws exceptions if you misuse it so that you know if your tests are written correctly. The gotcha is that Mockito does the validation  **next time** you use the framework (e.g. next time you verify, stub, call mock etc.). But even though the exception might be thrown in the next test, the exception  **message contains a navigable stack trace element** with location of the defect. Hence you can click and find the place where Mockito was misused.

Sometimes though, you might want to validate the framework usage explicitly. For example, one of the users wanted to put validateMockitoUsage() in his @After method so that he knows immediately when he misused Mockito. Without it, he would have known about it not sooner than **next time** he used the framework. One more benefit of having validateMockitoUsage() in @After is that jUnit runner will always fail in the test method with defect whereas ordinary 'next-time' validation might fail the **next** test method. But even though JUnit might report next test as red, don't worry about it and just click at navigable stack trace element in the exception message to instantly locate the place where you misused mockito.

**Built-in runner: [`MockitoJUnitRunner`][MockitoJUnitRunner]** does validateMockitoUsage() after each test method.

Bear in mind that **usually you don't have to validateMockitoUsage()** and framework validation triggered on next-time basis should be just enough, mainly because of enhanced exception message with clickable location of defect. However, I would recommend validateMockitoUsage() if you already have sufficient test infrastructure (like your own runner or base class for all tests) because adding a special action to @After has zero cost.

See examples in javadoc for [`Mockito`][Mockito] class

--------------------

### withSettings ###

public static MockSettings withSettings()

Allows mock creation with additional mock settings.

Don't use it too often. Consider writing simple tests that use simple mocks. Repeat after me: simple tests push simple, KISSy, readable & maintainable code. If you cannot write a test in a simple way - refactor the code under test.

Examples of mock settings:

//Creates mock with different default answer & name
       Foo mock = mock(Foo.class, withSettings()
           .defaultAnswer(RETURNS_SMART_NULLS)
           .name("cool mockie"));
           
       //Creates mock with different default answer, descriptive name and extra interfaces
       Foo mock = mock(Foo.class, withSettings()
           .defaultAnswer(RETURNS_SMART_NULLS)
           .name("cool mockie")
           .extraInterfaces(Bar.class));

[`MockSettings`][MockSettings] has been introduced for two reasons. Firstly, to make it easy to add another mock settings when the demand comes. Secondly, to enable combining different mock settings without introducing zillions of overloaded mock() methods.

See javadoc for [`MockSettings`][MockSettings] to learn about possible mock settings.

**Returns:**

mock settings instance with defaults.

--------------------

转载于:https://www.cnblogs.com/james1207/p/3301671.html

[extended by]: http://docs.mockito.googlecode.com/hg/resources/inherit.gif
[BDDMockito]: http://docs.mockito.googlecode.com/hg/org/mockito/BDDMockito.html
[logo.jpg]: http://docs.mockito.googlecode.com/hg/org/mockito/logo.jpg
[http_mockito.org]: http://mockito.org/
[1. Let_s verify some behaviour]: http://docs.mockito.googlecode.com/hg/org/mockito/Mockito.html#1
[2. How about some stubbing]: http://docs.mockito.googlecode.com/hg/org/mockito/Mockito.html#2
[3. Argument matchers]: http://docs.mockito.googlecode.com/hg/org/mockito/Mockito.html#3
[4. Verifying exact number of invocations _ at least once _ never]: http://docs.mockito.googlecode.com/hg/org/mockito/Mockito.html#4
[5. Stubbing void methods with exceptions]: http://docs.mockito.googlecode.com/hg/org/mockito/Mockito.html#5
[6. Verification in order]: http://docs.mockito.googlecode.com/hg/org/mockito/Mockito.html#6
[7. Making sure interaction_s_ never happened on mock]: http://docs.mockito.googlecode.com/hg/org/mockito/Mockito.html#7
[8. Finding redundant invocations]: http://docs.mockito.googlecode.com/hg/org/mockito/Mockito.html#8
[9. Shorthand for mocks creation - _Mock annotation]: http://docs.mockito.googlecode.com/hg/org/mockito/Mockito.html#9
[10. Stubbing consecutive calls _iterator-style stubbing]: http://docs.mockito.googlecode.com/hg/org/mockito/Mockito.html#10
[11. Stubbing with callbacks]: http://docs.mockito.googlecode.com/hg/org/mockito/Mockito.html#11
[12. doThrow_doAnswer_doNothing_doReturn_ family of methods mostly for stubbing voids]: http://docs.mockito.googlecode.com/hg/org/mockito/Mockito.html#12
[13. Spying on real objects]: http://docs.mockito.googlecode.com/hg/org/mockito/Mockito.html#13
[14. Changing default return values of unstubbed invocations _Since 1.7]: http://docs.mockito.googlecode.com/hg/org/mockito/Mockito.html#14
[15. Capturing arguments for further assertions _Since 1.8.0]: http://docs.mockito.googlecode.com/hg/org/mockito/Mockito.html#15
[16. Real partial mocks _Since 1.8.0]: http://docs.mockito.googlecode.com/hg/org/mockito/Mockito.html#16
[17. Resetting mocks _Since 1.8.0]: http://docs.mockito.googlecode.com/hg/org/mockito/Mockito.html#17
[18. Troubleshooting _ validating framework usage _Since 1.8.0]: http://docs.mockito.googlecode.com/hg/org/mockito/Mockito.html#18
[19. Aliases for behavior driven development _Since 1.8.0]: http://docs.mockito.googlecode.com/hg/org/mockito/Mockito.html#19
[20. Serializable mocks _Since 1.8.1]: http://docs.mockito.googlecode.com/hg/org/mockito/Mockito.html#20
[21. New annotations_ _Captor_ _Spy_ _InjectMocks _Since 1.8.3]: http://docs.mockito.googlecode.com/hg/org/mockito/Mockito.html#21
[22. _New_ Verification with timeout _Since 1.8.5]: http://docs.mockito.googlecode.com/hg/org/mockito/Mockito.html#22
[Click here to see]: http://docs.mockito.googlecode.com/hg/org/mockito/Matchers.html
[ArgumentMatcher]: http://docs.mockito.googlecode.com/hg/org/mockito/ArgumentMatcher.html
[ArgumentCaptor]: http://docs.mockito.googlecode.com/hg/org/mockito/ArgumentCaptor.html
[stubVoid_Object]: http://docs.mockito.googlecode.com/hg/org/mockito/Mockito.html#stubVoid%28T%29
[doThrow_Throwable]: http://docs.mockito.googlecode.com/hg/org/mockito/Mockito.html#doThrow%28java.lang.Throwable%29
[doAnswer_Answer]: http://docs.mockito.googlecode.com/hg/org/mockito/Mockito.html#doAnswer%28org.mockito.stubbing.Answer%29
[here]: http://monkeyisland.pl/2008/07/12/should-i-worry-about-the-unexpected/
[never]: http://docs.mockito.googlecode.com/hg/org/mockito/Mockito.html#never%28%29
[MockitoJUnitRunner]: http://docs.mockito.googlecode.com/hg/org/mockito/runners/MockitoJUnitRunner.html
[MockitoAnnotations]: http://docs.mockito.googlecode.com/hg/org/mockito/MockitoAnnotations.html
[Answer]: http://docs.mockito.googlecode.com/hg/org/mockito/stubbing/Answer.html
[when_Object]: http://docs.mockito.googlecode.com/hg/org/mockito/Mockito.html#when%28T%29
[doNothing]: http://docs.mockito.googlecode.com/hg/org/mockito/Mockito.html#doNothing%28%29
[doReturn_Object]: http://docs.mockito.googlecode.com/hg/org/mockito/Mockito.html#doReturn%28java.lang.Object%29
[here 1]: http://monkeyisland.pl/2009/01/13/subclass-and-override-vs-partial-mocking-vs-refactoring
[RETURNS_SMART_NULLS]: http://docs.mockito.googlecode.com/hg/org/mockito/Mockito.html#RETURNS_SMART_NULLS
[spy_Object]: http://docs.mockito.googlecode.com/hg/org/mockito/Mockito.html#spy%28T%29
[here 2]: http://code.google.com/p/mockito/issues/detail?id=55
[here 3]: http://code.google.com/p/mockito/wiki/FAQ
[http_groups.google.com_group_mockito]: http://groups.google.com/group/mockito
[validateMockitoUsage]: http://docs.mockito.googlecode.com/hg/org/mockito/Mockito.html#validateMockitoUsage%28%29
[http_en.wikipedia.org_wiki_Behavior_Driven_Development]: http://en.wikipedia.org/wiki/Behavior_Driven_Development
[BDDMockito.given_Object]: http://docs.mockito.googlecode.com/hg/org/mockito/BDDMockito.html#given%28T%29
[MockSettings.serializable]: http://docs.mockito.googlecode.com/hg/org/mockito/MockSettings.html#serializable%28%29
[serialization requirements]: http://java.sun.com/j2se/1.5.0/docs/api/java/io/Serializable.html
[Captor]: http://docs.mockito.googlecode.com/hg/org/mockito/Captor.html
[Spy]: http://docs.mockito.googlecode.com/hg/org/mockito/Spy.html
[InjectMocks]: http://docs.mockito.googlecode.com/hg/org/mockito/InjectMocks.html
[MockitoAnnotations.initMocks_Object]: http://docs.mockito.googlecode.com/hg/org/mockito/MockitoAnnotations.html#initMocks%28java.lang.Object%29
[ReturnsEmptyValues]: http://docs.mockito.googlecode.com/hg/org/mockito/internal/stubbing/defaultanswers/ReturnsEmptyValues.html
[mock_Class_ Answer]: http://docs.mockito.googlecode.com/hg/org/mockito/Mockito.html#mock%28java.lang.Class,%20org.mockito.stubbing.Answer%29
[ReturnsMoreEmptyValues]: http://docs.mockito.googlecode.com/hg/org/mockito/internal/stubbing/defaultanswers/ReturnsMoreEmptyValues.html
[Mockito]: http://docs.mockito.googlecode.com/hg/org/mockito/Mockito.html
[Read more.]: http://docs.mockito.googlecode.com/hg/org/mockito/Mock.html
[MockSettings]: http://docs.mockito.googlecode.com/hg/org/mockito/MockSettings.html
[withSettings]: http://docs.mockito.googlecode.com/hg/org/mockito/Mockito.html#withSettings%28%29
[here 4]: http://monkeyisland.pl/2008/04/26/asking-and-telling
[stub_Object]: http://docs.mockito.googlecode.com/hg/org/mockito/Mockito.html#stub%28T%29
[wiki pages]: http://code.google.com/p/mockito/w/list
[InOrder.verifyNoMoreInteractions]: http://docs.mockito.googlecode.com/hg/org/mockito/InOrder.html#verifyNoMoreInteractions%28%29
[times_int]: http://docs.mockito.googlecode.com/hg/org/mockito/Mockito.html#times%28int%29
[verifyZeroInteractions_Object...]: http://docs.mockito.googlecode.com/hg/org/mockito/Mockito.html#verifyZeroInteractions%28java.lang.Object...%29
[verifyNoMoreInteractions_Object...]: http://docs.mockito.googlecode.com/hg/org/mockito/Mockito.html#verifyNoMoreInteractions%28java.lang.Object...%29