Note: Mình đã update cách đọc file excel mới ở đây.

I. Mở đầu

Mình ít khi sử dụng đến cách làm này, nên cóp nhặt trên mạng đoạn code này, bạn nào dùng có thể copy thẳng vào trong project.

NOTE: Cái cách này mình ko khuyến khích nhé. Hãy dùng chức năng đọc csv của Junit5 thay thế.

Yêu cầu:

• thư viện POI của Apache.
• thư viện Common-compress Down file Jar

Giải nén và add các tất cả các file jar vào project ngoại trừ log4j. 

Lưu ý là phải add cả những file jar ở trong folder /lib/ và  /ooxml-lib/

Bạn nào nếu sử dụng Maven project thì add 2 cái này vào file pom.xml

<dependency>
	<groupId>org.apache.poi</groupId>
	<artifactId>poi</artifactId>
	<version>4.0.0</version>
</dependency>

<dependency>
	<groupId>org.apache.poi</groupId>
	<artifactId>poi-ooxml</artifactId>
	<version>4.0.0</version>
</dependency>

II. Class đọc file Excel

Mình đặt cái class này ở trong package utilities.

package utilities;

import java.io.FileInputStream;
import org.apache.poi.ss.usermodel.Cell;
import org.apache.poi.ss.usermodel.DataFormatter;
import org.apache.poi.ss.usermodel.Row;
import org.apache.poi.xssf.usermodel.XSSFCell;
import org.apache.poi.xssf.usermodel.XSSFSheet;
import org.apache.poi.xssf.usermodel.XSSFWorkbook;

public class ReadFile {

	private static XSSFWorkbook ExcelWBook;
	private static XSSFSheet ExcelWSheet;

	public static void setExcelFile(String path, String sheetName) throws Exception {
		try {
			// Open the Excel file
			FileInputStream ExcelFile = new FileInputStream(path);

			// Access the excel data sheet
			ExcelWBook = new XSSFWorkbook(ExcelFile);
			ExcelWSheet = ExcelWBook.getSheet(sheetName);
		} catch (Exception e) {
			throw (e);
		}
	}

	public static String[][] getTestData(String tableName) {
		String[][] testData = null;

		try {
			// Handle numbers and strings
			DataFormatter formatter = new DataFormatter();
			XSSFCell[] boundaryCells = findCells(tableName);
			XSSFCell startCell = boundaryCells[0];

			XSSFCell endCell = boundaryCells[1];

			int startRow = startCell.getRowIndex() + 1;
			int endRow = endCell.getRowIndex() - 1;
			int startCol = startCell.getColumnIndex() + 1;
			int endCol = endCell.getColumnIndex() - 1;

			testData = new String[endRow - startRow + 1][endCol - startCol + 1];

			for (int i = startRow; i < endRow + 1; i++) {
				for (int j = startCol; j < endCol + 1; j++) {
					Cell cell = ExcelWSheet.getRow(i).getCell(j);
					testData[i - startRow][j - startCol] = formatter.formatCellValue(cell);
				}
			}
		} catch (Exception e) {
			e.printStackTrace();
		}
		return testData;
	}

	public static XSSFCell[] findCells(String tableName) {
		DataFormatter formatter = new DataFormatter();
		String pos = "begin";
		XSSFCell[] cells = new XSSFCell[2];

		for (Row row : ExcelWSheet) {
			for (Cell cell : row) {
				if (tableName.equals(formatter.formatCellValue(cell))) {
					if (pos.equalsIgnoreCase("begin")) {
						cells[0] = (XSSFCell) cell;
						pos = "end";
					} else {
						cells[1] = (XSSFCell) cell;
					}
				}
			}
		}
		return cells;
	}

}

Trong class có 3 method chính:

• setExcelFile: Đọc file và xác định data ở sheet nào trong file excel
• findCells: Tìm vị trí các cell có chứa data trong sheet
• getTestData: Lấy data và lưu vào các array

III. Cách inject data vào trong các test method

1. Cấu trúc file Excel

File Excel phù hợp với Class trên có dạng như sau:

Nó sẽ được đánh dấu ở 2 góc bằng 1 từ hoặc 1 dãy ký tự nào đó (chính là method findCells ở trên). Trong ví dụ này mình sử dụng từ invalid

2. Cách lấy đường dẫn đến file linh hoạt

File data nên được đặt trong project luôn, đừng để ở vị trí nào đó ở trên máy ngoài project vì nếu có ai đó làm chung với bạn thì đường dẫn đến file sẽ bị sai. Tất nhiên là đường dẫn đến project ở mỗi máy lại khác nhau nên chúng ta phải có cách để dynamic cái đường dẫn đó để lúc nào cũng đúng dù ở bất kỳ máy nào.

Như ở trong hình: file sẽ nằm ở trong folder “data” và file có tên là “data.xlsx”. Do cái đường dẫn là cố định, không đổi nên mình sẽ đặt nó ở trong class Links (Xem lại bài 16)

public class Links {
	
	....
	public static final String PATH_TO_EXCEL = System.getProperty("user.dir") + File.separator + "data" + File.separator + "data.xlsx";
}

Cái File.separator chính là cái ký tự “\” hoặc “/”, sẽ tùy vào hệ điều hành để hiển thị.

3. Thực hiện việc đọc file excel vào lúc nào?

Tùy vào mục đích sử dụng để xác định thời điểm đọc file Excel:

• Đọc file 1 lần và sẽ run trước tất cả các test
• Test nào cần data thì chỉ đọc file ở test đó.

Trong hướng dẫn lần này, mình dùng cách thứ 2 vì dễ làm :)))) Ai muốn làm cách 1 thì tự nhét cái read file vào BeforeSuite hoặc BeforeTest, tùy bạn.

Class test Login sẽ như sau:

public class LoginTest extends BaseTest {
	LoginPage loginPg;
	
	@Test(dataProvider="loginData")
	public void loginFail(String userName, String password) {
		loginPg = new LoginPage(driver);
		loginPg.login(userName, password);
		Assert.assertTrue(loginPg.isDisplayed());
	}
	
	
	@DataProvider(name = "loginData")
	public Object[][] dataProvider() throws Exception {
		ReadFile.setExcelFile(Links.PATH_TO_EXCEL, "LoginTest");
		Object[][] testData = ReadFile.getTestData("invalid");
		return testData;
	}

}

Trong đó: sử dụng annotation DataProdiver của TestNG để làm việc inject data vào trong method test.

Một số điểm lưu ý:

• Nếu cái dataProdiver method mà bạn đặt ở Class khác thì trên chỗ method Test bạn cần phải khai báo cái class chứa method DataProvider.
• Bắt buộc cái method Test phải có parameter trùng với số cột được định nghĩa trong file excel (ko tính 2 cái từ ở góc dùng để đánh dấu). Giả sử cái file data có thêm 1 cột nữa là email thì ở trong Method Test cũng phải có thêm parameter Email
• Không nên định nghĩa pass/fail ở trong file data vì 2 TH pass và fail sẽ có cách check kết quả khác nhau
• Càng không nên lưu pass/fail ra file excel vì bạn đã có 1 cái report của TestNG rồi, giờ còn phải mò mẫm vào file excel để xem kết quả pass fail thì quá khổ.

Và đây là kết quả sau khi run test, mình chỉ làm demo nên giá trị đầu vào nó ko đúng với tiêu chí test lắm.

IV. Tổng kết

Nhiều bạn yêu cầu bài này quá, nay mình mới cố gắng sắp xếp thời gian viết được, mong rằng đáp ứng được nhu cầu của mọi người. Nếu có thắc mắc gì thì hãy đặt lại comment nhé.