|
Copyright © 2006 BEA Systems, Inc. All Rights Reserved | ||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.ObjectControlContext
com.bea.netuix.servlets.controls.BackingContext
com.bea.netuix.servlets.controls.application.backing.DesktopBackingContext
public class DesktopBackingContext
The DesktopBackingContext
is used to interact with the underlying Desktop control. This is the
BackingContext for a Desktop.
This BackingContext
can only be referenced from a backing file. If you need to reference
this from a JSP you should use DesktopPresentationContext
instead.
To get a handle to the BackingContext just call the following:
DesktopBackingContext.getDesktopBackingContext(request);
Note: most methods for retrieving child contexts do not work if called from the init()
method of a backing file. This is because the portal tree has not been fully initialized. You may have to call
the method from the preRender()
or handlePostbackData
method.
Field Summary | |
---|---|
protected static String |
CLASS_NAME
|
Method Summary | |
---|---|
BookBackingContext |
getBookBackingContext()
Retrieve the main book (top level) backing context. |
BookBackingContext |
getBookBackingContextRecursive(String definitionLabel)
Return a book searching the entire tree recursively. |
BookBackingContext[] |
getBookBackingContextsByMeta(MetaData[] metaData,
int limit)
Return a set of books matching the supplied metadata search criteria. |
String |
getDefinitionLabel()
Get definition label as defined in the portal file. |
static DesktopBackingContext |
getDesktopBackingContext(HttpServletRequest request)
Obtain a reference to the current DesktopBackingContext in the request. |
PageBackingContext |
getDisplayedPageBackingContext()
Return the last displayed page (not book). |
FooterBackingContext |
getFooterBackingContextRecursive()
Return a reference to the Footer backing context if one exists. |
HeaderBackingContext |
getHeaderBackingContextRecursive()
Return a reference to the Header backing context if one exists. |
LookAndFeelDefinitionId |
getLookAndFeelDefinitionId()
Return the look and feel definition id. |
String |
getLookAndFeelDefinitionLabel()
Return the look and feel definition label. |
PageBackingContext |
getPageBackingContextRecursive(String definitionLabel)
Return a book or a page but traverse the entire tree, this will go inside books that are on pages too. |
PageBackingContext[] |
getPageBackingContextsByMeta(MetaData[] metaData,
int limit)
Return a set of pages and books (books extend pages) matching the supplied metadata search criteria. |
PortletBackingContext |
getPortletBackingContextRecursive(String instanceLabel)
Return the portlet backing context matching the supplied instance label. |
PortletBackingContext[] |
getPortletBackingContextsByMeta(MetaData[] metaData,
int limit)
Return a set of portlets matching the supplied metadata search criteria. |
PortletBackingContext[] |
getPortletsBackingContextRecursive(String definitionLabel)
Return portlet backing contexts matching the supplied definition label. |
String |
getTitle()
Get the internationalized title for this desktop. |
void |
setTitle(String title)
Set a temporary value for the title. |
Methods inherited from class com.bea.netuix.servlets.controls.BackingContext |
---|
ensureCurrentLifecycleStageLegalForOperation, getChildrenBackingContexts, getParentBackingContext, getTopParentBackingContext, isBackingPhase, isVisible, setBackingPhase, setVisible |
Methods inherited from class java.lang.Object |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Field Detail |
---|
protected static final String CLASS_NAME
Method Detail |
---|
public static DesktopBackingContext getDesktopBackingContext(HttpServletRequest request)
Obtain a reference to the current DesktopBackingContext
in the request.
Note: the DesktopBackingContext should only be obtained from a backing file. If you
think you need this context from a JSP look at DesktopPresentationContext.
request
- http servlet request.
public BookBackingContext getBookBackingContext()
public BookBackingContext getBookBackingContextRecursive(String definitionLabel)
getPageBackingContextRecursive()
as that method returns both.
Note: this method may return null if called from the init() method of a backing context.
definitionLabel
- of the book
public BookBackingContext[] getBookBackingContextsByMeta(MetaData[] metaData, int limit)
limit
is reached. Meta
data can be added to books by inserting <netuix:meta> tags into the body of the main book element.
If you are interested in both books AND pages use getPageBackingContextsByMeta()
as that method returns both.
metaData
- contains the search criterialimit
- maximium number of items to return: 0 == no limit, 1 == first match , n == first n matches
public PageBackingContext[] getPageBackingContextsByMeta(MetaData[] metaData, int limit)
limit
is reached. Meta data can be added to pages by inserting
<netuix:meta> tags into the body of the main page element.
metaData
- contains the search criterialimit
- maximium number of items to return: 0 == no limit, 1 == first match , n = first n matches
public PortletBackingContext[] getPortletBackingContextsByMeta(MetaData[] metaData, int limit)
limit
is reached. Meta data can be added to portlets by inserting
<netuix:meta> tags into the body of the main portlet element.
metaData
- contains the search criterialimit
- maximium number of items to return: 0 == no limit, 1 == first match , n = first n matches
public PageBackingContext getPageBackingContextRecursive(String definitionLabel)
definitionLabel
-
public PortletBackingContext getPortletBackingContextRecursive(String instanceLabel)
instanceLabel
- unique instance label of the portlet
public PortletBackingContext[] getPortletsBackingContextRecursive(String definitionLabel)
getPortletBackingContextRecursive(String instanceLabel)
Note: this method may return null if called from the init() method of a backing context.
definitionLabel
- label of the portlet
public HeaderBackingContext getHeaderBackingContextRecursive()
public FooterBackingContext getFooterBackingContextRecursive()
public PageBackingContext getDisplayedPageBackingContext()
Return the last displayed page (not book). This method listens to Page Change events and remembers the last page that was activated in the Desktop. If no page changes have occurred then the first default page found will be returned.
Note: This method will only return the right results if called after the
handlePostbackData
method. Therefore, it is recommended that you call this methods from
preRender
.
PageBackingContext
public String getTitle()
Get the internationalized title for this desktop.
public void setTitle(String title)
Set a temporary value for the title.
public String getDefinitionLabel()
Get definition label as defined in the portal file.
public LookAndFeelDefinitionId getLookAndFeelDefinitionId()
Return the look and feel definition id. This method will only work for streamed portals.
public String getLookAndFeelDefinitionLabel()
Return the look and feel definition label.
|
Copyright © 2006 BEA Systems, Inc. All Rights Reserved | ||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |