planetj.magic
Class InsertRowRequest

java.lang.Object
  |
  +--planetj.html.AbstractHTMLRenderer
        |
        +--planetj.magic.AbstractMagicRequest
              |
              +--planetj.magic.MagicRequest
                    |
                    +--planetj.magic.AbstractRowRequest
                          |
                          +--planetj.magic.InsertRowRequest

All Implemented Interfaces:

IFeature, IHTMLRenderer, IMagicRequest, IRenderer, Serializable

Direct Known Subclasses:

InsertAndNewRowRequest

public class InsertRowRequest

extends AbstractRowRequest

!!DA (8/7/2003 6:28:32 PM) documenation needed

See Also:

Serialized Form

Nested Class Summary

Nested classes inherited from class planetj.dataengine.IFeature

IFeature.OperationCountFeature

Field Summary

Fields inherited from class planetj.html.AbstractHTMLRenderer

className

Fields inherited from interface planetj.magic.IMagicRequest

IS_COMPLETE, MAGIC_REQUEST, MAGIC_REQUEST_PARAM1, MAGIC_REQUEST_RC, SAME_URI, TYPE, TYPE_PAGE, TYPE_SESSION, TYPE_STATIC, USER_REQUEST_ATTRIBUTES_STORED

Fields inherited from interface planetj.html.IHTMLRenderer

HTML

Fields inherited from interface planetj.dataengine.IFeature

DEFAULT_MESSAGE_FEATURE, FEATURE_DELETE, FEATURE_INSERT, FEATURE_LEVEL_ENTERPRISE, FEATURE_LEVEL_ENTRY, FEATURE_LEVEL_PROFESSIONAL, FEATURE_LEVEL_STANDARD, FEATURE_UPDATE, MESSAGE_END, MESSAGE_START

Constructor Summary

InsertRowRequest(Row row, javax.servlet.http.HttpServletRequest request, javax.servlet.http.HttpServletResponse response)
Constructor comment.

InsertRowRequest(String id, javax.servlet.http.HttpServletRequest req, javax.servlet.http.HttpServletResponse res, String rowId)
Deprecated. by WK on (11/25/2003 1:43:37 PM) should hold reference to row and not the row key also no need for the id

Method Summary

String	getDataEngineMode() By default, InsertRowRequests should be in insert mode.
int	getDataEngineRowMode() This is a insert request.
String	getDefaultUserMessage() Return the default user message for delete operations.
void	postInsert(Row row, int numInserted, javax.servlet.http.HttpServletRequest request, javax.servlet.http.HttpServletResponse response) Method called after insert is attempted.
Row	prepareInsertRow(Row row, javax.servlet.http.HttpServletRequest request, javax.servlet.http.HttpServletResponse res, DataEngineServlet ser) Deprecated. by WK on (8/9/2003 8:16:22 PM) because the HttpServletResponse and DataEngineServlet should never be needed. Made final to ensure that no subclasses override this method thinking their logic will get run. prepareRow is the method called before processing a Row. This method will no longer be available in WOW 7.0.
Row	processRow(Row row, ExecutingContext ec, javax.servlet.http.HttpServletRequest request, javax.servlet.http.HttpServletResponse response) Inserts the given Row into the database.

Methods inherited from class planetj.magic.AbstractRowRequest

execute, extractDataIntoRow, getDefaultEndNavigationGroup, getExecutingContext, getFeatureLevel, getRow, getRowId, postRowProcess, prepareRow, setUserMessage

Methods inherited from class planetj.magic.MagicRequest

getType, store

Methods inherited from class planetj.magic.AbstractMagicRequest

addLinkedRequestAfter, addLinkedRequestBefore, appendUnsupportedHTMLMessage, clone, clone, equals, executeAll, getAnchorName, getBaseField, getBaseRow, getBaseRowCollection, getCurrentURI, getFailMessage, getFirstRequest, getId, getKey, getLastRequest, getMagicServletURI, getMagicURI, getNextURI, getRequestAttribute, getRequestParameter, getRequestParameterValues, getSessionAttribute, getSharedSessionAttribute, getSuccessMessage, hasLinkedRequestsAfter, hasLinkedRequestsBefore, isApplicable, isCompleted, isEndNavigationGroup, isPopup, isReturnToRequester, isSaveResults, isStartNewNavigationGroup, preexecute, removeRequestAttribute, removeSessionAttribute, removeSharedSessionAttribute, setAnchorName, setBaseField, setBaseRow, setBaseRowCollection, setCompleted, setEndNavigationGroup, setFailMessage, setId, setNextURI, setNextURI, setNextURIs, setPopup, setRequestGroupAttribute, setRequestPageAttribute, setRequestPersistentAttribute, setRequestTransientAttribute, setReturnToRequester, setRowEventListener, setSessionAttribute, setSessionSharedAttribute, setStartNewNavigationGroup, setSuccessMessage

Methods inherited from class planetj.html.AbstractHTMLRenderer

append, generate, getDisplayType

Methods inherited from class java.lang.Object

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

Methods inherited from interface planetj.magic.IMagicRequest

addLinkedRequestAfter, addLinkedRequestBefore, executeAll, getBaseField, getBaseRow, getCurrentURI, getFirstRequest, getId, getKey, getLastRequest, getMagicURI, getNextURI, isCompleted, isEndNavigationGroup, isReturnToRequester, isSaveResults, isStartNewNavigationGroup, setBaseField, setBaseRow, setRowEventListener

Methods inherited from interface planetj.html.IHTMLRenderer

append, generate

Methods inherited from interface planetj.dataengine.display.IRenderer

getDisplayType

Methods inherited from interface planetj.dataengine.IFeature

appendUnsupportedHTMLMessage, isApplicable

Constructor Detail

InsertRowRequest

public InsertRowRequest(String id,
                        javax.servlet.http.HttpServletRequest req,
                        javax.servlet.http.HttpServletResponse res,
                        String rowId)

Deprecated. by WK on (11/25/2003 1:43:37 PM) should hold reference to row and not the row key also no need for the id

Constructor comment

InsertRowRequest

public InsertRowRequest(Row row,
                        javax.servlet.http.HttpServletRequest request,
                        javax.servlet.http.HttpServletResponse response)

Constructor comment.

Method Detail

getDataEngineMode

public String getDataEngineMode()

By default, InsertRowRequests should be in insert mode.

Specified by:

getDataEngineMode in class AbstractRowRequest

Returns:

insert mode

getDataEngineRowMode

public int getDataEngineRowMode()

This is a insert request.

Specified by:

getDataEngineRowMode in class AbstractRowRequest

Returns:

mode request should run in

See Also:

Row

getDefaultUserMessage

public String getDefaultUserMessage()

Return the default user message for delete operations.

Specified by:

getDefaultUserMessage in class AbstractRowRequest

Returns:

String

postInsert

public void postInsert(Row row,
                       int numInserted,
                       javax.servlet.http.HttpServletRequest request,
                       javax.servlet.http.HttpServletResponse response)
                throws CMException

Method called after insert is attempted. Subclasses may override this method to provide additional functionality after the Row is inserted.

Parameters:

row - Row inserted into the database

numInserted - number of Rows inserted into the database

request - request from client

CMException

prepareInsertRow

public final Row prepareInsertRow(Row row,
                                  javax.servlet.http.HttpServletRequest request,
                                  javax.servlet.http.HttpServletResponse res,
                                  DataEngineServlet ser)
                           throws CMException

Deprecated. by WK on (8/9/2003 8:16:22 PM) because the HttpServletResponse and DataEngineServlet should never be needed. Made final to ensure that no subclasses override this method thinking their logic will get run. prepareRow is the method called before processing a Row. This method will no longer be available in WOW 7.0.

Subclasses may override this method to alter the row being used before it is inserted into the database. This method may return a new Row all completly.

Parameters:

row - original Row to be inserted

request - request from client

CMException

processRow

public Row processRow(Row row,
                      ExecutingContext ec,
                      javax.servlet.http.HttpServletRequest request,
                      javax.servlet.http.HttpServletResponse response)
               throws CMException

Inserts the given Row into the database.

Specified by:

processRow in class AbstractRowRequest

Parameters:

row - Row to be processed in some manner

ec - current context in which Row should be process during execution

request - request from client

response - response to client

Returns:

processed Row

CMException