com.sas.webapp.contextsharing
Class WebappContextParams

com.sas.webapp.contextsharing.WebappContextParams

public class WebappContextParams

This class encapsulates the setting and getting of shared data between web applications.

Usage

To use this class for setting parameters, use the constructor which takes a SessionContextInterface and a startURL. Then call the various set methods to set the needed data. When done setting the data, call the getURL method to get the full URL that should be used to start the application.

To use this class for getting parameters, use the constructor which takes a HttpServletRequest. then call the various get methods needed. When you are done with the parameter data (not the session context), call the term method to cleanup the shared parameters.

Since:

07NOV2002

Constructor Summary

WebappContextParams(SessionContextInterface sessionContext)
Constructs the class with the intent of populating the context parameters.

WebappContextParams(SessionContextInterface sessionContext, java.lang.String url)
Constructs the class with the intent of populating the context parameters and then calling the getURL method to get the full URL.

WebappContextParams(SessionContextInterface sessionContext, java.lang.String url, boolean shouldReceiverDestroyWACP)
Constructs the class with the intent of populating the context parameters and then calling the getURL method to get the full URL.

WebappContextParams(UserContextInterface user, javax.servlet.http.HttpServletRequest request)
Constructs the class with the intent of reading the context parameters.

WebappContextParams(UserContextInterface user, javax.servlet.http.HttpServletRequest request, boolean useRemoteServices)
Constructs the class with the intent of reading the context parameters.

WebappContextParams(UserContextInterface user, javax.servlet.http.HttpServletRequest request, com.sas.webapp.components.services.ServicesManager servicesManager)
Constructs the class with the intent of reading the context parameters.

Method Summary

