休眠注释。 @Where 与 @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             |
|---------------------|-------------------|-------------------|

结果我真的很困惑我应该如何知道我应该为 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 集合中。