Oracle ATG Web Commerce form handler classes all implement the interface atg.droplet.DropletFormHandler. Three form handler base classes implement this interface:

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.


atg.droplet.EmptyFormHandler implements the DropletFormHandler interface and provides empty implementations of the methods in this interface.


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.


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.