TopLink Wiki: DebugUnitOfWork

Line 1 was replaced by line 1

- By far the most frequent TopLink problems come from invalid UOW usage. Mixing registered clones and unregistered instances is a common one. Fortunately that class of XXX can be diagnosed with the following API:

+ By far the most frequent TopLink problems come from invalid UnitOfWork usage. Mixing registered clones and unregistered instances is a common one. (Read the UnitOfWorkPrimer for more guidelines.) Fortunately that class of bugs can be diagnosed and solved with the following API:

At line 4 added 1 line.

+ ;[performPartialValidation()|javadoc:sessions/UnitOfWork.html#performPartialValidation()] and [performFullValidation()|javadoc:sessions/UnitOfWork.html#performFullValidation()]:Both these methods simply set the validation level on the UOW. Increase the validation level manually for more info?

Line 6 was replaced by line 7

- ;[performPartialValidation()|javadoc:sessions/UnitOfWork.html#performPartialValidation()] and [performFullValidation()|javadoc:sessions/UnitOfWork.html#performFullValidation()]:The unit of work performs validations such as, ensuring multiple copies of the same object don't exist in the same unit of work, ensuring deleted objects are not refered after commit, ensures that objects from the parent cache are not refered in the unit of work cache. The level of validation can be increased or decreased for debugging purposes or under advanced situation where the application requires/desires to violate clone identity in the unit of work. It is strongly suggested that clone identity not be violate in the unit of work.

+ ;[validateObjectSpace()|javadoc:sessions/UnitOfWork.html#validateObjectSpace()]:This can be used to help debugging an object-space corruption. An object-space corruption is when your application has incorrectly related a clone to an original object. This method will validate that all registered objects are in a correct state and throw an error if not, it will contain the full stack of object references in the error message. If you call this method after each register or change you perform, it will pin-point where the error was made.

Line 8 was replaced by line 9

- ;[validateObjectSpace()|javadoc:sessions/UnitOfWork.html#validateObjectSpace()]:xxx

+ ''validateObjectSpace: I have done exactly what is described above (call it after each change, in a debugging session), and it pointed out exactly what the problem was. Very helpful.''

Line 10 was replaced by line 11

- Not enough? See DebugTopLink.

+ Need more? See DebugTopLink.