Contents for Client Application Developer's Guide
Introducing Data Services Platform for Client Applications
Simplifying Data Programming
What is a Data Services Platform Client?
Deciding Which Programming Model to Use
Service Data Objects (SDO)
Development Steps
Security Considerations in Client Applications
Runtime Client JAR Files
Enabling Data Source Updates
Client Programming with Service Data Objects (SDO)
What is Service Data Objects (SDO) Programming?
SDO and the Data Services Platform
Looking at an SDO Client Application
Looking at a Data Graph
XML Schema-to-Java Type Mapping
ArrayOf Types
Static versus Dynamic Interfaces
Static Interface
Dynamic Data Object Interface
Common SDO Operations and Examples
Instantiating and Populating Data Objects
Static Interface Instantiation
Dynamic Interface Instantiation
Accessing Data Object Properties
Typed Property Access
Untyped Property Access
Setting Data Object Properties
Adding New Data Objects
Deleting Data Objects
Submitting Data Object Changes
Typed Interface Submit
Untyped Interface Submit
Introspecting a Data Object
Working with Data Graphs
XPath Support in the Untyped SDO API
For More Information
Enabling SDO Data Source Updates
Overview
How Data Source Updates Work
Decomposition
Update Processing Sequence
Update Overrides
Update Behavior
Update Order
Understanding Property Maps
Multi-Level Data Services
Transaction Management
SDO Submit Inside a Containing Transaction
When to Customize Updates
Developing an Update Override Class
UpdateOverride Interface
Development Steps
Testing Submit Results
Understanding Update Override Context
Physical Level Update Override Considerations
Update Programming Patterns
Override Decomposition and Update
Augment Original Data Object Content
Accessing the Data Service Mediator Context
Accessing the Decomposition Map
Customizing an Update Plan
Executing an Update Plan
Retrieving the Container of the Current Data Object
Retrieving and Updating Data Through Other Data Services
Setting the Log Level
Configuring Optimistic Locking
Handling Foreign and Primary Keys
Returning Computed Primary Keys
Managing Key Dependencies
Foreign Keys
Accessing Data Services from Java Clients
Overview of the Data Services Platform Mediator API
What's in the Data Service Mediator API?
Setting the Classpath
Creating the Mediator Client JAR File from the Command Line
Build an EAR File
Build the Client JAR
How to Use the Mediator API
Getting a WebLogic JNDI Context for DSP
Using the Static Data Service Interface
Using the Dynamic Data Service Interface
Using Navigation Functions
Bypassing a Function's Data Cache When Using the Mediator API
Accessing Data Services from Workshop Applications
WebLogic Workshop and Data Services Platform
Data Service Controls
Use With Page Flow, Web Services, Portals, Business Processes
Data Service Control (JCX) File
Design View
Source View
Running Ad Hoc Queries Through a Data Service Control
Creating Data Service Controls
Step 1: Create a Project in an Application
Step 2: Start WebLogic Server, If Not Already Running
Step 3: Create a Folder in a Project
Step 4: Create the Data Service Control
Step 5: Enter Connection Information to the WebLogic Server
Step 6: Select Data Service Functions to Add to Your Control
Modifying Existing Data Service Controls
Changing a Method Used by a Control
Adding a New Method to a Control
Updating an Existing Control if Schemas Change
Using Data Services Platform with NetUI
Generating a Page Flow From a Control
To Generate a Page Flow From a Data Service Control
Adding a Data Service Control to an Existing Page Flow
Adding Service Data Objects (SDO) Variables to the Page Flow
To Add a Variable to a Page Flow
To Initialize the Variable in the Page Flow
Working with Data Objects
Displaying Array Values in a Table or List
Adding a Repeater to a JSP File
Adding a Nested Level to an Existing Repeater
Adding Code to Handle Null Values
Using the Data Services Platform in Business Process Projects
Creating a Data Service Control
Adding a Data Service Control to a JPD File
Setting Up the Control in the Business Process
Submitting Changes from a Business Process
Caching Considerations When Using Data Service Controls
Bypassing the Cache When Using a Data Service Control
Cache Bypass Example When Using a Data Service Control
Security Considerations When Using Data Service Controls
Security Credentials Used to Create Data Service Controls
Testing Controls With the Run-As Property in the JWS File
Trusted Domains
Configuring Trusted Domains
Exposing Data Services through Web Services
Exposing Data Services as Web Services
Adding a Data Service Control to a Web Service Project
Creating a Web Service From a Data Service Control
Using the Data Services Platform JDBC Driver
About the Data Services Platform JDBC Driver
Features of the Data Services Platform JDBC Driver
Data Services Platform and JDBC Driver Terminology
Installing the Data Services Platform JDBC Driver with JDK 1.4x
Using the JDBC Driver
Obtaining a Connection
Using the preparedStatement Interface
Getting Data Using JDBC
Connecting to the JDBC Driver from a Java Application
Connecting to Data Services Platform Client Applications Using the ODBC-JDBC Bridge from Non-Java Applications
Using the EasySoft ODBC-JDBC Bridge
Using OpenLink ODBC-JDBC Bridge
Using Reporting Tools with the Data Services Platform ODBC-JDBC Driver
Crystal Reports 10 - ODBC
Crystal Reports 10 - JDBC
Business Objects 6.1 - ODBC
Microsoft Access 2000 - ODBC
DSP and SQL Type Mappings
SQL-92 Support
Supported Features
Limitations
Advanced Topics
Applying Filter Data Service Results
Using Filters
Specifying Filter Effects
Filter Operators
Ordering and Truncating Data Service Results
Consuming Large Result Sets (Streaming API and Writing Results To a File)
Using the Streaming Interface
Writing Data Service Function Results to a File
Using Ad Hoc Queries
Transaction Considerations
Setting Up Data Source Aliases for Relational Sources Accessed by DSP
Setting Up Handlers for Web Services Accessed by DSP