解决Vaadin Grid“同一属性多列”异常：理解自动列生成与手动添加

理解Vaadin Grid的列自动生成机制

vaadin grid是一个强大的数据表格组件，它提供了多种方式来定义和显示数据列。当使用构造函数 new grid<>(entity.class) 初始化 grid 时，vaadin会利用java反射机制，自动检测 entity.class 中所有符合javabeans规范的属性（即具有公共getter方法的字段），并为每个属性自动创建一列。

例如，在提供的 Audit 实体类中，存在 getAuditId()、getTrip()、getUser()、getEnterprise() 等方法。当 Grid 被声明为 new Grid<>(Audit.class) 时，它会自动为 auditId、trip、user、enterprise 等属性生成对应的列。

@Entity
@Table
public class Audit {
    private int auditId;
    // ... 其他属性和方法
    @Id
    @GeneratedValue
    @NotNull
    @Column(unique = true)
    public int getAuditId() {
        return auditId;
    }
    // ...
}

异常根源：“同一属性多列”

问题中抛出的 java.lang.IllegalArgumentException: Multiple columns for the same property: auditId 异常，其核心在于 auditId 属性被尝试添加了不止一次。

回顾 EnterpriseView 的构造函数：

public class EnterpriseView extends VerticalLayout implements HasUrlParameter<String>, AfterNavigationObserver{
    // ...
    public EnterpriseView(EnterpriseDao enterpriseDao, AuditDao auditDao) {
        this.enterpriseDao = enterpriseDao;
        this.auditDao = auditDao;
        this.grid = new Grid<>(Audit.class); // 第一次：自动为Audit类的所有属性（包括auditId）创建列

        VerticalLayout layout = new VerticalLayout();
        layout.add(grid);
        grid.addColumns( "auditId" ); // 第二次：手动尝试添加auditId列
    }
    // ...
}

如上所示，this.grid = new Grid<>(Audit.class); 这一行已经使得 auditId 列被自动创建。紧接着的 grid.addColumns("auditId"); 又试图再次添加一个名为 auditId 的列。Vaadin Grid为了避免数据模型与显示列的混淆，不允许同一个属性在Grid中对应多个列，因此抛出了 Multiple columns for the same property 异常。

解决方案：避免重复添加列

最直接的解决方案是移除冗余的列添加操作。由于 Grid 已经通过 new Grid<>(Audit.class) 自动为 auditId 属性创建了列，我们无需再手动添加它。

修正后的 EnterpriseView 构造函数：

import com.vaadin.flow.component.grid.Grid;
import com.vaadin.flow.component.orderedlayout.VerticalLayout;
import com.vaadin.flow.router.*;
import com.wtd.assistant.frontend.dao.AuditDao;
import com.wtd.assistant.frontend.dao.EnterpriseDao;
import com.wtd.assistant.frontend.domain.Audit;
import com.wtd.assistant.frontend.domain.Enterprise;

import java.util.List;
import java.util.Optional;

@Route("EnterpriseView")
public class EnterpriseView extends VerticalLayout implements HasUrlParameter<String>, AfterNavigationObserver{

    private EnterpriseDao enterpriseDao;
    private AuditDao auditDao;
    private Grid<Audit> grid;
    private List<Audit> auditsList;
    private Optional<Enterprise> enterprise;
    private String enterpriseId;

    public EnterpriseView(EnterpriseDao enterpriseDao, AuditDao auditDao) {
        this.enterpriseDao = enterpriseDao;
        this.auditDao = auditDao;
        this.grid = new Grid<>(Audit.class); // 自动创建所有列，包括auditId

        VerticalLayout layout = new VerticalLayout();
        layout.add(grid);
        // 移除冗余的 grid.addColumns( "auditId" );
    }

    @Override
    public void setParameter(BeforeEvent event, String parameter) {
        enterpriseId = parameter;
        System.out.println("setParameter(), enterpriseId: " + enterpriseId);
    }

