ariba.ui.aribaweb.core
Class AWErrorManager

java.lang.Object
  ariba.ui.aribaweb.util.AWBaseObject
      ariba.ui.aribaweb.core.AWErrorManager

All Implemented Interfaces:

AWObject

Direct Known Subclasses:

AWErrorManager.AWNewErrorManager

public class AWErrorManager
extends AWBaseObject

Nested Class Summary

static class	AWErrorManager.AWNewErrorManager This class is here to restrict access to the AWErrorManager so that the only interaction we do with it is to call setErrorMessageAndValue(...).
static class	AWErrorManager.MultiErrorBucket

Field Summary

static int	ApplyValuesPhase
static String	EnvironmentErrorKey
static String	GeneralErrorKey
static String	InstanceKey
static int	InvokePhase
static int	OutOfPhase
static int	RenderPhase

Fields inherited from class ariba.ui.aribaweb.util.AWBaseObject

AribaHashtableClass, AribaVectorClass, ClassClass, EmptyHashtable, EmptyMap, EmptyVector, False, IntegerClass, JavaHashtableClass, JavaMapClass, JavaVectorClass, LogHandling, NullObject, ObjectClass, StringClass, True, UndefinedObject, UndefinedString, UninitializedRealNumber

Constructor Summary

AWErrorManager(AWPage page)

Method Summary

List	_getRegisteredValidationHandlers()
void	_setupOffPageNavigationAtDst(AWErrorInfo curError, AWErrorHandler navHandler)
boolean	allErrorsAreWarnings()
AWComponent	alternateResponseForNavigationAction(AWComponent target, int action)
boolean	changesSavedSafely()
boolean	checkErrorsAndEnableDisplay()
void	clearErrorInAppend(Object key) Clear a single error, during append.
void	clearHighLightedError()
void	enableErrorDisplay(boolean enable)
Object	errantValueForKey(Object key)
String	errorMessageForKey(Object key)
List<AWErrorBucket>	errorsForKeys(Object[] keys)
List	errorsForValueSource(Object valueSource)
List	errorsForValueSource(Object valueSource, String fieldPath)
List<AWErrorBucket>	errorsForValueSource(Object valueSource, String fieldPath, String group)
AWErrorInfo	firstErrorForKeys(Object[] keys, boolean isWarning)
String	firstErrorMessageForKeys(Object[] keys)
String	firstWarningMessageForKeys(Object[] keys)
List<AWErrorInfo>	getAllErrors()
List<AWErrorInfo>	getAllWarnings()
AWComponent	getDeferredNavigationDestination()
static Object	getErrorKeyForComponent(AWComponent comp)
static Object[]	getErrorKeyFromBindings(AWComponent comp)
static Object[]	getErrorKeyFromBindingsOnly(AWComponent comp)
AWEncodedString	getErrorNavSubmitForm()
int	getErrorSetId()
AWErrorInfo	getHighLightedError()
boolean	getIgnoreKnownWarnings()
String	getLogPrefix()
int	getNumberOfErrors()
int	getNumberOfErrors(boolean excludeKnownWarnings)
AWErrorInfo	getPreviousError()
ariba.ui.aribaweb.core.AWErrorManager.EMMultiKeyHashtable	getVisitedErrors()
boolean	hasDeferredNavHandlerForCurrentError()
boolean	hasErrors()
boolean	hasHighLightedError()
boolean	hasNewError(Object key)
boolean	hasWarnings()
boolean	isErrorDisplayEnabled()
boolean	isHighLightedError(Object key)
boolean	isHighLightedError(Object[] keys)
boolean	isValidationRequiredInAppend()
Object	mostRecentErrorKey()
void	navToErrorAsNeeded(boolean onlyInAppend, Object keysForPendingDisplayError, boolean forceCheckExistence)
AWComponent	navUsingDeferredNavHandler(AWComponent pageComponent)
AWErrorInfo	newErrorForKey(Object key) Get the recently added error for this key.
String	newErrorMessageForKey(Object key) Get the recently added error for this key.
Object	newErrorValueForKey(Object key) Get the recently added error value for this key.
AWComponent	nextError(AWComponent pageComponent)
int	phase()
AWComponent	prevError(AWComponent pageComponent)
void	registerErrorHandler(AWErrorHandler handler, int priority)
void	registerErrorHandler(AWErrorHandler handler, int priority, boolean isAutoScrollHandler)
void	registerFullValidationHandler(AWFullValidationHandler handler)
boolean	requiresRevalidation()
void	rerunValidation()
void	setAssociatedTableItem(Object[] errorKeys, AWComponent datatable, Object tableItem)
void	setChangesSavedSafely(boolean flag)
void	setErrorDisplayOrder(AWErrorInfo error, boolean isNavigable)
void	setErrorNavSubmitForm(AWRequestContext requestContext)
void	setIgnoreKnownWarnings(boolean ignore) Indicates whether error count should include the warnings that have been displayed before.
void	setMostRecentErrorKey(Object errorKey)
void	setPhase(int phase)
void	unregisterErrorHandler(AWErrorHandler handler)
void	unregisterFullValidationHandler(AWFullValidationHandler handler)
void	validateOnAppend()
String	warningMessageForKey(Object key)

