Contents

Title and Copyright Information

Preface

• Audience
• Documentation Accessibility
• Related Documents
• Conventions

1 Introduction to J2EE Application Development in JDeveloper

• 1.1 Summary
• 1.2 Introduction
• 1.3 Considering the Application Architecture
• 1.4 Partitioning Application Development in JDeveloper
• 1.5 Speeding Development with Frameworks in JDeveloper
• 1.6 Development Methodology in JDeveloper
• 1.6.1 Iterative Development and Visual Tools
• 1.6.2 Roles and Code Integration
• 1.7 Proceeding with Application Development in JDeveloper
• 1.8 Related Information

2 Business Services and the Oracle Application Development Framework

• 2.1 Summary
• 2.2 The Available Business Service Technologies
• 2.2.1 Oracle ADF Business Components Technology
• 2.2.2 Enterprise JavaBeans Technology
• 2.2.3 OracleAS TopLink Plain Old Java Objects (POJO)
• 2.2.4 Enterprise JavaBeans Technology with TopLink CMP
• 2.2.5 Web Services
• 2.2.6 Java Objects with Hand-Coded Persistence
• 2.3 Which Business Services Technology Should I Use?
• 2.3.1 Do You Have Your Own Object Framework?
• 2.3.2 Do You Want to Use an Existing Object Framework?
• 2.3.3 Can You Use Oracle Runtime Technology?
• 2.4 Business Service Layers
• 2.4.1 Persistent Business Objects
• 2.4.2 Data Access Components
• 2.4.3 Service Objects
• 2.5 Detailed Comparison of Business Service Architectures
• 2.5.1 How ADF Business Components Technology Provides Persistent Business Objects
• 2.5.2 How ADF Business Components Technology Provides Data Access Components
• 2.5.3 How ADF Business Components Technology Provides Service Objects
• 2.5.4 How Enterprise JavaBeans Technology Provides Persistent Business Objects
• 2.5.5 How Enterprise JavaBeans Technology Provides Data Access Components
• 2.5.6 How Enterprise JavaBeans Technology Provides Service Objects
• 2.5.7 How OracleAS TopLink Technology with POJO Provides Persistent Business Objects
• 2.5.8 How OracleAS TopLink Technology with POJO Provides Data Access Components
• 2.5.9 How OracleAS TopLink Technology with POJO Provides Service Objects
• 2.5.10 How Enterprise JavaBeans Technology with TopLink CMP Provides Persistent Business Objects
• 2.5.11 How Enterprise JavaBeans Technology with TopLink CMP Provides Data Access Components
• 2.5.12 How Enterprise JavaBeans Technology with TopLink CMP Provides Service Objects

3 ADF Business Components in Depth

• 3.1 Summary
• 3.2 ADF Entity Object Definitions
• 3.2.1 Attributes and Accessors
• 3.2.2 Validators
• 3.2.3 The validateEntity() Method
• 3.2.4 Creation and Deletion Logic
• 3.2.5 DML Customization
• 3.2.6 Security
• 3.3 ADF Associations
• 3.3.1 Accessor Attributes
• 3.3.2 Cardinality
• 3.3.3 Row Iterators
• 3.3.4 Compositions
• 3.4 ADF Domains
• 3.4.1 Predefined Domains
• 3.4.2 Oracle Object Type Domains
• 3.4.3 Validation Domains
• 3.5 ADF View Object Definitions
• 3.5.1 Attribute Mappings
• 3.5.2 Navigating Through Result Sets
• 3.5.3 Creating and Deleting Rows
• 3.5.4 Keys
• 3.5.5 View Criteria
• 3.6 ADF View Link Definitions
• 3.6.1 Accessor Attributes
• 3.6.2 Cardinality
• 3.7 ADF Application Module Definitions
• 3.7.1 View Object and View Link Instances
• 3.7.2 Transactions
• 3.7.3 Service Methods
• 3.7.4 Application Module Pooling
• 3.8 ADF Business Components Design Decisions
• 3.8.1 Where to Implement Business Rules
• 3.8.2 Whether to Use Entity Object Definitions

4 Overview of the Oracle ADF Model Layer

• 4.1 Summary
• 4.2 Role of the Model Layer
• 4.2.1 About MetaData for the Oracle ADF Binding Context
• 4.2.2 Oracle ADF Model API Overview
• 4.3 Benefiting from the Oracle ADF Model Layer
• 4.3.1 Role of the Oracle ADF Data Controls
• 4.3.1.1 Business Object Access Services
• 4.3.1.2 Transaction Services
• 4.3.1.3 State Management Services
• 4.3.2 Role of the Oracle ADF Bindings
• 4.3.3 Generic Runtime Properties for All Oracle ADF Bindings
• 4.4 Oracle ADF Data Control Runtime Integration with Business Services
• 4.5 Creating the Oracle ADF Model Layer in JDeveloper
• 4.5.1 Oracle ADF Business Components as Data Controls
• 4.5.2 Oracle ADF Data Controls for EJB Components
• 4.5.3 Oracle ADF Data Controls for Web Services
• 4.5.3.1 Creating Data Controls for Web Services Created in JDeveloper
• 4.5.3.2 Creating Data Controls for External Web Services
• 4.5.3.3 Web Services That Return Arrays
• 4.5.4 Oracle ADF Data Controls for JavaBeans and TopLink-Based Beans Components
• 4.6 Summary of Oracle ADF Data Control Operations
• 4.7 Summary of Oracle ADF Bindings
• 4.7.1 About the Iterator Binding
• 4.7.2 About the Value Bindings
• 4.7.2.1 Attribute Value Binding
• 4.7.2.2 Boolean Value Binding
• 4.7.2.3 List Value Binding
• 4.7.2.4 Range Value Binding
• 4.7.2.5 Scroll Value Binding
• 4.7.3 About the Action Binding

