Oracle9i Application Server Wireless Edition Developer's Guide -- Contents

1.1 Creating Adapters

1.2 Creating Transformers

1.3 Rebranding the Wireless Edition Personalization Portal

1.4 The Runtime API

1.4.1 Hooks

1.5 The Data Model API

1.6 The Location API

1.7 Wireless Edition XML

2.1 What Is a Wireless Edition Adapter?

2.1.1 Using Wireless Edition Adapters

2.1.2 Implementing Wireless Edition Adapters

2.1.3 Adapter Content Formats

2.2 Creating Adapters

2.2.1 Sample Adapter Class

2.2.1.1 init()

2.2.1.2 invoke()

2.2.1.3 getInitArguments()

2.2.1.4 getInputArguments()

2.2.1.5 getOutputArguments()

2.2.2 Managing Arguments

2.2.2.1 Filtering Adapter Output

2.2.2.2 Filtering Adapter Output Sample Code

2.3 Importing an Adapter into the Repository

2.3.1 Deleting an Adapter

2.3.2 Modifying Adapters

2.4 HelloAdapter Source Code

3.1 Overview

3.2 Wireless Edition Transformers

3.3 XSLT Stylesheets

3.4 Java Transformers

3.5 Creating a Transformer

3.5.1 Creating an XSL Transformer

3.5.2 Sample XSLT ResultTransformer

3.5.3 Creating a Java Transformer

3.5.4 Components of a Java Transformer

3.5.4.1 SimpleResultToText()

3.5.4.2 format()

3.5.4.3 transform()

3.6 Managing Transformers with the Service Designer

3.6.1 Creating a Transformer in the Repository

3.6.2 Modifying a Transformer

3.6.3 Removing a Transformer from the Repository

3.7 Testing the Transformer

3.8 Using the Transformer Testing Tool

4.1 Overview

4.2 Page Naming Conventions

4.3 JavaServer Pages Structure

4.3.1 Directory Structure

4.4 Customization Levels

4.4.1 Appearance Customization

4.4.2 JSP Modification

4.4.3 Customization Components

4.4.4 Flow Example - Customizing a Services

4.4.5 Creating New JSP

4.5 Setting the Multi-Byte Encoding for the Personalization Portal

5.1 Overview

5.2 Personalization Portal API Classes

5.2.1 Login and Initialize Session - RequestController

5.2.2 Group Creation and Modification - GroupController

5.2.3 User Creation and Modification - UserController

5.2.4 Object Customization -- ServiceController

5.2.5 Alert Customization -- AlertController

5.2.6 Locationmark Creation and Modification -- LocationMarkController

5.3 Session Flow

5.3.1 Sample Code

5.3.1.1 Authenticate User

5.3.1.2 Initialize Session

5.3.1.3 Retrieve Objects

5.3.1.4 Display/Edit Objects

5.3.1.5 Cleanup Request

6.3.1 Implementing the RequestListener Interface

6.3.2 Implementing the ResponseListener Interface

6.3.3 Implementing the SessionListener Interface

6.3.4 Guidelines

6.4 Hooks

6.4.1 The ListenerRegistrationHook

6.4.2 The DeviceIdentificationHook

6.4.3 The SessionIDHook

6.4.4 The AuthenticationHook

6.4.5 The SignOnPagesHook

6.4.6 The SubscriberIDHook

6.4.7 The AuthorizationHook

6.4.8 The CallerLocationHook

6.4.9 Service

6.4.10 The PreProcessorHook, Transformer, and PostPorcessorHook

6.5 The Runtime Execution Reference Model

6.5.1 The Reference Model

6.5.1.1 Case: A Request Involving Session Establishment and Authentication

6.6 System Parameters

6.6.1 Static System Parameters

6.6.2 Derived System Parameters

6.7 General Guidelines on User-Defined Listeners and Hook Implementation

6.7.1 Implementing the Respective Interface

6.7.2 Compile Your Java Source

6.7.3 Plug in Your Implementation through Property File

6.7.4 Modify the JServ Property File

6.7.5 Restart the Server

6.7.6 Tips and Hints

6.7.6.1 Concurrent Requests

6.7.6.2 Recursive Instances of Requests

6.7.6.3 Query Parameters

6.7.6.4 Runtime Object References

6.7.6.5 Thread-Safe and High-Concurrency

6.8 Examples

6.8.1 User-Defined Hooks

6.8.1.1 Example 1

6.8.1.2 Example 2

6.8.2 Event Listener Example

6.8.2.1 Implementing the RequestListener Interface

6.8.2.2 Register the Request Listener Entry in the System.properties File

6.8.2.3 Register the RequestListener with Each Request Object

6.8.2.4 Modify the Event Mask

7.2.1.8 ModelServices

7.2.1.9 Service

7.2.1.10 Transformer

7.2.1.11 User

7.3 Sample Adapter that Uses the Data Model API

7.3.1 Sample Adapter Code

8.1 Overview

8.2 Managing the Location Application Components

8.3 Using the Geocoder Interface

8.3.1 Third-Party Geocoders

8.3.2 Reliability of Service

8.3.3 Ambiguous Address

8.4 Using the Routing API

8.4.1 Source, Destination, and Via Points

8.4.2 Maneuver List

8.4.3 Map Displays

8.4.4 Driving Distance

8.4.5 Routing Settings

8.4.6 Routing Search Results

8.4.7 Display Functions

8.4.8 Mapping

8.4.8.1 Mapping Routes and Maneuvers

8.5 Finding a User's Location

8.6 The Locationmark Interface

8.7 Using Business Directory Services

8.7.1 Yellow Pages XML Files

8.7.2 Yellow Pages API

9.1 Why XML?

9.2 Oracle XML Parser

9.3 Wireless Edition XML Formats

9.4 Adapter Result Format

9.5 Simple Result Format

9.6 The Wireless Edition Repository

9.7 Provisioning DTD

PUSR_LIST Element

PUSR Element

9.8 Repository XML Reference

A.5.2 SimpleFormSelect

A.5.3 SimpleFormOption

A.6 SimpleTable

A.6.1 SimpleTableHeader

A.6.2 SimpleTableBody

B.1 System Parameters

B.2 Macros

Contents

Title and Copyright Information

List of Figures

List of Tables

Send Us Your Comments

Preface

1 Introduction

2 Creating Adapters

3 Creating Transformers

4 Rebranding the Personalization Portal

5 Using the Personalization Portal API

6 Using the Runtime API

7 Using the Data Model API

8 Using the Location API

9 Working with Wireless Edition XML

A Simple Result DTD Reference

B Runtime System Variables

Glossary

Index