ariba.ui.aribaweb.core
Class AWComponent

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

All Implemented Interfaces:

AWCycleable, AWCycleableReference, AWResponseGenerating, AWResponseGenerating.ResponseSubstitution, AWObject

Direct Known Subclasses:

AribaAction, AribaCondition, AribaContactBox, AribaHelp, AribaImage, AribaNotificationDialog, AribaPrintMenu, AribaResourceUrl, AribaShutdownWarning, AribaSite, AribaString, AWActionCheckbox, AWArea, AWBackTrack, AWBaseImage, AWBaseMonitorStatsPage, AWBody, AWBrowser, AWCatch, AWCheckbox, AWClientSideScript, AWComponentInclude, AWCurrWindowDecl, AWDebugContent, AWDragContainer, AWDropContainer, AWEditableRegion, AWErrorManagerScope, AWEvaluateTemplateFile, AWExceptionBodyRenderer, AWFileDownload, AWFileUpload, AWFileUploadInternals, AWFocusRegion, AWForm, AWFormRedirect, AWFrame, AWGenericActionTag, AWGroupingRepetition, AWHead, AWHiddenFormParameter, AWHiddenFormValue, AWHighLightedErrorScope, AWHyperlink, AWIFrame, AWImageButton, AWImageData, AWIncludeBlock, AWInstanceInclude, AWJSDebug, AWJSListRepetition, AWLabel, AWLazyDiv, AWLazyDivInternals, AWMetaContentType, AWMetaRefresh, AWMetaTemplateWrapper, AWMonitorSessionStatsPage, AWPageRedirect, AWPageWrapper, AWPasswordField, AWPollInterval, AWPopup, AWPrivateHyperlink, AWPrivateScript, AWRadioButton, AWRadioButtonEnvironment, AWRedirect, AWRefreshRegion, AWRelocatableDiv, AWRemoteLink, AWRemotePageWrapper, AWRichClientFooter, AWSingleton, AWStyleSheet, AWSubmitButton, AWSwitchTemplate, AWTBatchNavigationBar, AWTDataTable, AWTDataTable.ColumnRenderer, AWTDragList, AWTExportConditional, AWTextArea, AWTextField, AWTMetaContentRenderer, AWTOptionalColumnsPage, AWTOptionsMenuButton, AWTOptionsMenuItems, AWTPivotConfigurationPanel, AWTScrollTableWrapper, AWTSortHeading, AWVModalPageWrapper, AWVTextArea, AWXBasicScriptFunctions, AWXHandleExceptionPage, AWXLogString, AWXSessionRestorationErrorPage, BaseTabSet, BasicNavigator, BrandedComponent, BrandingComponent, BucketHeading, BucketItem, BucketsTOC, Calendar, Chart, ChartData, ChartPivotData, CheckboxList, Chooser, ChooserPanel, ClientPanelWrapper, ComplexRepetition, Confirmation, CueTip, DateField, DefaultCommandBar, DeferredDisplayWrapper, DialogContentWrapper, DialogPageWrapper, ErrorBubble, ErrorFlag, FileBrowser, FileUploadChooser, FileUploadStatusBar, FooterIncludes, FooterLinks, FormGroupBlock, FormRow, FormTable, FourZoneLayout, GenericChooser, GoogleAnalyticsFooter, GoogleAnalyticsHeader, GradientBox, HeaderIncludes, HintMessage, HTMLActionFilter, HtmlInclude, ImagePrefetch, MapForEach, MessageBanner, MessagesList, MetaActionList, MetaContentPage, MetaDetailTable, MetaForm, MetaHomePage, MetaInspectorPane, MetaLayout, MetaList, MetaMarkdown, MetaModalPage, MetaNavEditorMenu, MetaNavTabBar, MetaRange, MetaSearch, MetaSearchForm, MetaSideInspector, MetaTable, MetaTableColumnsRenderer, MetaTabs, MimeMessageView, ModalPageWrapper, ModalWindowClose, ModalWindowExceptionPage, ModalWindowLink, ModalWindowScriptFunctions, ModalWindowWrapper, MRUTabList, OutlineBox, OutlineControl, OutlineFolderControl, OutlineInnerRepetition, OutlineRepetition, PaddedImage, PageErrorPanel, PageWrapper, PageWrapperForm, PopupCalendar, PopupControl, PopupMenu, PopupMenuButton, PopupMenuHeading, PopupMenuItem, PopupMenuLink, PortletWrapper, PulldownButton, RadioButtonList, RichTextArea, RichTextAreaScript, RoundedBox, RoundedCorners, RoundedStep, SearchBox, SectionBody, SectionHeading, SetterLink, SimpleTocPanel, StepByStepTOC, StepHeader, StepNavigator, StepNavigatorBar, StepNavigatorButton, StepNavigatorButtonContent, Substep, Tab, TableHeaderRow, TabList, TabSet, TestComponentPage, TextButton, TextFormSubmitButton, TocPanel, TocPanelItem, ToggleBox, ToggleImage, TopFrameRedirect, TruncateString, VirtualForm, WaterMark, WidgetInclude, WidgetsJavaScript, WizardAction, WizardButtonsBarBottom, WizardButtonsBarTop, WizardFrameContent, WizardNavigator, WizardPage, WizardPageWrapper, WizardTOC

