com.beasys.commerce.axiom.jsp
Class JspHelper

java.lang.Object
  |
  +--com.beasys.commerce.axiom.jsp.JspHelper

Direct Known Subclasses:

PortalAdminHelper

public class JspHelper

extends java.lang.Object

implements JspConstants

A helper class for all JSP pages. Some of these methods assume the you are using the JspServiceManager model. Prescribes methods which faciltate p13n run-time operation. Allows access to the JspServiceManager URI, the application's working directory, the home page, and the current page. Also, facilitates management of the application's run-time session, by providing convenience methods for setting and getting session values, and setting and getting JSP destinations. Implements several constants interface to reduce the burden of constant referencing by JSP pages.

Fields inherited from interface com.beasys.commerce.axiom.jsp.JspConstants

DATE_FORMAT, DEFAULT_DESTINATION, DEFAULT_SUCCESSOR, DESTINATION_URI, IMMUTABLE_SERVICEMANAGER_HOME_PAGE, JSP_CALENDAR_FEATURES, JSP_PORTALS_BASE_DIRECTORY, JSP_TOOLS_ADMIN_HOME, JSP_TOOLS_BASE_DIRECTORY, JSP_TOOLS_DOC_RTR, JSP_TOOLS_GUIDE_FEATURES, JSP_TOOLS_PROPERTYMGMT_ADMIN_HOME, JSP_TOOLS_USERMGMT_ADMIN_HOME, JSP_TOOLS_UTIL_DIRECTORY, P13N_CACHED_REQUEST, P13N_CACHED_SESSION, REPOSITORY_DIR, SERVICEMANAGER_COOKIE_TIMEOUT, SERVICEMANAGER_CURRENT_PAGE, SERVICEMANAGER_HOME_PAGE, SERVICEMANAGER_LOGGED_IN, SERVICEMANAGER_SESSION_TIMEOUT, SERVICEMANAGER_SUCCESSOR, SERVICEMANAGER_USER, TRAFFIC_URI, TRANSACTION_SERVICE, TRANSACTION_TIMEOUT, WORKING_DIR, WORKING_DIR_FILES

Constructor Summary

JspHelper()

Method Summary

static java.lang.String	decode(java.lang.String aString) Decodes the provided String using a Base64Decoder.
static java.lang.String	encode(java.lang.String aString) Encodes the provided String using a Base64Encoder.
static javax.servlet.http.Cookie	findCookie(java.lang.String aName, javax.servlet.http.Cookie[] cookies) Finds the cookie for a given cookie name.
static int	getCookieTimeout(javax.servlet.http.HttpServletRequest aRequest) Retrieves the p13n app Cookie timeout, in seconds.
static java.lang.String	getCookieValue(java.lang.String aName, javax.servlet.http.Cookie[] cookies) Retrieves a particular cookie value from a set of javax.servlet.http.Cookie objects.
static java.lang.String	getDefaultDestination(javax.servlet.http.HttpServletRequest aRequest) Retrieves the default destination of the p13n app associated with the provided javax.servlet.http.HttpServletRequest.
static java.lang.String	getDefaultSuccessor(javax.servlet.http.HttpServletRequest aRequest) Get the default succssor (group) that was specified in the servlet registration.
static java.util.Hashtable	getDequalifiedSessionValues(javax.servlet.http.HttpServletRequest request) Retrieves a hashtable of dequalified session property names and their corresponding values for the provided request.
static boolean	getLoggedIn(javax.servlet.http.HttpServletRequest aRequest) Determines whether a user is currently logged into the p13n app.
static java.lang.String	getRepositoryDirectory(javax.servlet.http.HttpServletRequest aRequest) Retrieves the repository directory of the portal associated with the provided javax.servlet.http.HttpServletRequest.
static java.lang.Object	getSessionValue(java.lang.String aName, javax.servlet.http.HttpServletRequest aRequest) Retrieves a session value based on the name provided.
static java.lang.Object	getSessionValue(java.lang.String scopeName, java.lang.String aName, javax.servlet.http.HttpServletRequest aRequest) Retrieves a session value based on the name provided.
static java.lang.String	getTrafficURI(javax.servlet.http.HttpServletRequest aRequest) Retrieves the URI of the JspServiceManager associated with the request.
static java.lang.String	getWorkingDirectory(javax.servlet.http.HttpServletRequest aRequest) Retrieves the working directory of the p13n app associated with the provided javax.servlet.http.HttpServletRequest.
static void	putSessionValue(java.lang.String aName, java.lang.Object aValue, javax.servlet.http.HttpServletRequest aRequest) Sets a session value based on the name provided.
static void	putSessionValue(java.lang.String scopeName, java.lang.String aName, java.lang.Object aValue, javax.servlet.http.HttpServletRequest aRequest) Sets a session value based on the scope name and propertyname provided.
static java.lang.String	qualifiedName(java.lang.String aBaseName, javax.servlet.http.HttpServletRequest aRequest) Creates a name, based on the provided base name, which uniquely identifies a session paramater as belonging to a particular JspServiceManager.
static void	removeSessionValue(java.lang.String aName, javax.servlet.http.HttpServletRequest aRequest) Removes a session value based on the name provided.
static void	setCookie(java.lang.String aName, java.lang.String aValue, javax.servlet.http.Cookie[] cookies, javax.servlet.http.HttpServletResponse aResponse, int aMaxAge) Locates a javax.servlet.http.Cookie with a name matching the provided name, and sets the value of the Cookie to the provided value.
static void	setSessionValue(java.lang.String aName, java.lang.Object aValue, javax.servlet.http.HttpServletRequest aRequest) Sets a session value based on the name provided.
static void	setSessionValue(java.lang.String scopeName, java.lang.String aName, java.lang.Object aValue, javax.servlet.http.HttpServletRequest aRequest)
static boolean	validSession(javax.servlet.http.HttpServletRequest aRequest) Checks to see if the session has all of the valid values for p13n run-time.

