Oracle Dynamic Services. User’s and Administrator’s Guide

Srivastava A., Carreг M., Lin P.

Oracle Dynamic Services is a Java-based programmatic framework for incorporating, managing, and deploying Internet services. Oracle Dynamic Services makes it easy for application developers to rapidly incorporate existing services residing in Web sites, local databases, or proprietary systems into their own applications.

---

Table of contents :
User’s and Administrator’s Guide……Page 1
List of Examples……Page 9
List of Figures……Page 11
List of Tables……Page 12
Send Us Your Comments……Page 13
Organization……Page 15
Related Documents……Page 16
Documentation Accessibility……Page 17
1 Introduction……Page 19
1.1.1 Business Problems or Technical Challenges……Page 20
1.1.2 Oracle Dynamic Services Solutions……Page 21
1.2 Overview of Concepts……Page 23
1.2.1 Service Provider……Page 27
1.2.5 Service Consumer Application……Page 28
1.2.7 Services as Application Components……Page 29
1.3 Dynamic Services Implementation Overview……Page 30
1.3.1 Java Deployment View……Page 32
1.3.2 PL/SQL Deployment View……Page 34
1.3.3 Java (HTTP/Java Messaging Services (JMS)) Deployment View……Page 35
1.4 Using Multiple Dynamic Services Engines……Page 37
1.5 How to Get Started with Oracle Dynamic Services……Page 38
2.1 System Requirements……Page 41
2.2 Dynamic Services Distribution……Page 42
2.3 Installing the DSSYS Schema……Page 43
2.4 Dynamic Services Configuration……Page 45
3.1 Configuring and Running the DSAdmin Utility……Page 47
3.1.2 Configuring the DSAdmin Utility……Page 48
3.1.3 Running the DSAdmin Utility……Page 50
3.2 Registering a New Service……Page 51
3.2.1 Creating a New Service Package Category……Page 53
3.3 Browsing Registered Services……Page 55
3.4 Executing a Registered Service……Page 57
4.1 Enabling PL/SQL Interfaces……Page 61
4.2.2 Installing Monitor Services……Page 63
4.2.3 Using the Event Monitor Utility……Page 64
4.2.5 Starting and Stopping the Event Monitor……Page 65
4.2.6 Using the Logger Monitor Service (Case Study)……Page 66
4.3.1 Configuring the Apache/Jserv Servlet Engine……Page 68
4.4 Enabling Java Messaging Services (JMS) Communications……Page 71
4.4.1 Configuring and Running the JMS Daemon……Page 72
4.4.2 Configuring the DSAdmin Utility to Enable JMS Communications……Page 73
4.5.1 Setting Up LDAP with Oracle Internet Directory……Page 74
4.5.2 Configuring Dynamic Services Registry to Use LDAP……Page 76
4.6 Manual Fine-Tuning of Dynamic Services Properties……Page 77
5.1 Java Interface for Service Consumers……Page 79
5.1.2 Registering a Service Consumer Application in the Application Profile Registry……Page 80
5.1.3 Opening a Connection to the Dynamic Services Engine……Page 82
5.1.4 Example: Executing the YahooPortfolio Service……Page 83
5.1.5 Displaying Service Response……Page 84
5.2 PL/SQL Interface for Service Consumers……Page 85
6 Service Development Guide……Page 89
6.1 Quick Start……Page 90
6.1.1 Creating a Service Package……Page 91
6.1.2 Service Provider — Organization and Contacts XML Files……Page 92
6.1.3 Service Classification XML File……Page 93
6.1.4 Service Interface Specification — Request Definition……Page 94
6.1.5 Service Interface Specification — Response Definition……Page 95
6.1.6 Editing the Service Descriptor……Page 97
6.2 Creating Advanced Services — Service Package……Page 103
6.3.1 Service Header Section……Page 104
6.3.2 Service Body Section……Page 108
6.4 Creating Advanced Services — Description of Supplied Adaptors……Page 115
6.4.1 Input Adaptor……Page 116
6.4.2 Protocol Adaptors……Page 117
6.4.3 Execution Adaptors……Page 122
6.4.4 Output Adaptor……Page 131
6.5.1 Packaging Your Adaptor……Page 132
7.1 Managing Consumer Applications……Page 133
7.2 Managing Services……Page 134
7.3 Service Response Caching……Page 135
7.5 Connecting Multiple Dynamic Services Engine Instances……Page 136
7.6.1 Using Script Files with the DSAdmin Utility……Page 137
8.4 Other Problems and Issues……Page 139
A Links……Page 141
B Frequently Asked Questions……Page 143
C.1 Syntax of the Service Descriptor Schema……Page 145
C.2 Syntax of the Parameters Section for the Packaged Adaptors……Page 153
C.2.2 oracle.ds.engine.ioa.DSXSLTOutputAdaptor……Page 154
C.2.3 oracle.ds.engine.pa.DSHTTPProtocolAdaptor……Page 155
C.2.4 oracle.ds.engine.pa.DSJDBCProtocolAdaptor……Page 156
C.2.5 oracle.ds.engine.pa.DSSMTPProtocolAdaptor……Page 157
C.2.6 oracle.ds.engine.ea.compound.DSCompoundServiceExecutionAdaptor……Page 158
C.2.7 oracle.ds.engine.ea.DSConditionalExecutionAdaptor……Page 161
C.2.8 oracle.ds.engine.ea.DSFailOverExecutionAdaptor……Page 162
D Sample Service Packages……Page 163
E.1 Execution Engine Errors……Page 175
E.2 Communication Errors……Page 176
E.3 DS Registry Errors……Page 179
E.4 DS Engine Errors……Page 184
E.6 DS Compound Execution Adaptor Module Errors……Page 192
Glossary……Page 195
Index……Page 199