Contents

Title and Copyright Information

List of Examples

List of Figures

List of Tables

Send Us Your Comments

Preface

Audience

Organization

Related Documents

Conventions

Documentation Accessibility

1 Introduction

1.1 Application Scenarios

1.1.1 Business Problems or Technical Challenges

1.1.2 Oracle Dynamic Services Solutions

1.1.2.1 Wireless Service Developers

1.1.2.2 Portal Service Developers

1.1.2.3 e-Business Service Application Developers

1.2 Overview of Concepts

1.2.1 Service Provider

1.2.2 Service Registry

1.2.3 Application Profile Registry

1.2.4 Service Administrator

1.2.5 Service Consumer Application

1.2.6 Dynamic Services Engine

1.2.7 Services as Application Components

1.2.8 Communication Between the Service Consumer Application and the Dynamic Services Engine

1.2.9 Communication Between the Service Administrator and the Dynamic Services Engine

1.3 Dynamic Services Implementation Overview

1.3.1 Java Deployment View

1.3.2 PL/SQL Deployment View

1.3.3 Java (HTTP/Java Messaging Services (JMS)) Deployment View

1.4 Using Multiple Dynamic Services Engines

1.5 How to Get Started with Oracle Dynamic Services

2 Installation

2.1 System Requirements

2.2 Dynamic Services Distribution

2.3 Installing the DSSYS Schema

2.4 Dynamic Services Configuration

3 Configuration

3.1 Configuring and Running the DSAdmin Utility

3.1.1 Configuring Dynamic Services Proxy Settings

3.1.2 Configuring the DSAdmin Utility

3.1.3 Running the DSAdmin Utility

3.2 Registering a New Service

3.2.1 Creating a New Service Package Category

3.2.2 Registering a Service Package

3.3 Browsing Registered Services

3.4 Executing a Registered Service

4 Advanced Installation Options

4.1 Enabling PL/SQL Interfaces

4.2 Enabling Persistent Auditing or Event Monitor Services

4.2.1 Configuring Oracle Advanced Queuing

4.2.2 Installing Monitor Services

4.2.3 Using the Event Monitor Utility

4.2.4 Enabling Persistent Auditing

4.2.5 Starting and Stopping the Event Monitor

4.2.6 Using the Logger Monitor Service (Case Study)

4.3 Enabling HTTP Communications

4.3.1 Configuring the Apache/Jserv Servlet Engine

4.3.2 Configuring the DSAdmin Utility to Use the HTTP Driver

4.4 Enabling Java Messaging Services (JMS) Communications

4.4.1 Configuring and Running the JMS Daemon

4.4.2 Configuring the DSAdmin Utility to Enable JMS Communications

4.5 Using Lightweight Directory Access Protocol (LDAP) as a Central Master Registry

4.5.1 Setting Up LDAP with Oracle Internet Directory

4.5.1.1 Oracle Internet Directory

4.5.1.2 Dynamic Services LDAP Schema

4.5.2 Configuring Dynamic Services Registry to Use LDAP

4.6 Manual Fine-Tuning of Dynamic Services Properties

5 Service Consumer Interfaces

5.1 Java Interface for Service Consumers

5.1.1 Setting the Classpath

5.1.2 Registering a Service Consumer Application in the Application Profile Registry

5.1.3 Opening a Connection to the Dynamic Services Engine

5.1.3.1 Available Connection Drivers

5.1.4 Example: Executing the YahooPortfolio Service

5.1.5 Displaying Service Response

5.1.6 Service Consumer Application Sessions

5.2 PL/SQL Interface for Service Consumers

6 Service Development Guide

6.1 Quick Start

6.1.1 Creating a Service Package

6.1.2 Service Provider -- Organization and Contacts XML Files

6.1.3 Service Classification XML File

6.1.4 Service Interface Specification -- Request Definition

6.1.5 Service Interface Specification -- Response Definition

6.1.6 Editing the Service Descriptor

6.1.6.1 Service Header

6.1.6.2 Service Body

6.1.7 Testing the Execution of Your Service

6.2 Creating Advanced Services -- Service Package

6.3 Creating Advanced Services -- Service Descriptor

6.3.1 Service Header Section

6.3.1.1 Naming Specification

6.3.1.2 Package Specification

6.3.1.3 Service Provider Specification -- Organization and Contacts

6.3.1.4 Deployment Specification -- Classification and Caching

6.3.1.5 Service Interface Specification -- Request and Response Definitions

6.3.2 Service Body Section

6.3.2.1 Input Handling and Adaptor Specifications

6.3.2.2 Protocol Adaptor Specification

6.3.2.3 Execution Adaptor Specification

6.3.2.4 Output Handling and Adaptor Specification

6.4 Creating Advanced Services -- Description of Supplied Adaptors

6.4.1 Input Adaptor

6.4.1.1 oracle.ds.engine.ioa.DSXSLTInputAdaptor

6.4.2 Protocol Adaptors

6.4.2.1 oracle.ds.engine.pa.http.DSHTTPProtocolAdaptor

6.4.2.2 oracle.ds.engine.pa.http.DSHTTPSProtocolAdaptor

6.4.2.3 oracle.ds.engine.pa.jdbc.DSJDBCProtocolAdaptor

6.4.2.4 oracle.ds.engine.pa.smtp.DSSMTPProtocolAdaptor

6.4.3 Execution Adaptors

6.4.3.1 oracle.ds.engine.ea.DSFailOverExecutionAdaptor

6.4.3.2 oracle.ds.engine.ea.compound.DSCompoundServiceExecutionAdaptor

6.4.3.3 oracle.ds.engine.ea.DSConditionalExecutionAdaptor

6.4.4 Output Adaptor

6.4.4.1 oracle.ds.engine.ioa.DSXSLTOutputAdaptor

6.5 Creating Advanced Services -- Building Your Own Adaptors

6.5.1 Packaging Your Adaptor

7 Service Administration

7.1 Managing Consumer Applications

7.2 Managing Services

7.3 Service Response Caching

7.4 Cache Cleanup

7.5 Connecting Multiple Dynamic Services Engine Instances

7.6 Additional Operations of the DSAdmin Utility

7.6.1 Using Script Files with the DSAdmin Utility

8 Known Issues and Problems

8.1 Communications

8.2 Service Execution

8.3 Service Definitions and Creation

8.4 Other Problems and Issues

A Links

B Frequently Asked Questions

C Descriptive Matrix

C.1 Syntax of the Service Descriptor Schema

C.2 Syntax of the Parameters Section for the Packaged Adaptors

C.2.1 oracle.ds.engine.ioa.DSXSLTInputAdaptor

C.2.2 oracle.ds.engine.ioa.DSXSLTOutputAdaptor

C.2.3 oracle.ds.engine.pa.DSHTTPProtocolAdaptor

C.2.4 oracle.ds.engine.pa.DSJDBCProtocolAdaptor

C.2.5 oracle.ds.engine.pa.DSSMTPProtocolAdaptor

C.2.6 oracle.ds.engine.ea.compound.DSCompoundServiceExecutionAdaptor

C.2.7 oracle.ds.engine.ea.DSConditionalExecutionAdaptor

C.2.8 oracle.ds.engine.ea.DSFailOverExecutionAdaptor

D Sample Service Packages

E Error Messages

E.1 Execution Engine Errors

E.2 Communication Errors

E.3 DS Registry Errors

E.4 DS Engine Errors

E.5 DS Driver Errors

E.6 DS Compound Execution Adaptor Module Errors

Glossary

Index