Package com.microstrategy.web.app.beans
Interface PageComponent
- 
- All Superinterfaces:
 AppComponent,Transformable,WebComponent
- All Known Implementing Classes:
 CSRFConfirmationPageComponentImpl,DesktopPageComponentImpl,DocumentPageComponentImpl,EditPromptPageComponentImpl,FolderPageComponentImpl,HistoryListPageComponentImpl,MySubscriptionsPageComponentImpl,NewWindowPageComponentImpl,PageSubscriptionsEdit,PreferenceSettingPageComponentImpl,PreferencesPageComponentImpl,ReportPageComponentImpl,ResultSetPageComponentImpl,RWOIVMPageComponent,RWPageComponentImpl,RWPromptsPageComponent,RWSaveAsPageComponentImpl,SearchPageComponentImpl,SharingConfirmationPageComponentImpl,SimplePageComponentImpl
public interface PageComponent extends AppComponent
A PageComponent class instance represents the information regarding a page that can be handled by the Web Application. All the details required for displaying one page on the application is available from here.
It has aPageInfoclass associated. This PageInfo contains the structure as defined in the pageConfig.xml Things like BeanList and Bean Properties are retrieved from here.- Since:
 - MicroStrategy Web 7.3.1 or earlier
 
 
- 
- 
Field Summary
Fields Modifier and Type Field Description static intREMOVE_PAGEUsed by saveReturnToPage(int mode) to indicate the page link in the return to browser setting should be removedstatic intSTORE_PAGEUsed by saveReturnToPage(int mode) to add a page's link to the browser setting- 
Fields inherited from interface com.microstrategy.web.app.beans.AppComponent
COMPONENT_POSITION_NOT_INITIALIZED 
 - 
 
