一、背景描述
在版本开发中,时间段大致的划分为:需求,开发,测试;
需求阶段:理解需求做好接口设计;
开发阶段:完成功能开发和对接;
测试上线:自测,提测,修复,上线;
实际上开发阶段两个核心的工作,开发和流程自测,自测的根本目的是为自己提前解决可能出现的问题;如果缺少自测和提测两个关键步骤,那么问题就会被传递给更多的用户,产生更多的资源消耗;
自测是于开发而言,提测是对专业的测试人员而言,如果尽可能在自测阶段就发现问题,并解决问题,那么一个问题就不会影响到团队协作上的更多人员,如果一个简单的问题上升到团队协作层面,很可能会导致问题本身被放大。
工欲善其事必先利其器,开发如果要做好自测流程,学会使用工具提高效率是十分关键的,自测的关键在于发现问题和解决问题,所以选择好用和高效的工具可以极大的降低自测的时间消耗。
下面围绕几个自己开发过程中常用的测试工具和手段,做简单的总结,不在于对比方式的好坏,存在即合理,在不同场景中对合理手段的选择,快速解决问题才是根本目的。
二、PostMan工具
PostMan很常用的接口测试工具,开发过程中快速测试接口,功能强大并且简单方便,不但可以单个接口测试,也可以对接口分块管理批量运行:
整体来说工具比较好用,适应于开发阶段的接口快速测试,或者在解决问题的过程中单个接口的测试,同时对测试游戏参数有存储和记忆能力,这也是受欢迎的一大原因。
但是该工具不适应于复杂的流程化测试,例如需要根据上次接口的响应报文做分别处理,或者下次请求需要填充某个接口响应的数据。
三、Swagger文档
Swagger管理接口文档,是当下服务中很常用的组件,通过对接口和对象的简单注释,快速生成接口描述信息,并且可以对接口发送请求,协助调试,该文档在前后端联调中极大的提高效率。
接口文档的管理本身是一件麻烦事,接口通常会根据业务不断的调整,如果单独维护一份接口文档,需要付出很多时间成本,并且容易出问题,利用swagger就可以避免这个问题。
借助swagger注解标记对象
@TableName("jt_activity")@ApiModel(value="活动PO对象", description="活动信息表【jt_activity】")public class Activity { @ApiModelProperty(value = "主键ID") @TableId(type = IdType.AUTO) private Integer id; @ApiModelProperty(value = "活动主题") private String activityTitle; @ApiModelProperty(value = "联系号码") private String contactPhone; @ApiModelProperty(value = "1线上、2线下") private Integer isOnline; @ApiModelProperty(value = "举办地址") private String address; @ApiModelProperty(value = "主办单位") private String organizer; @ApiModelProperty(value = "创建时间") private Date createTime;}
1.
借助swagger注解标记接口
@Api(tags = "活动主体接口")@RestControllerpublic class ActivityWeb { @Resource private ActivityService activityService ; @ApiOperation("新增活动") @PostMapping("/activity") public Integer save (@RequestBody Activity activity){ activityService.save(activity) ; return activity.getId() ; } @ApiOperation("主键查询") @GetMapping("/activity/{id}") public Activity getById (@PathVariable("id") Integer id){ return activityService.getById(id) ; } @ApiOperation("修改活动") @PutMapping("/activity") public Boolean updateById (@RequestBody Activity activity){ return activityService.updateById(activity) ; }}
1.
通常来说,基于swagger注解标记接口类和方法上的入参和关键返参对象www.sangpi.com即可,这样可以避免再单独维护接口文档。
Swagger接口文档在开发的过程中更多是扮演文档的角色,真正使用swagger去调试的接口也常是一些增删改查的简单接口,这个工具也同样不适应于复杂流程的测试。
四、TestRestTemplate类
SpringBoot测试包中集成的测试API,需要依赖测试包,可以访问控制层接口,非常方便的完成交互过程:
Jar包依赖
<dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-test</artifactId> <scope>test</scope></dependency>
1.
使用案例
@RunWith(SpringRunner.class)@SpringBootTest(webEnvironment = SpringBootTest.WebEnvironment.RANDOM_PORT)public class ActivityTest01 { protected static Logger logger = LoggerFactory.getLogger(ActivityTest01.class) ; @Resource private TestRestTemplate restTemplate; private Activity activity = null ; @Before public void before (){ activity = restTemplate.getForObject("/activity/{id}", Activity.class,1); logger.info("\n"+JSONUtil.toJsonPrettyStr(activity)); } @Test public void updateById (){ if (activity != null){ activity.setCreateTime(new Date()); activity.setOrganizer("One商家"); restTemplate.put("/activity",activity); } } @After public void after (){ activity = restTemplate.getForObject("/activity/{id}", Activity.class,1); logger.info("\n"+JSONUtil.toJsonPrettyStr(activity)); activity = null ; }}
1.
在TestRestTemplate源码中可以发现,基于RestTemplate做封装,很多功能的实现都是调用RestTemplate方法。
用写代码的方式去实现接口测试,灵活度非常高,可以根据流程做定制开发,很适应于中等复杂的场景测试,这里为什么这样描述,下面对比Http请求再细说。
五、Http请求模式
通过模拟接口的Http请求实现的方式,目前来说个人感觉灵活的最高的方式,先看简单的案例:
@RunWith(SpringRunner.class)@SpringBootTest(webEnvironment = SpringBootTest.WebEnvironment.DEFINED_PORT)public class ActivityTest03 { protected static Logger logger = LoggerFactory.getLogger(ActivityTest03.class) ; protected static String REQ_URL = "服务地址+端口"; @Test public void testHttp (){ // 查询 String getRes = HttpUtil.get(REQ_URL+"activity/1"); logger.info("\n {} ",JSONUtil.toJsonPrettyStr(getRes)); Activity activity = JSONUtil.toBean(getRes, Activity.class) ; // 新增 activity.setId(null); activity.setOrganizer("Http商家"); String saveRes = HttpUtil.post(REQ_URL+"/activity",JSONUtil.toJsonStr(activity)); logger.info("\n {} ",saveRes); // 更新 activity.setId(Integer.parseInt(saveRes)); activity.setOrganizer("Put商家"); String putRes = HttpRequest.put(REQ_URL+"/activity") .body(JSONUtil.toJsonStr(activity)).execute().body(); logger.info("\n {} ",putRes); }}
1.
这种方式对于复杂的业务流程来说非常好用,当然这里不排除个人习惯,在测试复杂流程的时候,一个简单方案:
用户信息:模拟http中token数据;
业务流程:通过数据获取包装参数模型;
独立服务管理,模拟并发场景;
根据执行过程生成分析数据结果;
对于复杂业务流程的测试,每个节点的模拟都具有一定的难度,通常在完整的流程中涉及到的服务和库表都是多个,并且请求链路复杂,基于一个灵活的自动化流程,去测试完整的链路,可以对效率有极大的提升。
六、Service层测试
针对服务层的测试手段,其本意在于业务实现的逻辑测试:
@RunWith(SpringRunner.class)@SpringBootTest(classes = Application.class)public class ActivityTest04 { protected static Logger logger = LoggerFactory.getLogger(ActivityTest04.class) ; @Autowired private ActivityService activityService ; @Test public void testService (){ // 查询 Activity activity = activityService.getById(1) ; // 新增 activity.setId(null); activityService.save(activity) ; // 修改 activity.setOrganizer("Ser商家"); activityService.updateById(activity) ; // 删除 activityService.removeById(activity.getId()) ; }}
1.
该测试在实际的开发过程也并不常用,偶尔在于某个业务方法实现难度很大,用来针对性测试。
七、MockMvc方式
MockMvc同样是SpringBoot集成测试包提供的测试方式,通过对象的模拟,验证接口是否符合预期:
@AutoConfigureMockMvc@RunWith(SpringRunner.class)@SpringBootTest(webEnvironment = SpringBootTest.WebEnvironment.MOCK)public class ActivityTest02 { protected static Logger logger = LoggerFactory.getLogger(ActivityTest02.class) ; @Resource private MockMvc mockMvc ; private Activity activity = null ; @Before public void before () throws Exception { ResultActions resultAction = mockMvc.perform(MockMvcRequestBuilders.get("/activity/{id}",1)) ; MvcResult mvcResult = resultAction.andReturn() ; String result = mvcResult.getResponse().getContentAsString(); activity = JSONUtil.toBean(result,Activity.class) ; } @Test public void updateById () throws Exception { activity.setId(null); activity.setCreateTime(new Date()); activity.setOrganizer("One商家"); ResultActions resultAction = mockMvc.perform(MockMvcRequestBuilders.post("/activity") .contentType(MediaType.APPLICATION_JSON) .content(JSONUtil.toJsonStr(activity))) ; MvcResult mvcResult = resultAction.andReturn() ; String result = mvcResult.getResponse().getContentAsString(); activity.setId(Integer.parseInt(result)); logger.info("result : {} ",result); } @After public void after () throws Exception { activity.setCreateTime(new Date()); activity.setOrganizer("Update商家"); ResultActions resultAction = mockMvc.perform(MockMvcRequestBuilders.put("/activity") .contentType(MediaType.APPLICATION_JSON) .content(JSONUtil.toJsonStr(activity))) ; MvcResult mvcResult = resultAction.andReturn() ; String result = mvcResult.getResponse().getContentAsString(); logger.info("result : {} ",result); }}
1.
对于这种Mock类型的测试,非常专业,通常个人使用极少,暂时没有Get到其精髓思想。
八、Mockito测试
Mock属于非常专业和标准的测试手段,需要依赖powermock包:
<dependency> <groupId>org.powermock</groupId> <artifactId>powermock-core</artifactId> <scope>test</scope></dependency><dependency> <groupId>org.powermock</groupId> <artifactId>powermock-api-mockito2</artifactId> <scope>test</scope></dependency><dependency> <groupId>org.powermock</groupId> <artifactId>powermock-module-junit4</artifactId> <scope>test</scope></dependency>
1.
简单使用案例:
@RunWith(PowerMockRunner.class)@SpringBootTestpublic class ActivityTest05 { @Test public void testMock (){ Set mockSet = PowerMockito.mock(Set.class); PowerMockito.when(mockSet.size()).thenReturn(10); int actual = mockSet.size(); int expected = 15 ; Assert.assertEquals("返回值不符合预期",expected, actual); } @Test public void testTitle (){ String expectTitle = "Mock主题" ; Activity activity = PowerMockito.mock(Activity.class); PowerMockito.when(activity.getMockTitle()).thenReturn(expectTitle); String actualTitle = activity.getMockTitle(); Assert.assertNotEquals("主题相符", expectTitle, actualTitle); }}
1.
可以通过Mock方式,快速模拟出复杂的对象结构,以便构建测试方法,由于使用很少,同样个人暂时没Get到点。