Hibernate如何禁止实体创建？以只读Country实体场景为例

针对你提到的仅允许读取、禁止创建的实体（如Country），除了@Immutable禁止更新外，以下是几种可行的Hibernate方案：

1. 自定义@SQLInsert抛出插入异常 #

通过@SQLInsert注解替换默认的插入SQL，让任何插入操作直接抛出数据库层面的异常，从根源阻止创建。不同数据库的报错语法略有不同：

MySQL示例： #

@Entity
@Immutable
@SQLInsert(sql = "SIGNAL SQLSTATE '45000' SET MESSAGE_TEXT = 'Country实体不允许创建'")
public class Country {
    // 实体字段、映射配置
}

PostgreSQL示例： #

@Entity
@Immutable
@SQLInsert(sql = "RAISE EXCEPTION 'Country实体不允许创建'")
public class Country {
    // 实体字段、映射配置
}

这种方式直接在数据库执行层面拦截插入操作，无论应用层怎么调用persist都会触发异常。

2. 在Repository层拦截创建操作 #

如果使用Spring Data JPA，可以针对Country编写专属Repository，在save/saveAll方法中检查实体状态，禁止新实体创建：

public interface CountryRepository extends JpaRepository<Country, Long> {

    @Override
    default <S extends Country> S save(S entity) {
        if (entity.getId() == null) { // 判定为新实体创建请求
            throw new IllegalArgumentException("Country实体不允许创建");
        }
        return JpaRepository.super.save(entity);
    }

    @Override
    default <S extends Country> List<S> saveAll(Iterable<S> entities) {
        entities.forEach(entity -> {
            if (entity.getId() == null) {
                throw new IllegalArgumentException("Country实体不允许创建");
            }
        });
        return JpaRepository.super.saveAll(entities);
    }
}

这种方式在应用层直接拦截创建请求，适合需要友好提示的场景。

3. 利用Hibernate事件监听器拦截插入事件 #

通过实现Hibernate的PreInsertEventListener，全局监听插入事件，当检测到是Country实体时抛出异常：

public class CountryInsertBlocker implements PreInsertEventListener {

    @Override
    public boolean onPreInsert(PreInsertEvent event) {
        if (event.getEntity() instanceof Country) {
            throw new PersistenceException("Country实体不允许创建");
        }
        return false; // 允许其他实体正常插入
    }
}

随后将监听器注册到Hibernate配置中：

@Configuration
public class HibernateConfig {

    @Bean
    public HibernatePropertiesCustomizer hibernatePropertiesCustomizer() {
        return properties -> {
            properties.put("hibernate.event.pre-insert", CountryInsertBlocker.class.getName());
        };
    }
}

这种方式是全局层面的拦截，无论通过哪种方式触发插入都会被拦截，适合需要彻底禁止的场景。

4. 限制实体构造访问权限 #

将Country实体的构造函数设为私有，仅保留Hibernate所需的无参构造，避免应用层直接实例化：

@Entity
@Immutable
public class Country {

    private Country() {
        // 私有构造，防止应用层直接创建实例
    }

    // 实体字段、Getter方法
}

注意：这种方式只能限制应用层直接new实例，若通过反射或其他途径获取到实体实例并调用persist，仍需配合前面的方案使用才能彻底禁止创建。

内容的提问来源于stack exchange，提问作者Radu Dumbrăveanu