Methods inherited from class java.lang.Object

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

Constructor Detail

JspHelper

public JspHelper()

Method Detail

validSession

public static boolean validSession(javax.servlet.http.HttpServletRequest aRequest)

Checks to see if the session has all of the valid values for p13n run-time. Also checks to see the session has timed out.

Parameters:

the - javax.servlet.http.HttpServletRequest from which the session is retreived

Returns:

boolean whether the session is valid

findCookie

public static javax.servlet.http.Cookie findCookie(java.lang.String aName,
                                                   javax.servlet.http.Cookie[] cookies)

Finds the cookie for a given cookie name.

Parameters:

aName - the cookie name

cookies - an array of cookies previously obtain from from the request.

Returns:

Cookie the cookie if found, null if not.

getDefaultSuccessor

public static java.lang.String getDefaultSuccessor(javax.servlet.http.HttpServletRequest aRequest)

Get the default succssor (group) that was specified in the servlet registration.

Parameters:

aRequest. -

Returns:

the default successor.

encode

public static java.lang.String encode(java.lang.String aString)

Encodes the provided String using a Base64Encoder.

Parameters:

aString - the String to encode

Returns:

String the encoded version of the provided String

decode

public static java.lang.String decode(java.lang.String aString)
                               throws java.io.IOException

Decodes the provided String using a Base64Decoder.

Parameters:

the - String to decode

Returns:

String the decoded version of the provided String

Throws:

IOException - buffer read error

setCookie

public static void setCookie(java.lang.String aName,
                             java.lang.String aValue,
                             javax.servlet.http.Cookie[] cookies,
                             javax.servlet.http.HttpServletResponse aResponse,
                             int aMaxAge)

Locates a javax.servlet.http.Cookie with a name matching the provided name, and sets the value of the Cookie to the provided value. Also, sets the maximum age of the Cookie to the age provided. If a cookie is not found in the provided array, a new cookie is created, and appropriate values are set.

Parameters:

aName - the Cookie name

aValue - the new Cookie value

cookies - the array of Cookie object searched for the provided name

aResponse - the javax.servlet.http.HttpServletResponse to which the cookie is added

aMaxAge - the maximum cookie age, in seconds

getTrafficURI

public static java.lang.String getTrafficURI(javax.servlet.http.HttpServletRequest aRequest)

Retrieves the URI of the JspServiceManager associated with the request.

Parameters:

aRequest - the request used to obtain the Traffic URI.

Returns:

String

getWorkingDirectory

public static java.lang.String getWorkingDirectory(javax.servlet.http.HttpServletRequest aRequest)

Retrieves the working directory of the p13n app associated with the provided javax.servlet.http.HttpServletRequest.

Parameters:

aRequest - the HttpServletRequest associated with the p13n app

Returns:

String the working directory of the p13n app

getRepositoryDirectory

public static java.lang.String getRepositoryDirectory(javax.servlet.http.HttpServletRequest aRequest)

Retrieves the repository directory of the portal associated with the provided javax.servlet.http.HttpServletRequest.

Parameters:

aRequest - the HttpServletRequest associated with the portal

Returns:

String the working directory of the portal

getDefaultDestination

public static java.lang.String getDefaultDestination(javax.servlet.http.HttpServletRequest aRequest)

Retrieves the default destination of the p13n app associated with the provided javax.servlet.http.HttpServletRequest. This value is the destination to which the JspServiceManager directs the browser when no alternate destination is provided to the JspServiceManager.

Parameters:

aRequest - the HttpServletRequest associated with the p13n app

Returns:

String the default destination of the p13n app

qualifiedName

public static java.lang.String qualifiedName(java.lang.String aBaseName,
                                             javax.servlet.http.HttpServletRequest aRequest)

Creates a name, based on the provided base name, which uniquely identifies a session paramater as belonging to a particular JspServiceManager. This prevents naming collisions between multiple p13n app instances, as multiple p13n apps can be part of the same session.

Parameters:

aBaseName - the base parameter name (e.g. "userName")

