Mock方法时的参数匹配

  在mock方法时，对于方法的参数匹配是有要求的，只有要执行的方法的参数匹配mock方法里面的参数时，该mock方法才会起作用。Powermock提供了很多种参数匹配的方式，比如，如果需要精确地匹配参数，可以使用equal方式；如果需要灵活地匹配参数，可以使用any方式。下面，我们就来简单地介绍下mock方法时的参数匹配。

一、精确匹配

  还是先来看下被测试代码：

public class EmployeeService {
    public Employee findEmployeeByEmail(String email) {
        throw new UnsupportedOperationException();
    }

    public boolean employeeExists(Employee employee) {
        throw new UnsupportedOperationException();
    }
}
public class EmployeeController {
    private EmployeeService employeeService;

    public EmployeeController(EmployeeService employeeService) {
        this.employeeService = employeeService;
    }

    public Employee findEmployeeByEmail(String email) {
        return employeeService.findEmployeeByEmail(email);
    }

    public boolean isEmployeeEmailAlreadyTaken(String email) {
        return employeeService.employeeExists(new Employee(email));
    }
}

  代码很直观，EmployeeController类中定义了两个方法，一个是findEmployeeByEmail，根据email查询员工，调用employeeService.findEmployeeByEmail方法；另一个方法是isEmployeeEmailAlreadyTaken方法，判断某个员工是否存在，调用employeeService.employeeExists方法。
  
  现在看下测试代码：

public class EmployeeControllerTest {
    @Test
    public void testFindEmployeeByEmail() {
        EmployeeService employeeService = PowerMockito.mock(EmployeeService.class);
        Employee employee = new Employee();
        PowerMockito.when(employeeService.findEmployeeByEmail(Mockito.eq("123@abc.com"))).thenReturn(employee);

        EmployeeController employeeController = new EmployeeController(employeeService);

        Assert.assertSame(employee, employeeController.findEmployeeByEmail("123@abc.com"));
        Assert.assertNull(employeeController.findEmployeeByEmail("123@dce.com"));
    }
}

  从上述测试方法可以看到，在模拟employeeService.findEmployeeByEmail方法时使用了eq方法，这个就是精确匹配模式，执行参数完全匹配该参数时，才会返回employee。

二、模糊匹配

  有时候，我们想要在匹配参数时更灵活些，可以使用模糊匹配。看下下面的测试方法：

public class EmployeeControllerTest {
    @Test
    public void testFindEmployeeByEmail() {
        EmployeeService employeeService = PowerMockito.mock(EmployeeService.class);
        Employee employee = new Employee();
        PowerMockito.when(employeeService.findEmployeeByEmail(Mockito.startsWith("123"))).thenReturn(employee);

        EmployeeController employeeController = new EmployeeController(employeeService);

        Assert.assertSame(employee, employeeController.findEmployeeByEmail("123@abc.com"));
        Assert.assertSame(employee, employeeController.findEmployeeByEmail("123@dce.com"));
        Assert.assertNull(employeeService.findEmployeeByEmail("456@abc.com"));
    }
}

  该例中，使用startWith替换了eq，可以看到当参数为"123@abc.com"和"123@456.com"时，都返回了employee，而"456@abc.com"则返回了Null。可见此时参数是匹配任何以"123"开头的字符串，这种用法能够使得参数的匹配相对于eq方式更灵活些。

三、任意匹配

  另外一种参数匹配，即无论入参是什么值，都认为是匹配的。

public class EmployeeControllerTest {
    @Test
    public void testFindEmployeeByEmail() {
        EmployeeService employeeService = PowerMockito.mock(EmployeeService.class);
        Employee employee = new Employee();
        PowerMockito.when(employeeService.findEmployeeByEmail(Mockito.anyString())).thenReturn(employee);

        EmployeeController employeeController = new EmployeeController(employeeService);

        Assert.assertSame(employee, employeeController.findEmployeeByEmail("123@abc.com"));
        Assert.assertSame(employee, employeeController.findEmployeeByEmail("123@dce.com"));
        Assert.assertSame(employee, employeeService.findEmployeeByEmail("456@abc.com"));
    }
}

  此例中，使用了anyString方式，即无论入参是什么字符串，都返回employee。此时可以看出给定的三个字符串，都返回了employee。

四、自定义匹配

  除了使用自带的匹配方式之外，还可以自己定义相应的参数匹配方式。

public class EmployeeControllerTest {
    @Test
    public void testIsEmployeeEmailAlreadyTaken() {
        EmployeeService employeeService = PowerMockito.mock(EmployeeService.class);
        final String email = "123@abc.com";
        PowerMockito.when(employeeService.employeeExists(Mockito.argThat(new ArgumentMatcher<Employee>() {
            @Override
            public boolean matches(Object employee) {
                return ((Employee) employee).getEmail().equals(email);
            }
        }))).thenReturn(true);

        EmployeeController employeeController = new EmployeeController(employeeService);

        Assert.assertTrue(employeeController.isEmployeeEmailAlreadyTaken(email));
    }
}

  这个例子看上去稍微有点复杂。从业务代码可以看出，EmployeeController类的方法isEmployeeEmailAlreadyTaken和EmployeeService类的方法参数并不一样，但是又有所关联，是使用isEmployeeEmailAlreadyTaken的入参构造了一个新的入参。现在，我们要想精确匹配入参，就需要自己实现matcher方法。

  除了上述的一些例子外，Mockito还提供了许多别的参数匹配的方法，比如any、matches、isNull等等。如何使用这些匹配方式，需要根据自己的需求来选择相应的模式实现。另外，上面介绍的参数匹配同样适用于Mockito.verify。

  最后，强调一点，对于多个参数的方法，如果我们其中一个参数使用了参数匹配模式，那么所有的参数都必须使用参数匹配模式，下面的例子中的使用方式就是错误的：

PowerMockito.when(mock.findEmployeeByFirstNameAndLastName("Deep", Mockito.anyString())).thenReturn(null);

  正确的方式为：

PowerMockito.when(mock.findEmployeeByFirstNameAndLastName(Mockito.eq("Deep"), Mockito.anyString())).thenReturn(null);