    @Override
    public void afterNavigation(AfterNavigationEvent event) {
        enterprise = enterpriseDao.findById(Integer.valueOf(enterpriseId));
        System.out.println("EnterpriseId: " + enterprise.get().getEnterpriseId());
        auditsList = enterprise.get().getAudits();
        grid.setItems(auditsList);
    }
}

通过移除 grid.addColumns("auditId"); 这一行，Grid将正常显示 Audit 实体中的所有列，包括 auditId，而不再抛出异常。

替代的列配置策略

虽然上述解决方案直接解决了问题，但在实际开发中，我们可能需要更精细地控制Grid的列。Vaadin提供了多种配置列的方式，可以根据需求选择：

千面视频动捕

千面视频动捕是一个AI视频动捕解决方案，专注于将视频中的人体关节二维信息转化为三维模型动作。

27

查看详情

1. 完全依赖自动生成（如上述修正）

   • 优点： 快速便捷，适用于显示实体所有简单属性的场景。
   • 缺点： 无法控制列的顺序、标题、宽度，也无法直接显示嵌套属性（如audit.getTrip().getName()）或进行自定义渲染。

2. 手动添加所有所需列

   • 这种方法提供最大的灵活性和控制力。首先，不带实体类初始化Grid，即 new Grid<>();。然后，逐一添加所需的列，并可以自定义列的显示方式。
   • 优点： 完全控制列的顺序、标题、宽度、对齐方式，支持显示嵌套属性、自定义值渲染器（ValueProvider）、组件渲染器（ComponentRenderer）等。
   • 缺点： 代码量相对较大，需要手动定义每一列。

   示例：手动定义列

   public EnterpriseView(EnterpriseDao enterpriseDao, AuditDao auditDao) {
       this.enterpriseDao = enterpriseDao;
       this.auditDao = auditDao;
       this.grid = new Grid<>(); // 不传入实体类，不自动生成列
   
       // 手动添加auditId列
       grid.addColumn(Audit::getAuditId)
           .setHeader("审计ID")
           .setKey("auditId") // 可选，设置一个键用于后续操作
           .setSortable(true);
   
       // 添加trip名称列（示例：显示嵌套属性）
       grid.addColumn(audit -> audit.getTrip() != null ? audit.getTrip().getName() : "N/A")
           .setHeader("行程名称")
           .setKey("tripName");
   
       // 添加user名称列
       grid.addColumn(audit -> audit.getUser() != null ? audit.getUser().getName() : "N/A")
           .setHeader("用户名称")
           .setKey("userName");
   
       // ... 根据需要添加其他列
   
       VerticalLayout layout = new VerticalLayout();
       layout.add(grid);
   }

   登录后复制

   注意事项：

   • 当访问嵌套属性（如audit.getTrip().getName()）时，请确保关联实体（Trip）已被正确加载，避免N+1查询问题。可以通过JPA的FetchType.EAGER或在查询时使用JOIN FETCH来预加载。
   • 对于可能为null的关联实体，务必进行空值检查，以避免 NullPointerException。

总结

java.lang.IllegalArgumentException: Multiple columns for the same property 异常是Vaadin Grid中常见的配置错误，它源于对Grid列自动生成机制的误解。核心在于避免在 new Grid<>(Entity.class) 已经自动生成列的情况下，再次手动添加同名列。

根据您的需求，可以选择以下策略：

• 简单场景： 依赖 new Grid<>(Entity.class) 的自动生成，并避免任何冗余的 grid.addColumns() 调用。
• 复杂场景或需精细控制： 使用 new Grid<>(); 初始化Grid，然后通过 grid.addColumn(...) 逐一手动定义所有列，以获得最大灵活性。

理解并正确应用这些列配置策略，将有助于您更高效、稳定地使用Vaadin Grid构建用户界面。

以上就是解决Vaadin Grid“同一属性多列”异常：理解自动列生成与手动添加的详细内容，更多请关注php中文网其它相关文章！