Methods inherited from class ariba.ui.aribaweb.util.AWBaseObject

debugString, ensureFieldValuesClear, getFieldValue, init, isKindOfClass, localizedJavaString, logString, logWarning, setFieldValue

Methods inherited from class java.lang.Object

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

Field Detail

GeneralErrorKey

public static final String GeneralErrorKey

See Also:

Constant Field Values

InstanceKey

public static final String InstanceKey

See Also:

Constant Field Values

EnvironmentErrorKey

public static final String EnvironmentErrorKey

See Also:

Constant Field Values

OutOfPhase

public static int OutOfPhase

RenderPhase

public static int RenderPhase

ApplyValuesPhase

public static int ApplyValuesPhase

InvokePhase

public static int InvokePhase

Constructor Detail

AWErrorManager

public AWErrorManager(AWPage page)

Method Detail

setPhase

public void setPhase(int phase)

phase

public int phase()

validateOnAppend

public void validateOnAppend()

isValidationRequiredInAppend

public boolean isValidationRequiredInAppend()

setErrorNavSubmitForm

public void setErrorNavSubmitForm(AWRequestContext requestContext)

getErrorNavSubmitForm

public AWEncodedString getErrorNavSubmitForm()

isErrorDisplayEnabled

public boolean isErrorDisplayEnabled()

enableErrorDisplay

public void enableErrorDisplay(boolean enable)

getNumberOfErrors

public int getNumberOfErrors()

setIgnoreKnownWarnings

public void setIgnoreKnownWarnings(boolean ignore)

Indicates whether error count should include the warnings that have been displayed before. Let's say a page has only warnings. When we ask the question "Is the page valid?" before taking a submit action, the error count will not be zero because there are warnings. However, if ask again (and go through another append cycle), the exact same warnings are considered known warnings. If desired, setting this flag will result in the error count to exclude the known warnings. In that case, the answer to "Is the page valid?" will be Yes and the submit action will go through. By default we don't ignore known warnings.

Parameters:

ignore -

getIgnoreKnownWarnings

public boolean getIgnoreKnownWarnings()

getNumberOfErrors

public int getNumberOfErrors(boolean excludeKnownWarnings)

getAllErrors

public List<AWErrorInfo> getAllErrors()

hasErrors

public boolean hasErrors()

getAllWarnings

public List<AWErrorInfo> getAllWarnings()

hasWarnings

public boolean hasWarnings()

allErrorsAreWarnings

public boolean allErrorsAreWarnings()

setErrorDisplayOrder

public void setErrorDisplayOrder(AWErrorInfo error,
                                 boolean isNavigable)

checkErrorsAndEnableDisplay

public boolean checkErrorsAndEnableDisplay()

hasNewError

public boolean hasNewError(Object key)

newErrorForKey

public AWErrorInfo newErrorForKey(Object key)

Get the recently added error for this key. This method should NOT be used to get the errors while building the user interface, because it will violate phase boundaries. Use errorMessageForKey instead.

Parameters:

key - The error key

Returns:

the error object if any

newErrorMessageForKey

public String newErrorMessageForKey(Object key)

Get the recently added error for this key. This method should NOT be used to get the errors while building the user interface, because it will violate phase boundaries. Use errorMessageForKey instead.

Parameters:

key - The error key

Returns:

the error message if any, or null if there is no error

See Also:

errorMessageForKey(java.lang.Object)

newErrorValueForKey

public Object newErrorValueForKey(Object key)

