planetj.magic
Class AbstractMagicRequest

java.lang.Object
  planetj.magic.AbstractMagicRequest

All Implemented Interfaces:

IFeature, IMagicRequest, java.io.Serializable

Direct Known Subclasses:

AbstractActionRequest, MagicRequest, RowReflectionRequest

public abstract class AbstractMagicRequest

extends java.lang.Object

implements IMagicRequest, java.io.Serializable

Abstract Class for all MagicRequests

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 interface planetj.magic.IMagicRequest

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

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

AbstractMagicRequest()
MagicRequest constructor comment.

AbstractMagicRequest(HttpServletRequest request, HttpServletResponse response)
MagicRequest constructor comment.

AbstractMagicRequest(java.lang.String pId, HttpServletRequest request, HttpServletResponse response)
MagicRequest constructor comment.

Method Summary

void	addLinkedRequestAfter(IMagicRequest pMagicRequest) Adds the given MagicRequest to the list of requests to be executed after this MagicRequest
void	addLinkedRequestBefore(IMagicRequest pMagicRequest) Adds the given MagicRequest to the list of requests to be executed before this MagicRequest
java.lang.StringBuffer	appendUnsupportedHTMLMessage(java.lang.StringBuffer html) Appends the default unsupported message
void	changeMode(java.lang.String mode, HttpServletRequest request, HttpServletResponse response) Changes the current mode of execution.
java.lang.Object	clone() Clone this object.
java.lang.Object	clone(java.lang.String cloneKey, HttpServletRequest request) Clone this object.
static boolean	equals(java.lang.Object one, java.lang.Object two)
abstract IMagicRequest	execute(HttpServletRequest request, HttpServletResponse response, DataEngineServlet servlet) Execute method comment.
IMagicRequest	executeAll(HttpServletRequest pRequest, HttpServletResponse pResponse, DataEngineServlet pServlet) Execute method comment.
java.lang.String	getAnchorName() Get the name of the anchor generated next to the Field requiring the status change.
Field	getBaseField() Get the based on Row for this Request.
Row	getBaseRow() Get the based on Row for this Request.
RowCollection	getBaseRowCollection() Get the based on RowCollection for this Request.
java.lang.String	getCurrentURI() Get the URI of the page this MagicRequest was created on.
boolean	getDefaultEndNavigationGroup() Get the default state if this request should end its navigation group.
PageType	getDefaultPageType(java.lang.String section) Get the PageType to use for the specified section when no PageType is explictly specified
java.lang.String	getFailMessage() Deprecated. - only temporarily added to support custom fail messages
int	getFeatureLevel() Gets the minimum feature level requried to execute this operation
IMagicRequest	getFirstRequest() Gets the first magic request that will be executed when executeAll() is invoked on this magic request.
java.lang.String	getId() Return the id used to store this magic request in the session.
java.lang.String	getKey() Return the id used to store this magic request in the session.
IMagicRequest	getLastRequest() Gets the last magic request that will be executed when executeAll() is invoked on this magic request.
java.lang.String	getMagicRequestParameter(HttpServletRequest request) Get a magic requests parameter
java.lang.String	getMagicServletURI()
java.lang.String	getMagicURI() Get the URI to use to call the Magic Servlet for this request
java.lang.String	getNextURI(LayoutDisplayPropertyGroup layoutTemplate) Get the URI of the next page to call.
java.lang.String	getPleaseWaitJSP(ExecutingContext ec) Gets the please wait JSP to display to the user.
Operation	getPleaseWaitOperation(ExecutingContext ec) Gets the Operation used to control the please wait functionality for this MR.
static java.lang.Object	getRequestAttribute(java.lang.String key, HttpServletRequest request)
static java.lang.String	getRequestParameter(java.lang.String key, HttpServletRequest request) Gets the specified parameter from the HTTPRequest.
static java.lang.String[]	getRequestParameterValues(java.lang.String key, HttpServletRequest request) Gets the specified parameter from the HTTPRequest.
static java.lang.Object	getSessionAttribute(java.lang.String pKey, HttpServletRequest pRequest) Gets the specified object in the HTTPSession.
static java.lang.Object	getSharedSessionAttribute(java.lang.String key, HttpServletRequest request) Gets the specified object in the HTTPSession.
java.lang.String	getSuccessMessage() Get the message to set in the request if this "Magic Request" runs successfully.
abstract java.lang.String	getType() Get the type of magic request.
boolean	hasLinkedRequestsAfter() Return wheter or not this request has additional request to execute
boolean	hasLinkedRequestsBefore() Return wheter or not this request has additional request to execute
boolean	isApplicable() Assume by default that this feature applies
boolean	isCompleted(HttpServletRequest req) Gets whether or not the request has completed execution
boolean	isEndNavigationGroup() Tests whether or not this magic request needs to end the current navigation group and go back to the previous state of the last page of the last group.
boolean	isLoadParameterValuesFromRequest() Do we load parameter values from the http request during the executing of this magic request? If parameters for a context are being displayed and a different context ends up being executed, it may cause a new copy of the first context to be executed as well, and we may not want to load the "old" parameter values into that context.
boolean	isOverridePrimaryNavigation() Tests if the navigation from this magic request should override the navigation in the primary magic request.
boolean	isPleaseWait(ExecutingContext ec) Tests if this magic request is a please wait magic request.
boolean	isPopup() Tests if this request should execute in a popup window.
boolean	isRepeatable() Is this request repeatable.
boolean	isReturnToRequester() Returns whether or not the magic request needs to be returned to the requester.
boolean	isSaveResults() Deprecated. - from code prior to navigation and layouts - wasn't referenced or used any where !!N WK (4/22/2003 8:27:47 AM)
boolean	isStartNewNavigationGroup() Tests whether or not this magic request needs to start a new navigation group.
void	postexecute(HttpServletRequest pRequest, HttpServletResponse pResponse, DataEngineServlet pServlet) Deprecated. - replaced with postExecute
void	postExecute(HttpServletRequest pRequest, HttpServletResponse pResponse, DataEngineServlet pServlet) Called after the execute method runs.
void	preexecute(HttpServletRequest pRequest, HttpServletResponse pResponse, DataEngineServlet pServlet) Deprecated. - replaced with preExecute
void	preExecute(HttpServletRequest pRequest, HttpServletResponse pResponse, DataEngineServlet pServlet) Called before the execute method runs.
void	processPleaseWait(HttpServletRequest req, HttpServletResponse res) Processes a magic request which is being waited for.
static java.lang.Object	removeRequestAttribute(java.lang.String key, HttpServletRequest request)
static void	removeSessionAttribute(java.lang.String key, HttpServletRequest request) Removes the specified object in the HTTPSession.
static void	removeSharedSessionAttribute(java.lang.String key, HttpServletRequest request) Removes the specified object in the HTTPSession.
void	setAnchorName(java.lang.String name) Set the name of the anchor generated next to the Field requiring the status change.
void	setBaseField(Field pBaseField) Set the based on Field for this Request.
void	setBaseRow(Row pBaseRow) Set the based on Row for this Request.
void	setBaseRowCollection(RowCollection pBaseRowCollection) Set the based on RowCollection for this Request.
void	setCompleted(boolean pCompleted, HttpServletRequest request) Sets the state of the magic request to finished executing
void	setEndNavigationGroup(boolean endGroup)
void	setFailMessage(java.lang.String message) Deprecated. - only temporarily added to support custom fail messages
void	setId(java.lang.String pId) Sets the id used to store this magic request in the session.
void	setLoadParameterValuesFromRequest(boolean loadValues) Do we load parameter values from the http request during the executing of this magic request? If parameters for a context are being displayed and a different context ends up being executed, it may cause a new copy of the first context to be executed as well, and we may not want to load the "old" parameter values into that context.
void	setNextURI(java.lang.String uri) Set the URI of the next page to call.
void	setNextURI(java.lang.String section, java.lang.String uri) Set the URI of the specified section of the template
void	setNextURI(java.lang.String section, java.lang.String uri, PageType pageType) Set the URI of the specified section of the template, along with what type of page that section is
void	setNextURIs(LayoutDisplayPropertyGroup props)
void	setOverridePrimaryNavigation(boolean override) Sets if the navigation from this magic request should override the navigation in the primary magic request.
void	setPopup(boolean newPopup) Sets if this request should execute in a popup window.
void	setRepeatable(boolean repeatable) Set whether or not this request repeatable.
static void	setRequestGroupAttribute(java.lang.String key, java.lang.Object value, HttpServletRequest request)
static void	setRequestPageAttribute(java.lang.String key, java.lang.Object value, HttpServletRequest request) Sets an attribute on the request that is associated with this page.
static void	setRequestPersistentAttribute(java.lang.String key, java.lang.Object value, HttpServletRequest request) Sets an attribute on the request that will be persisted.
static void	setRequestTransientAttribute(java.lang.String key, java.lang.Object value, HttpServletRequest request) Sets an attriubte on the request that will not be automatically transferred to another request.
void	setReturnToRequester(boolean returnToRequester) Returns whether or not the magic request needs to be returned to the requester.
void	setRowEventListener(IRowEventListener newRowEventListener) Sets the RowEventListener on this MagicReqest.
static void	setSessionAttribute(java.lang.String pKey, java.lang.Object pValue, HttpServletRequest pRequest) Sets the specified object in the HTTPSession.
static void	setSessionSharedAttribute(java.lang.String key, java.lang.Object value, HttpServletRequest request) Sets the specified object in the HttpSession.
void	setStartNewNavigationGroup(boolean startNew)
void	setSuccessMessage(java.lang.String message) Message to set in the request if this "Magic Request" runs successful.
IMagicRequest	store(HttpServletRequest request) Store this MagicRequest in the user's session to the DataEngineServlet can get at it when requested

