Phoenix Framework

phoenixframework是一个支持对webUI，接口，web性能，mobile app或mobile browser进行自动化测试和监控的平台。

平台官网：http://www.cewan.la

环境搭建及使用说明书：http://my.oschina.net/u/2391658/blog/706055

• 集代码管理， 分机（node节点）管理，定时任务，分布式或并发等方式执行通过phoenix_develop模块调试好的用例。

• 平台使用SSH4开发，覆盖了webgui，接口，移动mobile等终端的测试与监控。

• 目前webGUI模块已经完成，兼容chrome，Firefox，IE，httpunit以及phantomjs驱动。

• 平台原生支持对svn，socket，ftpserver服务器的操作。

• 平台通过phoenix_develop模块在客户端开发及调试代码，然后通过将代码托管到phoenix_web控制端，控制端通过指派多个phoenix_node端方式执行测试用例。通过使用phoenix_develop开发用例代码的示例，用例如果在本地调试时没有问题，那么就可以放到控制端进行执行了。

• 【模块介绍】
  phoenix_develop：用例代码开发模块
  phoenix_node：分布式执行node节点
  phoenix_web：平台控制端
  phoenix_webdriver：webGUI自动化测试模块
  phoenix_mobiledriver：移动设备测试模块
  phoenix_interface：接口测试系统
  phoenix_db:数据库操作模块，对hibernate4的封装
  phoenix_ftpclient：ftp服务器操作
  phoenix_svnclient：对svn进行操作
  phoenix_telentclient：对socket服务器进行操作
  phoenix_imgreader：验证码及图片的识别模块
  phoenix_browser：phoenix定制浏览器，用于属性录制
  phoenix_recorder：用于对执行过程录制回放
  phoenix_tcpserver：可独立部署在Windows和Linux，用于特殊场景下的操作。如生成或执行shell 
  phoenix_jbehave：行为驱动支持 
  phoenix_jmeter：基于jmeter定制的专门用于web系统性能测试的模块

• 

• 
  

• Android App自动化测试示例：

• package org.phoenix.cases.android;
  
  import java.util.LinkedList;
  
  import org.openqa.selenium.WebElement;
  import org.phoenix.enums.LocatorType;
  import org.phoenix.model.CaseLogBean;
  import org.phoenix.model.UnitLogBean;
  import org.phoenix.proxy.ActionProxy;
  
  /**
   * android基本操作测试
   * @author mengfeiyang
   *
   */
  public class AndroidBaseTest extends ActionProxy{
  	@Override
  	public LinkedList<UnitLogBean> run(CaseLogBean caseLogBean) {
  		init(caseLogBean);
  		phoenix.androidAPI().openAndroidAppBySelendroidWithEmulator("F:\\baozhanggl.apk");//apk的物理路径
  		WebElement el = phoenix.androidAPI().linkFinder("#TextField1", null);
  		String tagN = el.getTagName();
  		String valN = el.getText();
  		System.out.println("TagName:"+tagN+"    value:"+valN);
  		//webProxy.checkPoint().checkIsNull(tagN);
  		//webProxy.checkPoint().checkIsEqual("Hello", valN);
  		phoenix.androidAPI().element("#TextField2", null).setText("shuruceshi");
  		phoenix.androidAPI().element("#gaoji", null).click();
  		phoenix.androidAPI().element("#chushimima", LocatorType.ID).setText("test123");
  		//根据XPath定位app元素，XPath无需手写，用例编写过程中可通过录制方式获取
  		phoenix.androidAPI().element("(//TextView[@id='text1'])[1]", LocatorType.XPATH).click();
  		phoenix.androidAPI().element("(//CheckedTextView[@id='text1'])[2]", LocatorType.XPATH).click();
  		WebElement v = phoenix.androidAPI().linkFinder("//Button[@id='button1']", LocatorType.XPATH);
  		System.out.println(v.getText());
  		phoenix.checkPoint().checkIsEqual("查询", v.getText());
  		phoenix.androidAPI().element("//Button[@id='button1']", LocatorType.XPATH).click();
  		phoenix.androidAPI().pressKeyByKeyboard("\uE100");//操作Android硬件，本次点击的是返回键
  		phoenix.checkPoint().checkNotNull(phoenix.androidAPI().getSelendroidDriver().getBrightness());
  		phoenix.androidAPI().setBrightness(80);//调整Android屏幕的亮度为80
  		phoenix.androidAPI().setBrightness(40);
  		phoenix.androidAPI().closeSelendroidServer();//关闭本次与Android设备上server的连接
  		
  		return getUnitLog(); 
  	}
  	
  	public static void main(String[] args) {
  		AndroidBaseTest p = new AndroidBaseTest();
  		LinkedList<UnitLogBean> ll = p.run(new CaseLogBean());
  		for(UnitLogBean l : ll){
  			System.out.println(l.getContent());
  		}
  	}
  }

