Oracle® Access Manager Developer Guide 10g (10.1.4.3) Part Number E12491-01 |
|
|
View PDF |
This appendix provides information on files needed for building Web services that access multiple services. Whether you have a fresh 10g (10.1.4.3) installation or you have an earlier environment, the information here will be helpful. Topics include:
You need specific Oracle-provided Web Services Description Language (WSDL) and XML schema files when building Web services that access multiple services. This section provides information on the following:
This topic outlines the WSDL and XML schema directories and their content in a fresh 10g (10.1.4.3) installation. Package names might differ for each platform. However, all WSDL and XML schema files are the same for each platform.
Note:
Do not make any changes to any Oracle schema files. You can customize java script (.js) files and style sheet (.xsl) files.After installing 10g (10.1.4.3), the WSDL and XML schema files are stored as follows:
WebPass_install_dir/identity/oblix/WebServices/CompositeWebServices/
WSDL Schema Files in /CompositeWebServices/WSDL/*wsdl contains WSDL template files, each of which corresponds to an IdentityXML function.
XML Schema Files in /CompositeWebServices/XMLSchema/*xsd contains the schema required for generating proxy objects.
Sample code in /CompositeWebServices/Samples/WSDL contains sample code for invoking Web services using Java and .NET.
Note:
There is no /CompositeWebServices/Samples/UDDI directory. For UDDI sample files, see WebPass_install_dir/identity/oblix/WebServices/Samples/UDDI, as described in "Earlier Files", next.Oracle recommends that you make plans to use the new files in Webservices\CompositeWebServices. An earlier set of files is present in the /WebServices subdirectories for those who might have been using these earlier files with a previous Oracle Access Manager release:
Earlier Files: Are provided in WebPass_install_dir/identity/oblix/WebServices subdirectories as follows for those who have been using these earlier files with a previous Oracle Access Manager release:
WSDL Schema Files: /WebServices/WSDL/*
XML Schema Files: /WebServices/XMLSchema/*
Note:
Oracle recommends that you use the new files in /WebServices/CompositeWebServices. However, for sample UDDI files, see WebPass_install_dir/identity/oblix/WebServices/Samples/UDDI.See Also:
"Locations for Each Application" for a description of file system directories
If your environment is at release 10g (10.1.4.2.0), you can apply the 10g (10.1.4.3) patch set when it becomes available. After applying the 10g (10.1.4.3) patch, two sets of WSDL and XML schema files are located as follows:
10g (10.1.4.3) Files in /CompositeWebServices: Are described in "WSDL and XML Schema Files in Fresh 10g (10.1.4.3) Installations" (and differ from earlier /WebServices files).
WebPass_install_dir/identity/oblix/WebServices/CompositeWebServices includes:
Earlier Files: Are preserved for backward compatibility and remain in WebPass_install_dir/identity/oblix/WebServices subdirectories as follows:
WSDL Schema Files: /WebServices/WSDL/*
XML Schema Files: /WebServices/XMLSchema/*
If your environment is at release 10g (10.1.4.2.0), you can obtain the files in /CompositeWebServices by applying bundle patch 03 or later. Bundle patches are available on My Oracle Support (formerly MetaLink).
See Also:
"Obtaining the Latest Bundle Patch" in the Oracle Access Manager Installation GuideThe directions for using WSDL and XML schema files are contained in the Readme that accompanies each file. Oracle recommends that:
If you do not already have Web services applications created, use the latest WSDL and XML schema files in /CompositeWebServices when you create new Web service applications.
If your site includes Web services clients created with earlier WSDL and XML schema files, continue to use the earlier set in /WebServices for backward compatibility until you migrate existing clients to use the latest files.
If your environment is release 10g (10.1.4.2.0), you can obtain the files in /CompositeWebServices by applying bundle patch 03 or later. Bundle patches are available on My Oracle Support (formerly MetaLink), as described previously.
The following procedure describes how to locate and use the latest WSDL and XML schema files whether you have a fresh 10g (10.1.4.3) installation or you have applied the 10g (10.1.4.3) patch set.
See Also:
To obtain and use the latest WSDL and XML schema files
Locate the subdirectories in WebPass_install_dir/identity/oblix/WebServices:
/CompositeWebServices/Samples/*
/CompositeWebServices/WSDL/*
/CompositeWebServices/XMLSchema/*
Locate and open each new readme and follow instructions in the file, as needed. For example:
Use instructions in WSDL_java_axis_README.html
when invoking a single Web service using Axis 1.4. For example:
WebPass_install_dir\identity\oblix\lang\language\html\WSDL_java_axis_README .html
Use instructions in "Compiling and Running Sample Axis Code for Composite Web Services" to invoke multiple Web services from a single client using Axis1.4.
If you have WebLogic Workshop, use instructions in "Using Composite Web Services Examples Developed Using WebLogic Workshop".
Problem in an Earlier Deployment
In 10.1.4 environments earlier than 10g (10.1.4.3), you might experience a problem using Oracle-provided Web Services Description Language (WSDL) and XML Schema files when building Web services that can access multiple services.
In earlier WSDL and XSD files, certain elements with different definitions were defined in the same namespace. When multiple services are referred to from a single Java client, the different type libraries generated in a .jar file would have the same fully qualified name. This led to some ambiguity.
Solution
To provide wider support, changes have been made to WSDL, Java, and XML schema files in Oracle Access Manager 10g (10.1.4.3). The latest files have been tested with the following:
Axis 1.3 (no longer available on the Apache site) and Axis 1.4 are supported. Note that later versions (Axis 2, for example), will not work.
Java version 1.4.2_04 [JDK 2 v 1.4+] is supported. Note that lower or higher versions of the same package might not work.
Information from the earlier WebLogicWorkshopSetup.doc is now located in "Using Composite Web Services Examples Developed Using WebLogic Workshop".