使用的自動化框架
java + httpclient + log4j + json + mybatis + excel + testng
- excel : API 管理
- httpclient:接口請求
- log4j:腳本log記錄
- json-lib:接口返回數據的解析
- mybatis: 腳本與數據庫的交互
- testng:測試用例管理,斷言
excel
httpclient ( get / post)
/** * get 形式請求API *
* @param uri url 和 對應參數
* @param @key key
* @return 返回相應信息
* @throws java.net.URISyntaxException
* @throws java.io.IOException
*/
public static JSON getAPI(URI uri) throws URISyntaxException, IOException {
CloseableHttpClient httpclient = HttpClients.createDefault();
try {
httpget = new HttpGet(uri);
log.info("執行API請求" + httpget.getRequestLine());
ResponseHandler<String> responseHandler = new ResponseHandler<String>() {
public String handleResponse(final HttpResponse response) throws ClientProtocolException, IOException {
int status = response.getStatusLine().getStatusCode();
if (status >= 200 && status < 300) {
HttpEntity entity = response.getEntity();
return entity != null ? EntityUtils.toString(entity) : null;
} else {
log.error("請求錯誤,狀態碼為:" + response.getStatusLine().getStatusCode());
throw new ClientProtocolException("意外的狀態返回: " + status);
}
}
};
String responseBody = httpclient.execute(httpget, responseHandler);
JSONObject dataObject = JSONObject.fromObject(responseBody.trim());
return dataObject;
} finally {
httpclient.close();
}
}
/** * Post 形式請求API *
* @param uri url 和 對應參數
* @param @key key
* @return 返回相應信息
* @throws java.net.URISyntaxException
* @throws java.io.IOException
*/
public static JSON postAPI(URI uri) throws URISyntaxException, IOException {
CloseableHttpClient httpclient = HttpClients.createDefault();
try {
httpPost = new HttpPost(uri);
log.info("執行API接口請求" + httpPost.getRequestLine());
ResponseHandler<String> responseHandler = new ResponseHandler<String>() {
public String handleResponse(
final HttpResponse response) throws ClientProtocolException, IOException {
int status = response.getStatusLine().getStatusCode();
if (status >= 200 && status < 300) {
HttpEntity entity = response.getEntity();
return entity != null ? EntityUtils.toString(entity) : null;
} else {
throw new ClientProtocolException("意外的狀態返回: " + status);
}
}
};
String responseBody = httpclient.execute(httpPost, responseHandler);
JSONObject dataObject = JSONObject.fromObject(responseBody);
return dataObject;
} finally {
httpclient.close();
}
}
log4g
###set output encoding###
log4j.appender.logfile.encoding=UTF-8
### set log levels ###
log4j.rootLogger = INFO , ERROR ,stdout , logfile
### 控制臺輸出 ###
log4j.appender.stdout=org.apache.log4j.ConsoleAppender
log4j.appender.stdout.Target = System.out
log4j.appender.stdout.layout=org.apache.log4j.PatternLayout
log4j.appender.stdout.layout.ConversionPattern=%-d{yyyy-MM-dd HH:mm:ss} %p %t [%c]%M(line:%L)%m%n
### save error log ###
log4j.appender.ERROR = org.apache.log4j.DailyRollingFileAppender
log4j.appender.ERROR.File = logs/error.log
log4j.appender.ERROR.Append = true
log4j.appender.ERROR.Threshold = ERROR
log4j.appender.ERROR.layout = org.apache.log4j.PatternLayout
log4j.appender.ERROR.layout.ConversionPattern =%-d{yyyy-MM-dd HH:mm:ss} %p %t [%c]%M(line:%L)%m%n
### write in log ###
log4j.appender.logfile = org.apache.log4j.DailyRollingFileAppender
log4j.appender.logfile.File=logs/debug.log
log4j.appender.logfile.Append = true
log4j.appender.logfile.Threshold = DEBUG
log4j.appender.logfile.layout=org.apache.log4j.PatternLayout
log4j.appender.logfile.layout.ConversionPattern=%-d{yyyy-MM-dd HH:mm:ss} %p %t [%c]%M(line:%L)%m%n
mybatis:跟mysql交互
- 根據表名創建各跟表名一樣的類 例如Account_info表如下,并定義跟表結構一樣的字段。
- 新建一個interface(如Account_infoDao) 創建一個方法,參數為mysql語句中你想通過什么查詢的,例如下面我想通過account_id來查詢出Accounts_info表的某行數據
- 實現接口interface(如Account_infoDaoImpl)
- 新建mapper文件(如新建個Accounts_infoMapper.xml文件)
- 在config.xml文件配置上mapper文件路徑,如下Accounts_infoMapper.xml 路徑
- 新建個類,用于接口需要時調用
- 接口需要處使用
public class Accounts_infoTest {
static Accounts_infoDao accountsDao = new Accounts_InfoDaoImpl();
/*** 通過account_id查詢出 accounts_info表數據
* @param account_id 用戶id
* @return account_info 表數據
*/
public static Accounts_Info byAccount_id(String account_id){
Accounts_info a = accountsDao.account_id(account_id);
return a;
}
Accounts_info accounts_info=Accounts_infoTest.byAccount_id(Integer.valueOf(account_id));
int coin_num_sql = accounts_info.getCoin();// 拿到數據庫中 coin_num 字段
返回json解析
- 例1
// 拿到response_status對應的值success
String response_status = jsonObject .getString("response_status");
// 拿到post_enable的值1
String post_enable = json.getJSONObject("info").getJSONObject("data").getJSONObject("priv_option").getString("post_enable");
- 例2 返回的json是一組一組的
// 拿到list下多個組數據
JSONArray jsonArray = json.getJSONObject("info").getJSONObject("data").getJSONArray("list");
// 獲取組數據中第一個數據(數組從0開始)并強制轉成json格式
JSONObject jsonObject = (JSONObject) jsonArray.get(0);
String id = jsonObject.getString("id");// 獲取強制轉成json后的id
創建一個自動化API腳本的步驟
- 從api文檔地址查找到對應api
- 配置對應api的 信息到 excel 表格
- 唯一標示(tid),協議(http),服務器地址與端口,api路徑,api參數(0到多個)
- 新建個跟API 同名的類(例如LoginTest)
- 發起請求
- JSONObject jsonObject = ApiEngine.taquAPI(唯一標識, Parameters.KEY,參數1的值,參數2的值);
- Html例子
- Document document= ApiEngine.XXXAPIHtml(tid, m, a, ticket_id);
- log.info(jsonObject) 輸出jsonObject 便于控制臺查看結果
可能遇到的問題
-
控制臺輸出如下,可能你代碼中的tid唯一標示在excel不存在或者excel編寫后未能保存
-
控制臺輸入如下 可能原因 excel 配置的參數個數和代碼發起請求是給的參數值的個數不一致通常發起請求代碼給的參數個數大于excel配置的個數
錯誤提示 【x】【y】單元格為空,請。。。。 類似問題基本上解決方案是打開excel 找到第X+1 行 第Y+1 列,隨便數據數據,保存,右鍵清空數據