• webUI，mobile browser代码实例：

• package org.phoenix.cases;
  
  import java.util.HashMap;
  import java.util.LinkedList;
  import java.util.Map.Entry;
  
  import org.phoenix.enums.LocatorType;
  import org.phoenix.model.CaseLogBean;
  import org.phoenix.model.InterfaceBatchDataBean;
  import org.phoenix.model.LocatorBean;
  import org.phoenix.model.UnitLogBean;
  import org.phoenix.proxy.ActionProxy;
  
  /**
   * 浏览器驱动测试类:
   * 通用方法API：phoenix.commonAPI()....
   * webUI/mobileUI用例API：phoenix.webAPI()....
   * 接口测试用例API：phoenix.interfaceAPI()....
   * androidappAPI：phoenix.androidAPI()....
   * IOSappAPI：phoenix.iosAPI()....
   * svnClientAPI：phoenix.svnClient()....
   * ftpClientAPI：phoenix.ftpClient()....
   * socketClientAPI:phoenix.telnetClient()....
   * ...
   * @author mengfeiyang
   */
  public class TestBrowserDriver extends ActionProxy{
  	private static String caseName = "浏览器驱动测试用例";	
  	public TestBrowserDriver() {}
  
  	@Override
  	public LinkedList<UnitLogBean> run(CaseLogBean caseLogBean) {
  		init(caseLogBean);//必须有这一步
  		//phoenix.webAPI().setFirefoxExePath("D:\\Program Files (x86)\\Mozilla Firefox\\firefox.exe");//使用Firefox浏览器时，必须添加
  		//phoenix.webAPI().setChromeDriverExePath("C:\\Program Files (x86)\\Google\\Chrome\\Application\\chromedriver64.exe");//使用chrome浏览器时，必须添加,且chromedriver64.exe必须和chrome.exe在同一目录下		
  		HashMap<InterfaceBatchDataBean, HashMap<String, String>> datas = phoenix.commonAPI().loadWebCaseDatas(caseName);//加载数据库测试数据方法		
  		HashMap<String,LocatorBean> locators = phoenix.commonAPI().addLocator(caseName);//加载定位信息的方法
  		for(Entry<InterfaceBatchDataBean, HashMap<String, String>> es : datas.entrySet()){
  			InterfaceBatchDataBean batchData = es.getKey();
  			batchData.getExpectData();//这批数据的执行结果期望值
  			HashMap<String, String> dataBlocks = es.getValue();
  			String phoenixframe = dataBlocks.get("输入数据1");//在数据库中此数据的key
  			phoenix.webAPI().openNewWindowByFirefox("http://www.baidu.com");
  			//phoenix.webAPI().openNewWindowByChrome("http://www.baidu.com");
  			//phoenix.webAPI().openNewWindowByIE("http://www.baidu.com");
  			//phoenix.webAPI().openNewWindowByHtmlUnit("http://www.baidu.com", true, BrowserVersion.INTERNET_EXPLORER);
  			//phoenix.webAPI().openNewWindowByPhantomJs("http://www.baidu.com");
  			phoenix.webAPI().webElement("//*[@id=\"kw\"]",LocatorType.XPATH).setText(phoenixframe);//引用数据
  			phoenix.webAPI().webElement(locators.get("btnLocator").getLocatorData()).click();//使用数据中的定位信息，等同于phoenix.webAPI().webElement("btnLocator").click();
  			String r = phoenix.webAPI().webElement("//*[@id=\"su\"]", LocatorType.XPATH).getAttribute("value");//数据库中的数据可以与页面不变的数据混合使用
  			phoenix.checkPoint().checkIsEqual(r, "百度一下");//调用检查点，检查结果会在日志中统计
  			phoenix.commonAPI().addLog("我是自定义的");//可以手动插入一句日志，该日志会在最后的日志记录中体现
  			phoenix.webAPI().sleep(1000);
  			phoenix.webAPI().closeWindow();	
  		}
  		return getUnitLog();
  	}
  	public static void main(String[] args) {
  		LinkedList<UnitLogBean> ll = new TestBrowserDriver().run(new CaseLogBean());
  		for(UnitLogBean l : ll){
  			System.out.println(l.getContent());
  		}
  	}
  }

