Unit-5 Web Database
Unit-5 Web Database
Turning the Oracle database into a Web service provider leverages investment in Java
stored procedures, PL/SQL packages, pre-defined SQL queries and DML. Conversely,
consuming external Web services from the database itself, together with integration with
the SQL engine, enables Enterprise Information Integration.
This chapter focuses on the advantages of opening up the Oracle Database, through
PL/SQL packages and Java classes deployed within the database, to the world of Web
services, using the Oracle Application Server and the Oracle database.
Refer to the Oracle9iAS Web Services Developer's Guide for information on:
This chapter also provides a general road map for database Web services, mapping out
Web services support for additional database capabilities, such as SQL queries, DML
statements, and Java Stored Procedures—through synchronous invocation.
See the Oracle9iAS Web Services Developer's Guide on how to create Web services and
invoke them from clients. This chapter covers how to call out to Web services from
within the database and how a Web service can call in to the database.
12.2 Using the Database as Service Provider for
Web Services
Web Services uses industry-standard mechanisms to provide easy access to remote
content and applications, regardless of the provider's platform, location, implementation,
or data format. Client applications can query and retrieve data from Oracle databases and
invoke stored procedures using standard web service protocols. There is no dependency
on Oracle-specific database connectivity protocols. This approach is highly beneficial in
heterogeneous, distributed, and non-connected environments.
You can call into the database from a Web Service, using the database as a service
provider. This allows you to leverage existing or new SQL, PL/SQL, Java stored
procedures, or Java classes within an Oracle database. You can access and manipulate
database tables from a Web service client.
Use JPublisher to generate Java wrappers that correspond to database operations, then
deploy the wrappers as Web services in Oracle AS. Figure 12-1 demonstrates how you
use JPublisher to publish PL/SQL packages, SQL objects, collections, and packages as
Java classes. Once published, these objects can be accessed by any Web service through
an OC4J Web services servlet.
How to Use
For directions on how to use JPublisher to publish your PL/SQL or SQL objects,
collections or packages as Java classes, see the "What JPublisher Can Publish" section in
the "Introduction to JPublisher" chapter of the Oracle Database JPublisher User's Guide.
See the Oracle9iAS Web Services Developer's Guide for more information on creating
and using Web services.
Using the database as a Web Service provider offers the following features:
The following JPublisher features support Web services call-ins to code running in
Oracle Database. Refer to the JPublisher Oracle Database JPublisher User's Guide for
complete information.
An example of using the database as a service consumer would be to call external Web
Services from a predefined database job in order to obtain inventory information from
multiple suppliers, then update your local inventory database. Another example is that of
a Web Crawler: a database job can be scheduled to collate product and price information
from a number of sources.
How to Use
The Web services client code is written in SQL, PL/SQL, or Java to run inside the
database, which then invokes the external Web service. Figure 12-2 demonstrates how
you can call out to a Web service from a Java client within the database by using one of
the following methods:
• SQL and PL/SQL call specs – Invoke a Web service through a user-defined
function call (generated through JPublisher) either directly within a SQL
statement or view or through a variable.
• Pure Java static proxy class – Use JPublisher to pre-generate a client proxy class.
which uses JAX-RPC). This method simplifies the Web service invocation as the
location of the service is already known without needing to look up the service in
the UDDI registry. The client proxy class does all of the work to construct the
SOAP request, including marshalling and unmarshalling parameters.
• Pure Java using DII (dynamic invocation interface) over JAX-RPC – Dynamic
invocation provides the ability to construct the SOAP request and access the
service without the client proxy.
Which method to use depends on if you want to execute from SQL or PL/SQL or from
Java classes.
To call out to any Web service through PL/SQL, use the UTL_DBWS PL/SQL package.
This package essentially uses the same APIs as the DII classes. See the PL/SQL Packages
and Types Reference for a full description of this package.
You can use a Web Services Data Source to process the results from any Web service
request as if it was a real database table.
To access data (returned from single or multiple Web service invocations) through a
database table, create a virtual table through a Web service data source. This table
function allows you to query a set of returned rows as though it were a table.
The client invokes a Web service and the results are stored in a virtual table in the
database. You can pass result sets from function to function, allowing you to set up a
sequence of transformation without a table holding intermediate results. To reduce
memory usage, you can return the result set rows a few at a time within a function.
By using Web services with the table function, you can manipulate a range of input
values (from single or multiple Web services) as a real table. In the following example,
the inner SELECT creates rows whose columns are used as arguments for invoking the
CALL_WS Web service call-out. The table expression could be used in other SQL queries,
for constructing views, and so on.
Using the database as a Web Service consumer offers the following features:
Before generating any stubs or call specs, you must install the UTL_DBWS package in the
database. This package includes both the Java and PL/SQL implementation necessary for
facilitating the Web services functionality within the database.
Use the following script to install the Web Services Client Library:
$ORACLE_HOME/sqlj/lib/inctldbws.sql
To remove the Web Services Client Library at a later time, use the following script:
$ORACLE_HOME/sqlj/lib/rmctldbws.sql
JPublisher can receive the WSDL from the Web Service and create the static java, proxy
class, or PL/SQL call spec, as shown in Figure 12-4.
• -proxywsdl=url
Use this option to generate JAX-RPC static client proxies, given the WSDL
document at the specified URL. This option also generates additional wrapper
classes to expose instance methods as static methods, and generates PL/SQL
wrappers. In all, it executes the following steps:
Note:
Once generated, your database client can access the Web service through PL/SQL
using the call specs or through the JAX-RPC client proxy classes. The PL/SQL
wrappers use the static methods: your client would not normally access any Web
service through the static method directly.
• -httpproxy=proxy_url
Where WSDL is accessed through a firewall, use this option to specify a proxy
URL to use in resolving the URL of the WSDL document.
• -proxyclasses=class_list
For Web services, this option is used behind the scenes by the -proxywsdl option
and is set automatically, as appropriate. In addition, you can use this option
directly, for general purposes, any time you want to create PL/SQL wrappers for
Java classes with static methods, and optionally to produce wrapper classes to
expose instance methods as static methods.
• -proxyopts=wrapper_specifications
See the "Additional Features" chapter in the Oracle Database JPublisher User's Guide
for more information on how to use JPublisher.