IBM WebSphere Multichannel Bank Transformation Toolkit Javadoc

com.ibm.btt.base
Class FunctionalErrorTraceHelper

java.lang.Object
  extended by com.ibm.btt.base.FunctionalErrorTraceHelper

public class FunctionalErrorTraceHelper
extends java.lang.Object

This is a helper class used to separate functional error tracing code from the rest of the code.


Constructor Summary
FunctionalErrorTraceHelper()
           
 
Method Summary
static void ajaxOperationFailed(java.lang.Exception e, Operation op)
          Traces an error triggered when an AJAX operation generates an exception.
static boolean checkPageAvailability(javax.servlet.Servlet reqServlet, java.lang.String jspFullName)
          Checks whether a JSP page exists, and traces an error if it does not.
static void destinationDataNotFoundWhileMapping(java.lang.Exception e, Context toCtx, java.lang.String toExpr)
          Traces an error triggered when a mapping fails because the mapping target is not found.
static void expressionMappingFailed(javax.script.ScriptException e, java.lang.String expression)
          Traces an error triggered when an expression in the mapping source fails during evaluation
static void flowNotFound(java.lang.Exception e, java.lang.String flowName)
          Traces an error triggered when a flow cannot be instantiated from its id
static java.lang.String[] getMessagesForException(java.lang.Throwable t)
          Returns zero or more error messages associated to a given exception.
static void incompatibleTypeMapping(java.lang.Exception e, DataElement fromDataElement, DataElement toDataElement)
          Traces an error triggered when mapping between incompatible types.
static void missingFieldOnPagePost(java.lang.Exception e, Processor proc, DataElement data)
           
static void missingTransition(java.lang.Exception e, Processor proc, java.lang.String eventName)
          Traces an error triggered when an event is generated at a state that has no associated transition for it.
static void operationFailed(java.lang.Exception e, Operation op)
          Traces an error triggered when an operation throws an exception during its execution.
static void operationNotFound(java.lang.Exception e, java.lang.String operationName)
          Traces an error triggered when an operation cannot be instantiated from its id
static void refDataNotFound(java.lang.Exception e, Tag parentTag, java.lang.String tagId, java.lang.String xmlFile)
          Traces an error triggered when a refData element references a non-existing data element.
static void viewRenderFailed(java.lang.Exception e, java.lang.String replyPageName)
          Traces an error triggered when a view fails to render.
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

FunctionalErrorTraceHelper

public FunctionalErrorTraceHelper()
Method Detail

flowNotFound

public static void flowNotFound(java.lang.Exception e,
                                java.lang.String flowName)
Traces an error triggered when a flow cannot be instantiated from its id

Parameters:
e - originating exception
flowName - the id of the flow that could not be instantiated

operationNotFound

public static void operationNotFound(java.lang.Exception e,
                                     java.lang.String operationName)
Traces an error triggered when an operation cannot be instantiated from its id

Parameters:
e - originating exception
operationName - the id of the operation that could not be instantiated

checkPageAvailability

public static boolean checkPageAvailability(javax.servlet.Servlet reqServlet,
                                            java.lang.String jspFullName)
Checks whether a JSP page exists, and traces an error if it does not.

Parameters:
req - the servlet request object
jspFullName - the full JSP path
Returns:
false if the page is not available, true if it is available or not enough information is available to determine page availability

viewRenderFailed

public static void viewRenderFailed(java.lang.Exception e,
                                    java.lang.String replyPageName)
Traces an error triggered when a view fails to render.

Parameters:
e - exception thrown while forwarding the page
replyPageName - the name of the JSP

operationFailed

public static void operationFailed(java.lang.Exception e,
                                   Operation op)
Traces an error triggered when an operation throws an exception during its execution.

Parameters:
e - the exception thrown by the operation
op - the failing operation

missingTransition

public static void missingTransition(java.lang.Exception e,
                                     Processor proc,
                                     java.lang.String eventName)
Traces an error triggered when an event is generated at a state that has no associated transition for it.

Parameters:
e - the originating exception
proc - the processor instance that triggered the event
eventName - the event id

destinationDataNotFoundWhileMapping

public static void destinationDataNotFoundWhileMapping(java.lang.Exception e,
                                                       Context toCtx,
                                                       java.lang.String toExpr)
Traces an error triggered when a mapping fails because the mapping target is not found.

Parameters:
e - originating exception
toCtx - the target context
toExpr - the target mapping expression

incompatibleTypeMapping

public static void incompatibleTypeMapping(java.lang.Exception e,
                                           DataElement fromDataElement,
                                           DataElement toDataElement)
Traces an error triggered when mapping between incompatible types.

Parameters:
e - originating exception
fromDataElement - mapping source element
toDataElement - mapping destination element

expressionMappingFailed

public static void expressionMappingFailed(javax.script.ScriptException e,
                                           java.lang.String expression)
Traces an error triggered when an expression in the mapping source fails during evaluation

Parameters:
e -
expression -

ajaxOperationFailed

public static void ajaxOperationFailed(java.lang.Exception e,
                                       Operation op)
Traces an error triggered when an AJAX operation generates an exception.

Parameters:
e - the exception thrown by the operation
op - the failing operation

refDataNotFound

public static void refDataNotFound(java.lang.Exception e,
                                   Tag parentTag,
                                   java.lang.String tagId,
                                   java.lang.String xmlFile)
Traces an error triggered when a refData element references a non-existing data element.

Parameters:
e - the originating exception
parentTag - the refData tag
tagId - the refId value
xmlFile - the id of the flow or operation containing the refData element

missingFieldOnPagePost

public static void missingFieldOnPagePost(java.lang.Exception e,
                                          Processor proc,
                                          DataElement data)

getMessagesForException

public static java.lang.String[] getMessagesForException(java.lang.Throwable t)
Returns zero or more error messages associated to a given exception. This is useful for redisplaying the error message, for example from the error jsp page.

Parameters:
t - the exception to retrieve the associated messages
Returns:
the associated messages, if found, or an empty array otherwise

IBM WebSphere Multichannel Bank Transformation Toolkit Javadoc

(c) Copyright IBM Corporation 1998, 2011