• API/接口测试代码实例：

• package org.phoenix.cases.webservice;
  
  import java.io.IOException;
  import java.util.LinkedHashMap;
  import java.util.LinkedList;
  import java.util.List;
  import java.util.Map.Entry;
  
  import org.phoenix.model.CaseLogBean;
  import org.phoenix.model.InterfaceBatchDataBean;
  import org.phoenix.model.InterfaceDataBean;
  import org.phoenix.model.UnitLogBean;
  import org.phoenix.proxy.ActionProxy;
  
  import com.meterware.httpunit.WebResponse;
  /**
   * 使用phoenix做接口测试的案例,包括两个：<br>
   * 1、使用多批数据对一个接口url做测试<br>
   * 2、不使用多批数据<br>
   * 若对wsdl形式的接口做测试，则wsdl的文件需要以Dom方式解析。使用WebResponse中的Dom即可。
   * @author mengfeiyang
   */
  public class ContactJieKou extends ActionProxy{
  	private static String caseName = "接口测试用例";
  	public ContactJieKou() {}
  	//@Test   //使用Jenkins执行此用例的方式,此Test为：org.testng.annotations.Test
  	@Override
  	public LinkedList<UnitLogBean> run(CaseLogBean caseLogBean) {
  		init(caseLogBean);
  		LinkedHashMap<InterfaceBatchDataBean, List<InterfaceDataBean>> datas = phoenix.commonAPI().loadInterfaceDatas(caseName);
  		for(Entry<InterfaceBatchDataBean, List<InterfaceDataBean>> entry : datas.entrySet()){
  			InterfaceBatchDataBean iBatchBean = entry.getKey();
  			List<InterfaceDataBean> iDatas = entry.getValue();
  			System.out.println("--数据批次："+iBatchBean.getId()+"   期望值："+iBatchBean.getExpectData());
  			String url ="http://v.youku.com/player/getPlayList/VideoIDS/XNzUwODY4Nzc2/timezone/+08/version/5/source/video?ctype=10&ev=1&password=&";
  			for(InterfaceDataBean iData : iDatas)url += iData.getDataName()+"="+iData.getDataContent()+"&";
  			url = url.substring(0, url.length()-1);//这只是个拼接url参数的过程
  			WebResponse resp = phoenix.interfaceAPI().getResponseByGet(url);
  			try {
  				//如果接口返回的数据是json格式，则可以通过jsonPath取出实际值，如果不是json则可以自己通过自定义方式如正则表达式等。
  				String actual = phoenix.interfaceAPI().getJSONValue(resp.getText(), "JSON.data[0].dvd.point[3].title");
  				//String actual = resp.getElementWithID("su").getText();根据页面中的id，tagName，XPath，Dom等方式取到实际值
  				String r = phoenix.checkPoint().checkIsEqual(actual, iBatchBean.getExpectData());//检查点结果入库
  				if(r == null)System.out.println("-----测试通过-----");
  			} catch (IOException e) {
  				e.printStackTrace();
  			}
  		}
  		return getUnitLog();
  	}
  }

  
  

  
  

  
  

• 其他还有如socketClient，mobile browser，Druid，svnClient等的代码示例，鉴于篇幅，请大家到官网：http://www.cewan.la 详细浏览。