- 
Method Summary
All Methods Instance Methods Abstract Methods Deprecated Methods Modifier and Type Method Description voidcleanUp()Performs any necessary clean up tasks before leaving the page.booleanexecuteCollectDataRequiredAddons(WebComponent wc)Checks if the different addons associated with theWebComponentrequire a collect data to be performed.voidexecutePostCollectDataAddons()Executes the post collect data addons on the page in the order in which they appear in the pageconfig file.voidexecutePreCollectDataAddons()Executes the addons on the page in the order in which they appear in the pageconfig file.java.lang.StringgetContactInfo()Returns the administrator contact info for this application.ContextMenuManagergetContextMenuManager()Deprecated.This method is not used by the application and will be removed in future versions.intgetDebugFlags()Get the decimal-format debug flags from the pageMarkupOutputgetDebugOut(int debugFlags)Get the Debug Information into the outputAppBeanErrorgetErrorInfo()Returns the lastAppBeanErrorset to this page.intgetExplicitScreenMode()java.lang.StringgetFontName()Returns a string with the name of the fonts, or the list of fonts that a browser should use when rendering the page.java.lang.StringgetFontSize()A string with the base font size to use, the string might contain the type of size (i.e, pt, px, etc.)intgetLastMessageKey()java.lang.StringgetLastMsgID()PageInfogetPageInfo()java.lang.StringgetRedirectURL()Returns the URL to be send down to the browser that corresponds to the page.PageResourceManagergetResourceManager()Returns the instance of thePageResourceManagerassociated with the page.intgetResourceManagerMode()Returns the mode of the page manager set up on the page component.intgetScreenMode()Return the current page screen mode.java.lang.StringgetTemplateFileName()Returns the name of a template file to redirectTemplateInfogetTemplateInfo()Returns theTemplateInfoto use with this pagejava.lang.StringgetTitle()Returns the pages's title.WebIServerSessiongetWebIServerSession()java.lang.StringgetXMLStatusPageName()Returns the name of the page in the Page Framework that will be displayed for the current page and xml status combination.booleanhasBinaryContent()booleanhasXMLStatusPage()Returns true if a page in the Page Framework will be displayed for the current page and xml status combination.booleanisRedirect()Indicates if the page will be sent down as a redirect response (HTTP 302) instead of an ok response (HTTP 200)booleanisRestoredFromPageHistory()booleanisStagePage()Returns true if this page is just a stage page which acts as a bridge between two pages.voidprocessApplyChanges(java.lang.String pageName)The method will be responsible for executing the apply events to those beans that require to so, when the page is about to changevoidsaveLastPage()Saves the information of the last succesful page so it can be restored by the cancel event.voidsaveReturnToPage(int mode)Saves the information of the last visited page so it can be restored by the returnTo event.voidsetErrorInfo(AppBeanError error)Associates anAppBeanErrorwith the page.voidsetExplicitScreenMode(int screenMode)Use to set the explicit screen mode.voidsetIsRedirect(boolean redirect)Sets the page as a redirect response (HTTP 302) instead of an ok response (HTTP 200)voidsetPageInfo(PageInfo page)This method sets the currentPageInfo(the object with the current Page structure).voidsetRestoredFromPageHistory(boolean value)voidsetScreenMode(int screenMode)Set the screenMode of the page.voidsetStagePage(boolean isStagePage)Sets the page as a stage page which acts as a bridge between two pages.voidsetTemplateFileName(java.lang.String value)Sets the name of a template file to redirectvoidsetTitle(java.lang.String title)Define the alias that the page will display when called.voidsetWebIServerSession(WebIServerSession session)voidswitchPage(java.lang.String pageName, ServletWebComponent servletWebComponent)Replaces the current page in the Servlet with the indicated page- 
Methods inherited from interface com.microstrategy.web.app.beans.AppComponent
getAppContext, getDescriptor, getDescriptor, getEventManager, getExtraInput, getExtraUrl, getLeft, getResultFilterMode, getTop, isDialog, isForcedChildrenStateSaving, isModal, isModalOpen, isOpen, setExtraInput, setExtraUrl, setForcedChildrenStateSaving, setHasJustOpened, setIsDialog, setIsModal, setIsOpen, setLeft, setTop 
- 
Methods inherited from interface com.microstrategy.web.beans.Transformable
addTransform, addTransformByClass, addTransformByStyle, addTransformByStyle, clearTransforms, getBeanContext, getMessageString, getMyTransformInstances, getTransformInstance, getTransformInstance, getTransformInstances, getType, hasTransform, hasTransform, invalidateTransformCache, setBeanContext, transform, transform 
- 
Methods inherited from interface com.microstrategy.web.beans.WebComponent
addChild, addChildStateInfo, addChildStateInfo, collectData, collectMinimalData, generateOutput, getBeanContext, getChild, getChild, getChildByClass, getChildByType, getChildCount, getChildrenByClass, getDefaultStateLevel, getFeaturesManager, getMaximumStateLevel, getName, getOutputFormat, getParent, getPath, getPersistMode, getRenderingFilter, getRoot, getTargetBean, getTargetBeanPath, getWebEvent, getWebEvent, getWebEventHandler, getXMLStatus, handleRequest, hasChanged, hasJustOpened, initBean, invalidateChildrenState, isBeanContextEmpty, isFeatureAvailable, prepareForReuse, removeChild, removeChild, searchChild, setBeanContext, setBeanContext, setChanged, setChanged, setDefaultStateLevel, setFeaturesManager, setName, setOutputFormat, setParent, setPersistMode, setRenderingFilter, setTargetBean, setTargetBeanPath, setWebEventHandler 
 - 
 
 - 
 
- 
- 
Field Detail
- 
REMOVE_PAGE
static final int REMOVE_PAGE
Used by saveReturnToPage(int mode) to indicate the page link in the return to browser setting should be removed- Since:
 - MicroStrategy Web 8.0.0
 - See Also:
 - Constant Field Values
 
 
- 
STORE_PAGE
static final int STORE_PAGE
Used by saveReturnToPage(int mode) to add a page's link to the browser setting- Since:
 - MicroStrategy Web 8.0.0
 - See Also:
 - Constant Field Values
 
 
 - 
 
- 
Method Detail
- 
setPageInfo
void setPageInfo(PageInfo page)
This method sets the currentPageInfo(the object with the current Page structure). ThePageInfoshould be the one used to create this component.- Parameters:
 page- Page object
 
- 
getTemplateInfo
TemplateInfo getTemplateInfo()
Returns theTemplateInfoto use with this page- Returns:
 - the current 
TemplateInfoto be used by this page 
 
- 
getWebIServerSession
WebIServerSession getWebIServerSession()
- Returns:
 - The 
WebIServerSessionused by this page. If this page is not using a session, it returns null; 
 
