Hibernate Envers 用户指南：实体审计与查询

"Hibernate Envers 用户指南" 《Hibernate Envers 用户指南》是一份详细的文档，用于指导用户如何在项目中使用 Hibernate Envers 进行实体审计。Hibernate Envers 是 Hibernate ORM 的一个扩展，它提供了一个方便的框架来追踪数据库中实体的变化历史。以下是文档中的关键知识点： 1. **快速入门** (Quickstart): 这部分简要介绍了如何快速配置和使用 Hibernate Envers，包括添加依赖、启用审计功能以及创建审计实体。 2. **配置** (Configuration): 配置包括基础设置和审计策略的选择。基础配置涉及在 Hibernate 配置文件中启用 Envers，并指定审计实体。审计策略选择则涉及选择合适的审计实现，如默认的“RevisionEntity”策略。 3. **日志数据记录** (Logging data for revisions): Envers 能够记录每个修订（revision）的数据，这使得你可以跟踪实体的每一次变更。这部分解释了如何配置日志系统以捕获这些信息。 4. **查询** (Queries): 查询部分介绍了如何查询特定修订时的实体状态，以及查找特定类别的实体在何时发生了变化。这包括使用 `AuditQuery` API 进行高级查询。 5. **生成Schema** (Generating schema with Ant): Envers 提供了通过 Ant 脚本自动生成审计表的工具。这部分说明了如何配置和执行脚本来创建相应的数据库结构。 6. **审计表分区** (Audittable partitioning): 对于大量审计数据，审计表分区可以提高性能。这部分讨论了分区的好处、适合的分区列以及如何配置示例。 7. **映射异常** (Mapping exceptions): 文档指出了 Envers 目前不支持或将来可能支持的映射情况，例如 @OneToMany 和 @JoinColumn 的组合，以及某些复杂的关联映射。 8. **从 Envers 独立版迁移** (Migration from Envers standalone): 如果之前使用的是 Envers 的独立版本，这部分提供了代码更改的指南，以适应与 Hibernate ORM 集成的新版本。 9. **构建与测试** (Building from source and testing): 包含了从源码构建 Envers 的步骤，以及如何贡献代码到项目。同时，还介绍了 Envers 的集成测试。 10. **异常处理** (Mapping exceptions) 继续列出了一些不被支持的映射情况和未来可能支持的特性，帮助开发者理解 Envers 的限制。 通过以上知识点，开发者可以全面了解并有效地利用 Hibernate Envers 实现数据库实体的审计功能，追踪和查询历史变更记录。