接口测试文档

需求内容：
功能描述：店铺会有很多的评价，评价分两种类型，好评，差评，根据店铺的没个评价，确定这个店铺有多少个星。

具体的要求是
1. 评价分好评，差评
2. 连续5个好评可以转换为1个星，有一个差评，减少1个星
3. 最多有5个星
4. 初始星为0，最少有0个星
接口设计：
public interface IStoreService {
/**
*根据店铺Id，得到店铺的星数
*@param storeId店铺id
*@return店铺星数
*/
publicint getSotreStar(String storeId);}
分析过程：
从需求角度分析，需要测试的点包括：
1.店铺没有评价
2.店铺全部差评
3.店铺全部好评
4.店铺有差评，有好评
5.点评评价数小于5个
6.店铺评价中，连续好评不够5个
7.根据星计算规则，店铺所得星号大于5个
具体实现：
privateint getStar(List<PingJia> pingJiaList) {
if(pingJiaList ==null) {
System.out.println("评价列表不能为null");
return0;
}
int star = 0;
int pingJiaCount = pingJiaList.size();
if(pingJiaCount < 5) {
return star;
}
int goodPing = 0;
for(int i = 0; i < pingJiaCount; i++) {
if(pingJiaList.get(i).getPingJiaType() == PingType.goodPing) {
goodPing++;
if(goodPing == 5) {
star++;
goodPing = 0;
}
}else{
goodPing = 0;
if(star > 0) {
star -= 1;
}
}
}
if(star > 5) {
star = 5;
}
return star;
}
用例设计
略
测试过程：
1. 分析需求，找出被测需求测试点：
2. 分析测试点，通过测试用例设计方法，准备测试数据，添加期望结果，提炼测试点为可执行测试用例
常用测试用例设计方法：
1. 边界值
2. 等价类
3. 场景法
4. 错误推测法
5. 针对参数测试
3. 根据测试用例，准备测试数据
4. 编写测试代码，调用被测代码，执行测试，断言测试结果
测试注意点
1. 代码测试依赖的是需求，而不是开发的代码
2. 代码测试的测试用例和功能测试用例类似，增加关于传入参数的验证
在接口测试培训系列1中，描述了针对一个需求的实现方法，及对这个需求方法接口测试用例的设计，在本篇中，在该需求的基础上再增加需求，同时将需求扩展为一个小的项目，讲解针对项目的接口测试如何去做。

需求描述：
1. 增加店铺对象，评价属于店铺
2. 可以针对店铺增加评价，删除评价，修改评价
3. 根据店铺id获得店铺的星
4. 根据店铺id获得店铺的好评率
5. 根据店铺id获得店铺在所有店铺当中的排序，排序算法是：星越多排序越靠前，如果星相等，则根据好评率排序，好评率越高，排序越靠前，如果好评率相等，则评价越多越靠前，如果评价数相等，则默认当前店铺排名靠前。

实现思路：
1. 建立一个店铺类，具有店铺名称，店铺ID两个属性
2. 建立一个评价类，具有所属店铺id，评价类型，更新时间属性
3. 增加一个店铺操作类，具有增加评价，删除评价，修改评价，获取店铺星，获取店铺好评，获取店铺排序的方法
4. 建立一个数据库，里面有两张表，一张店铺表，一张评价表
5. 店铺表字段：店铺id，店铺名称
6. 评价表字段：所属店铺id，评价类型，更新时间
分层开发
1.DAO层：具体的对数据库的操作
publicinterface IPingJiaDao {
//插入一条记录
publicboolean insert(PingJia pingJia);
//修改评价记录
publicboolean update(PingJia pingJia);
//删除评价记录
publicboolean delete(String pingJiaId);
//得到一个店铺的评价列表
public List<PingJia> getPingJiaList(String storeId);
//得到一个店铺的好评率
publicdouble getGoodPingJiaRate(String storeId);
}
2.Service层：具体的业务逻辑层
publicinterface IStoreService {
//添加评价，
publicboolean addPingJia(PingJia pingJia);
//修改评价类型
publicboolean updatePingJia(PingJia pingJia);
//删除评价
publicboolean deletePingJia(String pingjiaId);
//根据店铺Id，得到店铺的星数
publicint getSotreStar(String storeId);
//得到店铺排序位置
publicint getStoreIndex(String storeId);
//得到店铺好评率
publicdouble getStoreGoodRate(String storeId);
}
代码实现
1.DAO实现，使用ibatis进行dao的实现
2.Service实现，数据插入，更新，获取，直接通过调用dao
方法实现，业务逻辑在service中实现
可测试接口方法
1.添加评价boolean addPingJia(PingJia pingJia)
2.更新评价boolean updatePingJia(PingJia pingJia);
3.删除评价boolean deletePingJia(String pingjiaId)
4.获得店铺星数int getSotreStar(String storeId)
5.得到店铺排序位置getStoreIndex(String storeId)
6.得到店铺好评率int getStoreHaoPingLv(String storeId); 接口测试过程
1.@BeforeClass注解中，做初始化相关的操作，比如需要创建
服务实例：storeService = new StoreService();
2.@Test注解中，编写具体的测试用例，编写测试用例时可用
的一些技巧：
a.通过不同的接口方法参数来实现对不同业务场景的
覆盖
b.接口参数如果是基本数据类型，比如String，则需
要考虑该参数是做什么用的，是否需要在调用被
测方法之前准备相应的数据，比如，获得店铺星
数，getSotreStar(String storeId)需要的参数
是String类型的storeId，我们在测试的时候，
在调用被测方法之前，就需要先为这个storeId
对应的店铺构造评价，来满足对应的测试用例。

c. 接口参数如果是对象类型，则需要考虑是否可
以通过独立的方法来提取设置对象属性过程，而将不
同对象属性值通过方法参数传递，而如果对象属性过
多，则可以考虑将部分对象属性构造为另外的一个对
象
d.调用被测方法后，需要根据被测方法返回值，断言
被测方法是否返回期望结果，同时需要通过数据库验
证
e.如果一个测试用例中，涉及到多个步骤的验证，则
需要在每个步骤后增加对应的验证方法。

f.在测试用例中，针对该测试产生的数据，需要进行
销毁。

3. @AfterClass注解中，增加对数据清理及对象销毁相应的方法
4. 关于数据库比对：可以将数据库操作，比对的方法专门提取为一个公共类。