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

        在完成了数据访问层的单元之后,接下来看如何编写服务层(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);
    }
}


      其实服务层的测试并没有太多的新东西,而最关键的问题是如何把逻辑中各个分支都能测试到,使测试真正起到为软件质量保驾护航的作用。

 

 

posted @ 2013-07-24 19:49  xinyuyuanm  阅读(364)  评论(0编辑  收藏  举报