二.HttpClient+testNG实现对接口的测试及校验
在上面第一篇中已经实现了基础配置和测试用例数据准备,本篇文章将以登录举例进行测试执行。
这是之前login接口的代码
@Test(groups = "loginTrue",description = "用户登录接口测试")
public void loginTrue() throws IOException {
SqlSession session = DatabaseUtil.getSqlsession();
LoginCase loginCase = session.selectOne("loginCase",1);
System.out.println(loginCase.toString());
System.out.println(TestConfig.loginUrl);
}
//接下来只需要进行两步:1.发送请求 2.验证返回结果
//第一步发送请求
String result = getResult(loginCase);
//第二步验证返回结果
Assert.assertEquals(loginCase.getExpected(),result);
getResult方法被我抽离出来了放在下面,原因是无论我是登录成功,或者登录失败,等会执行相同的操作,只是测试数据和校验部分会不一样。
这是getResult方法的具体代码:
private String getResult(LoginCase loginCase) throws IOException {
HttpPost post = new HttpPost(TestConfig.loginUrl);
//设置body部分
JSONObject param = new JSONObject();
param.put("userName",loginCase.getUserName());
param.put("password",loginCase.getPassword());
//设置header部分信息
post.setHeader("content-type","application/json");
StringEntity entity = new StringEntity(param.toString(),"utf-8");
post.setEntity(entity);
//测试执行
String result;
HttpResponse response = TestConfig.defaultHttpClient.execute(post);
result = EntityUtils.toString(response.getEntity(),"utf-8");
System.out.println(result);
TestConfig.store = TestConfig.defaultHttpClient.getCookieStore();
return result;
}
获取的结果会返回到result中,然后与mysql中存的预期值loginCase.getExpected()进行对比,如结果一样则测试通过。
三.Mybatis之Mapper接口的开发方式
该方式开发,不需要写dao层的实现类,而是mybatis根据映射文件等信息对接口进行jdk动态代理生成代理类来实现接口中的方法,因此,采用这种方式,我们只需要编辑接口,而不需要去写实现。
这里举一个例子来说明:
3.1.需求分析
根据id查询用户。
3.2.Mapper开发代理规范
1、mapper接口的全限定名要和mapper映射文件的namespace值一致。
2、mapper接口的方法名称要和mapper映射文件的statement,即sql中的id一致。
3、mapper接口的方法参数类型要和mapper映射文件的statement即sql中的parameterType的值一致,而且它的参数是一个。
4、mapper接口的方法返回值类型要和mapper映射文件的statement即sql中的resultType的值一致。
3.3.代码实现
准备po类:
@Data
public class User {
private Integer id;
private String username;
private Date birthday;
private String sex;
private String address;
//getter和setter方法省略,可以通过@Data注解自动添加get和set方法
}
Mapper接口:
public interface UserMapper {
public User findUserById(int id);
}
UserMapper.xml配置文件:
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE mapper
PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN"
"http://mybatis.org/dtd/mybatis-3-mapper.dtd">
<!--
namespace:命名空间,它的作用就是对SQL进行分类化管理,可以理解为SQL隔离
注意:使用mapper代理开发时,namespace有特殊且重要的作用
-->
<configuration>
<typeAliases>
<package name=" com.lc.mybatis.mapper"/>
</typeAliases>
</configuration>
<mapper namespace="UserMapper">
<!-- 根据用户ID查询用户信息 -->
<!-- select:表示一个MappedStatement对象 -->
<!-- id:statement的唯一标识 -->
<!-- #{}:表示一个占位符?-->
<!-- #{id}:里面的id表示输入参数的参数名称,如果该参数为简单类型,那么#{}里面的参数可以任意 -->
<!-- parameterType:输入参数的java类型 -->
<!-- resultType:输出结果的所映射的java类型(单条结果所对应的java类型) -->
<select id="findUserById" parameterType="java.lang.Integer" resultType="com.lc.mybatis.po.User">
SELECT * FROM USER WHERE id = #{id}
</select>
</mapper>
在全局配置文件SqlMapperConfig中添加该映射文件
测试代码:
//或者不使用springboot集成管理mapper,则需要加下面的setUp方法
private SqlSessionFactory sqlSessionFactory ;
@Before
public void setUp() throws IOException {
InputStream inputStream = Resources.getResourceAsStream("SqlMapConfig.xml");
sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);
}
@Test
public void testFindUserById() {
SqlSession sqlSession = sqlSessionFactory.openSession();
//获取UserMapper的代理类
UserMapper userMapper = sqlSession.getMapper(UserMapper.class);
User user = userMapper.findUserById(10);
System.out.println(user);
sqlSession.close();
//使用springboot集成
User user = userMapper.findUserById(10);
System.out.println(user);
}
}
四.jenkins集成httpclient项目并生成在线报告
本章主要讲解项目的业务代码在写完后,如何集成至jenkins实现自动构建执行。
在执行下面的流程之前,需要完成两件事:
1.将项目代码上传至git
2.安装tomcat
实现过程:
1. 新建自由风格项目
2.配置Tomcat并启动
因为jenkins一般是部署在linux上,生成的报告其他用户无法直接查看,tomcat作为一个web中间件,将jenkins生成的报告拷贝至tomcat服务上,用以让其他用户进行查看。
下载完成后,因为tomcat默认的端口号是8080,与jenkins冲突了,所以我们首先在conf文件下的server.xml文件中配置tomcat的默认端口号,将默认的8080修改为可用端口号,在这里我修改为8088,保存后退出。
切换至bin目录下,执行startup.sh文件,启动tomcat。
3.将jenkins生成的测试报告拷贝至tomcat
在jenkins的工程配置部分,shell中添加以下语句
//获取最后一次构建的id
result=$(curl -s http://ip:8080/job/JavaApiTest/lastBuild/buildNumber --user admin:admin)
//tomcat目录下新建文件用以保存测试报告
sudo mkdir /Applications/apache-tomcat-9.0.10/webapps/ROOT/$result
//将jenkins生成的目录拷贝至tomcat内
sudo cp /Users/Shared/Jenkins/test/ApiTest/test-output/index.html /Applications/apache-tomcat-9.0.10/webapps/ROOT/$result/index.html
然后构建项目,执行完,构建成功~
然后访问tomcat:http://ip:8088/65/index.html,可以看到生成的报告
在这里说明一下,为什么要用tomcat。如果不用tomcat,直接访问jenkins生成的报告也是可以的,但是一般jenkins会部署在linux服务器上,无法直接访问或者访问需要权限。tomcat作为一个web中间件,浏览权限是公开的。