[hibernate-issues] [Hibernate-JIRA] Updated: (HHH-3293) Event System is poorly document

Event System is poorly document ------------------------------- Key: HHH-3293 URL: http://opensource.atlassian.com/projects/hibernate/browse/HHH-3293 Project: Hibernate3 Issue Type: Improvement Components: documentation Affects Versions: 3.2.6 Reporter: Alberto A. Flores In reading interceptor vs. event listeners, it appears that documentation on "event systems" is very poor. Further more, there is no documentation as to how and when evenlisteners are called (which can be relevant depending on the constraints specified in the hbm file and/or db schema. I encountered a problem where the PreInsertEventListener is not only poorly documented in the javadoc (see HHH-1942 and HHH-3237) but also, the DefaultSaveOrUpdateEventListener is ran first after which the Nullability engine checks for constraints in the hbm file and *then* the defined PreInsertEventListener code is executed. This had to be learned by painful debugging when clear documentation could avoid this. The intent was to run the PreInsertEventListener to avoid the not-null constraint, but obviously this is not possible with the current design.