static void	cleanSessionParams(SessionContextInterface sessionContext, java.lang.String sessionRequestId) Removes the context parameters from the session.
java.lang.String	getParamRequestAction() Gets the PFS_REQUEST_ACTION parameter.
RequestActionMenuData[]	getParamRequestActionmenu() Gets the PFS_REQUEST_ACTIONMENU parameter.
java.lang.String	getParamRequestAuthDomain() Gets the PFS_REQUEST_AUTH_DOMAIN parameter.
java.util.List	getParamRequestBackdescriptionList() Gets the PFS_REQUEST_BACKDESCRIPTION_LIST parameter.
java.lang.String	getParamRequestBacklabel() Deprecated. Use getParamRequestBacklabelList instead.
java.util.List	getParamRequestBacklabelList() Gets the PFS_REQUEST_BACKLABEL_LIST parameter.
java.lang.String	getParamRequestBackurl() Deprecated. Use getParamRequestBackurlList instead.
java.util.List	getParamRequestBackurlList() Gets the PFS_REQUEST_BACKURL_LIST parameter.
java.lang.Object	getParamRequestEntity() Gets the PFS_REQUEST_ENTITY parameter.
java.lang.String	getParamRequestEntitykey() Gets the PFS_REQUEST_ENTITYKEY parameter.
java.lang.String	getParamRequestLogoffurl() Gets the PFS_REQUEST_LOGOFFURL parameter.
java.lang.String	getParamRequestPathUrl() Gets the PFS_REQUEST_PATH_URL parameter.
java.lang.String	getParamRequestSource() Gets the PFS_REQUEST_SOURCE parameter.
java.lang.String	getParamRequestTimeoutBackurl() The location to return to if the webapp times out.
java.lang.String	getParamRequestType() Gets the PFS_REQUEST_TYPE parameter.
java.lang.String	getPortletid() Returns the PORTAL_PORTLETID parameter.
static SessionContextInterface	getRemoteSessionContext(UserContextInterface privlUser, java.lang.String sessionKey) Gets the remote SessionContext for the specified sessionKey using the privleged UserContext
java.util.Map	getRequestParams() Returns the map of request parameters.
SessionContextInterface	getSessionContext() Returns the session context for this class.
static SessionContextInterface	getSessionContext(java.lang.String sessionKey) Gets the session context for the specified sessionKey.
static SessionContextInterface	getSessionContext(java.lang.String sessionKey, boolean useRemoteServices) Deprecated.
static SessionContextInterface	getSessionContext(UserContextInterface user, java.lang.String sessionKey, boolean useRemoteServices) Gets the SessionContext for the specified sessionKey.
static SessionContextInterface	getSessionContext(UserContextInterface user, java.lang.String sessionKey, SessionServiceInterface sessionService) Gets the SessionContext for the specified sessionKey and SessionService
java.lang.String	getSessionId() Returns the session id for this class.
java.lang.String	getSessionKeyParam() Returns the key parameter that can be used to find a remote SessionContext
java.lang.String	getSessionRequestId() Returns the request parameters id.
java.lang.String	getStartURL() Returns the starting url string before any other parameters are added.
java.lang.String	getURL() Returns the full url based on the starting url and the parameters that were set.
void	setParamRequestAction(java.lang.String requestAction) Sets the PFS_REQUEST_ACTION parameter.
void	setParamRequestActionmenu(RequestActionMenuData[] requestActionmenu) Sets the PFS_REQUEST_ACTIONMENU parameter.
void	setParamRequestAuthDomain(java.lang.String authDomain) Sets the PFS_REQUEST_AUTH_DOMAIN parameter.
void	setParamRequestBackdescriptionList(java.util.List requestBackdescList) Sets the PFS_REQUEST_BACKDESCRIPTION_LIST parameter.
void	setParamRequestBacklabel(java.lang.String requestBacklabel) Deprecated. Use setParamRequestBacklabelList instead.
void	setParamRequestBacklabelList(java.util.List requestBacklabelList) Sets the PFS_REQUEST_BACKLABEL_LIST parameter.
void	setParamRequestBackurl(java.lang.String requestBackurl) Deprecated. Use setParamRequestBackurlList instead.
void	setParamRequestBackurlList(java.util.List requestBackurlList) Sets the PFS_REQUEST_BACKURL_LIST parameter.
void	setParamRequestEntity(java.lang.Object requestEntity) Sets the PFS_REQUEST_ENTITY parameter.
void	setParamRequestEntitykey(java.lang.String requestEntitykey) Sets the PFS_REQUEST_ENTITYKEY parameter.
void	setParamRequestLogoffurl(java.lang.String requestLogoffurl) Sets the PFS_REQUEST_LOGOFFURL parameter.
void	setParamRequestPathUrl(java.lang.String requestPathUrl) Sets the PFS_REQUEST_PATH_URL parameter.
void	setParamRequestSource(java.lang.String requestSource) Sets the PFS_REQUEST_SOURCE parameter.
void	setParamRequestTimeoutBackurl(java.lang.String requestBackurl) Sets the PFS_REQUEST_TIMEOUT_BACKURL parameter.
void	setParamRequestType(java.lang.String requestType) Sets the PFS_REQUEST_TYPE parameter.
void	setPortletid(java.lang.String portletid) Sets the PORTAL_PORTLETID parameter.
void	setStartURL(java.lang.String startURL)
void	term() Removes the context parameters from the session.

Constructor Detail

WebappContextParams

public WebappContextParams(SessionContextInterface sessionContext,
                           java.lang.String url,
                           boolean shouldReceiverDestroyWACP)
                    throws java.rmi.RemoteException

Constructs the class with the intent of populating the context parameters and then calling the getURL method to get the full URL.

Parameters:

sessionContext - The session context that is to be shared with the web application.

