Where can I find documentation about the event system. The tutorial has some info about it but it does not describe when all the events occurs and what the contract for the events are. What actions are allowed, what does the return value indicate etc. etc.

I want to use an event listener to update a lastChanged field to the current date/time when an entity is saved to the database. I wrongly assumed flush-entity was the right event to do this. I now assume that preUpdate is the one but I'm not sure and cannot find good information on the site or in the forums.

There is some example code in the forums but that is not using events but the old deprecated system.

Any pointers to some docs on this are very welcome.

Starting point: http://www.hibernate.org/hib_docs/v3/reference/en/html/events.html

The event model in Hibernate is really cool and I would like to use it for object state to audit logs, however, the documentation seems pretty sparse. I have read the documentation in the user guide and looked into the API docs, but the only way to figure it out appears to be to read source code or play around with it.

Am I incorrect? Could the JavaDocs for the Event and EventListener classes be beefed up? Thanks!