基于Cucumber+Selenide：如何通过反射获取带注解的SelenideElement？

我正在使用Cucumber结合Selenide进行UI测试，尝试借助org.reflections.Reflections库构建页面对象模式，通过反射搜索带有自定义注解的页面对象类和元素字段。但在第二个方法findElementByTitle中，无法从获取到的Field中返回可用的SelenideElement实例，当前代码在转换字段时出错。

我的代码如下：

public static void initPage(String pageName) throws Exception {
    Set<Class<?>> annotated = new Reflections(PAGES_PACKAGE).getTypesAnnotatedWith(PageTitle.class);
    for (Class classToInit : annotated) {
        PageTitle annotation = (PageTitle) classToInit.getAnnotation(PageTitle.class);
        if (annotation.name().equals(pageName)) {
            classToInit.newInstance();
            lastInitialized = substringAfter(classToInit.toString(), "class ");
            lastInitClass = classToInit;
            return;
        }
    }
    throw new AutotestError("Could not find page to init: " + pageName);
}

public static SelenideElement findElementByTitle(String elementName) throws IllegalAccessException, InstantiationException {
    Set<Field> annotated = new Reflections(lastInitialized, new FieldAnnotationsScanner()).getFieldsAnnotatedWith(ElementTitle.class);
    for (Field field : annotated) {
        ElementTitle annotation = field.getAnnotation(ElementTitle.class);
        if (annotation.name().equals(elementName)) {
            field.setAccessible(true);
            SelenideElement el = (SelenideElement) field; // 当前该行代码存在错误
            return el;
        }
    }
    throw new AutotestError("Element not found: " + elementName);
}

嗨，我一眼就看出问题所在了——你把Field对象和字段的实际值搞混了！Field只是用来描述类中字段的元数据（比如字段名、类型、注解信息），它不是字段本身的实例。要拿到可用的SelenideElement，你得从已经实例化的页面对象中取出这个字段的实际值，而不是直接把Field强转成SelenideElement。

下面是具体的修复步骤：

1. 保存页面对象的实例 #

你的initPage方法里调用了classToInit.newInstance()创建了页面对象，但没有把这个实例保存下来——只记录了类名和Class对象。我们需要新增一个变量来存储这个实例，这样后续才能从它身上获取元素字段：

// 新增变量，保存当前初始化的页面对象实例
private static Object currentPageInstance;
private static Class<?> lastInitClass;
private static String lastInitialized;

public static void initPage(String pageName) throws Exception {
    Set<Class<?>> annotated = new Reflections(PAGES_PACKAGE).getTypesAnnotatedWith(PageTitle.class);
    for (Class<?> classToInit : annotated) {
        PageTitle annotation = classToInit.getAnnotation(PageTitle.class);
        if (annotation.name().equals(pageName)) {
            // 把创建的实例保存到currentPageInstance中
            currentPageInstance = classToInit.newInstance();
            lastInitialized = substringAfter(classToInit.toString(), "class ");
            lastInitClass = classToInit;
            return;
        }
    }
    throw new AutotestError("Could not find page to init: " + pageName);
}

2. 修正字段取值逻辑 #

现在有了页面对象的实例，我们就可以通过Field.get(Object obj)方法，传入实例来获取字段的实际值了。修改findElementByTitle方法：

public static SelenideElement findElementByTitle(String elementName) throws IllegalAccessException {
    Set<Field> annotated = new Reflections(lastInitialized, new FieldAnnotationsScanner()).getFieldsAnnotatedWith(ElementTitle.class);
    for (Field field : annotated) {
        ElementTitle annotation = field.getAnnotation(ElementTitle.class);
        if (annotation.name().equals(elementName)) {
            field.setAccessible(true);
            // 从当前页面对象实例中取出字段的实际值
            SelenideElement el = (SelenideElement) field.get(currentPageInstance);
            return el;
        }
    }
    throw new AutotestError("Element not found: " + elementName);
}

3. 额外优化建议 #

• 类型安全校验：可以在取值后增加类型检查，避免ClassCastException，比如：

  Object fieldValue = field.get(currentPageInstance);
  if (fieldValue instanceof SelenideElement) {
      return (SelenideElement) fieldValue;
  } else {
      throw new AutotestError("Field " + elementName + " is not a SelenideElement");
  }
  

• 缓存字段映射：如果频繁调用findElementByTitle，可以提前把页面对象的ElementTitle注解和字段的映射缓存起来，比如用Map<String, Field>，避免每次都用Reflections扫描，提升测试执行效率。
• 异常处理：可以细化异常处理，比如对NoSuchFieldException、IllegalAccessException做更友好的封装，方便排查问题。

内容的提问来源于stack exchange，提问作者Kirill