5 Overview of Oracle ADF Integration with Struts

• 5.1 Summary
• 5.2 Highlights of the Struts Framework
• 5.3 Oracle ADF Extensions to Struts
• 5.3.1 Oracle ADF Data Action and Data Forward Action Classes
• 5.3.2 Oracle ADF Lifecycle
• 5.3.3 Named Events in Oracle ADF
• 5.3.4 Oracle ADF Data Action Mapping Class
• 5.3.5 Oracle ADF Data Form Bean
• 5.3.6 Oracle ADF Binding Filter
• 5.4 Struts Design Time Integration with Oracle ADF
• 5.4.1 Struts Page Flow Diagram
• 5.4.2 Source View Tab
• 5.4.3 Property Inspector Integration with the Struts Configuration File
• 5.4.4 Design Time Rendering of Struts Tag Libraries
• 5.4.5 Interactive Code Insight for JSP Code Editing
• 5.5 Struts Runtime Integration with the Oracle ADF Model Layer
• 5.6 Data Pages and Data Actions in the Databound Struts Page Flow
• 5.6.1 Working with Data Pages
• 5.6.2 Working with Data Actions
• 5.7 Best Practices
• 5.7.1 When to Use a Data Page or Data Action
• 5.7.2 Adding Business Service Methods to a Data Action
• 5.7.3 When to Subclass the DataAction or DataForwardAction Class
• 5.7.4 When to Use an Oracle ADF Lifecycle Plugin
• 5.7.5 Summary of Best Practices in Working with Oracle ADF/Struts Integration

6 Overview of Oracle ADF Data Binding in View Technologies

• 6.1 Summary
• 6.2 Role of the View Layer
• 6.2.1 Differences Between JSP Pages and UIX XML Documents
• 6.3 JDeveloper Design Time Integration with the Oracle ADF Model Layer
• 6.3.1 Overview of Data Control Palette Usage
• 6.3.2 Overview of the Data Control Business Objects
• 6.3.3 Overview of Oracle ADF Project Files
• 6.3.3.1 Files in the Oracle ADF Model Project
• 6.3.3.2 Files in the ViewController Project
• 6.4 Web Application Runtime Integration with the Oracle ADF Model Layer
• 6.5 JClient Application Runtime Integration with the Oracle ADF Model Layer
• 6.5.1 About Data Binding in JClient
• 6.5.2 Generated JClient Containers
• 6.5.2.1 Standard Java Containers
• 6.5.2.2 How JClient Preserves the Data Context Between Data Panels
• 6.5.3 Process for Creating and Using the Panel Binding
• 6.5.4 About the Frame Class in JClient
• 6.5.4.1 Application Bootstrap
• 6.5.4.2 Frame Initialization
• 6.5.5 About the Layout Panel in JClient
• 6.5.6 About Data Panels in JClient
• 6.5.7 About Control Binding in JClient
• 6.5.7.1 Populating Controls with Data
• 6.5.7.2 Updating Data Through Controls
• 6.6 Best Practices
• 6.6.1 Customizing the Oracle ADF Iterator Binding for UI Access
• 6.6.2 Creating a Search Criteria Form Using Oracle ADF Find Mode
• 6.6.2.1 About Parameterized Queries
• 6.6.2.2 Process for Displaying Results
• 6.7 Summary of UI Components in Oracle ADF Web Pages
• 6.7.1 Value Bindings for the Entire Collection or Row Set
• 6.7.2 Value Bindings for Individual Data Object Attribute Values
• 6.7.3 Action Bindings for Business Object Methods and Data Control Operations
• 6.8 Summary of UI Components in Oracle ADF Java Clients
• 6.8.1 Value Bindings for the Entire Collection or Data Object
• 6.8.2 Value Bindings for Individual Data Object Attribute Values

A Troubleshooting JDeveloper Runtime Issues

• A.1 Problems and Solutions
• A.1.1 JSP Page Fails with HTTP 404-Page Not Found Error
• A.1.2 JSP Page Compilation Returns Errors
• A.1.3 Browser Locates JSP File But Fails to Render with Content
• A.1.4 Unable to Run a Large JSP Without Error
• A.1.5 JDeveloper Unable to Establish Connection to Embedded OC4J Server
• A.1.6 Unable to Specify Connection Driver Class to Use with a Web Application in JDeveloper
• A.1.7 Unable to Establish Connection Upon EJB Lookup
• A.2 Need More Help?

B Troubleshooting Oracle ADF

• B.1 Problems and Solutions
• B.1.1 Previously Working Application Using ADF Business Components Starts Throwing JDBC Errors
• B.1.2 Changes to ADF Business Components Parameters Have No Effect
• B.1.3 ADF Business Components Throw ClassNotFoundException
• B.1.4 ADF Business Components Deployed with Libraries Throw Exceptions
• B.1.5 Unable to Use Browser Buttons to Navigate ADF Data Bound Web Pages
• B.2 Need More Help?