Hibernate Envers를 사용하면 엔티티의 변경 이력을 추적하고, 이전 상태로 되돌릴 수 있으며, 변경 이력을 통해 데이터의 무결성을 관리할 수 있습니다. 이를 통해 개발자는 데이터 변경과 관련된 문제를 해결하고, 시스템의 안정성을 향상시킬 수 있습니다.

Hibernate Envers는 주요 기능을 제공합니다. 첫째로, 변동 사항을 추적하여 엔티티의 이력을 생성합니다. 이 이력에는 어떤 속성이 변경되었는지, 언제 변경되었는지와 같은 정보가 포함됩니다. 둘째로, 엔티티의 상태를 쉽게 복구할 수 있습니다. 예를 들어, 특정 시점까지 엔티티의 상태를 되돌릴 수 있습니다. 마지막으로, 변경 이력을 쿼리하여 특정 기간 동안 어떤 변경이 있었는지 확인할 수 있습니다.

아래는 Hibernate Envers를 사용하여 엔티티의 변경 이력을 추적하는 간단한 예제입니다.

@Entity
@Audited
public class Product {
    @Id
    @GeneratedValue
    private Long id;

    private String name;
    private String description;
    
    // Getters and setters
}

위의 코드에서 @Audited 어노테이션은 해당 엔티티의 변경 이력을 추적하도록 설정합니다. Hibernate Envers는 엔티티의 변경 이력을 자동으로 생성하고 관리합니다.

만약 ProductService 클래스에서 Product 엔티티를 업데이트 한다고 가정해 봅시다.

@Service
@Transactional
public class ProductService {
    @Autowired
    private ProductRepository productRepository;

    public void updateProduct(Long productId, String name, String description) {
        Product product = productRepository.findById(productId);
        product.setName(name);
        product.setDescription(description);
    }
}

위의 코드에서 Product 엔티티를 업데이트하면, Hibernate Envers는 자동으로 해당 변경 이력을 추적합니다.

이렇게 생성된 엔티티의 변경 이력은 Envers를 사용하여 조회할 수 있습니다.

@Service
@Transactional
public class HistoryService {
    @Autowired
    private AuditReader auditReader;

    public List<Number> getRevisions(Long productId) {
        AuditQuery query = auditReader.createQuery().forRevisionsOfEntity(Product.class, false, true);
        query.add(AuditEntity.id().eq(productId));

        return query.getResultList();
    }
}

위의 코드에서 Product 엔티티의 변경 이력을 조회하는 메서드를 보여줍니다. Hibernate Envers를 사용하여 변경 이력을 쿼리할 수 있으며, 결과는 변경 이력의 ID 리스트로 반환됩니다.

Hibernate Envers를 사용하면 데이터의 변경 이력을 관리하는 작업이 크게 단순화되고, 데이터의 무결성을 높일 수 있습니다. Hibernate Envers의 자세한 사용법은 Hibernate Envers 문서를 참고하시기 바랍니다[^1^].