1. Download the schema zip file from OTN. If you created the schema previously, go to the next cue card.
2. Unzip the file to a convenient location (for example, c:\temp).
3. From the File menu, choose Open . Open the workspace c:\temp\Infrastructure\Infrastructure.jws.
4. If you are prompted to migrate the project, click Yes to confirm, then click OK.
5. In the Application Navigator, expand the MasterBuildScript project. Under Resources double-click build.properties to open it in the editor.
6. Set the appropriate values in the build.properties file ( jdeveloper.home, and all the jdbc.* and db.* settings). Keep all other properties set to their default values. The demo user must be named FOD.
   The relevant settings are:
   jdeveloper.home             The /jdeveloper directory where you have JDeveloper installed, for example, c:/JDeveloper_11/jdeveloper/
   jdbc.urlBase                    Base URL for your database, for example, jdbc:oracle:thin:@localhost
   jdbc.port                         Port number for your database, for example, 1521
   jdbc.sid                           Database System Identifier, for example, XE or ORCL
   db.adminUser                  Database user with admin privileges, for example, system
   db.demoUser.tablespace  Tablespace name where the FOD user will be installed, for example, USERS
7. In the MasterBuildScript project, select the build.xml file.
8. In the Structure window, right-click the refreshSchema target and choose Run Target "refreshSchema" .
9. When prompted, enter the password for the database user with admin privileges.
   

   In the IDE

   After running the Ant task, you should see a build successful message in the JDeveloper Log window.   [ tell me more...]

   
   
   

Create a New Application and Project

1. Open the Create Application wizard [ File > New > General > Applications] .
2. To follow along with the example, enter the application name OrdersApplication.
3. Select Java Desktop Application (ADF) in the Applica tion Template list, and click Finish .
   

   Application Templates

   Application templates provide you with a quick way to create the project structure for standard applications with the appropriate combination of technologies already specified. The new application created from the template appears in the Application Navigator already partitioned into tiered projects, with the associated technology scopes set in each project.   [ tell me more...]

   
   
   
   

   In the IDE

   When you complete the steps for creating a new application and project, the Projects panel in the Application Navigator should look like this:  [ tell me more...]

   
   
   

Create a Database Connection

1. Open the Create Database Connection dialog [ File > New > General > Connections > Database Connection] .
2. Select Application Resources if it is not already selected as the Create Connection In option.
3. Enter a name for the connection, select the connection type, and enter the username and password. To follow along with this example, use FOD for the connection name and  fod for the username.
4. Click Test Connection to confirm that you can connect.
5. Click OK if the connection was successful.
6. In the Application Navigator, expand the Connections and Database nodes in the Application Resources panel to see the database objects.
   

   In the IDE

   When you complete the steps for creating a database connection, the Application Navigator should look similar to this when you expand the Application Resources panel. The database connection is now included as a resource for your application under the Connections | Database nodes.   [ tell me more...]

   
   
   

Create Oracle ADF Business Components

1. In the Application Navigator, select the Model project and launch the Create Business Components from Tables wizard [ File > New > Business Tier > ADF Business Components > Business Components from Tables] .
2. In the Initialize Business Components Project dialog, ensure that FOD is the currently selected database connection. Then click OK.
   

   Business Components Connection

   The Oracle ADF Business Components project requires a database connection that you will use to create business components from database objects. The database connection you specify will also be used by the Oracle ADF Business Components runtime to manage session facade failover and state management.  [ tell me more...]

   
   
   
3. On step 1, Entity Objects, click Query to populate the A vailable list. If your schema has many tables, you may experience a short delay.
4. Select the tables, ORDERS and ORDER_ITEMS, from the A vailable list and then click to move them to the Selec ted list. (The tables are related by a foreign key so the resulting business components represent a one-to-many relationship.) Click Next .
   

   Oracle ADF Business Components from Database Tables

   The Create Business Components from Tables wizard allows you to easily create a package of business domain components (entity objects, associations, and domains) from existing database objects and optionally to create a default package of data model components (view objects, view links, and an application module) from these newly generated business domain components.  [ tell me more...]

   
   
   