Methods inherited from class java.lang.Object

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

Constructor Detail

AbstractMagicRequest

public AbstractMagicRequest()

MagicRequest constructor comment.

AbstractMagicRequest

public AbstractMagicRequest(java.lang.String pId,
                            HttpServletRequest request,
                            HttpServletResponse response)

MagicRequest constructor comment.

Parameters:

pId - id of MagicRequest used to store the request in the session

AbstractMagicRequest

public AbstractMagicRequest(HttpServletRequest request,
                            HttpServletResponse response)

MagicRequest constructor comment.

Method Detail

addLinkedRequestAfter

public void addLinkedRequestAfter(IMagicRequest pMagicRequest)

Adds the given MagicRequest to the list of requests to be executed after this MagicRequest

Specified by:

addLinkedRequestAfter in interface IMagicRequest

addLinkedRequestBefore

public void addLinkedRequestBefore(IMagicRequest pMagicRequest)

Adds the given MagicRequest to the list of requests to be executed before this MagicRequest

Specified by:

addLinkedRequestBefore in interface IMagicRequest

appendUnsupportedHTMLMessage

public java.lang.StringBuffer appendUnsupportedHTMLMessage(java.lang.StringBuffer html)

Appends the default unsupported message

Specified by:

appendUnsupportedHTMLMessage in interface IFeature

