com.groiss.dms
Class FormEventAdapter

java.lang.Object
  com.groiss.dms.FormEventAdapter

All Implemented Interfaces:

FormEventHandler, FormEventHandler2

public class FormEventAdapter
extends java.lang.Object
implements FormEventHandler2

The adapter which receives form events. The methods in this class are empty; this class is provided as a convenience for easily creating handlers by extending this class and overriding only the methods of interest.

Constructor Summary

FormEventAdapter()

Method Summary

void	beforeShow(DMSForm f, FormContext ctx, javax.servlet.http.HttpServletRequest req) This method will be called before the page for the passed form is build.
java.lang.String	getName(DMSForm f) Returns the name of this form.
void	onDelete(DMSForm f) This method is called before the form is deleted.
void	onInsert(DMSForm f) This method is called before the form is inserted in the store.
void	onShow(DMSForm f, ActivityInstance ai, HTMLPage p, javax.servlet.http.HttpServletRequest req) This method is called before the form is sent to the browser.
void	onUpdate(DMSForm f) This method is called before the form is updated to the store (the existing form in the store will be overwritten with the values of this form).

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

FormEventAdapter

public FormEventAdapter()

Method Detail

onInsert

public void onInsert(DMSForm f)
              throws java.lang.Exception

This method is called before the form is inserted in the store.

Specified by:

onInsert in interface FormEventHandler

Parameters:

f - the form to insert

Throws:

java.lang.Exception

onUpdate

public void onUpdate(DMSForm f)
              throws java.lang.Exception

This method is called before the form is updated to the store (the existing form in the store will be overwritten with the values of this form).

Specified by:

onUpdate in interface FormEventHandler

Parameters:

f - the form to update

Throws:

java.lang.Exception

onDelete

public void onDelete(DMSForm f)
              throws java.lang.Exception

This method is called before the form is deleted.

Specified by:

onDelete in interface FormEventHandler

Parameters:

f - the form to delete

Throws:

java.lang.Exception

beforeShow

public void beforeShow(DMSForm f,
                       FormContext ctx,
                       javax.servlet.http.HttpServletRequest req)
                throws java.lang.Exception

This method will be called before the page for the passed form is build. This allows particularily to set default values for form attributes which will be used when building the page.

Specified by:

beforeShow in interface FormEventHandler2

Parameters:

f - the form to show

ctx - holds context information for the form

req - the http request requesting the form's page

Throws:

java.lang.Exception

onShow

public void onShow(DMSForm f,
                   ActivityInstance ai,
                   HTMLPage p,
                   javax.servlet.http.HttpServletRequest req)
            throws java.lang.Exception

This method is called before the form is sent to the browser.

Specified by:

onShow in interface FormEventHandler

Parameters:

f - the form to show

ai - the actual activity instance (in case of process forms)

p - the html page which will be sent to the browser

req - the http request requesting the form's page

Throws:

java.lang.Exception

getName

public java.lang.String getName(DMSForm f)
                         throws java.lang.Exception

Returns the name of this form. If null is returned the default naming mechanism will be used. This default implementation returns always null.

Specified by:

getName in interface FormEventHandler

Parameters:

f - the form which name is wanted

Returns:

the name of the form

Throws:

java.lang.Exception