5. On step 2, Updatable View Objects, click to move both business components, OrderItems (FOD.ORDER_ITEMS) and Orders (FOD.ORDERS), from the A vailable list to the Selec ted list. Then click Next .
6. Click Next to skip step 3, Read-Only View Objects, which aren't needed.
7. On step 4, Application Module, accept the default application module name and click Finish .
8. Click Save All to save your work.
   

   In the IDE

   After completing the Create Business Components from Tables wizard, the Model project in the Application Navigator should look similar to this:  [ tell me more...]

   
   
   

Create a Master Form in ADF Swing Form

1. In the Application Navigator, select the View project and open the Create ADF Swing Empty Form dialog [ File > New > Client Tier > ADF Swing > Empty Form] .
2. Accept Form as the form name, and view as the package name. Confirm that Generate a Menu Bar is selected. Then click OK.
   

   Creating an ADF Swing Empty Form

   Oracle ADF Swing is a rich client technology in the Oracle Application Development Framework (Oracle ADF). Oracle ADF Swing is fully compatible with Java Swing and adds a thin layer to the client application so that standard Java components can work with the Oracle ADF data binding libraries. To enable ADF data binding in your Java client application, use the Create ADF Swing Empty Form dialog to generate a form that contains ADF-specific code.  [ tell me more...]

   
   
   
3. In the Application Navigator, expand the Data Controls panel and the AppModuleDataControl node. Drag and drop the collection OrdersView1 in the center of the empty form in the visual editor. Choose Add Edit Form from the context menu.
   

   Data Controls Panel and UI Controls

   The task of designing databound forms that coordinate with a back-end business service is accomplished declaratively with the Data Controls panel. The Data Controls panel affords the UI designer a hierarchical view of those business services that the application developer has registered with an instance of an Oracle ADF data control.   [ tell me more...]

   
   
   
4. In the Create ADF Swing Edit Form dialog, hold down the Ctrl key and multi-select all the attributes except the following: OrderId, OrderDate, OrderStatusCode, OrderTotal. Click to delete the selected attributes. Then select OrderId, and click to move the attribute to the top of the list. Accept the default file name. Deselect Create Navigator Bar , then click OK.
   

   Creating an ADF Swing Edit Form

   The Create ADF Swing Edit Form dialog simplifies creating a databound form by generating the code for the objects of the data collection you select.   [ tell me more...]

   
   
   
5. In the visual editor, click in the client form outside the top left corner of the edit form you just added.
6. In the Structure window, make sure dataPanel (which is below navBar) is selected. In the Property Inspector, Visual section, select BorderLayout from the layout dropdown list.
   

   BorderLayout and Constraints

   A Java UI container uses a special object called a layout manager to control how components in the container are located and sized each time the container is displayed. A layout manager automatically arranges the components in the container according to a particular set of rules specific to that layout manager. Layout managers allow you to specify rules and constraints for the layout of your UI in a way that will be portable across platforms.  [ tell me more...]

   
   
   
7. In the Structure window, select panelOrdersView1Helper1 (which is under the expanded dataPanel). Click the Constraints tab (next to the Property Inspector tab) to bring the Constraints property visual editor forward. In the Constraints property visual editor, select the topmost box.
8. Click Save All to save the files.
9. In the Application Navigator, double-click PanelOrdersView1Helper.java to open the source file for the edit form panel. In the editor window, click Design to use the Java visual editor.
10. In the Structure window, select dataPanel (FormLayout). In the Java visual editor, right-click the first cell in the first column and choose Column Properties. In the Column Properties dialog, do the following, then click OK.
    Under Alignment, select F ill .
    Under Size, select Component Size from the dropdown list, then click Default .
    Under Resize, select None .
    

    FormLayout and Column Properties

    The edit form panel you added previously is created by JDeveloper using FormLayout in the data panel, as shown in the Structure window:  [ tell me more...]

    
    
    
11. In the editor window, click the Form.java tab at the top to bring the client form forward. Click Rebuild to rebuild the View project.
    

    In the IDE

    When you complete the steps for creating a master form in ADF Swing Form, the form in the Java visual editor should look similar to this:  [ tell me more...]

    
    
    

Create a Detail Table in ADF Swing Panel

1. In the Application Navigator, select the View project and open the Create ADF Swing Empty Panel dialog [ File > New > Client Tier > ADF Swing > Empty Form] .
2. Enter OrderItemsPanel as the panel name, and accept view as the package name. Confirm that P anel , and both optional attributes are selected, then click OK.
   

   Creating an ADF Swing Empty Panel

   The Create ADF Swing Empty Panel/InternalFrame dialog lets you create either an empty panel or internal frame. Select P anel to create an empty panel. In the dialog, the name you enter becomes the Java class that defines the panel for containing databound UI components.  [ tell me more...]

   
   
   
