org.dbforms.event.datalist
Class GotoEvent

java.lang.Object
  org.dbforms.event.AbstractWebEvent
      org.dbforms.event.AbstractNavigationEvent
          org.dbforms.event.datalist.GotoEvent

public class GotoEvent
extends AbstractNavigationEvent

This event forces the controller to forward the current request to a Request-Dispatcher specified by the Application-Developer in a "org.dbforms.taglib.DbGotoButton". Works with new factory classes

Author:

Henner Kollmann

Constructor Summary

GotoEvent(String action, HttpServletRequest request, DbFormsConfig config)
Constructor - parses the event details.

GotoEvent(Table table, HttpServletRequest request, DbFormsConfig config, String position)
This constructor is not called by the controller but, actually, BY THE VIEW for example if the FormTag "gotoPrefix" attribute is set an a GotoEvent needs to be instanciated.

GotoEvent(Table table, HttpServletRequest request, DbFormsConfig config, String whereClause, String tableList)
This constructer is not called by the controller but, actually, BY THE VIEW for example if the FormTag needs a free form select, this constructor is called.

Method Summary

ResultSetVector

processEvent(FieldValue[] childFieldValues, 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.AbstractWebEvent

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

GotoEvent

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

Constructor - parses the event details.
Depending on the way the attributes where provided by the developer, different ways are used for resolving the dispatcher the user wants to get called and the position he wants the ResultSet to be scrolled to.

Parameters:

action - the action string

request - the request object

config - the config object

GotoEvent

public GotoEvent(Table table,
                 HttpServletRequest request,
                 DbFormsConfig config,
                 String position)

This constructor is not called by the controller but, actually, BY THE VIEW for example if the FormTag "gotoPrefix" attribute is set an a GotoEvent needs to be instanciated.

Parameters:

table - the input table

request - request the request object

config - the config object

position - the position string

GotoEvent

public GotoEvent(Table table,
                 HttpServletRequest request,
                 DbFormsConfig config,
                 String whereClause,
                 String tableList)

This constructer is not called by the controller but, actually, BY THE VIEW for example if the FormTag needs a free form select, this constructor is called.

Parameters:

table - the input table

request - request the request object

config - the config object

whereClause - the SQL where clause

tableList - the table list

Method Detail

processEvent

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

Process the current event.

Specified by:

processEvent in class AbstractNavigationEvent

Parameters:

childFieldValues - 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

firstPosition - DOCUMENT ME!

sqlFilterParams - a string identifying the last resultset position

count - record count

firstPosition - a string identifying the first resultset position

lastPosition - DOCUMENT ME!

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