休眠注释。@Where vs @WhereJoinTable

Question

以下java文档

@哪里

向子句添加到集合的元素实体或目标实体的where子句。该子句用SQL编写。此处的常见用例是软删除。

@WhereJoinTable

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

注释通常可以以相同的方式使用：

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

结果，我真的很困惑如何知道应该为“关系”字段使用哪个注释。我找不到使用@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集合中。