changeMode

public final void changeMode(java.lang.String mode,
                             HttpServletRequest request,
                             HttpServletResponse response)

Changes the current mode of execution.

clone

public java.lang.Object clone()

Clone this object.

Returns:

clone of this MagicRequest.

clone

public java.lang.Object clone(java.lang.String cloneKey,
                              HttpServletRequest request)

Clone this object.

Returns:

clone of this MagicRequest.

equals

public static final boolean equals(java.lang.Object one,
                                   java.lang.Object two)

execute

public abstract IMagicRequest execute(HttpServletRequest request,
                                      HttpServletResponse response,
                                      DataEngineServlet servlet)
                               throws CMException

Execute method comment.

Specified by:

execute in interface IMagicRequest

Throws:

CMException

executeAll

public final IMagicRequest executeAll(HttpServletRequest pRequest,
                                      HttpServletResponse pResponse,
                                      DataEngineServlet pServlet)
                               throws CMException

Execute method comment.

Specified by:

executeAll in interface IMagicRequest

Throws:

CMException

getAnchorName

public java.lang.String getAnchorName()

Get the name of the anchor generated next to the Field requiring the status change.

Returns:

name of HTML anchor

getBaseField

public Field getBaseField()

Get the based on Row for this Request. Used when you have associations.

Specified by:

