org.dbforms.event
Class NavigationEvent

java.lang.Object
  org.dbforms.event.WebEvent
      org.dbforms.event.NavigationEvent

Direct Known Subclasses:

GotoEvent, GotoEvent, NavCopyEvent, NavFirstEvent, NavFirstEvent, NavLastEvent, NavLastEvent, NavNewEvent, NavNextEvent, NavNextEvent, NavPrevEvent, NavPrevEvent, ReloadEvent

public abstract class NavigationEvent
extends WebEvent

Abstract base class for all web-events related to navigation.

Author:

Joe Peer

Constructor Summary

NavigationEvent(String action, HttpServletRequest request, DbFormsConfig config)
called by event engine

NavigationEvent(Table table, HttpServletRequest request, DbFormsConfig config)
called by DbFormsTag to create local web event

Method Summary

abstract ResultSetVector

processEvent(FieldValue[] filterFieldValues, FieldValue[] orderConstraint, String sqlFilter, FieldValue[] sqlFilterParams, int count, String firstPosition, String lastPosition, DbEventInterceptorData interceptorData) Process the current event.

Methods inherited from class org.dbforms.event.WebEvent

getConfig, getFollowUp, getFollowUpOnError, getProperties, getRequest, getTable, getType, hasUserPrivileg, setFollowUp, setFollowUpOnError, setProperties, setRequest, setTable, setType

Methods inherited from class java.lang.Object

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

Constructor Detail

NavigationEvent

public NavigationEvent(String action,
                       HttpServletRequest request,
                       DbFormsConfig config)

called by event engine

Parameters:

action - DOCUMENT ME!

request - DOCUMENT ME!

config - DOCUMENT ME!

NavigationEvent

public NavigationEvent(Table table,
                       HttpServletRequest request,
                       DbFormsConfig config)

called by DbFormsTag to create local web event

Parameters:

table - DOCUMENT ME!

request - DOCUMENT ME!

config - DOCUMENT ME!

Method Detail

processEvent

public abstract ResultSetVector processEvent(FieldValue[] filterFieldValues,
                                             FieldValue[] orderConstraint,
                                             String sqlFilter,
                                             FieldValue[] sqlFilterParams,
                                             int count,
                                             String firstPosition,
                                             String lastPosition,
                                             DbEventInterceptorData interceptorData)
                                      throws SQLException

Process the current event.

Parameters:

filterFieldValues - FieldValue array used to restrict a set of data

orderConstraint - FieldValue array used to build a cumulation of rules for ordering (sorting) and restricting fields to the actual block of data

sqlFilter - DOCUMENT ME!

sqlFilterParams - DOCUMENT ME!

count - record count

firstPosition - a string identifying the first resultset position

lastPosition - a string identifying the last resultset position

dbConnectionName - name of the used db connection. Can be used to get an own db connection, e.g. to hold it during the session (see DataSourceJDBC for example!)

con - the JDBC Connection object

Returns:

a ResultSetVector object

Throws:

SQLException - if any error occurs