持续集成之路—服务层的单元测试

在完成了数据访问层的单元之后,接下来看如何编写服务层(Service)的单元测试。服务层应该是整个系统中得重中之重,严密的业务逻辑设计保证了系统稳定运行,所以这一层的单元测试也应该占很大比重。虽然一般情况下单元测试应该尽量通过mock剥离依赖,但是由于在当前的项目中数据访问层使用spring-data框架,并没有包含太多的逻辑,因此我就把服务层和数据访问层放在做了一个伪单元测试。
  一、一般逻辑的单元测试。
  这里采用的方式和数据访问层几乎是一样的,主要包含三步:
  1. 通过@DatabaseSetup指定测试用数据集
  2. 执行被测试方法
  3. 通过Dao从数据库中查询数据验证执行结果
  假设要被测试的代码方法是:
@Service
@Transactional(readOnly = true)
public class ShopServiceImpl extends BaseService implements ShopService{
private Logger logger = LoggerFactory.getLogger(ShopServiceImpl.class);
@Transactional(readOnly = false)
public Floor addFloor(String buildingName, int floorNum, String layout) {
//如果已经存在对应的楼层信息,则抛出已经存在的异常信息
Floor floor = floorDao.findByBuildingNameAndFloorNum(buildingName, floorNum);
if (floor != null) {
throw new OnlineShopException(ExceptionCode.Shop_Floor_Existed);
}
//如果不存在对应的商场信息,则添加新的商场
Building building = buildingDao.findByName(buildingName);
if (building == null) {
building = new Building();
building.setName(buildingName);
buildingDao.save(building);
}
//添加并返回楼层信息
floor = new Floor();
floor.setBuilding(building);
floor.setFloorNum(floorNum);
floor.setMap(layout);
floorDao.save(floor);
return floor;
}
}
  其对应的接口是:
  public interface ShopService {
  public Floor addFloor(String buildingName, int floorNum, String layout);
  }

这段逻辑代码的意思十分简单和直白,那么要编写的单元的测试必须要包含所有分支情况:a. 商场和楼层信息都存在的,抛出异常 b. 商场存在,而楼层不存在, 楼层信息都被添加的。 c.  商场和楼层都不存在,全部新增。这里就以第一种情况为例,先准备测试数据:
  <?xml version="1.0" encoding="UTF-8"?>
  <dataset>
  <building id="1" name="New House"/>
  <floor id="1" building="1" floor_num="2"/>
  </dataset>
  接着编写测试用例,注意要必须得注解不能忘掉:
@RunWith(SpringJUnit4ClassRunner.class)
@ContextConfiguration("classpath:applicationContext-test.xml")
@Transactional
@TestExecutionListeners({
DependencyInjectionTestExecutionListener.class,
DirtiesContextTestExecutionListener.class,
CustomTransactionDbUnitTestExecutionListener.class,
ForeignKeyDisabling.class})
public class ShopServiceTest {
@Autowired
private ShopService shopService;
@Test
@DatabaseSetup("shop/ShopService-addFloorExistException-dataset.xml")
public void testAddFloorExistException(){
try {
shopService.addFloor("New House", 2, "");
fail();
} catch(Exception e){
assertTrue(e instanceof OnlineShopException);
assertEquals(ExceptionCode.Shop_Floor_Existed.code(), ((OnlineShopException)e).getCode());
}
}
}
  这个测试和数据访问层的测试看起来没有什么两样。
  二、使用Mock对象隔离第三方接口
  软件开发中一般都存在和第三方集成的情况,比如调用新浪的认证、百度的地图等等。那么在编写测试的时候,基于效率的考虑,一般情况不会真的去调用这些远程API(当然应该有其他测试可以及时发现第三方接口的变化),而是假定它们一直会返回预期的结果。这个时候就需要用到mock对象,来模拟这些API产生相应的结果。
  在这里,我是用了mockito,使用十分方便。假如现在用户登录时,需要去第三方系统验证,那么现在来看如何对这个场景进行测试。还是先来看被测试的方法:
  private boolean validateUser(String inputName, String inputPassword) {
  return thirdPartyAPI.authenticate(inputName, inputPassword);
  }
  其中thirdPartyAPI就是第三方用来认证的API。下面来看测试代码:
public class UserServiceTest {
@Autowired
private UserService userService;
private ThirdPartyAPI mockThirdPartyAPI = mock(ThirdPartyAPI.class);
@Test
public void testLogin(){
//指定mock对象特定操作的返回结果
when(mockThirdPartyAPI.authenticate("jiml", "jiml")).thenReturn(true);
//通过Setter用mock对象替换由Spring初始化的第三方依赖
((UserServiceImpl)userService).setThirdPartyAPI(mockThirdPartyAPI);
boolean loginStatus = userService.login("jiml", "jiml");
assertTrue(loginStatus);
}
}
  其实服务层的测试并没有太多的新东西,而最关键的问题是如何把逻辑中各个分支都能测试到,使测试真正起到为软件质量保驾护航的作用。


最新内容请见作者的GitHub页:http://qaseven.github.io/
上一篇:容器镜像服务 联手 IDE 插件,实现一键部署、持续集成与交付


下一篇:基于容器服务的持续集成与云端交付(一)- 交付之禅