com.ibm.dse.cs.html
Interface JspContextServices

All Known Implementing Classes:
DSEJspContextServices

public interface JspContextServices

Interface that defines the protocol to access the context from a JSP


Method Summary
 java.lang.String getBaseWebPath()
          Obtain the relative path (relative to the web app server web path) for jsp resources.
 Context getContext()
          Get the operation context for the page which initialized this bean.
 java.lang.String[] getCrossValidationErrorList()
          Return the current list of cross validation errors.
 DataElement getElement(java.lang.String name)
          Returns the named data element from the context.
 DSEException getException()
          If the framework placed an exception in the HttpServletRequest with key name dseexception, then it can be saved here when the bean is initialized.
 java.lang.String getExceptionMessage()
          Return message text cooresponding to the current exception.
 java.lang.String getFieldErrorMarker(java.lang.String name)
          Return the current error marker only if the given field is in error.
 java.lang.String getFieldLabel(java.lang.String name)
          Returns the label associated with the given field in the context.
 java.lang.String getFieldValidationError(java.lang.String name, int idx)
          Return the field error message text at the specified index.
 java.lang.String getFieldValidationErrorDecorated(java.lang.String name, int idx)
          Return the field error message text at the specified index decorated with prefix and suffix HTML strings.
 java.lang.String[] getFieldValidationErrorList(java.lang.String name)
          Retrieve the entire error list for the field.
 java.lang.String[] getJspFormatErrorList()
          Returns the list of Jsp Format Errors that were found during Jsp Processing.
 java.lang.String getLinkToPage(java.lang.String webPath, java.lang.String pageName, java.lang.String linkText)
          Emit the Html to the JspWriter stream to create a link with given text to a given JSP saved in a given web path (relative to the base JSP path for the application server).
 java.lang.String getLocaleId()
          Obtain any extra path information passed on the call to establish the session.
 java.lang.String getRequiredHtmlFields()
          Returns an string containing the HTML for all of the HTML Client required fields.
 java.lang.String getRequiredHtmlFields(java.lang.String parentctx, java.lang.String opname)
          Returns an string containing the HTML for all of the HTML Client required fields using the passed parameters to fill in the user specifiable information.
 java.lang.String getRequiredHtmlFieldsForGETMethod()
          Returns a string containing the HTML for all of the HTML Client required fields using the passed parameters to fill in the user specifiable information.
 java.lang.String getRequiredHtmlFieldsForGETMethod(java.lang.String parentctx, java.lang.String opname)
          Returns an string containing the HTML for all of the HTML Client required fields using the passed parameters to fill in the user specifiable information.
 java.lang.String getSessionId()
          Returns the current session identifier string "as-is" Creation date: (6/20/00 3:27:10 PM)
 java.lang.String getSessionIdHtmlField()
          Returns the current session identifier string as an HTML hidden field.
 java.lang.String getSessionIdParameter()
          Returns the current session identifier string as a URL parameter.
 java.lang.String getStringValue(java.lang.String name)
          Returns the specified value from the operation context as a string.
 java.lang.String[] getValidationErrorList()
          Returns all validation errors in a single list array.
 java.lang.Object getValue(java.lang.String name)
          Returns the named value from the context in its natural format.
 boolean isFieldHidden(java.lang.String name)
          Returns the "hidden" status of the named field in the context.
 boolean isFieldInError(java.lang.String name)
          Returns the error status of the named field in the context.
 boolean isFieldMandatory(java.lang.String name)
          Returns the "input mandatory" status of the named field in the context.
 boolean isFieldReadOnly(java.lang.String name)
          Returns the "read only" status of the named field in the context.
 void setErrorDecorationPrefix(java.lang.String pfx)
          Sets up the error decorator prefix.
 void setErrorDecorationSuffix(java.lang.String sfx)
          Sets up the error decorator suffix.
 void setErrorMarker(java.lang.String newmarker)
          Sets up the error marker value.
 

Method Detail

getBaseWebPath

public java.lang.String getBaseWebPath()
Obtain the relative path (relative to the web app server web path) for jsp resources. Creation date: (6/21/00 5:38:55 PM)
Returns:
java.lang.String

getContext

