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

[Alberto A. Flores (JIRA)]

Event System is poorly document
-------------------------------

                 Key: HHH-3293
                 URL: http://opensource.atlassian.com/projects/hibernate/browse/HHH-3293
             Project: Hibernate3
          Issue Type: Bug
    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.

-- 
This message is automatically generated by JIRA.
-
If you think it was sent incorrectly contact one of the administrators: http://opensource.atlassian.com/projects/hibernate/secure/Administrators.jspa
-
For more information on JIRA, see: http://www.atlassian.com/software/jira