public class AWComponent
extends AWBaseObject
implements AWCycleable, AWCycleableReference, AWResponseGenerating, AWResponseGenerating.ResponseSubstitution

AWComponent is the key class for template/based interactive content. All "pages", page sub-sections, "wrappers", as well as most controls / widgets, and even control contructs are implemented as subclasses of AWComponent.

Components typically have a template (.awl file) containing "bare html text" mixed with references to other embedded AWComponents (or low level elements). These, in turn, have bindings that refer back to the java instance paired with the template (often using fieldpaths to dynamically push/pull values and invoke actions.

Components may be either stateless (pooled) or stateful (bound to their page instance and stored in the session. (Typically pages, page sub-sections, and particular rich components are stateful, while simple controls are stateless and simply push/pull their needed state from their parent component via bindings).

Simple subclasses of AWComponent typically declare instance variables (possible public for use in bindings) as well as action methods (which return reponses which are usually just other page-level AWComponent instances for the next page (or null to rerender the current page while reflecting any updated state).

Components participate in the AWCycleable request handling lifecycle. In addition to renderResponse(AWRequestContext, AWComponent), applyValues(AWRequestContext, AWComponent), and invokeAction(AWRequestContext, AWComponent), an AWComponent also experiences init(), awake(), sleep(), and even possibly hibernate().

Nested Class Summary

Nested classes/interfaces inherited from interface ariba.ui.aribaweb.core.AWResponseGenerating

AWResponseGenerating.ResponseSubstitution

Field Summary

static Class	ClassObject
static String	ComponentTemplateFileExtension

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

AWComponent()

Method Summary

void	_topLevelApplyValues(AWRequestContext requestContext, AWComponent component)
AWResponseGenerating	_topLevelInvokeAction(AWRequestContext requestContext, AWComponent component)
void	_topLevelRenderResponse(AWRequestContext requestContext, AWComponent component)
boolean	allowEmbeddedKeyPaths()
boolean	allowsWhitespaceCompression()
AWApplication	application()
void	applyValues(AWRequestContext requestContext, AWComponent component) The receiver should take any form values (or query string parameters) that it owns from the AWRequestContext.request().
AWComponent	awcyclePageAndLog()
AWBinding	bindingForName(String bindingName)
AWBinding	bindingForName(String bindingName, boolean recursive)
AWBindingDictionary	bindings()
boolean	booleanValueForBinding(AWBinding binding)
boolean	booleanValueForBinding(AWBinding binding, boolean defaultValue)
boolean	booleanValueForBinding(String bindingName)
boolean	booleanValueForBinding(String bindingName, boolean defaultValue)
String	browserMaxWidth()
String	browserMinWidth()
AWCharacterEncoding	characterEncoding()
void	clearValidationError(Object errorKey) Clear an error in the error manager.
TimeZone	clientTimeZone()
Object	componentConfiguration(String configName)
AWComponentDefinition	componentDefinition()
AWFastStringBuffer	componentPath(String separatorString)
AWComponentReference	componentReference()
static AWComponent	createPageWithName(String pageName)
static AWTemplateParser	defaultTemplateParser()
AWElement	determineInstance(String elementName, Map bindingsHashtable, String templateName, int lineNumber)
AWElement	determineInstance(String elementName, String translatedClassName, Map bindingsHashtable, String templateName, int lineNumber)
Map	dict()
Object	dict(String key)
void	dict(String key, Object value)
double	doubleValueForBinding(AWBinding binding)
double	doubleValueForBinding(String bindingName)
double	doubleValueForBinding(String bindingName, double defaultValue)
AWEncodedString	encodedStringValueForBinding(AWBinding binding)
AWEncodedString	encodedStringValueForBinding(String bindingName)
void	ensureAwake(AWPage page)
void	ensureFieldValuesClear()
AWEnvironmentStack	env()
AWErrorManager	errorManager() Retrieve the error manager for the page.
AWEncodedString	escapeAttribute(AWEncodedString attributeValue)
AWEncodedString	escapeString(Object object)
AWEncodedString	escapeUnsafeString(Object object)
Map	extendedFields()
AWFormValueManager	formValueManager()
AWResponse	generateResponse()
AWResponse	generateResponse(AWResponse response)
AWResponse	generateResponse(AWResponse response, AWRequestContext requestContext)
String	generateStringContents()
AWParameters	getAWParameter() Allows for parameter field value syntax in AWL files.
AWComponent	getThis() This method allows for access to the current component fromthe .awl via "$this"
boolean	hasBinding(AWBinding binding)
boolean	hasBinding(String bindingName)
boolean	hasContentNamed(String name)
boolean	hasMultipleTemplates()
boolean	hasSubTemplateNamed(String templateName) Deprecated. Use hasContentNamed()
javax.servlet.http.HttpSession	httpSession()
void	init()
void	init(AWComponentReference componentReference, AWComponent parentComponent, AWPage page)
int	intValueForBinding(AWBinding binding)
int	intValueForBinding(String bindingName)
int	intValueForBinding(String bindingName, int defaultValue)
AWResponseGenerating	invokeAction(AWRequestContext requestContext, AWComponent component) The receiver should determine if it is the intended recipient of the current action (by checking the AWRequestContext.request() AWRequest.senderId()) and, if so, handle the action and return the result.
boolean	isBidirectional()
boolean	isBrowserMicrosoft()
boolean	isClientPanel()
boolean	isMacintosh()
boolean	isStateless() Overridden by AWComponent subclasses to indicate whether component instances should be preseved with the page/session (i.e.
boolean	isStrictTagNaming()
boolean	isValidationEnabled()
String	languageDirection()
String	languageLeft()
String	languageRight()
AWTemplate	loadTemplate()
String	localizedJavaString(int stringId, String originalString)
AWBacktrackState	markBacktrackState()
String	name()
String	namePath()
void	notifyChange() Only applicable to pageComponents.
AWBindingDictionary	otherBindings()
AWStringDictionary	otherBindingsValues()
AWPage	page()
AWComponent	pageComponent()
<T> T	pageWithClass(Class<T> tClass)
<T> T	pageWithClass(Class<T> tClass, Map<String,Object> assignments)
AWComponent	pageWithName(String pageName)
AWComponent	pageWithName(String pageName, Map<String,Object> assignments)
AWComponent	parent()
void	postTakeValueActions() Deprecated.
Locale	preferredLocale()
void	recordBacktrackState(int userBacktrackState)
void	recordBacktrackState(Object userBacktrackState)
void	recordValidationError(AWErrorInfo error) Record an error to the error manager.
void	recordValidationError(Object errorKey, String errorMessage, Object errantValue) Record an error to the error manager.
void	recordValidationError(Throwable exception, Object errorKey, Object errantValue) Record an error to the error manager.
void	recordValidationErrors(List errors) Record multiple error to the error manager.
void	recordValidationWarning(Object errorKey, String warningMessage) Record an error to the error manager.
AWPageRedirect	redirectToPage(AWComponent destinationPage)
static void	registerXmlNodeWithName(String xmlNodeName)
void	removeBacktrackState()
void	renderResponse(AWRequestContext requestContext, AWComponent component) The receiver should render its content to the AWRequestContext.response()
AWResponseGenerating	replacementResponse()
AWRequest	request()
AWRequestContext	requestContext()
boolean	requiresPreGlidCompatibility() Override this method to restore the behavior in this page to that of aribaweb-7.
String	resourceClassName() Get the name of the class where we get our resources from.
AWResourceManager	resourceManager()
AWResponse	response()
Object	restoreFromBacktrackState(Object userBacktrackState)
AWSession	session()
AWSession	session(boolean required)
void	setCharacterEncoding(AWCharacterEncoding characterEncoding)
void	setClientPanel(boolean yn)
void	setClientTimeZone(TimeZone timeZone)
void	setComponentConfiguration(String configName, Object config)
static void	setDefaultTemplateParser(AWTemplateParser templateParser)
void	setEnv(AWEnvironmentStack environmentStack)
void	setPreferredLocale(Locale locale)
void	setResourceManager(AWResourceManager resourceManager)
void	setTemplateParser(AWTemplateParser templateParser)
void	setupForNextCycle(AWComponentReference componentReference, AWComponent parentComponent, AWPage page)
void	setValueForBinding(boolean booleanValue, AWBinding binding)
void	setValueForBinding(boolean booleanValue, String bindingName)
void	setValueForBinding(int intValue, AWBinding binding)
void	setValueForBinding(int intValue, String bindingName)
void	setValueForBinding(Object objectValue, AWBinding binding)
void	setValueForBinding(Object objectValue, String bindingName)
boolean	shouldCachePage()
boolean	shouldCloseElements()
AWStringsThunk	strings()
String	stringValueForBinding(AWBinding binding)
String	stringValueForBinding(String bindingName)
String	stringValueForBinding(String bindingName, String defaultValue)
String[]	supportedBindingNames()
AWTemplate	template()
String	templateName()
AWTemplateParser	templateParser()
AWResource	templateResource()
static AWResourceManager	templateResourceManager() We need to use the same resource manager for loading templates.
void	truncateBacktrackState()
void	truncateBacktrackState(AWBacktrackState backtrackStateMark)
String	urlForResourceNamed(String resourceName)
String	urlForResourceNamed(String resourceName, boolean useFullUrl)
String	urlForResourceNamed(String resourceName, boolean useFullUrl, boolean isVersion)
boolean	useXmlEscaping()
Object	valueForBinding(AWBinding binding)
Object	valueForBinding(String bindingName)
Object	valueForBinding(String bindingName, Object defaultValue)
AWXmlNode	xml()

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

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

Methods inherited from class java.lang.Object

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

Methods inherited from interface ariba.ui.aribaweb.util.AWObject

getFieldValue, isKindOfClass, setFieldValue

Methods inherited from interface ariba.ui.aribaweb.util.AWObject

getFieldValue, isKindOfClass, setFieldValue

Field Detail

ComponentTemplateFileExtension

public static final String ComponentTemplateFileExtension

See Also:

Constant Field Values

ClassObject

public static final Class ClassObject

Constructor Detail

AWComponent

public AWComponent()

Method Detail

determineInstance

public AWElement determineInstance(String elementName,
                                   String translatedClassName,
                                   Map bindingsHashtable,
                                   String templateName,
                                   int lineNumber)

Specified by:

determineInstance in interface AWCycleableReference

determineInstance

public AWElement determineInstance(String elementName,
                                   Map bindingsHashtable,
                                   String templateName,
                                   int lineNumber)

Specified by:

determineInstance in interface AWCycleableReference

init

public void init(AWComponentReference componentReference,
                 AWComponent parentComponent,
                 AWPage page)

init

public void init()

Specified by:

init in interface AWObject

Overrides:

init in class AWBaseObject

parent

public AWComponent parent()

getThis

public AWComponent getThis()

This method allows for access to the current component fromthe .awl via "$this"

setupForNextCycle

public void setupForNextCycle(AWComponentReference componentReference,
                              AWComponent parentComponent,
                              AWPage page)

componentDefinition

public AWComponentDefinition componentDefinition()

hasMultipleTemplates

public boolean hasMultipleTemplates()

setDefaultTemplateParser

public static void setDefaultTemplateParser(AWTemplateParser templateParser)

defaultTemplateParser

public static AWTemplateParser defaultTemplateParser()

templateParser

public AWTemplateParser templateParser()

setTemplateParser

public void setTemplateParser(AWTemplateParser templateParser)

componentReference

public AWComponentReference componentReference()

createPageWithName

public static AWComponent createPageWithName(String pageName)

ensureFieldValuesClear

public void ensureFieldValuesClear()

Overrides:

ensureFieldValuesClear in class AWBaseObject

requestContext

public AWRequestContext requestContext()

application

public AWApplication application()

page

public AWPage page()

pageComponent

public AWComponent pageComponent()

session

public AWSession session()

session

public AWSession session(boolean required)

httpSession

public javax.servlet.http.HttpSession httpSession()

request

public AWRequest request()

response

public AWResponse response()

isBrowserMicrosoft

public boolean isBrowserMicrosoft()

isMacintosh

public boolean isMacintosh()

browserMinWidth

public String browserMinWidth()

browserMaxWidth

public String browserMaxWidth()

resourceManager

public AWResourceManager resourceManager()

setResourceManager

public void setResourceManager(AWResourceManager resourceManager)

setCharacterEncoding

public void setCharacterEncoding(AWCharacterEncoding characterEncoding)

characterEncoding

public AWCharacterEncoding characterEncoding()

setClientTimeZone

public void setClientTimeZone(TimeZone timeZone)

clientTimeZone

public TimeZone clientTimeZone()

setEnv

public void setEnv(AWEnvironmentStack environmentStack)

env

public AWEnvironmentStack env()

setPreferredLocale

public void setPreferredLocale(Locale locale)

preferredLocale

public Locale preferredLocale()

name

public String name()

namePath

public String namePath()

templateName

public String templateName()

resourceClassName

public String resourceClassName()

Get the name of the class where we get our resources from. This is the class in which we resolve AWLocal references.

Returns:

the full class name of the resource class

template

public AWTemplate template()

isClientPanel

public boolean isClientPanel()

setClientPanel

public void setClientPanel(boolean yn)

replacementResponse

public AWResponseGenerating replacementResponse()

Specified by:

replacementResponse in interface AWResponseGenerating.ResponseSubstitution

isValidationEnabled

public boolean isValidationEnabled()

isStrictTagNaming

public boolean isStrictTagNaming()

allowsWhitespaceCompression

public boolean allowsWhitespaceCompression()

templateResource

public AWResource templateResource()

templateResourceManager

public static AWResourceManager templateResourceManager()

We need to use the same resource manager for loading templates. Otherwise, each component instances can potential get templates with a different structure (ie, AWIncludeComponent maps)

hasContentNamed

public boolean hasContentNamed(String name)

hasSubTemplateNamed

public boolean hasSubTemplateNamed(String templateName)

Deprecated. Use hasContentNamed()

loadTemplate

public AWTemplate loadTemplate()

allowEmbeddedKeyPaths

public boolean allowEmbeddedKeyPaths()

isStateless

public boolean isStateless()

Overridden by AWComponent subclasses to indicate whether component instances should be preseved with the page/session (i.e. are "stateful") or can be pooled and reused for each phase of request processing (i.e. are stateless) Default is to be statelss unless the component is used as the top-level (page) component.

applyValues

public void applyValues(AWRequestContext requestContext,
                        AWComponent component)

Description copied from interface: AWCycleable

The receiver should take any form values (or query string parameters) that it owns from the AWRequestContext.request().

Specified by:

applyValues in interface AWCycleable

Parameters:

requestContext - the context for the current request.

component - the current parent component

invokeAction

public AWResponseGenerating invokeAction(AWRequestContext requestContext,
                                         AWComponent component)

Description copied from interface: AWCycleable

The receiver should determine if it is the intended recipient of the current action (by checking the AWRequestContext.request() AWRequest.senderId()) and, if so, handle the action and return the result.

Specified by:

invokeAction in interface AWCycleable

Parameters:

requestContext - the context for the current request.

component - the current parent component

Returns:

the response for the action

renderResponse

public void renderResponse(AWRequestContext requestContext,
                           AWComponent component)

Description copied from interface: AWCycleable

The receiver should render its content to the AWRequestContext.response()

Specified by:

renderResponse in interface AWCycleable

Parameters:

requestContext - the context for the current request.

component - the current parent component

_topLevelApplyValues

public void _topLevelApplyValues(AWRequestContext requestContext,
                                 AWComponent component)

_topLevelInvokeAction

public AWResponseGenerating _topLevelInvokeAction(AWRequestContext requestContext,
                                                  AWComponent component)

_topLevelRenderResponse

public void _topLevelRenderResponse(AWRequestContext requestContext,
                                    AWComponent component)

escapeAttribute

public AWEncodedString escapeAttribute(AWEncodedString attributeValue)

escapeString

public AWEncodedString escapeString(Object object)

escapeUnsafeString

public AWEncodedString escapeUnsafeString(Object object)

shouldCloseElements

public boolean shouldCloseElements()

useXmlEscaping

public boolean useXmlEscaping()

recordBacktrackState

public void recordBacktrackState(Object userBacktrackState)

recordBacktrackState

public void recordBacktrackState(int userBacktrackState)

removeBacktrackState

public void removeBacktrackState()

truncateBacktrackState

public void truncateBacktrackState()

truncateBacktrackState

public void truncateBacktrackState(AWBacktrackState backtrackStateMark)

markBacktrackState

public AWBacktrackState markBacktrackState()

restoreFromBacktrackState

public Object restoreFromBacktrackState(Object userBacktrackState)

shouldCachePage

public boolean shouldCachePage()

generateResponse

public AWResponse generateResponse(AWResponse response,
                                   AWRequestContext requestContext)

generateResponse

public AWResponse generateResponse(AWResponse response)

generateResponse

public AWResponse generateResponse()

Specified by:

generateResponse in interface AWResponseGenerating

generateStringContents

public String generateStringContents()

Specified by:

generateStringContents in interface AWResponseGenerating

ensureAwake

public void ensureAwake(AWPage page)

supportedBindingNames

public String[] supportedBindingNames()

bindings

public AWBindingDictionary bindings()

otherBindings

public AWBindingDictionary otherBindings()

otherBindingsValues

public AWStringDictionary otherBindingsValues()

bindingForName

public AWBinding bindingForName(String bindingName)

bindingForName

public AWBinding bindingForName(String bindingName,
                                boolean recursive)

hasBinding

public boolean hasBinding(String bindingName)

hasBinding

public boolean hasBinding(AWBinding binding)

doubleValueForBinding

public double doubleValueForBinding(AWBinding binding)

doubleValueForBinding

public double doubleValueForBinding(String bindingName)

doubleValueForBinding

public double doubleValueForBinding(String bindingName,
                                    double defaultValue)

intValueForBinding

public int intValueForBinding(AWBinding binding)

intValueForBinding

public int intValueForBinding(String bindingName)

intValueForBinding

public int intValueForBinding(String bindingName,
                              int defaultValue)

booleanValueForBinding

public boolean booleanValueForBinding(AWBinding binding)

booleanValueForBinding

public boolean booleanValueForBinding(String bindingName)

booleanValueForBinding

public boolean booleanValueForBinding(AWBinding binding,
                                      boolean defaultValue)

booleanValueForBinding

public boolean booleanValueForBinding(String bindingName,
                                      boolean defaultValue)

valueForBinding

public Object valueForBinding(AWBinding binding)

valueForBinding

public Object valueForBinding(String bindingName)

valueForBinding

public Object valueForBinding(String bindingName,
                              Object defaultValue)

stringValueForBinding

public String stringValueForBinding(AWBinding binding)

stringValueForBinding

public String stringValueForBinding(String bindingName)

stringValueForBinding

public String stringValueForBinding(String bindingName,
                                    String defaultValue)

encodedStringValueForBinding

public AWEncodedString encodedStringValueForBinding(AWBinding binding)

encodedStringValueForBinding

public AWEncodedString encodedStringValueForBinding(String bindingName)

setValueForBinding

public void setValueForBinding(Object objectValue,
                               AWBinding binding)

setValueForBinding

public void setValueForBinding(Object objectValue,
                               String bindingName)

setValueForBinding

public void setValueForBinding(int intValue,
                               AWBinding binding)

setValueForBinding

public void setValueForBinding(int intValue,
                               String bindingName)

setValueForBinding

public void setValueForBinding(boolean booleanValue,
                               AWBinding binding)

setValueForBinding

public void setValueForBinding(boolean booleanValue,
                               String bindingName)

registerXmlNodeWithName

public static void registerXmlNodeWithName(String xmlNodeName)

xml

public AWXmlNode xml()

pageWithName

public AWComponent pageWithName(String pageName)

pageWithName

public AWComponent pageWithName(String pageName,
                                Map<String,Object> assignments)

pageWithClass

public <T> T pageWithClass(Class<T> tClass)

pageWithClass

public <T> T pageWithClass(Class<T> tClass,
                           Map<String,Object> assignments)

componentConfiguration

public Object componentConfiguration(String configName)

setComponentConfiguration

public void setComponentConfiguration(String configName,
                                      Object config)

extendedFields

public Map extendedFields()

dict

public Map dict()

dict

public void dict(String key,
                 Object value)

dict

public Object dict(String key)

redirectToPage

public AWPageRedirect redirectToPage(AWComponent destinationPage)

awcyclePageAndLog

public AWComponent awcyclePageAndLog()

componentPath

public AWFastStringBuffer componentPath(String separatorString)

errorManager

public AWErrorManager errorManager()

Retrieve the error manager for the page.

Returns:

error manager

formValueManager

public AWFormValueManager formValueManager()

recordValidationError

public void recordValidationError(Object errorKey,
                                  String errorMessage,
                                  Object errantValue)

Record an error to the error manager. To avoid confusion between the current and new ErrorManagers, this is the only way to access the setErrorMessageAndValue().

Parameters:

errorKey - The object that identifies the error. This is typically a string.

errorMessage - The message that describes the error.

errantValue - The unparsable value that the user entered. Since the parsing failed, we cannot store this value in the field. We stash it away here so we can display in the UI later.

recordValidationError

public void recordValidationError(AWErrorInfo error)

Record an error to the error manager. To avoid confusion between the current and new ErrorManagers, this is the only way to access the setErrorMessageAndValue().

Parameters:

error - The error object.

recordValidationErrors

public void recordValidationErrors(List errors)

Record multiple error to the error manager. To avoid confusion between the current and new ErrorManagers, this is the only way to access the setErrorMessageAndValue().

Parameters:

errors - a list of AWErrorInfo objects

recordValidationError

public void recordValidationError(Throwable exception,
                                  Object errorKey,
                                  Object errantValue)

Record an error to the error manager. To avoid confusion between the current and new ErrorManagers, this is the only way to access the setErrorMessageAndValue().

Parameters:

exception -

errorKey - The object that identifies the error. This is typically a string.

errantValue - The unparsable value that the user entered. Since the parsing failed, we cannot store this value in the field. We stash it away here so we can display in the UI later.

recordValidationWarning

public void recordValidationWarning(Object errorKey,
                                    String warningMessage)

Record an error to the error manager. To avoid confusion between the current and new ErrorManagers, this is the only way to access the setErrorMessageAndValue().

Parameters:

errorKey - The object that identifies the error. This is typically a string.

warningMessage - The message that describes the warning.

clearValidationError

public void clearValidationError(Object errorKey)

Clear an error in the error manager. To avoid confusion between the current and new ErrorManagers, this is the only way to access the clearErrorForKey().

Parameters:

errorKey -

localizedJavaString

public String localizedJavaString(int stringId,
                                  String originalString)

strings

public AWStringsThunk strings()

urlForResourceNamed

public String urlForResourceNamed(String resourceName)

urlForResourceNamed

public String urlForResourceNamed(String resourceName,
                                  boolean useFullUrl)

urlForResourceNamed

public String urlForResourceNamed(String resourceName,
                                  boolean useFullUrl,
                                  boolean isVersion)

isBidirectional

public boolean isBidirectional()

languageDirection

public String languageDirection()

languageRight

public String languageRight()

languageLeft

public String languageLeft()

requiresPreGlidCompatibility

public boolean requiresPreGlidCompatibility()

Override this method to restore the behavior in this page to that of aribaweb-7. This only applies to page-level components

postTakeValueActions

public void postTakeValueActions()

Deprecated.

Method called after applyValues phase is completed. This method is highly dangerous. Note that whenever this method is called no bindings may be evaluated because all components are out of band.

getAWParameter

public AWParameters getAWParameter()

Allows for parameter field value syntax in AWL files. See AWParameters for more information. example: $AWParameters.System.UI.Table.MinHeight

notifyChange

public void notifyChange()

Only applicable to pageComponents. Called by AWPage when AWPage receives a change notification. See AWPage.notifyChange()