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 aPageInfo
class 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 int
REMOVE_PAGE
Used by saveReturnToPage(int mode) to indicate the page link in the return to browser setting should be removedstatic int
STORE_PAGE
Used 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 void
cleanUp()
Performs any necessary clean up tasks before leaving the page.boolean
executeCollectDataRequiredAddons(WebComponent wc)
Checks if the different addons associated with theWebComponent
require a collect data to be performed.void
executePostCollectDataAddons()
Executes the post collect data addons on the page in the order in which they appear in the pageconfig file.void
executePreCollectDataAddons()
Executes the addons on the page in the order in which they appear in the pageconfig file.java.lang.String
getContactInfo()
Returns the administrator contact info for this application.ContextMenuManager
getContextMenuManager()
Deprecated.This method is not used by the application and will be removed in future versions.int
getDebugFlags()
Get the decimal-format debug flags from the pageMarkupOutput
getDebugOut(int debugFlags)
Get the Debug Information into the outputAppBeanError
getErrorInfo()
Returns the lastAppBeanError
set to this page.int
getExplicitScreenMode()
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.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.)int
getLastMessageKey()
java.lang.String
getLastMsgID()
PageInfo
getPageInfo()
java.lang.String
getRedirectURL()
Returns the URL to be send down to the browser that corresponds to the page.PageResourceManager
getResourceManager()
Returns the instance of thePageResourceManager
associated with the page.int
getResourceManagerMode()
Returns the mode of the page manager set up on the page component.int
getScreenMode()
Return the current page screen mode.java.lang.String
getTemplateFileName()
Returns the name of a template file to redirectTemplateInfo
getTemplateInfo()
Returns theTemplateInfo
to use with this pagejava.lang.String
getTitle()
Returns the pages's title.WebIServerSession
getWebIServerSession()
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.boolean
hasBinaryContent()
boolean
hasXMLStatusPage()
Returns true if a page in the Page Framework will be displayed for the current page and xml status combination.boolean
isRedirect()
Indicates if the page will be sent down as a redirect response (HTTP 302) instead of an ok response (HTTP 200)boolean
isRestoredFromPageHistory()
boolean
isStagePage()
Returns true if this page is just a stage page which acts as a bridge between two pages.boolean
isUntrack()
Whether current page should not be tracked.void
processApplyChanges(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 changevoid
saveLastPage()
Saves the information of the last succesful page so it can be restored by the cancel event.void
saveReturnToPage(int mode)
Saves the information of the last visited page so it can be restored by the returnTo event.void
setErrorInfo(AppBeanError error)
Associates anAppBeanError
with the page.void
setExplicitScreenMode(int screenMode)
Use to set the explicit screen mode.void
setIsRedirect(boolean redirect)
Sets the page as a redirect response (HTTP 302) instead of an ok response (HTTP 200)void
setPageInfo(PageInfo page)
This method sets the currentPageInfo
(the object with the current Page structure).void
setRestoredFromPageHistory(boolean value)
void
setScreenMode(int screenMode)
Set the screenMode of the page.void
setStagePage(boolean isStagePage)
Sets the page as a stage page which acts as a bridge between two pages.void
setTemplateFileName(java.lang.String value)
Sets the name of a template file to redirectvoid
setTitle(java.lang.String title)
Define the alias that the page will display when called.void
setUntrack(boolean untrack)
Set whether current page should not be tracked.void
setWebIServerSession(WebIServerSession session)
void
switchPage(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). ThePageInfo
should be the one used to create this component.- Parameters:
page
- Page object
-
getTemplateInfo
TemplateInfo getTemplateInfo()
Returns theTemplateInfo
to use with this page- Returns:
- the current
TemplateInfo
to be used by this page
-
getWebIServerSession
WebIServerSession getWebIServerSession()
- Returns:
- The
WebIServerSession
used by this page. If this page is not using a session, it returns null;
-
setWebIServerSession
void setWebIServerSession(WebIServerSession session)
- Parameters:
session
- TheWebIServerSession
to be used by this page.
-
getContextMenuManager
@Deprecated 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 anAppBeanError
with 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.null
if none happened
-
getErrorInfo
AppBeanError getErrorInfo()
Returns the lastAppBeanError
set to this page. If no errors have been associated to this page it returns null.- Returns:
- the
AppBeanError
associated 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 theWebComponent
require a collect data to be performed.- Parameters:
wc
-WebComponent
instance that will have its addon methods called- Returns:
boolean
value 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
-String
value 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
-int
value indicating the type of action that should be performed about the return to page information. Values includeSTORE_PAGE
andREMOVE_PAGE
.- Since:
- MicroStrategy Web 8.0.0
-
processApplyChanges
void processApplyChanges(java.lang.String pageName) throws WebException
The 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.WebEventOpenHistoryPage
is 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 thePageResourceManager
class- 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 thePageResourceManager
associated with the page. Returnsnull
if 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:
boolean
value 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
-boolean
value 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
-boolean
value indicating if the the page is a stagePage.
-
switchPage
void switchPage(java.lang.String pageName, ServletWebComponent servletWebComponent) throws WebException, WebBeanException
Replaces 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()
-
isUntrack
boolean isUntrack()
Whether current page should not be tracked. The difference between this API andPageInfo.isTrack()
is, this API's value comes from URL whilePageInfo.isTrack()
comes from pageConfig.xml- Returns:
- Whether current page should not be untracked.
-
setUntrack
void setUntrack(boolean untrack)
Set whether current page should not be tracked.- Parameters:
untrack
- Whether current page should not be tracked.
-
-