在 java 单元测试中,使用页面对象模式(page object model, pom)组织 ui 测试的核心做法是创建一个独立的类来封装特定页面的所有元素定位器和交互方法,并在测试类中通过实例化该类来执行操作。具体实现时,通常结合 selenium webdriver 和 pagefactory 注解,将页面结构映射为字段,从而将测试逻辑与页面细节分离。这样做能让测试代码更贴近业务行为,减少重复代码,并提高维护效率。

如何定义一个标准的页面对象类
定义页面对象类的关键是使用 @FindBy 注解来声明页面元素,并通过构造函数初始化 WebDriver 实例。这样可以将元素的查找逻辑隐藏在类内部,测试类只需调用公开的方法即可。

import org.openqa.selenium.WebDriver;
import org.openqa.selenium.WebElement;
import org.openqa.selenium.support.FindBy;
import org.openqa.selenium.support.PageFactory;
public class LoginPage {
private WebDriver driver;
@FindBy(id = "username")
private WebElement usernameField;
@FindBy(id = "password")
private WebElement passwordField;
@FindBy(css = "button[type='submit']")
private WebElement submitButton;
public LoginPage(WebDriver driver) {
this.driver = driver;
PageFactory.initElements(driver, this);
}
public void enterUsername(String user) {
usernameField.sendKeys(user);
}
public void enterPassword(String pass) {
passwordField.sendKeys(pass);
}
public void clickSubmit() {
submitButton.click();
}
}
上述代码展示了 LoginPage 类的标准结构。它接收 WebDriver 实例,并通过 PageFactory.initElements 自动注入标注了 @FindBy 的元素。测试类可以直接调用 enterUsername 等方法,无需关心具体的 DOM 结构。
如何在测试类中集成并使用页面对象
在测试类中,需要创建 WebDriver 实例并传入页面对象类,然后按顺序调用页面对象提供的方法来模拟用户操作。这种结构使得测试用例读起来像自然语言描述的业务流程。
使用Atmosphere构建通过WebSocket、SSE、gRPC、WebTransport、MCP、A2A和AG-UI流传输的JVM代理网关,并带有治理钩子。

import org.junit.jupiter.api.AfterEach;
import org.junit.jupiter.api.BeforeEach;
import org.junit.jupiter.api.Test;
import org.openqa.selenium.WebDriver;
import org.openqa.selenium.chrome.ChromeDriver;
import static org.junit.jupiter.api.Assertions.assertTrue;
public class LoginTest {
private WebDriver driver;
private LoginPage loginPage;
@BeforeEach
public void setUp() {
driver = new ChromeDriver();
driver.get("http://localhost:8080/login");
loginPage = new LoginPage(driver);
}
@Test
public void testValidLogin() {
loginPage.enterUsername("admin");
loginPage.enterPassword("secret");
loginPage.clickSubmit();
assertTrue(driver.getTitle().contains("Dashboard"));
}
@AfterEach
public void tearDown() {
if (driver != null) {
driver.quit();
}
}
}
在 testValidLogin 方法中,我们直接调用了 loginPage 对象的方法。这种写法屏蔽了底层的点击和输入细节,使测试逻辑清晰可见。如果页面元素 ID 发生变化,只需修改 LoginPage 类中的 @FindBy 注解,而无需改动任何测试用例。
当登录失败时页面对象应如何处理异常
当登录失败时,页面对象类应当捕获或抛出特定的异常,或者返回表示失败状态的对象,而不是让测试类去解析复杂的错误信息。这样可以保持测试逻辑的简洁性。
在实际应用中,如果登录失败,clickSubmit 方法可能会抛出 ElementNotInteractableException 或等待超时。为了处理这种情况,可以在页面对象中添加验证方法,例如检查错误提示框是否存在。如果存在,则抛出自定义的 LoginException,或者返回一个包含成功/失败状态的布尔值。这样测试类可以根据返回值决定下一步的操作,而不必处理底层的技术异常。
Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南