getBaseField in interface IMagicRequest

getBaseRow

public Row getBaseRow()

Get the based on Row for this Request. Used when you have associations.

Specified by:

getBaseRow in interface IMagicRequest

getBaseRowCollection

public RowCollection getBaseRowCollection()

Get the based on RowCollection for this Request. .

getCurrentURI

public java.lang.String getCurrentURI()

Get the URI of the page this MagicRequest was created on.

Specified by:

getCurrentURI in interface IMagicRequest

getDefaultEndNavigationGroup

public boolean getDefaultEndNavigationGroup()

Get the default state if this request should end its navigation group. The default is set upon initialization of the request.

Returns:

true if navigation group should be ended; false otherwise.

getDefaultPageType

public PageType getDefaultPageType(java.lang.String section)

Get the PageType to use for the specified section when no PageType is explictly specified

getFailMessage

public java.lang.String getFailMessage()

Deprecated. - only temporarily added to support custom fail messages

Get the message to set in the request if this "Magic Request" fails attempting to run.

Returns:

fail message to set in the request

getFeatureLevel

public int getFeatureLevel()

Gets the minimum feature level requried to execute this operation

Specified by:

getFeatureLevel in interface IFeature

getFirstRequest

public IMagicRequest getFirstRequest()

Gets the first magic request that will be executed when executeAll() is invoked on this magic request. If there are no requests before this one, then this same object will be returned

Specified by:

getFirstRequest in interface IMagicRequest

getId

public java.lang.String getId()

Return the id used to store this magic request in the session.

Specified by:

getId in interface IMagicRequest

getKey

public java.lang.String getKey()

Return the id used to store this magic request in the session.

Specified by:

getKey in interface IMagicRequest

getLastRequest

public IMagicRequest getLastRequest()

Gets the last magic request that will be executed when executeAll() is invoked on this magic request. If there are no requests after this one, then this same object will be returned

Specified by:

getLastRequest in interface IMagicRequest

getMagicServletURI

public java.lang.String getMagicServletURI()

getMagicURI

public java.lang.String getMagicURI()

Get the URI to use to call the Magic Servlet for this request

Specified by:

getMagicURI in interface IMagicRequest

getNextURI

public java.lang.String getNextURI(LayoutDisplayPropertyGroup layoutTemplate)

Get the URI of the next page to call.

Specified by:

getNextURI in interface IMagicRequest

getPleaseWaitJSP

public java.lang.String getPleaseWaitJSP(ExecutingContext ec)
                                  throws CMException

Gets the please wait JSP to display to the user. This method is only invoked when this MR is used to initiaate a please wait scenario.

Throws:

CMException

getPleaseWaitOperation

public Operation getPleaseWaitOperation(ExecutingContext ec)
                                 throws CMException

Gets the Operation used to control the please wait functionality for this MR. (Null may be returned, in which case this MR will not use the please wait functionality)

Throws:

CMException

getRequestAttribute

public static java.lang.Object getRequestAttribute(java.lang.String key,
                                                   HttpServletRequest request)

getRequestParameter

public static java.lang.String getRequestParameter(java.lang.String key,
                                                   HttpServletRequest request)

Gets the specified parameter from the HTTPRequest. This provides a single place with potential error logging and programatic debug instead of all users getting their own parameters.

getRequestParameterValues

public static java.lang.String[] getRequestParameterValues(java.lang.String key,
                                                           HttpServletRequest request)

Gets the specified parameter from the HTTPRequest. This provides a single place with potential error logging and programatic debug instead of all users getting their own parameters.

getSessionAttribute

public static java.lang.Object getSessionAttribute(java.lang.String pKey,
                                                   HttpServletRequest pRequest)

Gets the specified object in the HTTPSession. This provides a single place with potential error logging and programatic debug instead of all users getting objects from the session.

Parameters:

pRequest - request containing session to retrieve objects from.

pKey - key used to identify the object in the session.

getSharedSessionAttribute

public static java.lang.Object getSharedSessionAttribute(java.lang.String key,
                                                         HttpServletRequest request)

