JPA/Hibernate中防止特定字段更新的策略与实践

import javax.persistence.*; // 或使用jakarta.persistence for Jakarta EE 9+

@Entity
@Table(name = "application")
public class Application {

    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private Long id;

    private String field1;
    private String field2;

    // 尽管我们会在setter中强制阻止更新，但保留updatable = false仍然是良好的实践，
    // 以便Hibernate在生成UPDATE语句时自动忽略此字段。
    @Column(name = "ins", updatable = false)
    private String ins;

    // 默认构造函数
    public Application() {
    }

    // 带有初始值的构造函数，用于创建新实体
    public Application(String field1, String field2, String ins) {
        this.field1 = field1;
        this.field2 = field2;
        this.ins = ins;
    }

    // Getters
    public Long getId() {
        return id;
    }

    public String getField1() {
        return field1;
    }

    public String getField2() {
        return field2;
    }

    public String getIns() {
        return ins;
    }

    // Setters
    public void setId(Long id) {
        this.id = id;
    }

    public void setField1(String field1) {
        this.field1 = field1;
    }

    public void setField2(String field2) {
        this.field2 = field2;
    }

    /**
     * 自定义setter方法，用于阻止对'ins'字段的更新。
     * 如果实体已经存在（即ID不为null），并且尝试修改'ins'字段的值，
     * 则抛出IllegalStateException。
     *
     * @param ins 新的'ins'值
     * @throws IllegalStateException 如果尝试更新已存在的'ins'字段
     */
    public void setIns(String ins) {
        // 检查实体是否已存在（通过ID判断）
        // 并且新值与当前值不同，才认为是尝试更新
        if (this.id != null && !this.ins.equals(ins)) {
            throw new IllegalStateException("Field 'ins' cannot be updated after initial creation for existing entity (ID: " + this.id + ").");
        }
        this.ins = ins;
    }

    // toString, equals, hashCode (省略)
}

import org.junit.jupiter.api.Assertions;
import org.junit.jupiter.api.Test;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.boot.test.context.SpringBootTest;
import org.springframework.transaction.annotation.Transactional;

import java.util.Optional;

import static org.assertj.core.api.Assertions.assertThat;

@SpringBootTest
@Transactional // 确保测试在事务中运行，并在结束后回滚
class ApplicationRepositoryTest {

    @Autowired
    private ApplicationRepository applicationRepository; // 假设您有一个Spring Data JPA Repository

    // 辅助方法：创建并保存一个初始实体
    private Application createAndSaveApplication(String field1, String field2, String ins) {
        Application app = new Application(field1, field2, ins);
        return applicationRepository.save(app);
    }

    @Test
    void updateIns_ShouldThrowError() {
        // 1. 创建并保存一个初始实体
        Application initialApp = createAndSaveApplication("f1_initial", "f2_initial", "ins_initial");
        Long entityId = initialApp.getId();
        assertThat(entityId).isNotNull();

        // 2. 从数据库加载实体
        Optional<Application> fetchedAppOptional = this.applicationRepository.findById(entityId);
        assertThat(fetchedAppOptional).isPresent();
        Application fetchedApp = fetchedAppOptional.get();

        // 3. 尝试更新'ins'字段，这将触发setter中的校验逻辑
        // 期望此处抛出IllegalStateException
        Assertions.assertThrows(IllegalStateException.class, () -> {
            fetchedApp.setIns("ins-update"); // 尝试修改'ins'字段
            // 虽然setter已经抛出异常，但为了完整性，我们也可以将save操作包含在断言中
            // this.applicationRepository.save(fetchedApp);
        });

        // 4. 验证数据库中的'ins'字段值未被修改
        // 重新从数据库加载实体，确保它保持原始值
        Optional<Application> finalAppOptional = this.applicationRepository.findById(entityId);
        assertThat(finalAppOptional).isPresent());
        Application finalApp = finalAppOptional.get();
        assertThat(finalApp.getIns()).isEqualTo("ins_initial"); // 验证'ins'字段仍是初始值
        assertThat(finalApp.getIns()).isNotEqualTo("ins-update"); // 确认没有被更新
    }

    @Test
    void createApplication_ShouldSetInsValue() {
        // 测试创建新实体时'ins'字段可以被设置
        Application newApp = new Application("f1", "f2", "new_ins_value");
        Application savedApp = applicationRepository.save(newApp);
        assertThat(savedApp.getId()).isNotNull();
        assertThat(savedApp.getIns()).isEqualTo("new_ins_value");
    }
}