清單 9. 修飾鍵方法 KeyDown(theKey)、keyUp(theKey)
Actions action = new Actions(driver);
action.keyDown(Keys.CONTROL);// 按下 Ctrl 鍵
action.keyDown(Keys.SHIFT);// 按下 Shift 鍵
action.keyDown(Key.ALT);// 按下 Alt 鍵
action.keyUp(Keys.CONTROL);// 釋放 Ctrl 鍵
action.keyUp(Keys.SHIFT);// 釋放 Shift 鍵
action.keyUp(Keys.ALT);// 釋放 Alt 鍵
所以要通過 Alt+F4 來關(guān)閉當前的活動窗口,可以通過下面語句來實現(xiàn):action.keyDown(Keys.ALT).keyDown(Keys.F4).keyUp(Keys.ALT).perform();
而如果是對于像鍵盤上面的字母鍵 a,b,c,d... 等的組合使用,可以通過以下語句實現(xiàn) :action.keyDown(Keys.CONTROL).sednKeys(“a”).perform();
在 WebDriver API 中,KeyDown(Keys theKey)、KeyUp(Keys theKey) 方法的參數(shù)只能是修飾鍵:Keys.SHIFT、Keys.ALT、Keys.CONTROL, 否者將拋出 IllegalArgumentException 異常。 其次對于 action.keyDown(theKey) 方法的調(diào)用,如果沒有顯示的調(diào)用 action.keyUp(theKey) 或者 action.sendKeys(Keys.NULL) 來釋放的話,這個按鍵將一直保持按住狀態(tài)。
使用 Robot 類來操作 Keys 沒有枚舉出來的按鍵操作
1.在 WebDriver 中,Keys 枚舉出了鍵盤上大多數(shù)的非字母類按鍵,從 F1 到 F10,NUMPAD0 到 NUMPAD9、ALTTABCTRLSHIFT 等等,你可以通過以下鏈接查看 Keys 枚舉出來的所有按鍵,Enum Keys。 但是并沒有列出鍵盤上的所有按鍵,比如字母鍵 a、b、c、d … z,一些符號鍵比如:‘ {}[] ’、‘ ’、‘。’、‘ ? ’、‘:’、‘ + ’、‘ - ’、‘ = ’、、‘“”’,還有一些不常用到的功能鍵如 PrtSc、ScrLk/NmLk。對于字母鍵和符號鍵,前面我們已經(jīng)提到可以直接使用 sendKeys(“a”),sendKeys(“/”) 的方式來觸發(fā)這些鍵盤事件。而對于一些功能組合鍵,如 Fn + NmLk 來關(guān)閉或者打開數(shù)字鍵,或者 Alt+PrtSC 來抓取當前屏幕的活動窗口并保存到圖片,通過 WebDriver 的 Keys 是沒辦法操作的。 這個時候我們需要用到 Java 的 Robot 類來實現(xiàn)對這類組合鍵的操作了。
2.下面以對 Alt+PrtSc 為例介紹一下 Robot 對鍵盤的操作。如代碼清單 10。
清單 10. 通過 Robot 發(fā)出組合鍵動作
/**
*
* @Description: 這個方法用來模擬發(fā)送組合鍵 Alt + PrtSc, 當組合鍵盤事件執(zhí)行之后,屏幕上的活動窗口
* 被截取并且存儲在剪切板了。 接下來是通過讀取剪切板數(shù)據(jù)轉(zhuǎn)換成 Image 圖像對象并保存到本地。
* @param filename : 要保存的圖像的名稱
*/
public static void sendComposeKeys(String fileName) throws Exception {
// 構(gòu)建 Robot 對象,用來操作鍵盤
Robot robot = new Robot();
// 模擬按下鍵盤動作,這里通過使用 KeyEvent 類來獲取對應鍵盤(ALT)的虛擬鍵碼
robot.keyPress(java.awt.event.KeyEvent.VK_ALT);
// 按下 PrtSC 鍵
robot.keyPress(java.awt.event.KeyEvent.VK_PRINTSCREEN);
// 釋放鍵盤動作,當這個動作完成之后,模擬組合鍵 Alt + PrtSC 的過程已經(jīng)完成,
//此時屏幕活動窗口一被截取并存入到剪切板
robot.keyRelease(java.awt.event.KeyEvent.VK_ALT);
// 獲取系統(tǒng)剪切板實例
Clipboard sysc = Toolkit.getDefaultToolkit().getSystemClipboard();
// 通過 getContents() 方法可以將剪切板內(nèi)容獲取并存入 Transferable 對象中
Transferable data = sysc.getContents(null);
if (data != null) {
/***
判斷從剪切板獲取的對象內(nèi)容是否為 Java Image 類, 如果是將直接轉(zhuǎn)化為 Image 對象。
到此為止,我們從發(fā)出組合鍵到抓取活動窗口,再讀取剪切板并存入 Image 對象的過程
完成了,接下來要做的是需要將 Image 對象保存到本地。
*/
if (data.isDataFlavorSupported(DataFlavor.imageFlavor)) {
Image image = (Image) data
.getTransferData(DataFlavor.imageFlavor);
writeImageToFile(image, fileName);
}
}
}
Robot 類對鍵盤的處理是通過 keyPress(int keycode)、keyRelease(int keycode) 方法來實現(xiàn)的,其中他們需要的參數(shù)是鍵盤按鍵對應的虛擬鍵碼,虛擬鍵碼的值可以通過 KeyEvent 類來獲取。在 Java API 中對于虛擬鍵碼的解釋如下: 虛擬鍵碼用于報告按下了鍵盤上的哪個鍵,而不是一次或多次鍵擊組合生成的字符(如 "A" 是由 shift + "a" 生成的)。 例如,按下 Shift 鍵會生成 keyCode 為 VK_SHIFT 的 KEY_PRESSED 事件,而按下 'a' 鍵將生成 keyCode 為 VK_A 的 KEY_PRESSED 事件。釋放 'a' 鍵后,會激發(fā) keyCode 為 VK_A 的 KEY_RELEASED 事件。另外,還會生成一個 keyChar 值為 'A' 的 KEY_TYPED 事件。 按下和釋放鍵盤上的鍵會導致(依次)生成以下鍵事件:
KEY_PRESSED
KEY_TYPED(只在可生成有效 Unicode 字符時產(chǎn)生。)
KEY_RELEASED
所以當測試中需要用到按下鍵盤 Alt+PrtSc 鍵的時候,只需要執(zhí)行代碼清單 10 中兩個 keyPress() 和一個 keyRelease() 方法即可。
3.當這兩個按鍵執(zhí)行結(jié)束之后,屏幕上面的活動窗口已經(jīng)保存到剪切板中。如果需要將其保存本地圖片,只需要從剪切板讀取并通過 JPEGImageEncoder 類或者 ImageIO 類將其寫入本地即可。
清單 11. 使用 JPEGImageEncoder 將 Image 對象保存到本地
/**
*
* @Description: 這個方法用來將 Image 對象保存到本地,主要是通過 JPEGImageEncoder 類來實現(xiàn)圖像的
* 保存
* @param image : 要保存的 Image 對象
* @param filename : 保存圖片的文件名稱
*/
public static void writeImageToFile(Image image, String fileName) {
try {
// 獲取 Image 對象的寬度和高度, 這里的參數(shù)為 null 表示不需要通知任何觀察者
int width = image.getWidth(null);
int height = image.getHeight(null);
BufferedImage bi = new BufferedImage(width, height,
BufferedImage.TYPE_INT_RGB);
// 通過 BufferedImage 繪制圖像并保存在其對象中
bi.getGraphics().drawImage(image, 0, 0, null);
// 構(gòu)建圖像名稱及保存路徑
String name = Const.DIRECTORY + fileName + Const.FORMAT;
File dir = new File(Const.DIRECTORY);
if (!dir.exists()) {
dir.mkdir();
}
FileOutputStream out = new FileOutputStream(name);
@SuppressWarnings("restriction")
JPEGImageEncoder encoder = JPEGCodec.createJPEGEncoder(out);
encoder.encode(bi);
out.flush();
out.close();
} catch (Exception e) {
e.printStackTrace();
}
}
代碼清單 11 是通過 JPEGImageEncoder 類將 Image 對象寫到本地文件流,注意 Image 對象是在代碼清單 10 中的如下語句獲取到的:
Clipboard sysc = Toolkit.getDefaultToolkit().getSystemClipboard();
Transferable data = sysc.getContents(null);
if (data != null) {
if (data.isDataFlavorSupported(DataFlavor.imageFlavor)) {
Image image = (Image) data
.getTransferData(DataFlavor.imageFlavor);
writeImageToFile(image, fileName);
}
}
清單 12. 使用 ImageIO 將 Image 對象保存到本地
/**
*
* @Description: 通過使用 ImageIO 類來保存 Image 對象為本地圖片
* @param image : 需要保存的 Image 對象
* @param filename : 文件名
*/
public static void saveImage(Image image, String fileName) throws Exception {
// 獲取 Image 對象的高度和寬度
int width = image.getWidth(null);
int height = image.getHeight(null);
BufferedImage bi = new BufferedImage(width, height,
BufferedImage.TYPE_INT_RGB);
Graphics g = bi.getGraphics();
//通過 BufferedImage 繪制圖像并保存在其對象中
g.drawImage(image, 0, 0, width, height, null);
g.dispose();
File f = new File(fileName);
// 通過 ImageIO 將圖像寫入到文件
ImageIO.write(bi, "jpg", f);
}
使用 sendKeys(keysToSend) 批量上傳文件
在 Selenium2.0 之前,要上傳文件是比較麻煩的一件事件,因為點擊 Upload File 控件會彈出 Windows 窗口以提供用戶選擇文件,但是 Window 窗口已經(jīng)是瀏覽器之外的組件,所以 Selenium 本身沒辦法控制, 而必須使用 Java Robot 類來模擬鍵盤去操作剪切板實現(xiàn)上傳功能,而且及其不穩(wěn)定。 在 Selenium 2.0 之后,WebDriver 解決了這個問題。前面已經(jīng)談到過,直接使用 WebElement 類的 sendKeys(keysToSend) 方法可以實現(xiàn)文件上傳了。但是如果想批量上傳文件,使用 element.sendKeys(“C:
\test\upload\test1.txt”, “C:\test\upload\test2.txt”...) 方法也是不行的,它能通過執(zhí)行,但是實際上沒有上傳成功。這時可以通過循環(huán)的方式來實現(xiàn)文件的批量上傳,代碼清單 13 是我在百度云上面批量上傳文件的測試。
清單 13. 批量上傳文件
/**
*
* @Description: 在百度云上測試文件批量上傳功能,主要是通過循環(huán)的方式去做單一
* 的上傳動作 , 登陸過程已經(jīng)去掉
*/
@Test
public void test_mutilUploadFile() throws Exception {
System.out.println("upload start");
// 獲取上傳控件元素
WebElement uploadButton = driver.findElement(By.name("html5uploader"));
// 構(gòu)建上傳文件路徑,將需要上傳的文件添加到 CharSequence 數(shù)組
CharSequence[] files = new CharSequence[5];
files[0] = "C:\test\test1.txt";
files[1] = "C:\test\test2.txt";
files[2] = "C:\test\test3.txt";
files[3] = "C:\test\test4.txt";
files[4] = "C:\test\test5.txt";
// 循環(huán)列出每支需要上傳的文件路徑,做單一上傳動作
for(CharSequence file: files){
uploadButton.sendKeys(file);
}
Thread.sleep(2000);
System.out.println("upload end");
}
當執(zhí)行結(jié)束后,效果如圖 1。
圖 1. 批量上傳文件
結(jié)束語
在 Selenium WebDriver 中,有了 Actions 類和 Keys 枚舉對鍵盤和鼠標的操作已經(jīng)做的非常到位,再結(jié)合 Java 本身 Robot、KeyEvent 等類的使用,基本上可以滿足工作中遇到的對鼠標鍵盤操作的應用了。
其次要注意的地方是 WebDriver 對瀏覽器的支持問題,Selenium WebDriver 支持的瀏覽器非常廣泛,從 IE、Firefox、Chrome 到 Safari 等瀏覽器, WebDriver 都有相對應的實現(xiàn):InterntExplorerDriver、FirefoxDriver、ChromeDriver、SafariDriver、AndroidDriver、 IPhoneDriver、HtmlUnitDriver 等。根據(jù)個人的經(jīng)驗,F(xiàn)irefox 以及 Chrome 瀏覽器對 WebDriver 的支持好了,F(xiàn)irefox 搭上 Firebug 以及 Firepath, 在寫腳本的過程中非常方便,而 ChromeDriver 是 Google 公司自己支持與維護的項目。HtmlUnitDriver 速度快,一個純 Java 實現(xiàn)的瀏覽器。IE 比較慢,而且對于 Xpath 等支持不是很好。更多關(guān)于 Selenium WebDriver 的知識,大家可以從下面的鏈接去訪問 Selenium 官方文檔。