Help

Hibernate 3.6.0.Beta4 has been released incorporating mostly minor bugfixes and improvements. Most of the work this cycle went into the improved documentation. For those not aware we are planning on splitting the documentation into 2 books:

  1. a Getting Started Guide, see HHH-5441 : this is a collection of tutorials and information on the Hibernate community, etc.
  2. a Developer Guide, see HHH-5466 : this is essentially the information from the existing manual, but presented in a more topical fashion.

The Getting Started Guide is mostly done. There is a single subtask outstanding to incorporate a tutorial on basic Envers usage, but it already contains tutorials on basic Hibernate using (both with hbm.xml and annotation usage) as well as a basic JPA usage tutorial. They all build on the same schema and domain classes, in hopes it will be useful illustrating how to move from one paradigm to another. In fact they all perform the exact same steps for illustration (except for the Envers tutorial when it gets done, since it need to present a very different use case to usefully show Envers usage).

We also are trying out actually bundling up the tutorials in a working project this time (a maven mutli-module project) to make it even easier to get up and running with the tutorials. We are still working through the details of hosting that in terms of referencing the zip from the tutorials (thats the problem with modularizing stuff). Anyway, in the interm I thought this one was close enough that I went ahead and made it available from http://dl.dropbox.com/u/3636512/getting-started-guide/index.html. Some notes:

  • This url is only made available temporarily
  • The documentation references a link to obtain the code. That link is not accurate. We are still deciding where these will live and how they will be referenced. In the meantime I have zipped up the code and made it available here: http://dl.dropbox.com/u/3636512/getting-started-guide/tutorials.tar.gz (again temporarily).

See http://hibernate.org/downloads.html for details on obtaining the release. Or try http://dl.dropbox.com/u/3636512/getting-started-guide/index.html#hibernate-gsg-obtain ;)

Please report any issues to JIRA. Visit us on IRC or the forums if you have usage questions.

2 comments:
 
02. Sep 2010, 05:13 CET | Link

Good stuff :-)

 
03. Sep 2010, 00:25 CET | Link
Arbi Sookazian

A (advanced) performance tuning/optimization section would be beneficial for intermediate-advanced users of JPA/Hibernate. For example, will the guide cover batch queries or 2nd level cache? I guess this material is covered in Ch. 13 of Bauer/King but it doesn't hurt to have similar coverage in the official ref docs.

Nevertheless, I like the idea of splitting into two books.