Oracle9i Application Server Wireless Edition Developer's Guide
Release 1.1

Part Number A86700-01


Solution Area


Go to next page


Title and Copyright Information

List of Figures

List of Tables

Send Us Your Comments


1 Introduction

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 Creating Adapters

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 init() invoke() getInitArguments() getInputArguments() getOutputArguments()
2.2.2 Managing Arguments Filtering Adapter Output 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 Creating Transformers

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 SimpleResultToText() format() 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 Rebranding the Personalization Portal

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 Using the Personalization Portal API

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 Authenticate User Initialize Session Retrieve Objects Display/Edit Objects Cleanup Request

6 Using the Runtime API

6.1 Overview
6.2 Runtime Core
6.2.1 Request
6.2.2 Response
6.2.3 Session
6.2.4 ServiceContext
6.2.5 ManagedContext
6.2.6 RequestFactory
6.3 Event, Listener
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 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 Concurrent Requests Recursive Instances of Requests Query Parameters Runtime Object References Thread-Safe and High-Concurrency
6.8 Examples
6.8.1 User-Defined Hooks Example 1 Example 2
6.8.2 Event Listener Example Implementing the RequestListener Interface Register the Request Listener Entry in the File Register the RequestListener with Each Request Object Modify the Event Mask

7 Using the Data Model API

7.1 Overview
7.2 Class Hierarchy
7.2.1 ModelObject Adapter AlertAddress Device Group LocationMark MetaLocator ModelFactory ModelServices Service Transformer User
7.3 Sample Adapter that Uses the Data Model API
7.3.1 Sample Adapter Code

8 Using the Location API

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 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 Working with Wireless Edition XML

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 Element
9.8 Repository XML Reference
PanamaObjects Element
PGRP Element
PUSR Element
XTRA Element
EXT_ATTR Element
JTRA Element
LDEV Element
ADAP Element
FOLD Element
LINK Element
MAST Element
BOMA Element
AGEN Element
9.9 XML Tools

A Simple Result DTD Reference

A.1 SimpleResult
A.2 SimpleContainer
A.3 SimpleText
A.3.1 SimpleTextItem
A.4 SimpleMenu
A.4.1 SimpleMenuItem
A.5 SimpleForm
A.5.1 SimpleFormItem
A.5.2 SimpleFormSelect
A.5.3 SimpleFormOption
A.6 SimpleTable
A.6.1 SimpleTableHeader
A.6.2 SimpleTableBody
A.6.3 SimpleRow
A.6.4 SimpleCol
A.7 SimpleImage
A.8 SimpleBreak
A.9 SimplePhone
A.10 SimpleEmail
A.11 SimpleHref
A.12 SimpleHelp
A.13 SimpleTimer

B Runtime System Variables

B.1 System Parameters
B.2 Macros



Go to next page
Copyright © 2001 Oracle Corporation.

All Rights Reserved.


Solution Area