- 
setWebIServerSession
void setWebIServerSession(WebIServerSession session)
- Parameters:
 session- TheWebIServerSessionto be used by this page.
 
- 
getContextMenuManager
ContextMenuManager getContextMenuManager()
Deprecated.This method is not used by the application and will be removed in future versions.- Returns:
 - The Page's 
ContextMenuManager 
 
- 
setErrorInfo
void setErrorInfo(AppBeanError error)
Associates anAppBeanErrorwith the page. If an error occurred during the page initialization/execution, this error should be set. It's responsibility of the display later (i.e., the JSP) to display this error to the end user.- Parameters:
 error- The last error on this page.nullif none happened
 
- 
getErrorInfo
AppBeanError getErrorInfo()
Returns the lastAppBeanErrorset to this page. If no errors have been associated to this page it returns null.- Returns:
 - the 
AppBeanErrorassociated with the execution of the page. 
 
- 
setTitle
void setTitle(java.lang.String title)
Define the alias that the page will display when called.- Parameters:
 title- String with the title of the page. User setTitle
 
- 
getTitle
java.lang.String getTitle()
Returns the pages's title.- Returns:
 - The title of this page
 
 
- 
executeCollectDataRequiredAddons
boolean executeCollectDataRequiredAddons(WebComponent wc)
Checks if the different addons associated with theWebComponentrequire a collect data to be performed.- Parameters:
 wc-WebComponentinstance that will have its addon methods called- Returns:
 booleanvalue indicating if the collectData is required or not- Since:
 - MicroStrategy Web 8.0.0
 
 
- 
executePreCollectDataAddons
void executePreCollectDataAddons()
Executes the addons on the page in the order in which they appear in the pageconfig file.- Since:
 - MicroStrategy Web 7.5.0
 
 
- 
hasBinaryContent
boolean hasBinaryContent()
- Returns:
 - true if the page would generate binary content in it's output
 
 
- 
getFontSize
java.lang.String getFontSize()
A string with the base font size to use, the string might contain the type of size (i.e, pt, px, etc.)- Returns:
 - a string with size of the font to use
 
 
- 
getFontName
java.lang.String getFontName()
Returns a string with the name of the fonts, or the list of fonts that a browser should use when rendering the page. This is usually retrieved from user Preferences- Returns:
 - a String with a comma separated list of the fonts to use in this page.
 
 
- 
getContactInfo
java.lang.String getContactInfo()
Returns the administrator contact info for this application.- Returns:
 - The admin contact info.
 
 
- 
getTemplateFileName
java.lang.String getTemplateFileName()
Returns the name of a template file to redirect- Returns:
 - a file name.
 
 
- 
setTemplateFileName
void setTemplateFileName(java.lang.String value)
Sets the name of a template file to redirect- Parameters:
 value-Stringvalue indicating the template file name to use.
 
- 
executePostCollectDataAddons
void executePostCollectDataAddons()
Executes the post collect data addons on the page in the order in which they appear in the pageconfig file.- Since:
 - MicroStrategy Web 7.5.0
 
 
- 
saveReturnToPage
void saveReturnToPage(int mode)
Saves the information of the last visited page so it can be restored by the returnTo event.- Parameters:
 mode-intvalue indicating the type of action that should be performed about the return to page information. Values includeSTORE_PAGEandREMOVE_PAGE.- Since:
 - MicroStrategy Web 8.0.0
 
 
- 
processApplyChanges
void processApplyChanges(java.lang.String pageName) throws WebExceptionThe method will be responsible for executing the apply events to those beans that require to so, when the page is about to change- Parameters:
 pageName- The name of the new page- Throws:
 WebException- Since:
 - MicroStrategy Web 8.0.0
 
 
- 
saveLastPage
void saveLastPage()
Saves the information of the last succesful page so it can be restored by the cancel event.- Since:
 - MicroStrategy Web 8.0.0
 
 
- 
cleanUp
void cleanUp()
Performs any necessary clean up tasks before leaving the page.
Called when eventEnumServletEvents.WebEventOpenHistoryPageis submited- Since:
 - MicroStrategy Web 9.0.0
 
 
