com.groiss.dms

Interface FormEventHandler

All Known Implementing Classes:

FormEventAdapter

public interface FormEventHandler

This interface is used for writing callback classes enhancing the functionality of forms. The methods beforeInsert, beforeUpdate, and beforeDelete are called before the database operation is performed.
Additional information can be taken from the ThreadContext. If the database operation is done in the context of a HTTP interaction, the ThreadContext contains the HTTP-request with the following parameters:

• task: the oid of the activity instance (if it is a process form or sub-form)
• _src: the oid of the main form, if it is a subform
• _srcclass: the class name of the main form
• _id: the id of the form relation

Method Summary

Modifier and Type	Method and Description
default void	afterDelete(DMSForm f) This method is called after the form has been deleted from the store.
default void	afterInsert(DMSForm f) This method is called after the form has been inserted into the store.
default void	afterUpdate(DMSForm f) This method is called after the form has been updated in the store.
default void	beforeDelete(DMSForm f) This method is called before the form is deleted.
default void	beforeInsert(DMSForm f) This method is called before the form is inserted into the store.
default void	beforeShow(DMSForm f, FormContext ctx, HttpServletRequest req) This method will be called before the page for the passed form is build.
default void	beforeUpdate(DMSForm f) This method is called before the form is updated in the store (the existing form in the store will be overwritten with the values of this form).
default Date	getChangedAt(DMSForm f) Deprecated.
default String	getName(DMSForm f) Returns the name of this form.
default void	onShow(DMSForm f, ActivityInstance ai, HTMLPage p, HttpServletRequest req) This method is called before the form is sent to the browser.

Method Detail

beforeInsert

default void beforeInsert(DMSForm f)
                   throws Exception

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

Parameters:

f - the form to insert

Throws:

Exception

beforeUpdate

default void beforeUpdate(DMSForm f)
                   throws Exception

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

Parameters:

f - the form to update

Throws:

Exception

beforeDelete

default void beforeDelete(DMSForm f)
                   throws Exception

This method is called before the form is deleted.

Parameters:

f - the form to delete

Throws:

Exception

afterInsert

default void afterInsert(DMSForm f)
                  throws Exception

This method is called after the form has been inserted into the store.

Parameters:

f - the inserted form

Throws:

Exception

afterUpdate

default void afterUpdate(DMSForm f)
                  throws Exception

This method is called after the form has been updated in the store.

Parameters:

f - the updated form

Throws:

Exception

afterDelete

default void afterDelete(DMSForm f)
                  throws Exception

This method is called after the form has been deleted from the store.

Parameters:

f - the deleted form

Throws:

Exception

beforeShow

default void beforeShow(DMSForm f,
                        FormContext ctx,
                        HttpServletRequest req)
                 throws Exception

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

Parameters:

f - the form to show

ctx - holds context information for the form

req - the http request requesting the form's page

Throws:

Exception

onShow

default void onShow(DMSForm f,
                    ActivityInstance ai,
                    HTMLPage p,
                    HttpServletRequest req)
             throws Exception

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

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:

Exception

getName

default String getName(DMSForm f)
                throws Exception

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

Parameters:

f - the form which name is wanted

Returns:

Default returns null

Throws:

Exception

getChangedAt

@Deprecated
default Date getChangedAt(DMSForm f)
                               throws Exception

Deprecated.

might return a customized changedAt-date for the passed form. this method will only be called for (x)htmlforms if not saved via ajax

will be removed in ep11

Parameters:

f - the form

Returns:

Throws:

Exception