2-12 Java EE Developers Guide for Oracle Application Development Framework
2.3.1 How to Use the Data Controls Panel
JDeveloper provides you with a predefined set of UI components from which to choose for each data control item you drop.
To use the Data Controls panel to create UI components: 1.
Select an item in the Data Controls panel and drag it onto the visual editor for your page. For a definition of each item in the panel, see
Table 2–1 .
2.
From the ensuing context menu, select a UI component. When you drag an item from the Data Controls panel and drop it on a page,
JDeveloper displays a context menu of all the default UI components available for the item you dropped.
Figure 2–6 shows the context menu displayed when an accessor returned
collection from the Data Controls panel is dropped on a page. Method
Return Represents an object that is returned by a custom method. The
returned object can be a single value or a collection. A method return appears as a child under the method that
returns it. The objects that appear as children under a method return can be attributes of the collection, other methods that
perform actions related to the parent collection, or operations that can be performed on the parent collection.
For single values: text fields and selection lists.
For collections: forms, tables, trees, and range
navigation components. When a single-value
method return is dropped, the method is not invoked
automatically by the framework. A user either
has to also create an invoke action as an
executable, or drop the corresponding method as
a button to invoke the method.
Operation Represents a built-in data control operation that performs actions on the parent object. Data control operations are located
in an Operations node under collections or method returns. The operations that are children of a particular collection or method
return operate on those objects only.
If an operation requires one or more parameters, they are listed in a Parameters node under the operation.
Command components such as buttons or links.
For information about creating command
components from operations, see
Section 3.4, Incorporating Range
Navigation into Forms. Parameter Represents a parameter value that is declared by the method or
operation under which it appears. Parameters appear in the Parameters node under a method or operation.
Label, text, and selection list components.
Table 2–1 Cont. The Data Controls Panel Icons and Object Hierarchy
Icon Name
Description Used to Create...
Using ADF Model Data Binding in a Java EE Web Application 2-13
Figure 2–6 Data Controls Panel Context Menu
Depending on the component you select from the context menu, JDeveloper may display a dialog that enables you to define how you want the component to look.
The resulting UI component appears in the JDeveloper visual editor, as shown in Figure 2–7
.
Figure 2–7 Databound UI Component: ADF Table
2.3.2 What Happens When You Use the Data Controls Panel to Create UI Components