Gets the specified object in the HTTPSession. This provides a single place with potential error logging and programatic debug instead of all users getting objects from the session.

getSuccessMessage

public java.lang.String getSuccessMessage()

Get the message to set in the request if this "Magic Request" runs successfully.

Returns:

success message to set in the request

getType

public abstract java.lang.String getType()

Get the type of magic request.

Specified by:

getType in interface IMagicRequest

hasLinkedRequestsAfter

public boolean hasLinkedRequestsAfter()

Return wheter or not this request has additional request to execute

hasLinkedRequestsBefore

public boolean hasLinkedRequestsBefore()

Return wheter or not this request has additional request to execute

isApplicable

public boolean isApplicable()
                     throws CMException

Assume by default that this feature applies

Specified by:

isApplicable in interface IFeature

Throws:

CMException

isCompleted

public boolean isCompleted(HttpServletRequest req)

Gets whether or not the request has completed execution

Specified by:

isCompleted in interface IMagicRequest

isEndNavigationGroup

public boolean isEndNavigationGroup()

Description copied from interface: IMagicRequest

Tests whether or not this magic request needs to end the current navigation group and go back to the previous state of the last page of the last group.

Specified by:

isEndNavigationGroup in interface IMagicRequest

isLoadParameterValuesFromRequest

public boolean isLoadParameterValuesFromRequest()

Do we load parameter values from the http request during the executing of this magic request? If parameters for a context are being displayed and a different context ends up being executed, it may cause a new copy of the first context to be executed as well, and we may not want to load the "old" parameter values into that context. This can happen when parameters for a context are being displayed inside of a tab, and the user reruns the tabbed operation, causing that same tab to be displayed again & run again. In this case we don't want to use the parameter displayed for the context in the tab since the entire tabbed operation has been rerun.

isOverridePrimaryNavigation

public boolean isOverridePrimaryNavigation()

Tests if the navigation from this magic request should override the navigation in the primary magic request. Normally, any nagivation in a magic request which is linked before or after to the primary magic request is ignored. If this method returns true and if this magic request is linked after (not before) the primary magic request, then the navigation from this magic request will be used instead of the navigation from the primary magic request.

Specified by:

isOverridePrimaryNavigation in interface IMagicRequest

isPleaseWait

public boolean isPleaseWait(ExecutingContext ec)
                     throws CMException

Tests if this magic request is a please wait magic request. When this is true, an itermediate "please wait" page is shown prior to showing the results page, instead of going directly to the results page.

Throws:

CMException

isPopup

public boolean isPopup()

Tests if this request should execute in a popup window. If true, there will be no header, TOC, or footer, and the popup window will be closed when this request's navigation group ends

isRepeatable

public boolean isRepeatable()

Is this request repeatable. For instance we don't want to repeat inserts, but it is ok to repeat refreshes. Any Request that is not repeatable, should override this and return false

Specified by:

isRepeatable in interface IMagicRequest

isReturnToRequester

public boolean isReturnToRequester()

Returns whether or not the magic request needs to be returned to the requester. Defaults to true. If any "Magic" requests do not require return to the requester, then this method should be overridden.

Specified by:

isReturnToRequester in interface IMagicRequest

isSaveResults

public boolean isSaveResults()

Deprecated. - from code prior to navigation and layouts - wasn't referenced or used any where !!N WK (4/22/2003 8:27:47 AM)

Tests if the results of executing this magic request should be saved. This allows the user to go back to this result after viewing another page. If this method returns false, and the user goes back from viewing a later page, the results of this request will be "skipped" and the user will see results from a page "before" this one.

Specified by:

isSaveResults in interface IMagicRequest

isStartNewNavigationGroup

public boolean isStartNewNavigationGroup()

Description copied from interface: IMagicRequest

Tests whether or not this magic request needs to start a new navigation group.

Specified by:

isStartNewNavigationGroup in interface IMagicRequest

preexecute

public final void preexecute(HttpServletRequest pRequest,
                             HttpServletResponse pResponse,
                             DataEngineServlet pServlet)
                      throws CMException

Deprecated. - replaced with preExecute

