重要新闻
我们很高兴地宣布,新的Hibernate ORM用户指南已成为Hibernate 5.1的默认参考文档。这个进程始于去年夏天,也是Hibernate 5项目版本的主要目标之一。
变更内容
之前,所有文档都是用DocBook编写的,我们希望转向一个更符合人类习惯的格式。多亏了Dan Allen和Asciidoctor社区,我们现在有一个工具来编写技术文档,这样实际内容就不会丢失在无数的XML标记标签中。
所有示例都是从单元测试中嵌入的,这些单元测试当然可在GitHub上找到。这样,我们确保所有代码片段在将来仍然是有效和相关的(删除一个已过时的类将触发测试失败,并且我们可以立即更新损坏的示例)。
以前的文档中包含了许多基于XML的示例,这些示例对于大多数用户来说已经不再相关。由于Hibernate通常被用作JPA提供者,大多数示例都是按照Java持久化API规范编写的,但Hibernate不仅仅是一个JPA提供者,我们还提供了Hibernate特有的示例,这些示例涵盖了JPA标准不支持的使用案例。