public Context getContext()
Get the operation context for the page which initialized this bean. Creation date: (6/20/00 12:50:57 PM)
Returns:
com.ibm.dse.base.Context

getCrossValidationErrorList

public java.lang.String[] getCrossValidationErrorList()
Return the current list of cross validation errors. Creation date: (6/23/00 11:31:45 AM)
Returns:
java.lang.String[]

getElement

public DataElement getElement(java.lang.String name)
Returns the named data element from the context. If the element is not present in the context, null is returned. Creation date: (6/22/00 2:46:27 PM)
Parameters:
name - java.lang.String
Returns:
java.lang.Object

getException

public DSEException getException()
If the framework placed an exception in the HttpServletRequest with key name dseexception, then it can be saved here when the bean is initialized. Creation date: (6/20/00 2:52:32 PM)
Returns:
com.ibm.dse.base.DSEException

getExceptionMessage

public java.lang.String getExceptionMessage()
Return message text cooresponding to the current exception. Creation date: (6/20/00 12:56:19 PM)
Parameters:
param - javax.servlet.jsp.JspWriter

getFieldErrorMarker

public java.lang.String getFieldErrorMarker(java.lang.String name)
Return the current error marker only if the given field is in error. Creation date: (6/22/00 4:52:56 PM)
Parameters:
name - java.lang.String
Returns:
java.lang.String

getFieldLabel

public java.lang.String getFieldLabel(java.lang.String name)
Returns the label associated with the given field in the context. Creation date: (6/22/00 1:22:11 PM)
Parameters:
name - java.lang.String
Returns:
java.lang.String

getFieldValidationError

public java.lang.String getFieldValidationError(java.lang.String name,
                                                int idx)
Return the field error message text at the specified index. This method returns a blank string if the field has no errors. Creation date: (6/23/00 12:13:19 PM)
Parameters:
name - java.lang.String
idx - int
Returns:
java.lang.String

getFieldValidationErrorDecorated

public java.lang.String getFieldValidationErrorDecorated(java.lang.String name,
                                                         int idx)
Return the field error message text at the specified index decorated with prefix and suffix HTML strings. This method returns a blank string if the field has no errors. Creation date: (6/23/00 12:13:19 PM)
Parameters:
name - java.lang.String
idx - int
Returns:
java.lang.String

getFieldValidationErrorList

public java.lang.String[] getFieldValidationErrorList(java.lang.String name)
Retrieve the entire error list for the field. An array of zero size is returned if there are no errors associated with the field. Creation date: (6/23/00 12:30:22 PM)
Parameters:
name - java.lang.String
Returns:
java.lang.String[]

getJspFormatErrorList

public java.lang.String[] getJspFormatErrorList()
Returns the list of Jsp Format Errors that were found during Jsp Processing. Creation date: (7/5/00 3:12:40 PM)
Returns:
java.lang.String[]

getLinkToPage

public java.lang.String getLinkToPage(java.lang.String webPath,
                                      java.lang.String pageName,
                                      java.lang.String linkText)
Emit the Html to the JspWriter stream to create a link with given text to a given JSP saved in a given web path (relative to the base JSP path for the application server). The link will include the session id using URL rewriting. Creation date: (6/20/00 3:39:50 PM)
Parameters:
param - javax.servlet.jsp.JspWriter
webPath - java.lang.String
pageName - java.lang.String
linkText - java.lang.String

getLocaleId

public java.lang.String getLocaleId()
Obtain any extra path information passed on the call to establish the session. For example, if the URL was invoked as:
http://.../CSEstablishSessionServlet/en
then the locale id is the string en. Creation date: (6/21/00 5:38:55 PM)
Returns:
java.lang.String

getRequiredHtmlFields

public java.lang.String getRequiredHtmlFields()
Returns an string containing the HTML for all of the HTML Client required fields.
Returns:
java.lang.String

getRequiredHtmlFields

public java.lang.String getRequiredHtmlFields(java.lang.String parentctx,
                                              java.lang.String opname)
Returns an string containing the HTML for all of the HTML Client required fields using the passed parameters to fill in the user specifiable information.
Parameters:
parentctx - java.lang.String
opname - java.lang.String
Returns:
java.lang.String