Called before the execute method runs. If this method is overriden, it must be invoked on the superclass

Throws:

CMException

preExecute

public void preExecute(HttpServletRequest pRequest,
                       HttpServletResponse pResponse,
                       DataEngineServlet pServlet)
                throws CMException

Called before the execute method runs. If this method is overriden, it must be invoked on the superclass

Specified by:

preExecute in interface IMagicRequest

Throws:

CMException

postexecute

public final void postexecute(HttpServletRequest pRequest,
                              HttpServletResponse pResponse,
                              DataEngineServlet pServlet)
                       throws CMException

Deprecated. - replaced with postExecute

Called after the execute method runs.

Throws:

CMException

postExecute

public void postExecute(HttpServletRequest pRequest,
                        HttpServletResponse pResponse,
                        DataEngineServlet pServlet)
                 throws CMException

Called after the execute method runs.

Specified by:

postExecute in interface IMagicRequest

Throws:

CMException

processPleaseWait

public void processPleaseWait(HttpServletRequest req,
                              HttpServletResponse res)
                       throws CMException

Processes a magic request which is being waited for. This method is only from the please wait JSP after the please wait message has been displayed to the user (unlike the handlePleaseWait() method). This is an internal WOW method and should not be invoked by application developers

Throws:

CMException

removeRequestAttribute

public static java.lang.Object removeRequestAttribute(java.lang.String key,
                                                      HttpServletRequest request)

removeSessionAttribute

public static void removeSessionAttribute(java.lang.String key,
                                          HttpServletRequest request)

Removes the specified object in the HTTPSession. This provides a single place with potential error logging and programatic debug instead of all users setting objects into the session.

removeSharedSessionAttribute

public static void removeSharedSessionAttribute(java.lang.String key,
                                                HttpServletRequest request)

Removes the specified object in the HTTPSession. This provides a single place with potential error logging and programatic debug instead of all users setting objects into the session.

setAnchorName

public void setAnchorName(java.lang.String name)

Set the name of the anchor generated next to the Field requiring the status change.

Parameters:

name - name of HTML anchor

setBaseField

public void setBaseField(Field pBaseField)

Set the based on Field for this Request. Used when you have associations.

Specified by:

setBaseField in interface IMagicRequest

setBaseRow

public void setBaseRow(Row pBaseRow)

Set the based on Row for this Request. Used when you have associations.

Specified by:

setBaseRow in interface IMagicRequest

setBaseRowCollection

public void setBaseRowCollection(RowCollection pBaseRowCollection)

Set the based on RowCollection for this Request.

Specified by:

setBaseRowCollection in interface IMagicRequest

setCompleted

public void setCompleted(boolean pCompleted,
                         HttpServletRequest request)

Sets the state of the magic request to finished executing

setEndNavigationGroup

public void setEndNavigationGroup(boolean endGroup)

Specified by:

setEndNavigationGroup in interface IMagicRequest

setFailMessage

public void setFailMessage(java.lang.String message)

Deprecated. - only temporarily added to support custom fail messages

Message to set in the request if this "Magic Request" fails attempting to run.

Parameters:

message - fail message to set in the request

setId

public void setId(java.lang.String pId)

Sets the id used to store this magic request in the session.

setLoadParameterValuesFromRequest

public void setLoadParameterValuesFromRequest(boolean loadValues)

Do we load parameter values from the http request during the executing of this magic request? If parameters for a context are being displayed and a different context ends up being executed, it may cause a new copy of the first context to be executed as well, and we may not want to load the "old" parameter values into that context. This can happen when parameters for a context are being displayed inside of a tab, and the user reruns the tabbed operation, causing that same tab to be displayed again & run again. In this case we don't want to use the parameter displayed for the context in the tab since the entire tabbed operation has been rerun.

setNextURI

public void setNextURI(java.lang.String uri)

Set the URI of the next page to call. This method counters any template pages previously set. When the magic request finishes executing, the uri parameter will be called. If the uri should be included in a template, then setNextURI(String, String) should be called.

setNextURI

public void setNextURI(java.lang.String section,
                       java.lang.String uri)

Set the URI of the specified section of the template

Specified by:

