Client Application Developer's Guide

Introducing Liquid Data for Client Applications

Simplifying Data Programming

What is a Liquid Data 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 Liquid Data

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 Service 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 Liquid Data

Using the Static Data Service Interface

Using the Dynamic Data Service Interface

Using Navigation Functions

Accessing Data Services from Workshop Applications

WebLogic Workshop and Liquid Data

Liquid Data Control

Use With Page Flow, Web Services, Portals, Business Processes

Liquid Data Control JCX File

Design View

Source View

Running Ad Hoc Queries Through a Liquid Data Control

Creating Liquid Data 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 Liquid Data Control

Step 5: Enter Connection Information to the WebLogic Server

Step 6: Select Data Service Functions to Add to the Control

Modifying Existing Liquid Data Controls

Changing a Method Used by a Control

Adding a New Method to a Control

Updating an Existing Control if Schemas Change

Using Liquid Data with NetUI

Generating a Page Flow From a Control

To Generate a Page Flow From a Control

Adding a Liquid Data 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 Liquid Data in Business Process Projects

Creating a Liquid Data Control

Adding a Liquid Data Control to a JPD File

Setting Up the Control in the Business Process

Submitting Changes from a Business Process

Security Considerations With Liquid Data Controls

Security Credentials Used to Create Liquid Data Control

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 Liquid Data Control to a Web Service Project

Creating a Web Service From a Liquid Data Control

Using the Liquid Data JDBC Driver

About the Liquid Data JDBC Driver

Features of the Liquid Data JDBC Driver

Liquid Data and JDBC Driver Terminology

Installing the Liquid Data 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 Liquid Data Client Applications Using the ODBC-JDBC Bridge from Non-Java Applications