| Gets called by TopLinkTemplate.execute with an active
Session . Does not need to care about activating or closing
the TopLink Session , or handling transactions.
Note that write operations should usually be performed on the active
UnitOfWork within an externally controlled transaction, through
calling getActiveUnitOfWork . However, an implementation can also
choose to use acquireUnitOfWork to create an independent
UnitOfWork , which it needs to commit at the end of the operation.
Allows for returning a result object created within the callback,
i.e. a domain object or a collection of domain objects.
A thrown custom RuntimeException is treated as an application exception:
It gets propagated to the caller of the template.
Parameters: session - active TopLink Session a result object, or null if none throws: TopLinkException - if thrown by the TopLink API See Also: oracle.toplink.sessions.Session.getActiveUnitOfWork See Also: oracle.toplink.sessions.Session.acquireUnitOfWork See Also: TopLinkTemplate.execute See Also: TopLinkTemplate.executeFind |