getRequiredHtmlFieldsForGETMethod

public java.lang.String getRequiredHtmlFieldsForGETMethod()
Returns a string containing the HTML for all of the HTML Client required fields using the passed parameters to fill in the user specifiable information. If no opName is specified, assume that this page is being displayed within a processor flow, so the processor name is got from the table of stored processors. The returned String is for use as part of an URL. The format is the needed to be sent via the GET method: param1=value1¶m2=value2&...¶mN=valueN
Returns:
String - The required fields html in the format needed to send using the GET method.

getRequiredHtmlFieldsForGETMethod

public java.lang.String getRequiredHtmlFieldsForGETMethod(java.lang.String parentctx,
                                                          java.lang.String opname)
Returns an string containing the HTML for all of the HTML Client required fields using the passed parameters to fill in the user specifiable information. The returned String is for use as part of an URL. The format is the needed to be sent via the GET method: param1=value1¶m2=value2&...¶mN=valueN
Parameters:
parentctx - java.lang.String
opname - java.lang.String
Returns:
java.lang.String

getSessionId

public java.lang.String getSessionId()
Returns the current session identifier string "as-is" Creation date: (6/20/00 3:27:10 PM)
Returns:
java.lang.String

getSessionIdHtmlField

public java.lang.String getSessionIdHtmlField()
Returns the current session identifier string as an HTML hidden field. Creation date: (6/22/00 2:27:48 PM)
Returns:
java.lang.String

getSessionIdParameter

public java.lang.String getSessionIdParameter()
Returns the current session identifier string as a URL parameter. Creation date: (6/22/00 1:41:24 PM)
Returns:
java.lang.String

getStringValue

public java.lang.String getStringValue(java.lang.String name)
Returns the specified value from the operation context as a string. Handles exceptions by returning a null string value. Creation date: (6/22/00 1:22:11 PM)
Parameters:
name - java.lang.String
Returns:
java.lang.String

getValidationErrorList

public java.lang.String[] getValidationErrorList()
Returns all validation errors in a single list array. Creation date: (6/23/00 11:31:14 AM)
Returns:
java.lang.String[]

getValue

public java.lang.Object getValue(java.lang.String name)
Returns the named value from the context in its natural format. If the element is not present in the context, null is returned. Creation date: (6/22/00 2:46:27 PM)
Parameters:
name - java.lang.String
Returns:
java.lang.Object

isFieldHidden

public boolean isFieldHidden(java.lang.String name)
Returns the "hidden" status of the named field in the context. Creation date: (6/22/00 4:57:08 PM)
Parameters:
name - java.lang.String
Returns:
boolean

isFieldInError

public boolean isFieldInError(java.lang.String name)
Returns the error status of the named field in the context. Creation date: (6/22/00 4:57:08 PM)
Parameters:
name - java.lang.String
Returns:
boolean

isFieldMandatory

public boolean isFieldMandatory(java.lang.String name)
Returns the "input mandatory" status of the named field in the context. Creation date: (6/22/00 4:57:08 PM)
Parameters:
name - java.lang.String
Returns:
boolean

isFieldReadOnly

public boolean isFieldReadOnly(java.lang.String name)
Returns the "read only" status of the named field in the context. Creation date: (6/22/00 4:57:08 PM)
Parameters:
name - java.lang.String
Returns:
boolean

setErrorDecorationPrefix

public void setErrorDecorationPrefix(java.lang.String pfx)
Sets up the error decorator prefix. This prefix is prepended to any error information returned in a "decorated" error string. Creation date: (6/23/00 2:17:22 PM)
Parameters:
pfx - java.lang.String

setErrorDecorationSuffix

public void setErrorDecorationSuffix(java.lang.String sfx)
Sets up the error decorator suffix. This suffix is appended to any error information returned in a "decorated" error string. Creation date: (6/23/00 2:17:22 PM)
Parameters:
pfx - java.lang.String

setErrorMarker

public void setErrorMarker(java.lang.String newmarker)
Sets up the error marker value. This is the string that is returned by the "getFieldErrorMarker" method if the field is found to be in error. Creation date: (6/22/00 5:03:20 PM)
Parameters:
newmarker - java.lang.String