Oracle ATG Web Commerce form handler classes all implement the interface atg.droplet.DropletFormHandler
. Three form handler base classes implement this interface:
atg.droplet.
EmptyFormHandleratg.droplet.
GenericFormHandleratg.droplet.
TransactionalFormHandler
You can create a form handler by extending one of these classes or any of their subclasses. The ATG Platform API Reference lists all form handler classes that implement the DropletFormHandler
interface.
EmptyFormHandler
atg.droplet.EmptyFormHandler
implements the DropletFormHandler
interface and provides empty implementations of the methods in this interface.
GenericFormHandler
atg.droplet.GenericFormHandler
extends EmptyFormHandler
. It provides simple implementations of DropletFormHandler
interface methods and adds basic error handling logic. If errors occur in processing a form that uses GenericFormHandler
, the errors are saved and exposed as properties of the form handler component. This form handler is included in the public API: see ATG Platform API Reference for more information.
TransactionalFormHandler
atg.droplet.TransactionalFormHandler
extends atg.droplet.GenericFormHandler
; it treats the form processing operation as a transaction. Although this form handler methods are processed discretely, their results are saved simultaneously. The transaction management occurs in the beforeGet
and afterGet
methods. This establishes the transaction before any of properties are set or handler methods are called, rather than in the handler methods themselves. See Handler Methods for an explanation of handler methods.