Hibernate 注释。 @Where 与 @WhereJoinTable

Question

以下java文档

@哪里

Where 子句添加到集合的元素实体或目标实体。该子句是用 SQL 编写的。这里的一个常见用例是软删除。

@WhereJoinTable

添加到集合连接表的Where 子句。该子句是用 SQL 编写的。就像 {@linkWhere} 一样，一个常见的用例是实现软删除。

看来注释一般可以用同样的方式使用：

|---------------------|-------------------|-------------------|
|                     |@Where             | @WhereTable       |
|---------------------|-------------------|-------------------|
|target elements      |TYPE, METHOD, FIELD|TYPE, METHOD, FIELD|
|---------------------|-------------------|-------------------|
|Retention            |RUNTIME            |RUNTIME            |
|---------------------|-------------------|-------------------|
|properties           |clause             |clause             |
|---------------------|-------------------|-------------------|

因此，我真的很困惑我应该如何知道应该为 Relation 字段使用哪个注释。我找不到使用

@Where

和

@WhereJoinTable

之间的区别。两者可以互相替代，对吗？

Answer 1

第一个注释应用于目标实体。这是这种情况的伪代码的非常简化的示例：

@Entity
public class Role {
    private Long id;
    private boolean enabled;
}     

@Entity
public class User {
    @OneToMany(fetch = FetchType.LAZY)
    @JoinTable(name = "USER_ROLE", joinColumns = @JoinColumn(name = "USER_ID"), inverseJoinColumns = @JoinColumn(name = "ROLE_ID"))
    @Where(clause = "enabled = true")
    private Set<Role> roles = new LinkedHashSet<>(0);
}

因此，只有启用的角色才会从数据库填充到 User.roles 集合中。

第二个注释应用于关联表。下面是伪代码中的另一个示例，但现在我们假设关联表并不像第一种情况那么简单：

@Entity
public class Role {
    private Long id;
    private boolean enabled;
}   

@Entity
public class User {
    @OneToMany(fetch = FetchType.LAZY)
    @JoinTable(name = "USER_ROLE", joinColumns = @JoinColumn(name = "USER_ID"), inverseJoinColumns = @JoinColumn(name = "ROLE_ID"))
    @Where(clause = "enabled = true")
    @WhereJoinTable(clause = "now() between valid_from and valid_until")
    private Set<Role> roles = new LinkedHashSet<>(0);
}

and association table has validity attributes, something like 

CREATE TABLE USER_ROLE {
    ID NUMBER NOT NULL,
    USER_ID NUMBER NOT NULL,
    ROLE_ID NUMBER NOT NULL,
    VALID_FROM DATETIME,
    VALID_UNTIL DATETIME
} 

结果，只有启用且有效的角色才会从数据库填充到 User.roles 集合中。

Answer 2

为了将来参考，

@Where

和

@WhereJoinTable

已替换为

@SqlJoinTableRestriction

（ref）。