Hibernate ORM 用户手册改版

jopen 9年前

我们很高兴的宣布 Hibernate ORM 用户手册 改版啦,新版的手册也将作为 Hibernate 5.1 默认的文档。改版工作从去年夏天就开始着手,并且也是作为 Hibernate 5.1 的主要任务之一。

What’s changed

以前的文档均是使用 DocBook 编写,但是我们想要将文档迁移到一种更加对人友好的格式。感谢 Dan Allen 和 Asciidoctor 社区,让我们使用上了更好的工具去编写文档而不至于浪费精力去编写成堆的 XML 标签。

文档中的所有代码示例均来自于单元测试(Github), 通过这种方式,我们想要确保所有的示例不会和功能脱节。

此外,从前文档中的代码示例都是基于 XML 配置的,这种方式早已不适合主流用户的习惯了,并且 Hibernate 是 JPA 规范实现厂商之一,因此我们决定将大部分的代码示例按JPA规范重写,而从功能上看 Hibernate 又是 JPA 的超集,我们还会给出在某些用例环境下 Hibernate 私有API的用法,而这些功能一般都是 JPA 规范未定义的。

What’s to come

如上所述,现在的用户手册还并不是很完备,在不久的将来我们还会对以下章节进行补充丰富:

  • Hibernate 对调用存储过程的支持

  • 将 Hibernate Envers 示例迁移到单元测试

  • 多租户的示例

  • 新增 Hibernate Spatial 章节

赶快去试读一下吧,我们期待着您的反馈


来自: http://www.oschina.net//news/70756/hibernate-orm-new-user-guide