- 
setScreenMode
void setScreenMode(int screenMode)
Set the screenMode of the page. Screen mode can be normal screen mode (screenMode = 1), full screen mode (screenMode = 2), or default to normal screen mode (screenMode = 0).- Parameters:
 screenMode-- Since:
 - MicroStrategy Web 8.1.0
 
 
- 
getScreenMode
int getScreenMode()
Return the current page screen mode.- Returns:
 - page screen mode.
 - Since:
 - MicroStrategy Web 8.1.0
 
 
- 
setExplicitScreenMode
void setExplicitScreenMode(int screenMode)
Use to set the explicit screen mode.- Parameters:
 screenMode-- Since:
 - MicroStrategy Web 8.1.0
 
 
- 
getExplicitScreenMode
int getExplicitScreenMode()
- Returns:
 - integer value representing the explicit screen mode selected
 - Since:
 - MicroStrategy Web 8.1.0
 
 
- 
getResourceManagerMode
int getResourceManagerMode()
Returns the mode of the page manager set up on the page component. The values are defined in thePageResourceManagerclass- Returns:
 - the current mode of the page resource manager for this page.
 - Since:
 - MicroStrategy Web 9.0.0
 
 
- 
getResourceManager
PageResourceManager getResourceManager()
Returns the instance of thePageResourceManagerassociated with the page. Returnsnullif the resource manager is disabled.- Returns:
 - instance of 
PageResourceManager - Since:
 - MicroStrategy Web 9.0.0
 
 
- 
isRedirect
boolean isRedirect()
Indicates if the page will be sent down as a redirect response (HTTP 302) instead of an ok response (HTTP 200)- Returns:
 booleanvalue indicating if the the page will be displayed as a redirect (HTTP 302) response- Since:
 - MicroStrategy Web 9.0.1
 
 
- 
setIsRedirect
void setIsRedirect(boolean redirect)
Sets the page as a redirect response (HTTP 302) instead of an ok response (HTTP 200)- Parameters:
 redirect-booleanvalue indicating if the the page will be displayed as a redirect (HTTP 302) response- Since:
 - MicroStrategy Web 9.0.1
 
 
- 
getRedirectURL
java.lang.String getRedirectURL()
Returns the URL to be send down to the browser that corresponds to the page.- Returns:
 - a URL String
 - Since:
 - MicroStrategy Web 9.0.1
 
 
- 
getXMLStatusPageName
java.lang.String getXMLStatusPageName()
Returns the name of the page in the Page Framework that will be displayed for the current page and xml status combination. This is defined at the template level in the pageConfig.xml file- Returns:
 - String. Page Name from pageConfig.xml
 
 
- 
hasXMLStatusPage
boolean hasXMLStatusPage()
Returns true if a page in the Page Framework will be displayed for the current page and xml status combination. This is defined at the template level in the pageConfig.xml file- Returns:
 - true is a page Name has been defined in pageConfig.xml
 
 
- 
isStagePage
boolean isStagePage()
Returns true if this page is just a stage page which acts as a bridge between two pages.- Returns:
 - true is this page is a stage page.
 
 
- 
setStagePage
void setStagePage(boolean isStagePage)
Sets the page as a stage page which acts as a bridge between two pages.- Parameters:
 isStagePage-booleanvalue indicating if the the page is a stagePage.
 
- 
switchPage
void switchPage(java.lang.String pageName, ServletWebComponent servletWebComponent) throws WebException, WebBeanExceptionReplaces the current page in the Servlet with the indicated page- Parameters:
 servletWebComponent-pageName- . Name of the new page to instantiate- Throws:
 WebException- When it fails to redirects to the target page.WebBeanException
 
- 
getDebugOut
MarkupOutput getDebugOut(int debugFlags)
Get the Debug Information into the output- Returns:
 - an instance of 
MarkupOutput. - Since:
 - MicroStrategy Web 9.0.3
 
 
- 
getDebugFlags
int getDebugFlags()
Get the decimal-format debug flags from the page- Since:
 - MicroStrategy Web 9.0.3
 
 
- 
isRestoredFromPageHistory
boolean isRestoredFromPageHistory()
 
- 
setRestoredFromPageHistory
void setRestoredFromPageHistory(boolean value)
 
- 
getLastMessageKey
int getLastMessageKey()
 
- 
getLastMsgID
java.lang.String getLastMsgID()
 
 - 
 
 -