oracle.cabo.ui.data.tree
Class BrowseNodeDataObject
java.lang.Object
|
+--oracle.cabo.ui.data.tree.BrowseNodeDataObject
- All Implemented Interfaces:
- DataObject, UIConstants
- public class BrowseNodeDataObject
- extends java.lang.Object
- implements DataObject, UIConstants
While the purpose of the BrowseMenuBean is to allow users to browse
through complex sets of hierarchical objects, the hierarchical data
isn't added to the BrowseMenu itself. BrowseNodeDataObject takes a
tree of DataObjects and a current location and extracts the appropriate
information.
BrowseNodeDataObject expects the nodes in the tree to use the following keys.
- UIConstants.TEXT_KEY - The title of this node.
- UIConstants.DESCRIPTION_KEY - The description or instructions for
this node.
- UIConstants.DESTINATION_KEY - The destination for this node.
- UIConstants.DESTINATION_TEXT_KEY - The text for the destination for
this node.
- UIConstants.NODES_KEY - A DataObjectList containing the children
of this node.
Usage
To begin with we will give an example of hierarchical, or tree-structured,
data which we will use in subsequent examples:
private SimpleTreeData createShopNode(
String text,
String description)
{
SimpleTreeData data = new SimpleTreeData();
data.setText( text );
if ( description != null )
data.setDescription( description);
data.setDestination( "http://bali.us.oracle.com");
data.setDestinationText( "More Information");
return data;
}
private DataObject createData()
{
SimpleTreeData treeRoot = new SimpleTreeData();
SimpleTreeData shop =
createShopNode("Shop", "Spend some money!");
SimpleTreeData books =
createShopNode("Books", null);
SimpleTreeData umbrellas =
createShopNode("Umbrellas", "Rain, rain go away");
SimpleTreeData art =
createShopNode("Art", "Picasso et al");
books.addChild( art);
shop.addChild(books);
shop.addChild(umbrellas);
return shop;
}
So this is the tree:
shop
/ \
books umbrellas
|
art
So "art" and "umbrellas" are leaves and therefore items, while "shop" and
"books" are categories. So "shop" is one of the 'roots' of this tree.
There could theoretically be multiple roots.
So let's use BrowseMenuUtils to set up a "default" looking BrowseMenu
using this data.
In this example we are using a servlet. For those not familiar with
servlets it may help to know that the init
method is called
once when the servlet is started while the doGet
method is
called once per request.
In init
we would build the tree of UINodes and somewhere
in there we might see the following:
public void init(ServletConfig config)
throws ServletException
{
.....
// create the browse menu
BrowseMenuBean browseMenu = new BrowseMenuBean();
// give it page-wide-unique id - IMPORTANT!!
browseMenu.setID(MY_BROWSE_MENU_NAME);
// add the "default" containers
BrowseMenuUtils.configureBrowseMenu(
MY_NAMESPACEURI,
MY_LOCALNAME,
browseMenu);
// set treeData, an instance field,
// to be the tree described above
treeData = createData();
// put the browse menu in a form
FormBean form = new FormBean("myForm");
form.addIndexedChild(browseMenu);
// add hidden field with current state so that if
// another bean fires event the browseMenu's current
// state is still sent back with the form
FormValueBean hidden = new FormValueBean();
hidden.setName( MY_BROWSE_MENU_NAME + ":State");
hidden.setValueBinding( new DataBoundValue(
MY_NAMESPACEURI,
MY_LOCALNAME,
BrowseNodeDataObject.CURRENT_STATE_KEY));
form.addIndexedChild(hidden);
.....
}
Then in the servlet's doGet
we might have:
public void doGet(
HttpServletRequest request,
HttpServletResponse response)
throws ServletException, IOException
{
.....
// get the state for the current location in the tree
String currentLocation =
request.getParameter("location");
// if null then the state might have been sent
// back with the form through the hidden field
if ( currentLocation == null )
currentLocation = request.getParameter(
MY_BROWSE_MENU_NAME + ":State");
// create the data
DataObject browseData = new BrowseNodeDataObject(
treeData,
currentLocation );
// push the data on the context
TableDataProvider provider = new TableDataProvider();
provider.put(MY_NAMESPACEURI, MY_LOCALNAME, browseData);
.....
}
Please see below for more information about the line
request.getParameter("location")
.
Keys
BrowseNodeDataObject takes a tree of data and a current location. The
BrowseNodeDataObject uses the current location to go through the tree
and find the current location node, to find the "books" node for example.
The current location node is expected to return results when queried with:
- UIConstants.TEXT_KEY
- UIConstants.DESCRIPTION_KEY
- UIConstants.DESTINATION_KEY
- UIConstants.DESTINATION_TEXT_KEY
- UIConstants.NODES_KEY
The BrowseNodeDataObject also creates data to be returned when queried
with the following keys:
- BrowseNodeDataObject.LOCATION_DATA_KEY - A DataObjectList with the
nodes for the location child. These are all the nodes along the path
from the root of the tree to the current location node.
- BrowseNodeDataObject.CATEGORIES_DATA_KEY - A DataObjectList with the
nodes for the categories child. These are all the children of the
current location data object who have children themselves, or are
not leaves in the tree.
- BrowseNodeDataObject.ITEMS_DATA_KEY - A DataObjectList with the nodes
for the items child. These are all the children of the current location
data object who do not have children themselves, or are leaves in the
tree.
- BrowseNodeDataObject.RENDER_LOCATION_KEY - if the current location
node is one of the 'roots' of the tree, this is set to Boolean.FALSE
since the location child should only be seen relative to one of the
'roots'.
- BrowseNodeDataObject.RENDER_CONTENT_LINK_KEY - if the current location
node is queried with UIConstants.DESTINATION_TEXT_KEY and it returns no
value or an empty string then this is set to Boolean.FALSE.
- BrowseNodeDataObject.RENDER_CATEGORIES_KEY - if the current location
node has no children who are categories, or internal nodes in the tree,
this is set to Boolean.FALSE.
- BrowseNodeDataObject.RENDER_ITEMS_KEY - if the current location node
has no children who are items, or tree leaves, this is set to
Boolean.FALSE.
- BrowseNodeDataObject.CURRENT_STATE_KEY - A String containing the
current state of the browse menu as passed in to the constructor.
So let's say the current location is the "books" node in the tree above.
The keys above would return the following.
- BrowseNodeDataObject.LOCATION_DATA_KEY - A DataObjectList containing
the nodes "shop" and "books".
- BrowseNodeDataObject.CATEGORIES_DATA_KEY - An empty DataObjectList.
"books" has no children which are internal nodes.
- BrowseNodeDataObject.ITEMS_DATA_KEY - A DataObjectList with the "art"
node in it.
- BrowseNodeDataObject.RENDER_LOCATION_KEY - set to Boolean.TRUE since
"books" is not one of the 'roots'.
- BrowseNodeDataObject.RENDER_CONTENT_LINK_KEY - set to Boolean.TRUE
since the "books" node returns "more information" when queried with
UIConstants.DESTINATION_TEXT_KEY.
- BrowseNodeDataObject.RENDER_CATEGORIES_KEY - Set to Boolean.FALSE
since there are no categories.
- BrowseNodeDataObject.RENDER_ITEMS_KEY - Set to Boolean.TRUE since
there are items.
- BrowseNodeDataObject.CURRENT_STATE_KEY - A String containing the
state indicating we are looking at the "books" node. In this case
this string would be "0,0" since "shop" is roots[0] and "books" is
its 0th child.
Destinations for 'location' and 'categories' Data
The location and categories data are DataObjectLists where the destination
on each DataObject is retrieved with the key UIConstant.DESTINATION_KEY.
The destination is set such that if a location or categories element is
pressed the following name-value pairs are returned to the server:
- 'event'='browse'
- 'source'=ID of BrowseMenu
- 'location'=new location state
When the BrowseMenu's formSubmitted attribute is set to true, then the
name-value pairs above are returned through form submission.
If the BrowseMenu's formSubmitted attribute is set to false or is not set
then the destinations contain the destination passed in to the constructor
to which the name-value pairs above are appended. If no destination was
passed in or the destination passed in was null, then the destination
returned by the call context.getURLEncoder().getDefaultURL()
is used.
Therefore the line request.getParameter("location")
above should
return the value associated with the parameter name 'location'. Thus if a
user has selected a category, for example, then the three name-value pairs
above are sent to the server and the line
request.getParameter("location")
will return a String
representing the new location state. The first time a client makes a
request to the servlet this parameter will not exist, in which case the
String returned will be null. When null is passed to the
BrowseNodeDataObject constructor the currentLocation will be set to the
default of "0", representing 'roots[0]'.
- See Also:
SimpleTreeData
,
BrowseMenuUtils
,
BrowseMenuBean
,
UIConstants
Field Summary |
static java.lang.String |
CATEGORIES_DATA_KEY
key to pass to selectValue which returns a DataObjectList with the data
for the categories child. |
static java.lang.String |
CURRENT_STATE_KEY
key to pass to selectValue which returns the String representing the
current location state |
static java.lang.String |
ITEMS_DATA_KEY
key to pass to selectValue which returns a DataObjectList with the data
for the items child. |
static java.lang.String |
LOCATION_DATA_KEY
key to pass to selectValue which returns a DataObjectList with the data
for the location child. |
static java.lang.String |
RENDER_CATEGORIES_KEY
key to pass to selectValue which returns the Boolean value of whether
or not to render the categories child |
static java.lang.String |
RENDER_CONTENT_LINK_KEY
key to pass to selectValue which returns the Boolean value of whether
or not to render the contentLink child |
static java.lang.String |
RENDER_ITEMS_KEY
key to pass to selectValue which returns the Boolean value of whether
or not to render the items child |
static java.lang.String |
RENDER_LOCATION_KEY
key to pass to selectValue which returns the Boolean value of whether
or not to render the location child |
Fields inherited from interface oracle.cabo.ui.UIConstants |
ABBREVIATION_ATTR, ABOUT_CHILD, ACCESS_KEY_ATTR, ADD_NAME, ADD_ROWS_EVENT, ADD_TABLE_ROW_NAME, ADVANCED_CHOICES_CHILD, AGENT_NAME, ALIGNMENT_GROUP_ATTR, ALL_DETAILS_ENABLED_ATTR, ALLOWS_TRANSPARENT_ATTR, ALTERNATE_CONTENT_CHILD, ALTERNATE_TEXT_ATTR, ANCESTOR_ATTRIBUTE_NAME, ANCESTOR_ID_ATTR, ANCESTOR_PATH_ATTR, ANCHOR_ATTR, AND_NAME, ANNOTATION_ATTR, APPLICATION_SWITCHER_NAME, ARRAY_NODE_LIST_NAME, ATTRIBUTE_MAP_NAME, AUTOFLIP_ATTR, AUTOMATIC_ATTR, AUTOSTART_ATTR, BACKGROUND_ATTR, BACKGROUND_DARK, BACKGROUND_LIGHT, BACKGROUND_MEDIUM, BACKGROUND_TRANSPARENT, BANDING_INTERVAL_KEY, BANDING_SHADE_DARK, BANDING_SHADE_KEY, BANDING_SHADE_LIGHT, BEAN_NAME, BETWEEN_TEXT_ATTR, BLOCK_SIZE_ATTR, BODY_NAME, BORDER_LAYOUT_NAME, BORDER_WIDTH_ATTR, BOTTOM_CHILD, BOUND_ATTRIBUTE_NAME, BOUND_MESSAGE_NAME, BOUND_TEXT_NAME, BOUND_VALUE_PROVIDER_NAME, BREAD_CRUMB_TEXT_ATTR, BREAD_CRUMBS_NAME, BROWSE_EVENT, BROWSE_MENU_NAME, BULLETED_LIST_NAME, BULLETS_GROUP_ATTR, BUNDLE_NAME, BUTTON_NAME, BUTTONS_CHILD, BYTE_LENGTH_NAME, CALENDAR_ID_ATTR, CALENDAR_NAME, CANCEL_EVENT, CASE_NAME, CATCH_CHILD, CATEGORIES_CHILD, CATEGORY_TITLE_ATTR, CELL_FORMAT_NAME, CELL_NO_WRAP_FORMAT_KEY, CELL_PADDING_ATTR, CELL_SPACING_ATTR, CENTER_CHILD, CHECK_BOX_NAME, CHECKED_ATTR, CHILD_BLOCK_SIZE_ATTR, CHILD_DATA_ATTR, CHILD_LIST_NAME, CHILD_MAP_NAME, CHILD_NAME_ATTR, CHILD_TYPE_TEXT, CHILD_TYPE_TEXT_ATTR, CHOICE_NAME, CHROME_TYPE_ATTR, CLICK_THRU_DESTINATION_URI_ATTR, COBRANDING_CHILD, COLLAPSE_ALL_EVENT, COLLAPSE_DESTINATION_KEY, COLOR_BUTTON_NAME, COLOR_DATA_ATTR, COLOR_FIELD_NAME, COLOR_NAME, COLOR_PALETTE_NAME, COLOR_PICKER_NAME, COLOR_SWATCH_NAME, COLUMN_BANDING, COLUMN_DATA_FORMAT_KEY, COLUMN_FOOTER_CHILD, COLUMN_FORMAT_ATTR, COLUMN_FORMATS_ATTR, COLUMN_GROUP_NAME, COLUMN_HEADER_CHILD, COLUMN_HEADER_DATA_ATTR, COLUMN_HEADER_FORMAT_ATTR, COLUMN_HEADER_FORMATS_ATTR, COLUMN_HEADER_STAMP_CHILD, COLUMN_NAME, COLUMN_SPAN_ATTR, COLUMNS_ATTR, COMPACT_ATTR, COMPARISON_NAME, COMPARISON_TYPE_EQUALS, COMPARISON_TYPE_GREATER_THAN, COMPARISON_TYPE_GREATER_THAN_OR_EQUALS, COMPARISON_TYPE_LESS_THAN, COMPARISON_TYPE_LESS_THAN_OR_EQUALS, COMPARISON_TYPE_NOT_EQUALS, COMPOSITE_ROLE, CONCAT_NAME, CONCISE_MESSAGE_CHILD, CONFIG_NAME_PARAM, CONSUMER_NAME, CONTENT_CONTAINER_NAME, CONTENT_FOOTER_CHILD, CONTENT_FOOTER_NAME, CONTENT_FORM_CHILD, CONTENT_LINK_CHILD, CONTENT_STYLE_CLASS_ATTR, CONTENT_TYPE_ATTR, CONTENTS_NAME, CONTEXT_POPPING_NAME, CONTEXT_PROPERTY_NAME, CONTEXT_SWITCHER_CHILD, CONTEXT_URI_PARAM, CONTROLS_ALL, CONTROLS_ATTR, CONTROLS_MINIMAL, CONTROLS_NONE, CONTROLS_NONE_VISIBLE, CONTROLS_TYPICAL, CONVERT_NAME, CONVERT_PARAM, COPYRIGHT_CHILD, CORPORATE_BRANDING_CHILD, CURRENT_DATA_ATTR, CURRENT_INDEX_ATTR, CURRENT_THROWABLE_PROPERTY, CUSTOM_COLOR_DATA_ATTR, DATA_KEY, DATA_NAME, DATA_NAME_ATTR, DATA_NAMESPACE_ATTR, DATA_OBJECT_NAME, DATA_SCOPE_NAME, DATA_TYPE_ATTR, DATE_BUTTON_NAME, DATE_EVENT, DATE_FIELD_NAME, DATE_FORMAT_NAME, DATE_NAME, DATE_STYLE_PARAM, DECIMAL_NAME, DEFAULT_CASE_ATTR, DEFAULT_CONTENTS_ATTR, DEFAULT_FORM_NAME, DEFAULT_NAME, DEFAULTING_NAME, DESCRIPTION_ATTR, DESCRIPTION_KEY, DESTINATION_ATTR, DESTINATION_KEY, DESTINATION_TEXT_KEY, DETAIL_CHILD, DETAIL_DISCLOSURE_ATTR, DETAIL_SELECTOR_NAME, DETAILED_MESSAGE_CHILD, DIRECTION_ATTR, DIRTY_ATTR, DISABLED_ATTR, DISCLOSED_ATTR, DISCLOSED_KEY, DISCLOSED_TEXT_ATTR, DISPLAY_EXCEPTION_NAME, DISPLAY_GRID_KEY, DOCUMENT_NAME, EDGE_STAMP_CHILD, EDIT_GROUP_ATTR, EMBEDDED_ATTR, ENC_PARAM, ENCODED_PARAMETER_NAME, END_CHILD, ENTER_CLIENT_ACTION_ATTR, EVENT_ATTR, EVENT_PARAM, EXCEPTIONS_CAUGHT_PROPERTY, EXPAND_ALL_EVENT, EXPAND_DESTINATION_KEY, EXPAND_EVENT, EXPANDABLE_ALWAYS, EXPANDABLE_COLLAPSED, EXPANDABLE_EXPANDED, EXPANDABLE_KEY, EXPANDABLE_NO, EXPRESSION_LANGUAGE_ATTRIBUTE_NAME, FACET_DEFAULT, FACET_EMAIL, FACET_PORTLET, FACET_PRINTABLE, FIELD_WIDTH_ATTR, FILE_UPLOAD_NAME, FILTER_CHILD, FILTER_CHOICE_CHILD, FIRST_CLICK_PASSED_ATTR, FIXED_NAME, FLOW_LAYOUT_NAME, FOCUS_EVENT, FONT_BAR_ATTR, FONT_BEAN_ATTR, FONT_COLOR_BEAN_ATTR, FONT_SIZE_BEAN_ATTR, FOOTER_CHILD, FOOTER_NAME, FOOTNOTE_CHILD, FORM_DATA_ATTR, FORM_NAME, FORM_NAME_ATTR, FORM_NAME_PROPERTY, FORM_PARAMETER_NAME, FORM_SUBMITTED_ATTR, FORM_VALUE_NAME, FORMAT_NAME, FORMATTED_TEXT_NAME, FRAME_BORDER_LAYOUT_NAME, FRAME_NAME, GENERATES_CONTENT_ATTR, GLOBAL_BUTTON_BAR_NAME, GLOBAL_BUTTON_NAME, GLOBAL_BUTTONS_CHILD, GLOBAL_HEADER_NAME, GOTO_EVENT, GRAPH_DIAGRAM_NAME, GRAPH_EDGE_NAME, GRAPH_NODE_NAME, GRAPH_VIEW_STATE_ATTR, H_ALIGN_ATTR, H_ALIGN_CENTER, H_ALIGN_END, H_ALIGN_LEFT, H_ALIGN_RIGHT, H_ALIGN_START, H_GRID_NAME, HARD_WRAP, HEAD_NAME, HEADER_ATTR, HEADER_INSTRUCTIONS_CHILD, HEADER_NAME, HEADERS_ATTR, HEIGHT_ATTR, HIDE_EVENT, HIDE_SHOW_HEADER_NAME, HIDE_SHOW_NAME, HYPERLINK_BUTTON_ATTR, ICON_ATTR, ICON_BUTTON_FORMAT, ICON_KEY, ICON_KEY_NAME, ICON_NAME, ICON_REQUIRED, ICON_SHORT_DESC_KEY, ID_ATTR, IF_NAME, IMAGE_ATTR, IMAGE_MAP_TYPE_ATTR, IMAGE_MAP_TYPE_NONE, IMAGE_MAP_TYPE_SERVER, IMAGE_NAME, IMAGE_UPLOAD_URI_ATTR, IMPORT_SCRIPT_NAME, IN_CONTEXT_BRANDING_CHILD, IN_CONTEXT_BRANDING_STYLE, INCLUDE_NAME, INCOMPLETE_DATA_SET, INDENTATION_GROUP_ATTR, INITIAL_FOCUS_CONTEXT_PROPERTY, INITIAL_FOCUS_ID_ATTR, INLINE_DATE_PICKER_NAME, INLINE_MESSAGE_NAME, INLINE_NAME, INLINE_STYLE_ATTR, INNER_BOTTOM_CHILD, INNER_END_CHILD, INNER_HEIGHT_ATTR, INNER_LEFT_CHILD, INNER_RIGHT_CHILD, INNER_START_CHILD, INNER_TOP_CHILD, INNER_WIDTH_ATTR, INSERTED_NODE_LIST_NAME, INSTANCE_NAME, INSTRUCTION_STYLE, ITEM_TITLE_ATTR, ITEMS_CHILD, JSP_PARAM, LABEL_CHILD, LABEL_WIDTH_ATTR, LABELED_FIELD_LAYOUT_NAME, LABELED_NODE_ID_ATTR, LANGUAGE_ATTR, LARGE_ADVERTISEMENT_CHILD, LEADING_CHILD, LEADING_DESC_SHOWN_ATTR, LEADING_FOOTER_CHILD, LEADING_HEADER_ATTR, LEFT_CHILD, LINK_NAME, LIST_NAME, LIST_OF_VALUES_NAME, LIST_STYLE_ATTR, LIST_STYLE_CIRCLE, LIST_STYLE_DECIMAL, LIST_STYLE_DISC, LIST_STYLE_LOWER_ALPHA, LIST_STYLE_NONE, LIST_STYLE_SQUARE, LIST_STYLE_UPPER_ALPHA, LOC_PARAM, LOCATION_CHILD, LOCATION_PARAM, LONG_DESC_ATTR, LONG_DESC_URL_ATTR, LOV_BUTTON_NAME, LOV_CHOICE_NAME, LOV_EVENT, LOV_FIELD_NAME, LOV_FILTER_EVENT, LOV_INPUT_NAME, LOV_LIBRARY_NAME, LOV_SEARCH_TEXT, LOV_SELECT_COLUMN_NAME, MAILTO_NAME, MAIN_VIEW_HEIGHT_ATTR, MAIN_VIEW_WIDTH_ATTR, MARLIN_NAMESPACE, MAX_VALUE_ATTR, MAX_VALUE_PARAM, MAX_VALUE_UNKNOWN, MAX_VISITED_ATTR, MAXIMUM_LENGTH_ATTR, MEDIA_NAME, MEDIUM_ADVERTISEMENT_CHILD, MESSAGE_ATTR, MESSAGE_BOX_NAME, MESSAGE_CHECK_BOX_NAME, MESSAGE_CHOICE_NAME, MESSAGE_COLOR_FIELD_NAME, MESSAGE_COMPONENT_LAYOUT_NAME, MESSAGE_DATA_ATTR, MESSAGE_DATA_TEXT_NAME, MESSAGE_DATE_FIELD_NAME, MESSAGE_FILE_UPLOAD_NAME, MESSAGE_FORMAT_NAME, MESSAGE_LAYOUT_NAME, MESSAGE_LIST_NAME, MESSAGE_LOV_CHOICE_NAME, MESSAGE_LOV_FIELD_NAME, MESSAGE_LOV_INPUT_NAME, MESSAGE_PROMPT_NAME, MESSAGE_RADIO_BUTTON_NAME, MESSAGE_RADIO_GROUP_NAME, MESSAGE_RADIO_SET_NAME, MESSAGE_RICH_TEXT_EDITOR_NAME, MESSAGE_STYLED_TEXT_NAME, MESSAGE_TEXT_INPUT_NAME, MESSAGE_TEXT_NAME, MESSAGE_TYPE_ATTR, MESSAGE_TYPE_CONFIRMATION, MESSAGE_TYPE_ERROR, MESSAGE_TYPE_INFO, MESSAGE_TYPE_NONE, MESSAGE_TYPE_PROCESSING, MESSAGE_TYPE_WARNING, MESSAGES_CHILD, META_CONTAINER_CHILD, METHOD_ATTR, METHOD_NAME, MIN_VALUE_ATTR, MIN_VALUE_PARAM, MINIMUM_WIDTH_ATTR, MODEL_ATTR, MONTH_PARAM, MULTIPLE_ATTR, MULTIPLE_SELECTION_NAME, NAME_ATTR, NAME_TRANSFORMED_ATTR, NAME_VALUES_ATTR, NAMED_SOURCE_ATTR, NAMES_ATTR, NAVIGATE_EVENT, NAVIGATION_BAR_NAME, NAVIGATION_EXCLUDE_NAMES_ATTR, NAVIGATION_FORM_NAME_ATTR, NAVIGATOR_HEIGHT_ATTR, NAVIGATOR_WIDTH_ATTR, NEXT_EVENT, NO_BANDING, NODE_ATTR, NODE_PARAM, NODE_STAMP_CHILD, NODES_ATTR, NODES_KEY, NOT_NAME, NULL_NAME, NUMBER_FORMAT, OBJECT_NAME_FORMAT, ON_BLUR_ATTR, ON_BLUR_VALIDATER_ATTR, ON_CHANGE_ATTR, ON_CLICK_ATTR, ON_CLICK_KEY, ON_COLOR_SELECT_ATTR, ON_DEMAND, ON_DOUBLE_CLICK_ATTR, ON_FOCUS_ATTR, ON_KEY_DOWN_ATTR, ON_KEY_PRESS_ATTR, ON_KEY_UP_ATTR, ON_LOAD_ATTR, ON_LOV_INIT_ATTR, ON_LOV_SELECT_ATTR, ON_LOV_VALIDATE_ATTR, ON_MOUSE_DOWN_ATTR, ON_MOUSE_MOVE_ATTR, ON_MOUSE_OUT_ATTR, ON_MOUSE_OVER_ATTR, ON_MOUSE_UP_ATTR, ON_NAVIGATE_ATTR, ON_SELECT_ATTR, ON_SUBMIT_ATTR, ON_SUBMIT_VALIDATER_ATTR, ON_SWITCH_APP_ATTR, ON_UNLOAD_ATTR, OPTION_NAME, OR_NAME, ORIENTATION_ATTR, ORIENTATION_BOTTOM, ORIENTATION_DEFAULT, ORIENTATION_HORIZONTAL, ORIENTATION_TOP, ORIENTATION_VERTICAL, PAGE_BUTTON_BAR_NAME, PAGE_BUTTONS_CHILD, PAGE_HEADER_CHILD, PAGE_HEADER_LAYOUT_NAME, PAGE_LAYOUT_NAME, PAGE_NAME, PAGE_STAMP_STYLE, PAGE_STATUS_CHILD, PALETTE_ID_ATTR, PALETTE_NAME, PARAM_NAME_EXCHANGES_ATTR, PARSE_NAME, PARTIAL_CONTENT_NAME, PARTIAL_KEEP_ALIVE_PROPERTY, PARTIAL_LINK_NAME, PARTIAL_LIST_UNRENDERED_PROPERTY, PARTIAL_NODE_ID_ATTR, PARTIAL_PAGE_CONTEXT_PROPERTY, PARTIAL_PARAM, PARTIAL_RENDER_ENABLED_ATTR, PARTIAL_RENDER_MODE_ATTR, PARTIAL_RENDER_MODE_MULTIPLE, PARTIAL_RENDER_MODE_NONE, PARTIAL_RENDER_MODE_SELF, PARTIAL_ROOT_NAME, PARTIAL_SUBMIT_BUTTON_NAME, PARTIAL_TARGET_IDS_ATTR, PARTIAL_TARGETS_ATTR, PARTIAL_TARGETS_PARAM, PATTERN_ATTR, PATTERN_PARAM, PATTERNS_ATTR, PERCENT_COMPLETE_ATTR, PERCENT_UNKNOWN, PICKER_ID_ATTR, PLAY_COUNT_ATTR, PLAYER_ATTR, PLAYER_LINK, PLAYER_QUICKTIME, PLAYER_REAL, PLAYER_WINDOWS, PORTLET_NAME, POST_TEXT_ATTR, PRE_TEXT_ATTR, PREVIOUS_EVENT, PRIMARY_CLIENT_ACTION_ATTR, PRIVACY_CHILD, PROCESS_STEPS_NAME, PROCESSING_LAYOUT_NAME, PROCESSING_NAME, PRODUCT_BRANDING_CHILD, PRODUCT_BRANDING_NAME, PROMPT_ATTR, PROMPT_CHILD, PROMPT_WIDTH_ATTR, PROVIDER_ATTR, PROXIED_ATTR, PROXY_ATTR, QUICK_LINKS_NAME, QUICK_LINKS_SHOWN_ATTR, QUICK_SEARCH_CHILD, RADIO_BUTTON_NAME, RADIO_GROUP_NAME, RADIO_GROUP_TYPE_CHOICE, RADIO_GROUP_TYPE_RADIO, RADIO_OPTION_NAME, RADIO_SET_NAME, RAW_TEXT_NAME, READ_ONLY_ATTR, REFRESH_EVENT, REG_EXP_NAME, RENDERED_ATTR, RENDERING_MODE_ATTR, REORDERABLE_ATTR, REQUIRED_ATTR, REQUIRED_NO, REQUIRED_UI_ONLY, REQUIRED_VALIDATER_ONLY, REQUIRED_YES, RESET_BUTTON_NAME, RETURN_NAVIGATION_CHILD, RICH_TEXT_EDITOR_NAME, RICH_TEXT_MODE, RICH_TEXT_MODE_DISPLAY_HEIGHT_ATTR, RICH_TEXT_MODE_DISPLAY_LENGTH_ATTR, RICH_TEXT_MODE_EVENT, RIGHT_CHILD, ROOT_ATTRIBUTE_MAP_NAME, ROOT_CHILD_EXISTS_NAME, ROOT_CHILD_LIST_NAME, ROOT_CHILD_MAP_NAME, ROOT_CHILD_NAME, ROOT_PARAM, ROW_BANDING, ROW_FORMATS_ATTR, ROW_HEADER_DATA_ATTR, ROW_HEADER_FORMATS_ATTR, ROW_HEADER_STAMP_CHILD, ROW_LAYOUT_NAME, ROW_SPAN_ATTR, ROWS_ATTR, SAMPLE_NAME, SCRIPT_NAME, SCROLLED_VALUE_ATTR, SCROLLED_VALUE_PARAM, SCROLLING_ATTR, SCROLLING_AUTO, SCROLLING_NO, SCROLLING_YES, SEARCH_AREA_MODE_ATTR, SEARCH_DESC_ATTR, SEARCH_INSTRUCTIONS_CHILD, SEARCH_TEXT_ATTR, SECRET_ATTR, SECRET_FIELD_DEFAULT_VALUE, SELECT_ATTR, SELECT_MODE_KEY, SELECT_OPTION_NAME, SELECTED_ATTR, SELECTED_INDEX_ATTR, SELECTED_KEY, SELECTED_VALUE_ATTR, SELECTION_ATTR, SELECTION_PARAM, SEPARATOR_CHILD, SEPARATOR_NAME, SERVER_VALIDATER_ATTR, SERVLET_INCLUDE_NAME, SET_CONTEXT_PROPERTY_NAME, SHORT_DESC_ATTR, SHORT_TEXT_ATTR, SHOW_ALL_ACTIVE, SHOW_ALL_ATTR, SHOW_ALL_NO, SHOW_ALL_YES, SHOW_EVENT, SHOW_WINDOW_ATTR, SHUTTLE_NAME, SIDE_BAR_NAME, SIDE_NAV_NAME, SINGLE_SELECTION_NAME, SINGLE_STEP, SIZE_ATTR, SIZE_PARAM, SOFT_WRAP, SORT_EVENT, SORT_STATE_ASCENDING, SORT_STATE_DESCENDING, SORTABLE_ASCENDING, SORTABLE_ATTR, SORTABLE_DESCENDING, SORTABLE_HEADER_NAME, SORTABLE_NO, SORTABLE_YES, SOURCE_ATTR, SOURCE_PARAM, SPACER_NAME, STACK_LAYOUT_NAME, STANDBY_TEXT_ATTR, START_CHILD, STATE_CHECK_ATTR, STATE_PARAM, STATE_ROLE, STEPS_COMPLETE_ATTR, STRUCTURAL_ROLE, STYLE_CLASS_ATTR, STYLE_GROUP_ATTR, STYLE_SHEET_NAME, STYLE_USAGE_ATTR, STYLED_ITEM_NAME, STYLED_LIST_NAME, STYLED_TEXT_NAME, SUB_TAB_BAR_NAME, SUB_TAB_LAYOUT_NAME, SUB_TABS_CHILD, SUB_TRAIN_ATTR, SUBMIT_BUTTON_NAME, SUBMIT_PREPARE_ATTR, SUMMARY_ATTR, SWITCH_APP_EVENT, SWITCH_APP_TYPE_BACK, SWITCH_APP_TYPE_GOTO, SWITCH_MODE_HYPERLINK_ATTR, SWITCHER_NAME, TAB_BAR_NAME, TABLE_ACTIONS_CHILD, TABLE_BANDING_KEY, TABLE_DATA_ATTR, TABLE_FILTER_CHILD, TABLE_FOOTER_NAME, TABLE_FORMAT_ATTR, TABLE_LAYOUT_NAME, TABLE_NAME, TABLE_NAME_ATTR, TABLE_SELECTION_CHILD, TABS_CHILD, TARGET_FRAME_ATTR, TARGET_FRAME_KEY, TEMPLATE_DEFINITION_NAME, TEMPLATE_IMPORT_NAME, TEMPLATE_LIBRARY_NAME, TEMPLATES_NAME, TEXT_ATTR, TEXT_FORMAT, TEXT_INPUT_NAME, TEXT_KEY, TEXT_MODE, TEXT_MODE_DISPLAY_HEIGHT_ATTR, TEXT_MODE_DISPLAY_LENGTH_ATTR, TEXT_NAME, THREADED_ATTR, THREADED_LAYOUT_NAME, TIME_INTERVAL_ATTR, TIP_ATTR, TIP_NAME, TITLE_ATTR, TOK_PARAM, TOP_CHILD, TOTAL_CHILD, TOTAL_ROW_NAME, TRAILING_CHILD, TRAILING_DESC_SHOWN_ATTR, TRAILING_FOOTER_CHILD, TRAILING_HEADER_ATTR, TRAIN_NAME, TREE_DATA_ATTR, TREE_NAME, TRUNCATE_AT_ATTR, TRUNCATE_NAME, TRY_NAME, TYPE_ATTR, TYPE_PARAM, TYPE_POST, TYPE_PRE, TYPE_TEXT_ATTR, TZ_OFFSET_PARAM, UNDISCLOSED_TEXT_ATTR, UNKNOWN_ROLE, UNVALIDATED_ATTR, UPDATE_EVENT, URI_PARAM, URL_INCLUDE_NAME, USE_SEPARATE_ROWS_ATTR, USER_INFO_CHILD, USER_INVISIBLE_ROLE, USES_UPLOAD_ATTR, UTF8_LENGTH_NAME, V_ALIGN_ABSMIDDLE, V_ALIGN_ATTR, V_ALIGN_BOTTOM, V_ALIGN_MIDDLE, V_ALIGN_TOP, VALID_ATTR, VALIDATE_BLANKS_ATTR, VALUE_ATTR, VALUE_COLUMNS_ATTR, VALUE_PARAM, VALUE_SHOW_ALL, WIDTH_ATTR, WIDTH_KEY, WML_NAME, WRAP_ATTR, WRAPPING_DISABLED_ATTR, YEAR_PARAM |
Constructor Summary |
BrowseNodeDataObject(DataObject[] treeRoots,
java.lang.String currentLocation)
Constructs a DataObject with information relevant to a BrowseMenu |
BrowseNodeDataObject(DataObject[] treeRoots,
java.lang.String currentLocation,
java.lang.String destination)
Constructs a DataObject with information relevant to a BrowseMenu |
BrowseNodeDataObject(DataObjectList treeRoots,
java.lang.String currentLocation)
Constructs a DataObject with information relevant to a BrowseMenu |
BrowseNodeDataObject(DataObjectList treeRoots,
java.lang.String currentLocation,
java.lang.String destination)
Constructs a DataObject with information relevant to a BrowseMenu |
BrowseNodeDataObject(DataObject treeRoot,
java.lang.String currentLocation)
Constructs a DataObject with information relevant to a BrowseMenu |
BrowseNodeDataObject(DataObject treeRoot,
java.lang.String currentLocation,
java.lang.String destination)
Constructs a DataObject with information relevant to a BrowseMenu |
Method Summary |
java.lang.Object |
selectValue(RenderingContext context,
java.lang.Object select)
Given a select object, returns the value matching that selection. |
Methods inherited from class java.lang.Object |
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
CATEGORIES_DATA_KEY
public static final java.lang.String CATEGORIES_DATA_KEY
- key to pass to selectValue which returns a DataObjectList with the data
for the categories child.
ITEMS_DATA_KEY
public static final java.lang.String ITEMS_DATA_KEY
- key to pass to selectValue which returns a DataObjectList with the data
for the items child.
LOCATION_DATA_KEY
public static final java.lang.String LOCATION_DATA_KEY
- key to pass to selectValue which returns a DataObjectList with the data
for the location child.
RENDER_ITEMS_KEY
public static final java.lang.String RENDER_ITEMS_KEY
- key to pass to selectValue which returns the Boolean value of whether
or not to render the items child
RENDER_CATEGORIES_KEY
public static final java.lang.String RENDER_CATEGORIES_KEY
- key to pass to selectValue which returns the Boolean value of whether
or not to render the categories child
RENDER_CONTENT_LINK_KEY
public static final java.lang.String RENDER_CONTENT_LINK_KEY
- key to pass to selectValue which returns the Boolean value of whether
or not to render the contentLink child
RENDER_LOCATION_KEY
public static final java.lang.String RENDER_LOCATION_KEY
- key to pass to selectValue which returns the Boolean value of whether
or not to render the location child
CURRENT_STATE_KEY
public static final java.lang.String CURRENT_STATE_KEY
- key to pass to selectValue which returns the String representing the
current location state
BrowseNodeDataObject
public BrowseNodeDataObject(DataObject treeRoot,
java.lang.String currentLocation,
java.lang.String destination)
- Constructs a DataObject with information relevant to a BrowseMenu
- Parameters:
treeRoot
- the root of a tree of DataObjectscurrentLocation
- the current location state.
currentLocation
is a
comma separated String. Children of nodes are counted using a zero-based
index. If the browse menu is currently rendering the 4th child of the
root node then currentLocation
would be "0,3". That's 0 for
the root node and 3 for its fourth child.
currentLocation
for the 7th child of the 4th child of the
root node would be stored as "0,3,6" and so on. Normally a user
would start with "0" to indicate the root of the tree of data, and
this is the default if currentLocation
is null.destination
- the url to which links should go. If null it will be
set to the destination returned by
context.getURLEncoder().getDefaultURL()
.
BrowseNodeDataObject
public BrowseNodeDataObject(DataObjectList treeRoots,
java.lang.String currentLocation,
java.lang.String destination)
- Constructs a DataObject with information relevant to a BrowseMenu
- Parameters:
treeRoots
- the roots of a tree of DataObjectscurrentLocation
- the current location state.
currentLocation
is a
comma separated String. Children of nodes are counted using a zero-based
index. If the browse menu is currently rendering the 4th child of the first
root node then currentLocation
would be "0,3". That's 0 for
the first root node and 3 for its fourth child.
currentLocation
for the 7th child of the 4th child of the
first root node would be stored as "0,3,6" and so on. Normally a user
would start with "0" or "1" to indicate one of the roots of the tree of
data. The default is "0" if currentLocation
is null.destination
- the url to which links should go. If null it will
be set to the destination returned by
context.getURLEncoder().getDefaultURL()
.
BrowseNodeDataObject
public BrowseNodeDataObject(DataObject[] treeRoots,
java.lang.String currentLocation,
java.lang.String destination)
- Constructs a DataObject with information relevant to a BrowseMenu
- Parameters:
treeRoots
- the roots of a tree of DataObjectscurrentLocation
- the current location state.
currentLocation
is a
comma separated String. Children of nodes are counted using a zero-based
index. If the browse menu is currently rendering the 4th child of the first
root node then currentLocation
would be "0,3". That's 0 for
the first root node and 3 for its fourth child.
currentLocation
for the 7th child of the 4th child of the
first root node would be stored as "0,3,6" and so on. Normally a user
would start with "0" or "1" to indicate one of the roots of the tree of
data. The default is "0" if currentLocation
is null.destination
- the url to which links should go. If null it will
be set to the destination returned by
context.getURLEncoder().getDefaultURL()
.
BrowseNodeDataObject
public BrowseNodeDataObject(DataObject treeRoot,
java.lang.String currentLocation)
- Constructs a DataObject with information relevant to a BrowseMenu
- Parameters:
treeRoot
- the root of a tree of DataObjectscurrentLocation
- the current location state.
currentLocation
is a
comma separated String. Children of nodes are counted using a zero-based
index. If the browse menu is currently rendering the 4th child of the
root node then currentLocation
would be "0,3". That's 0 for
the root node and 3 for its fourth child.
currentLocation
for the 7th child of the 4th child of the
root node would be stored as "0,3,6" and so on. Normally a user
would start with "0" to indicate the root of the tree of data, and
this is the default if currentLocation
is null.
BrowseNodeDataObject
public BrowseNodeDataObject(DataObjectList treeRoots,
java.lang.String currentLocation)
- Constructs a DataObject with information relevant to a BrowseMenu
- Parameters:
treeRoots
- the roots of a tree of DataObjectscurrentLocation
- the current location state.
currentLocation
is a
comma separated String. Children of nodes are counted using a zero-based
index. If the browse menu is currently rendering the 4th child of the first
root node then currentLocation
would be "0,3". That's 0 for
the first root node and 3 for its fourth child.
currentLocation
for the 7th child of the 4th child of the
first root node would be stored as "0,3,6" and so on. Normally a user
would start with "0" or "1" to indicate one of the roots of the tree of
data. The default is "0" if currentLocation
is null.
BrowseNodeDataObject
public BrowseNodeDataObject(DataObject[] treeRoots,
java.lang.String currentLocation)
- Constructs a DataObject with information relevant to a BrowseMenu
- Parameters:
treeRoots
- the roots of a tree of DataObjectscurrentLocation
- the current location state.
currentLocation
is a
comma separated String. Children of nodes are counted using a zero-based
index. If the browse menu is currently rendering the 4th child of the first
root node then currentLocation
would be "0,3". That's 0 for
the first root node and 3 for its fourth child.
currentLocation
for the 7th child of the 4th child of the
first root node would be stored as "0,3,6" and so on. Normally a user
would start with "0" or "1" to indicate one of the roots of the tree of
data. The default is "0" if currentLocation
is null.
selectValue
public java.lang.Object selectValue(RenderingContext context,
java.lang.Object select)
- Given a select object, returns the value matching that selection.
- Specified by:
selectValue
in interface DataObject
- Following copied from interface:
oracle.cabo.ui.data.DataObject
- Parameters:
context
- the current rendering contextselect
- a select criterion, syntax as defined by the data object