planetj.magic
Class UpdateRowRequest

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

All Implemented Interfaces:

IFeature, IHTMLRenderer, IMagicRequest, IRenderer, Serializable

public class UpdateRowRequest

extends AbstractRowRequest

This class gets a Row out of the request extracts values into it and updates the Row.

Author:

PlanetJ Corporation

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

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

UpdateRowRequest(String id, javax.servlet.http.HttpServletRequest request, javax.servlet.http.HttpServletResponse response, 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, UpdateRowRequests should be in edit mode.
int	getDataEngineRowMode() This is a update request.
String	getDefaultUserMessage() Return the default user message for delete operations.
void	postUpdate(Row row, int numUpdated, javax.servlet.http.HttpServletRequest request, javax.servlet.http.HttpServletResponse response) Method called after update is attempted.
Row	prepareUpdateRow(Row row, javax.servlet.http.HttpServletRequest pReq, javax.servlet.http.HttpServletResponse pRes, DataEngineServlet servlet) 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) Updated 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

UpdateRowRequest

public UpdateRowRequest(String id,
                        javax.servlet.http.HttpServletRequest request,
                        javax.servlet.http.HttpServletResponse response,
                        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

UpdateRequest constructor comment.

UpdateRowRequest

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

Constructor comment.

Method Detail

getDataEngineMode

public String getDataEngineMode()

By default, UpdateRowRequests should be in edit mode.

Specified by:

getDataEngineMode in class AbstractRowRequest

Returns:

edit mode

getDataEngineRowMode

public int getDataEngineRowMode()

This is a update 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

postUpdate

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

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

Parameters:

row - Row inserted into the database

numUpdated - number of Rows updated into the database

request - request from client

CMException

prepareUpdateRow

public final Row prepareUpdateRow(Row row,
                                  javax.servlet.http.HttpServletRequest pReq,
                                  javax.servlet.http.HttpServletResponse pRes,
                                  DataEngineServlet servlet)
                           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.

Override this method to alter the row before it is updated in the db. Creation date: (3/27/2003 4:39:51 PM)

CMException

processRow

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

Updated 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