本文介绍了如何在无法直接修改的实体基础上，通过@Subselect注解创建新的实体，并为其建立索引。重点讲解了如何使用@IndexingDependency注解来正确追踪关联实体属性的变化，从而确保索引能够随着关联实体属性的变更而自动更新，避免手动重建索引的繁琐过程。
在实际开发中，我们经常会遇到需要基于现有数据表创建只读视图的情况。Hibernate Search 提供了 @Subselect 注解，允许我们创建一个基于 SQL 查询的实体，从而实现这个需求。然而，如果我们需要对这个 Subselect 实体建立索引，并且这个索引依赖于关联实体的数据，就需要特别注意索引更新的问题。
假设我们有以下两个实体，它们是无法修改的：
@Entity
@Table(name = "main")
public class FirstEntity {
@Id
private Long id;
@ManyToOne
private SecondEntity secondaryEntity;
}
@Entity
@Table(name = "secondary")
public class SecondEntity {
@Id
private Long id;
private String name;
}现在，我们想基于 FirstEntity 创建一个 Subselect 实体 ThirdEntity，并对 ThirdEntity 的 name 属性建立索引，而 name 属性来源于关联的 SecondEntity。
@Indexed
@Entity
@Subselect("select * from main")
public class ThirdEntity {
@Id
private Long id;
@ManyToOne
private SecondEntity secondaryEntity;
@Transient
@GenericField(sortable = Sortable.YES)
@IndexingDependency(derivedFrom = {
@ObjectPath(@PropertyValue(propertyName = "secondaryEntity"))
})
public String getName() {
return secondaryEntity.getName();
}
}问题：索引更新不及时
上述代码看似正确，但实际上存在一个问题：当 SecondEntity 的 name 属性发生改变时，ThirdEntity 的索引并不会自动更新。这是因为 @IndexingDependency 注解配置不完整。
解决方案：完善 @IndexingDependency 注解
要解决这个问题，我们需要明确指定索引依赖的完整属性路径。正确的 @IndexingDependency 注解应该如下所示：
@Transient
@GenericField(sortable = Sortable.YES)
@IndexingDependency(derivedFrom = {
@ObjectPath(
@PropertyValue(propertyName = "secondaryEntity"),
@PropertyValue(propertyName = "name")
)
})
public String getName() {
return secondaryEntity.getName();
}在这个配置中，我们通过 @ObjectPath 指定了完整的属性路径 secondaryEntity.name。这意味着 Hibernate Search 会追踪 SecondEntity 的 name 属性的变化，并在其发生改变时自动更新 ThirdEntity 的索引。
解释：@ObjectPath 和 @PropertyValue 的作用
- @ObjectPath 用于定义属性路径，可以包含多个 @PropertyValue 注解，用于指定属性路径中的每个属性。
- @PropertyValue 用于指定属性名称。
注意事项：
- 确保 @IndexingDependency 注解中的属性路径与实际的属性路径完全一致。
- 如果属性路径包含多个层级，需要使用多个 @PropertyValue 注解。
- @IndexingDependency 注解只能用于瞬态（@Transient）属性或方法。
总结：
通过正确配置 @IndexingDependency 注解，我们可以确保 Subselect 实体的索引能够随着关联实体属性的变化而自动更新，避免手动重建索引的繁琐过程，提高应用的性能和数据一致性。 记住，需要明确指定索引依赖的完整属性路径，才能让 Hibernate Search 正确追踪关联实体属性的变化。