url - The url for the web application (before the parameters are added to it.

Throws:

java.rmi.RemoteException - If there is an error communicating.

WebappContextParams

public WebappContextParams(SessionContextInterface sessionContext,
                           java.lang.String url)
                    throws java.rmi.RemoteException

Constructs the class with the intent of populating the context parameters and then calling the getURL method to get the full URL.

Parameters:

sessionContext - The session context that is to be shared with the web application.

url - The url for the web application (before the parameters are added to it.

Throws:

java.rmi.RemoteException - If there is an error communicating.

WebappContextParams

public WebappContextParams(SessionContextInterface sessionContext)
                    throws java.rmi.RemoteException

Constructs the class with the intent of populating the context parameters. Does not create the full url. Session key can be accessed via the getSessionKeyParam method

Parameters:

sessionContext - The session context that is to be shared with the web application.

Throws:

java.rmi.RemoteException - If there is an error communicating.

WebappContextParams

public WebappContextParams(UserContextInterface user,
                           javax.servlet.http.HttpServletRequest request)
                    throws InitializationException,
                           java.rmi.RemoteException,
                           ServiceException

Constructs the class with the intent of reading the context parameters. It will use remote services to get the session context.

Parameters:

user - The identity of the caller of this method

request - The request object from the servlet that is used to retrieve the parameters from.

Throws:

java.rmi.RemoteException - If there is an error communicating.

InitializationException - If there is an error getting a service.

ServiceException - If there is an error in the service.

WebappContextParams

public WebappContextParams(UserContextInterface user,
                           javax.servlet.http.HttpServletRequest request,
                           boolean useRemoteServices)
                    throws InitializationException,
                           java.rmi.RemoteException,
                           ServiceException

Constructs the class with the intent of reading the context parameters.

Parameters:

user - Identity of the user making this call

request - The request object from the servlet that is used to retrieve the parameters from.

useRemoteServices - true if remote services should be used to retreive the session context, false otherwise.

Throws:

java.rmi.RemoteException - If there is an error communicating.

InitializationException - If there is an error getting a service.

ServiceException - If there is an error in the service.

WebappContextParams

public WebappContextParams(UserContextInterface user,
                           javax.servlet.http.HttpServletRequest request,
                           com.sas.webapp.components.services.ServicesManager servicesManager)
                    throws InitializationException,
                           java.rmi.RemoteException,
                           ServiceException

Constructs the class with the intent of reading the context parameters.

Parameters:

user - Identity of the user making this call

request - The request object from the servlet that is used to retrieve the parameters from.

useRemoteServices - true if remote services should be used to retreive the session context, false otherwise.

Throws:

java.rmi.RemoteException - If there is an error communicating.

InitializationException - If there is an error getting a service.

ServiceException - If there is an error in the service.

Method Detail

term

public void term()
          throws java.rmi.RemoteException

Removes the context parameters from the session. Any parameters that need special clean-up should implement the WebappContextParamsCleanupInterface interface so that its cleanup method. NOTE: this method should only be called by the RECEIVING application (ctor with HttpServletRequest).

Throws:

java.rmi.RemoteException - If there is an error communicating.

getSessionKeyParam

public java.lang.String getSessionKeyParam()
                                    throws java.rmi.RemoteException

Returns the key parameter that can be used to find a remote SessionContext

Returns:

name=value

Throws:

java.rmi.RemoteException - If there is a communications error.

getURL

public java.lang.String getURL()
                        throws java.rmi.RemoteException

Returns the full url based on the starting url and the parameters that were set.

Returns:

The full url.

Throws:

java.rmi.RemoteException - If there is a communications error.

getSessionContext

public SessionContextInterface getSessionContext()

Returns the session context for this class. It can return null if the session id was not set in the http request.

Returns:

The session context for this class.

getSessionId

public java.lang.String getSessionId()

Returns the session id for this class. It can return null if the session id was not set in the http request.

Returns:

The session id for this class.

getStartURL

public java.lang.String getStartURL()

Returns the starting url string before any other parameters are added.

Parameters:

The - starting url string.

getRequestParams

public java.util.Map getRequestParams()

Returns the map of request parameters. It can return null if the session request id was not specified in the http request or there were no parameters added.

Returns:

The map of request parameters.

getSessionRequestId

public java.lang.String getSessionRequestId()

Returns the request parameters id. It can return null if the session request id was not specified in the http request or there were no parameters added.

Returns:

The request parameters id.

getPortletid

public java.lang.String getPortletid()

Returns the PORTAL_PORTLETID parameter.

Returns:

The PORTAL_PORTLETID.

getParamRequestType

public java.lang.String getParamRequestType()

Gets the PFS_REQUEST_TYPE parameter.

Returns:

The PFS_REQUEST_TYPE parameter.

getParamRequestSource

public java.lang.String getParamRequestSource()

Gets the PFS_REQUEST_SOURCE parameter.

Returns:

The PFS_REQUEST_SOURCE parameter.

getParamRequestAction

public java.lang.String getParamRequestAction()

Gets the PFS_REQUEST_ACTION parameter.

Returns:

The PFS_REQUEST_ACTION parameter.

getParamRequestEntity

public java.lang.Object getParamRequestEntity()

Gets the PFS_REQUEST_ENTITY parameter.

Returns:

The PFS_REQUEST_ENTITY parameter.

getParamRequestEntitykey

public java.lang.String getParamRequestEntitykey()

Gets the PFS_REQUEST_ENTITYKEY parameter.

Returns:

The PFS_REQUEST_ENTITYKEY parameter.

getParamRequestPathUrl

public java.lang.String getParamRequestPathUrl()

Gets the PFS_REQUEST_PATH_URL parameter.

Returns:

The PFS_REQUEST_PATH_URL parameter.

getParamRequestActionmenu

public RequestActionMenuData[] getParamRequestActionmenu()

Gets the PFS_REQUEST_ACTIONMENU parameter.

Returns:

The PFS_REQUEST_ACTIONMENU parameter.

getParamRequestBackurl

public java.lang.String getParamRequestBackurl()

Deprecated. Use getParamRequestBackurlList instead.

Gets the PFS_REQUEST_BACKURL parameter.

Returns:

The PFS_REQUEST_BACKURL parameter.

getParamRequestTimeoutBackurl

public java.lang.String getParamRequestTimeoutBackurl()

The location to return to if the webapp times out.

Returns:

String The PFS_REQUEST_TIMEOUT_BACKURL parameter.

getParamRequestBacklabel

public java.lang.String getParamRequestBacklabel()

Deprecated. Use getParamRequestBacklabelList instead.

Gets the PFS_REQUEST_BACKLABEL parameter.

Returns:

The PFS_REQUEST_BACKLABEL parameter.

getParamRequestBackurlList

public java.util.List getParamRequestBackurlList()

Gets the PFS_REQUEST_BACKURL_LIST parameter.

Returns:

The PFS_REQUEST_BACKURL_LIST parameter.

getParamRequestBacklabelList

public java.util.List getParamRequestBacklabelList()

Gets the PFS_REQUEST_BACKLABEL_LIST parameter.

Returns:

The PFS_REQUEST_BACKLABEL_LIST parameter.

getParamRequestBackdescriptionList

public java.util.List getParamRequestBackdescriptionList()

Gets the PFS_REQUEST_BACKDESCRIPTION_LIST parameter.

Returns:

The PFS_REQUEST_BACKDESCRIPTION_LIST parameter.

getParamRequestLogoffurl

public java.lang.String getParamRequestLogoffurl()

Gets the PFS_REQUEST_LOGOFFURL parameter.

Returns:

The PFS_REQUEST_LOGOFFURL parameter.

getParamRequestAuthDomain

public java.lang.String getParamRequestAuthDomain()

Gets the PFS_REQUEST_AUTH_DOMAIN parameter.

Returns:

The PFS_REQUEST_AUTH_DOMAIN parameter.

setPortletid

public void setPortletid(java.lang.String portletid)
                  throws java.rmi.RemoteException

Sets the PORTAL_PORTLETID parameter.

Parameters:

The - value to add to the PORTAL_PORTLETID key.

Throws:

java.rmi.RemoteException

setParamRequestType

public void setParamRequestType(java.lang.String requestType)
                         throws java.rmi.RemoteException

Sets the PFS_REQUEST_TYPE parameter.

Parameters:

The - value to add to the PFS_REQUEST_TYPE key.

Throws:

java.rmi.RemoteException - If there is an error creating the parameters map.

setParamRequestSource

public void setParamRequestSource(java.lang.String requestSource)
                           throws java.rmi.RemoteException

Sets the PFS_REQUEST_SOURCE parameter.

Parameters:

The - value to add to the PFS_REQUEST_SOURCE key.

Throws:

java.rmi.RemoteException - If there is an error creating the parameters map.

setParamRequestAction

public void setParamRequestAction(java.lang.String requestAction)
                           throws java.rmi.RemoteException

Sets the PFS_REQUEST_ACTION parameter.

Parameters:

The - value to add to the PFS_REQUEST_ACTION key.

Throws:

java.rmi.RemoteException - If there is an error creating the parameters map.

setParamRequestEntity

public void setParamRequestEntity(java.lang.Object requestEntity)
                           throws java.rmi.RemoteException

Sets the PFS_REQUEST_ENTITY parameter.

Parameters:

The - value to add to the PFS_REQUEST_ENTITY key.

Throws:

java.rmi.RemoteException - If there is an error creating the parameters map.

setParamRequestEntitykey

public void setParamRequestEntitykey(java.lang.String requestEntitykey)
                              throws java.rmi.RemoteException

Sets the PFS_REQUEST_ENTITYKEY parameter.

Parameters:

The - value to add to the PFS_REQUEST_ENTITYKEY key.

Throws:

java.rmi.RemoteException - If there is an error creating the parameters map.

setParamRequestPathUrl

public void setParamRequestPathUrl(java.lang.String requestPathUrl)
                            throws java.rmi.RemoteException

Sets the PFS_REQUEST_PATH_URL parameter.

Parameters:

The - value to add to the PFS_REQUEST_PATH_URL key.

Throws:

java.rmi.RemoteException - If there is an error creating the parameters map.

setParamRequestActionmenu

public void setParamRequestActionmenu(RequestActionMenuData[] requestActionmenu)
                               throws java.rmi.RemoteException

Sets the PFS_REQUEST_ACTIONMENU parameter.

Parameters:

The - value to add to the PFS_REQUEST_ACTIONMENU key.

Throws:

java.rmi.RemoteException - If there is an error creating the parameters map.

setParamRequestBackurl

public void setParamRequestBackurl(java.lang.String requestBackurl)
                            throws java.rmi.RemoteException

Deprecated. Use setParamRequestBackurlList instead.

Sets the PFS_REQUEST_BACKURL parameter.

Parameters:

The - value to add to the PFS_REQUEST_BACKURL key.

Throws:

java.rmi.RemoteException - If there is an error creating the parameters map.

setParamRequestTimeoutBackurl

public void setParamRequestTimeoutBackurl(java.lang.String requestBackurl)
                                   throws java.rmi.RemoteException

Sets the PFS_REQUEST_TIMEOUT_BACKURL parameter.

Parameters:

The - value to add to the PFS_REQUEST_TIMEOUT_BACKURL key.

Throws:

java.rmi.RemoteException - If there is an error creating the parameters map.

setParamRequestBacklabel

public void setParamRequestBacklabel(java.lang.String requestBacklabel)
                              throws java.rmi.RemoteException

Deprecated. Use setParamRequestBacklabelList instead.

Sets the PFS_REQUEST_BACKLABEL parameter.

Parameters:

The - value to add to the PFS_REQUEST_BACKLABEL key.

Throws:

java.rmi.RemoteException - If there is an error creating the parameters map.

setParamRequestBackurlList

public void setParamRequestBackurlList(java.util.List requestBackurlList)
                                throws java.rmi.RemoteException

Sets the PFS_REQUEST_BACKURL_LIST parameter.

Parameters:

The - value to add to the PFS_REQUEST_BACKURL_LIST key.

Throws:

java.rmi.RemoteException - If there is an error creating the parameters map.

setParamRequestBacklabelList

public void setParamRequestBacklabelList(java.util.List requestBacklabelList)
                                  throws java.rmi.RemoteException

Sets the PFS_REQUEST_BACKLABEL_LIST parameter.

Parameters:

The - value to add to the PFS_REQUEST_BACKLABEL_LIST key.

Throws:

java.rmi.RemoteException - If there is an error creating the parameters map.

setParamRequestBackdescriptionList

public void setParamRequestBackdescriptionList(java.util.List requestBackdescList)
                                        throws java.rmi.RemoteException

Sets the PFS_REQUEST_BACKDESCRIPTION_LIST parameter.

Parameters:

The - value to add to the PFS_REQUEST_BACKDESCTIPTION_LIST key.

Throws:

java.rmi.RemoteException - If there is an error creating the parameters map.

setParamRequestLogoffurl

public void setParamRequestLogoffurl(java.lang.String requestLogoffurl)
                              throws java.rmi.RemoteException

Sets the PFS_REQUEST_LOGOFFURL parameter.

Parameters:

The - value to add to the PFS_REQUEST_LOGOFFURL key.

Throws:

java.rmi.RemoteException - If there is an error creating the parameters map.

setParamRequestAuthDomain

public void setParamRequestAuthDomain(java.lang.String authDomain)
                               throws java.rmi.RemoteException

Sets the PFS_REQUEST_AUTH_DOMAIN parameter.

Parameters:

The - value to add to the PFS_REQUEST_AUTH_DOMAIN key.

Throws:

java.rmi.RemoteException - If there is an error creating the parameters map.

setStartURL

public void setStartURL(java.lang.String startURL)

Parameters:

starting - url string before any other parameters are added.

getSessionContext

public static SessionContextInterface getSessionContext(java.lang.String sessionKey)
                                                 throws InitializationException,
                                                        java.rmi.RemoteException,
                                                        ServiceException

Gets the session context for the specified sessionKey. It will use remote services to get the session context.

Parameters:

sessionKey - The session key that specifies the session context.

Returns:

The session context.

Throws:

InitializationException

java.rmi.RemoteException

ServiceException

getSessionContext

public static SessionContextInterface getSessionContext(java.lang.String sessionKey,
                                                        boolean useRemoteServices)
                                                 throws InitializationException,
                                                        java.rmi.RemoteException,
                                                        ServiceException

Deprecated.

Gets the session context for the specified sessionKey.

Parameters:

sessionKey - The session key that specifies the session context.

useRemoteServices - true if remote services should be used to retreive the session context, false otherwise.

Returns:

The session context.

Throws:

InitializationException

java.rmi.RemoteException

ServiceException

getRemoteSessionContext

public static SessionContextInterface getRemoteSessionContext(UserContextInterface privlUser,
                                                              java.lang.String sessionKey)
                                                       throws InitializationException,
                                                              java.rmi.RemoteException,
                                                              ServiceException

Gets the remote SessionContext for the specified sessionKey using the privleged UserContext

Parameters:

user - The privleged user

sessionKey - The session key that specifies the session context.

Returns:

The session context.

Throws:

InitializationException

java.rmi.RemoteException

ServiceException

getSessionContext

public static SessionContextInterface getSessionContext(UserContextInterface user,
                                                        java.lang.String sessionKey,
                                                        boolean useRemoteServices)
                                                 throws InitializationException,
                                                        java.rmi.RemoteException,
                                                        ServiceException

Gets the SessionContext for the specified sessionKey.

Parameters:

user - The user calling the method

sessionKey - The session key that specifies the session context.

useRemoteServices - true if remote services should be used to retreive the session context, false otherwise.

Returns:

The session context.

Throws:

InitializationException

java.rmi.RemoteException

ServiceException

getSessionContext

public static SessionContextInterface getSessionContext(UserContextInterface user,
                                                        java.lang.String sessionKey,
                                                        SessionServiceInterface sessionService)
                                                 throws InitializationException,
                                                        java.rmi.RemoteException,
                                                        ServiceException

Gets the SessionContext for the specified sessionKey and SessionService

Parameters:

user - The user calling the method

sessionKey - The session key that specifies the session context.

SessionServiceInterface -

Returns:

The session context.

Throws:

InitializationException

java.rmi.RemoteException

ServiceException

cleanSessionParams

public static void cleanSessionParams(SessionContextInterface sessionContext,
                                      java.lang.String sessionRequestId)
                               throws java.rmi.RemoteException

Removes the context parameters from the session. Any parameters that need special clean-up should implement the WebappContextParamsCleanupInterface interface so that its cleanup method. NOTE: this method should only be called by the RECEIVING application.

Parameters:

sessionContext - The session context that holds the context parameters.

sessionRequestId - The id of the context parameters within the session context.

Throws:

java.rmi.RemoteException - If there is an error communicating.