aRequest - the HttpServletRequest used to retrieve the Traffic URI, and therefore the correct JspServiceManager name.

Returns:

String

getCookieValue

public static java.lang.String getCookieValue(java.lang.String aName,
                                              javax.servlet.http.Cookie[] cookies)
                                       throws java.io.IOException

Retrieves a particular cookie value from a set of javax.servlet.http.Cookie objects.

Parameters:

aName - the name of the Cookie from which the value is sought

cookies - an array of Cookie objects which is searched for the cookie whose name matches the provided name

Returns:

String the value of the cookie, if found ; null otherwise

Throws:

IOException - propagated from decode.

getCookieTimeout

public static int getCookieTimeout(javax.servlet.http.HttpServletRequest aRequest)

Retrieves the p13n app Cookie timeout, in seconds.

Parameters:

aRequest - the javax.servlet.http.HttpServletRequest associated with the p13n app

Returns:

int the Cookie timeout, in seconds.

getLoggedIn

public static boolean getLoggedIn(javax.servlet.http.HttpServletRequest aRequest)

Determines whether a user is currently logged into the p13n app.

Parameters:

aRequest - the javax.servle.http.HttpServletRequest used to retrieve the p13n app's session

Returns:

boolean whether a user is currently logged into the p13n app

getSessionValue

public static java.lang.Object getSessionValue(java.lang.String aName,
                                               javax.servlet.http.HttpServletRequest aRequest)

Retrieves a session value based on the name provided. This name is a base name, which is qualified to correspond to a particular JspServiceManager, so that naming collisions are avoided among p13n apps which co-exist in the same session.

Parameters:

aName - the name of the session value to be retrieved

aRequest - the javax.servlet.http.HttpServletRequest used to retrieve the current session

Returns:

Object

getSessionValue

public static java.lang.Object getSessionValue(java.lang.String scopeName,
                                               java.lang.String aName,
                                               javax.servlet.http.HttpServletRequest aRequest)

Retrieves a session value based on the name provided. This name is a base name, which is qualified to correspond to a particular JspServiceManager, so that naming collisions are avoided among p13n apps which co-exist in the same session.

Parameters:

scopeName - the scope associated with the property

aName - the name of the session value to be retrieved

aRequest - the javax.servlet.http.HttpServletRequest used to retrieve the current session

Returns:

Object

setSessionValue

public static void setSessionValue(java.lang.String aName,
                                   java.lang.Object aValue,
                                   javax.servlet.http.HttpServletRequest aRequest)

Sets a session value based on the name provided. This name is a base name, which is qualified to correspond to a particular JspServiceManager, so that naming collisions are avoided among p13n apps which co-exist in the same session.

Parameters:

aName - the name of the session value to be set

aValue - the new session value

aRequest - the javax.servlet.http.HttpServletRequest used to retrieve the current session

Returns:

Object

putSessionValue

public static void putSessionValue(java.lang.String aName,
                                   java.lang.Object aValue,
                                   javax.servlet.http.HttpServletRequest aRequest)

Sets a session value based on the name provided. This name is a base name, which is qualified to correspond to a particular JspServiceManager, so that naming collisions are avoided among p13n apps which co-exist in the same session.

Parameters:

aName - the name of the session value to be set

aValue - the new session value

aRequest - the javax.servlet.http.HttpServletRequest used to retrieve the current session

Returns:

Object

putSessionValue

public static void putSessionValue(java.lang.String scopeName,
                                   java.lang.String aName,
                                   java.lang.Object aValue,
                                   javax.servlet.http.HttpServletRequest aRequest)

Sets a session value based on the scope name and propertyname provided. This name is a base name, which is qualified to correspond to a particular ServiceManager, so that naming collisions are avoided among applications which co-exist in the same session.

Parameters:

scopeName - the name of the scope associated with the session value

aName - the name of the session value to be set

aValue - the new session value

aRequest - the javax.servlet.http.HttpServletRequest used to retrieve the current session

Returns:

Object

setSessionValue

public static void setSessionValue(java.lang.String scopeName,
                                   java.lang.String aName,
                                   java.lang.Object aValue,
                                   javax.servlet.http.HttpServletRequest aRequest)

removeSessionValue

public static void removeSessionValue(java.lang.String aName,
                                      javax.servlet.http.HttpServletRequest aRequest)

Removes a session value based on the name provided. This name is a base name, which is qualified to correspond to a particular JspServiceManager, so that naming collisions are avoided among p13n apps which co-exist in the same session.

Parameters:

aName - the name of the session value to be removed

aRequest - the javax.servlet.http.HttpServletRequest used to retrieve the current session

Returns:

Object

getDequalifiedSessionValues

public static java.util.Hashtable getDequalifiedSessionValues(javax.servlet.http.HttpServletRequest request)

Retrieves a hashtable of dequalified session property names and their corresponding values for the provided request.

Parameters:

request - the request whose session's values are sought

Returns:

a hash table of dequalified name-value pairs : null if no traffic URI is obtained