3. If necessary, click the Property Inspector tab to bring it in front of the Constraints property editor. In the Property Inspector, Visual section, select BorderLayout from the layout dropdown list.
4. In the Application Navigator, expand the Data Controls panel and the AppModuleDataControl node. Then expand the same master collection of objects that you used previously, OrdersView1.
   

   Collection Hierarchy in the Data Controls Panel

   The Data Controls panel affords the UI designer a hierarchical view of those business services that the application developer has registered with an instance of an Oracle ADF data control. The data control captures the master-detail relationships exposed by business service collections, and the Data Controls panel displays those relationships as parent and child nodes in the hierarchy. To create the detail portion of a master-detail page, always select a collection that constitutes a child node of the master collection node. If these parent-child nodes are not shown, then the business service that was registered with the ADF data control does not contain this relationship.  [ tell me more...]

   
   
   
5. Drag and drop the detail collection OrderItemsView2 in the top left corner of the empty panel in the visual editor. Choose Add Child NavigationBar from the context menu.
   

   Designing the Detail Panel

   Because the detail portion of your client form will display a set of data objects in the detail collection, your panel needs to contain a collection-level UI control. The table control is ideally suited for this purpose. Each row of the table corresponds to a single data object, such as an order items record, where the attributes of each object correspond to the table columns.   [ tell me more...]

   
   
   
6. In the Component Palette, Swing page, Containers panel, drag JScrollPane and drop it in the center of the remaining empty panel space in the visual editor.
7. In the Data Controls panel, drag the same detail collection of objects, OrderItemsView2, and drop it into the empty JScrollPane you just added.
8. From the context menu, choose Add Child Table to display the data objects of the detail collection in table format.
9. Click Save All to save the files.
   

   In the IDE

   When you complete the steps for creating a detail table in ADF Swing Panel, the panel in the Java visual editor should look similar to this:   [ tell me more...]

   
   
   

Complete and Run the Application

1. In the editor window, click the Form.java document tab to bring the client form forward.
2. In the Application Navigator, View project, drag OrderItemsPanel.java to the visual editor and drop it in the middle of the space below the master edit form.
3. In the Select Option dialog, make sure Embed Panel is selected, then click OK.
4. In the Application Navigator, select Form.java.
5. In the Structure window for Form.java, Design tab, make sure orderItemsPanel1 is selected. Click the Constraints tab to bring it in front of the Property Inspector. In the Constraints visual property editor, confirm that the center box is selected.
   

   Constraints Property

   The BorderLayout layout manager arranges a container's components in one of five areas within a BorderLayout, based on the constraints property of the component: North, South, East, West, and Center.   [ tell me more...]

   
   
   
6. Click Rebuild to rebuild the View project.
7. In the Application Navigator, right-click Form.java and choose R un .
8. In the running application window, choose File Exit to stop the application.
   

   In the IDE

   When you complete the steps, the client form in the Java visual editor should look similar to this:  [ tell me more...]

   
   
   

Customize Form Labels with ADF Control Hints

1. In the Application Navigator, Model project, under Application Sources | model, double-click the view object OrdersView that defines the attributes for which you want to set control hints.
2. In the overview editor for view objects, select Attributes.
3. In the Attributes section, double-click OrderId.
4. In the Edit Attribute dialog, select Control Hints. Enter Order Number in the Label Text field. Click OK.
   

   Control Hints

   Instead of displaying the value from the attribute's heading, such as OrderId, you can replace these with more meaningful labels for the user, such as Order Number.   [ tell me more...]

   
   
   
5. Repeat the procedure to customize the control hint labels of the other attributes you have added to the master edit form, namely OrderDate, OrderStatusCode, and OrderTotal, using the label text Date of Order, Status, and Total Price, respectively.
6. In the Application Navigator, View project, right-click Form.java and choose R un .
   

   In the IDE

   When you complete the steps for customizing labels with control hints, the Model project in the Application Navigator should look similar to this:  [ tell me more...]

   
   
   

Copyright © 1997, 2009, Oracle. All rights reserved.