Get the recently added error value for this key. This method should NOT be used to get the errors while building the user interface, because it will violate phase boundaries. Use errorValueForKey instead.

Parameters:

key - The error key

Returns:

the error value if any, or null if there is no error

See Also:

errantValueForKey(java.lang.Object)

errorMessageForKey

public String errorMessageForKey(Object key)

warningMessageForKey

public String warningMessageForKey(Object key)

errantValueForKey

public Object errantValueForKey(Object key)

errorsForKeys

public List<AWErrorBucket> errorsForKeys(Object[] keys)

firstErrorMessageForKeys

public String firstErrorMessageForKeys(Object[] keys)

firstWarningMessageForKeys

public String firstWarningMessageForKeys(Object[] keys)

firstErrorForKeys

public AWErrorInfo firstErrorForKeys(Object[] keys,
                                     boolean isWarning)

errorsForValueSource

public List errorsForValueSource(Object valueSource)

errorsForValueSource

public List errorsForValueSource(Object valueSource,
                                 String fieldPath)

errorsForValueSource

public List<AWErrorBucket> errorsForValueSource(Object valueSource,
                                                String fieldPath,
                                                String group)

getErrorKeyForComponent

public static Object getErrorKeyForComponent(AWComponent comp)

getErrorKeyFromBindings

public static Object[] getErrorKeyFromBindings(AWComponent comp)

getErrorKeyFromBindingsOnly

public static Object[] getErrorKeyFromBindingsOnly(AWComponent comp)

clearErrorInAppend

public void clearErrorInAppend(Object key)

Clear a single error, during append. A call to this method is not allowed except during append

Parameters:

key - - the error key that should be cleared

mostRecentErrorKey

public Object mostRecentErrorKey()

setMostRecentErrorKey

public void setMostRecentErrorKey(Object errorKey)

setChangesSavedSafely

public void setChangesSavedSafely(boolean flag)

changesSavedSafely

public boolean changesSavedSafely()

registerErrorHandler

public void registerErrorHandler(AWErrorHandler handler,
                                 int priority)

registerErrorHandler

public void registerErrorHandler(AWErrorHandler handler,
                                 int priority,
                                 boolean isAutoScrollHandler)

unregisterErrorHandler

public void unregisterErrorHandler(AWErrorHandler handler)

registerFullValidationHandler

public void registerFullValidationHandler(AWFullValidationHandler handler)

unregisterFullValidationHandler

public void unregisterFullValidationHandler(AWFullValidationHandler handler)

_getRegisteredValidationHandlers

public List _getRegisteredValidationHandlers()

rerunValidation

public void rerunValidation()

getHighLightedError

public AWErrorInfo getHighLightedError()

getPreviousError

public AWErrorInfo getPreviousError()

getVisitedErrors

public ariba.ui.aribaweb.core.AWErrorManager.EMMultiKeyHashtable getVisitedErrors()

isHighLightedError

public boolean isHighLightedError(Object key)

isHighLightedError

public boolean isHighLightedError(Object[] keys)

hasHighLightedError

public boolean hasHighLightedError()

getDeferredNavigationDestination

public AWComponent getDeferredNavigationDestination()

clearHighLightedError

public void clearHighLightedError()

navToErrorAsNeeded

public void navToErrorAsNeeded(boolean onlyInAppend,
                               Object keysForPendingDisplayError,
                               boolean forceCheckExistence)

nextError

public AWComponent nextError(AWComponent pageComponent)

prevError

public AWComponent prevError(AWComponent pageComponent)

_setupOffPageNavigationAtDst

public void _setupOffPageNavigationAtDst(AWErrorInfo curError,
                                         AWErrorHandler navHandler)

hasDeferredNavHandlerForCurrentError

public boolean hasDeferredNavHandlerForCurrentError()

navUsingDeferredNavHandler

public AWComponent navUsingDeferredNavHandler(AWComponent pageComponent)

getLogPrefix

public String getLogPrefix()

setAssociatedTableItem

public void setAssociatedTableItem(Object[] errorKeys,
                                   AWComponent datatable,
                                   Object tableItem)

getErrorSetId

public int getErrorSetId()

alternateResponseForNavigationAction

public AWComponent alternateResponseForNavigationAction(AWComponent target,
                                                        int action)

requiresRevalidation

public boolean requiresRevalidation()

Returns:

whether a set has resulted in the need to re-validate