setNextURI in interface IMagicRequest

setNextURI

public void setNextURI(java.lang.String section,
                       java.lang.String uri,
                       PageType pageType)

Set the URI of the specified section of the template, along with what type of page that section is

setNextURIs

public void setNextURIs(LayoutDisplayPropertyGroup props)

setOverridePrimaryNavigation

public void setOverridePrimaryNavigation(boolean override)

Sets if the navigation from this magic request should override the navigation in the primary magic request. Normally, any nagivation in a magic request which is linked before or after to the primary magic request is ignored. If this property is true and if this magic request is linked after (not before) the primary magic request, then the navigation from this magic request will be used instead of the navigation from the primary magic request.

Specified by:

setOverridePrimaryNavigation in interface IMagicRequest

setPopup

public void setPopup(boolean newPopup)

Sets if this request should execute in a popup window. If true, there will be no header, TOC, or footer, and the popup window will be closed when this request's navigation group ends

setRequestGroupAttribute

public static void setRequestGroupAttribute(java.lang.String key,
                                            java.lang.Object value,
                                            HttpServletRequest request)

setRequestPageAttribute

public static void setRequestPageAttribute(java.lang.String key,
                                           java.lang.Object value,
                                           HttpServletRequest request)

Sets an attribute on the request that is associated with this page. If the user navigates away from the page displayed from this request, and then returns via the "Cancel" button or other backwards navigation, any attributes stored in the request with this method will be restored to the request.

setRequestPersistentAttribute

public static void setRequestPersistentAttribute(java.lang.String key,
                                                 java.lang.Object value,
                                                 HttpServletRequest request)

Sets an attribute on the request that will be persisted. If the user navigates via a MagicRequest, any attribute set via this method will be propagated to the next HttpServletRequest.

setRequestTransientAttribute

public static void setRequestTransientAttribute(java.lang.String key,
                                                java.lang.Object value,
                                                HttpServletRequest request)

Sets an attriubte on the request that will not be automatically transferred to another request. This is how request attributes "normally" work.

setRepeatable

public void setRepeatable(boolean repeatable)

Set whether or not this request repeatable. For instance some requests such as inserts, shouldn't be repeateable, but refreshes might be.

Specified by:

setRepeatable in interface IMagicRequest

setReturnToRequester

public void setReturnToRequester(boolean returnToRequester)

Returns whether or not the magic request needs to be returned to the requester. Defaults to true. If any "Magic" requests do not require return to the requester, then this method should be overridden.

setRowEventListener

public void setRowEventListener(IRowEventListener newRowEventListener)

Sets the RowEventListener on this MagicReqest. Creation date: (7/11/2002 11:18:06 AM)

Specified by:

setRowEventListener in interface IMagicRequest

Parameters:

newRowEventListener - planetj.database.IRowEventListener

setSessionAttribute

public static void setSessionAttribute(java.lang.String pKey,
                                       java.lang.Object pValue,
                                       HttpServletRequest pRequest)

Sets the specified object in the HTTPSession. This provides a single place with potential error logging and programatic debug instead of all users setting objects into the session.

Parameters:

pRequest - request containing session to store the specified object in.

pValue - the object being stored in the session.

setSessionSharedAttribute

public static void setSessionSharedAttribute(java.lang.String key,
                                             java.lang.Object value,
                                             HttpServletRequest request)

Sets the specified object in the HttpSession. This provides a single place with potential error logging and programatic debug instead of all users setting objects into the session.

setStartNewNavigationGroup

public void setStartNewNavigationGroup(boolean startNew)

Specified by:

setStartNewNavigationGroup in interface IMagicRequest

setSuccessMessage

public void setSuccessMessage(java.lang.String message)

Message to set in the request if this "Magic Request" runs successful.

Parameters:

message - success message to set in the request

store

public IMagicRequest store(HttpServletRequest request)

Store this MagicRequest in the user's session to the DataEngineServlet can get at it when requested

getMagicRequestParameter

public java.lang.String getMagicRequestParameter(HttpServletRequest request)

Description copied from interface: IMagicRequest

Get a magic requests parameter

Specified by:

getMagicRequestParameter in interface IMagicRequest