Oracle® Application Server Web Services Developer's Guide 10g (10.1.3.1.0) Part Number B28974-01 |
|
|
View PDF |
This guide describes how to use Oracle Application Server Web Services and the Oracle WebServicesAssembler tool to assemble Web services from a variety of resources: Java classes, EJBs, database resources, JMS destinations and J2SE 5.0 Annotations. You can also assemble REST-style Web services. The Developers Guide also describes how to assemble J2SE and J2EE clients to access these services. This book includes descriptions of the message formats and datatypes supported by OracleAS Web Services.
This preface contains these topics:
Oracle Application Server Web Services Developer's Guide is intended for application programmers, system administrators, and other users who perform the following tasks:
Assemble Web services from Java classes, EJBs, Database Resources, and JMS queues
Assemble J2SE and J2EE Web service clients
Work with SOAP messages in RPC-literal, RPC-encoded and document-literal formats
Our goal is to make Oracle products, services, and supporting documentation accessible, with good usability, to the disabled community. To that end, our documentation includes features that make information available to users of assistive technology. This documentation is available in HTML format, and contains markup to facilitate access by the disabled community. Accessibility standards will continue to evolve over time, and Oracle is actively engaged with other market-leading technology vendors to address technical obstacles so that our documentation can be accessible to all of our customers. For more information, visit the Oracle Accessibility Program Web site at
http://www.oracle.com/accessibility/
Accessibility of Code Examples in Documentation
Screen readers may not always correctly read the code examples in this document. The conventions for writing code require that closing braces should appear on an otherwise empty line; however, some screen readers may not always read a line of text that consists solely of a bracket or brace.
Accessibility of Links to External Web Sites in Documentation
This documentation may contain links to Web sites of other companies or organizations that Oracle does not own or control. Oracle neither evaluates nor makes any representations regarding the accessibility of these Web sites.
TTY Access to Oracle Support Services
Oracle provides dedicated Text Telephone (TTY) access to Oracle Support Services within the United States of America 24 hours a day, seven days a week. For TTY support, call 800.446.2398.
For more information, see these Oracle resources:
Oracle Application Server Advanced Web Services Developer's Guide
This book describes topics beyond basic Web service assembly. For example, it describes how to diagnose common interoperability problems, how to enable Web service management features (such as reliability, auditing, and logging), and how to use custom serialization of Java value types.
This book also describes how to employ the Web Service Invocation Framework (WSIF), the Web Service Provider API, message attachments, and management features (reliability, logging, and auditing). It also describes alternative Web service strategies, such as using JMS as a transport mechanism.
For your convenience, "Contents of the Oracle Application Server Advanced Web Services Developer's Guide" lists the contents of the Oracle Application Server Advanced Web Services Developer's Guide.
Oracle Application Server Web Services Java API Reference
The Reference provides the output of the Javadoc tool for the OracleAS Web Services Java API.
Oracle Application Server Web Services Security Guide
This book describes the different security strategies that can be applied to a Web service in Oracle Application Server Web Services. The strategies that can be employed are username token, X.509 token, SAML token, XML encryption, and XML signature. The book describes the configuration options available for the client and the service, for inbound messages and outbound messages. It also describes how to configure these options for a number of different scenarios.
Oracle Containers for J2EE Security Guide
This book describes security features and implementations particular to OC4J. This includes information about using JAAS, the Java Authentication and Authorization Service, as well as other Java security technologies.
Oracle Containers for J2EE Services Guide
This book provides information about standards-based Java services supplied with OC4J, such as JTA, JNDI, JMS, JAAS, and the Oracle Application Server Java Object Cache.
Oracle Containers for J2EE Configuration and Administration Guide
This book describes how to configure and administer applications for OC4J, including use of the Oracle Enterprise Manager 10g Application Server Control Console, use of standards-compliant MBeans provided with OC4J, and, where appropriate, direct use of OC4J-specific XML configuration files.
Oracle Containers for J2EE Deployment Guide
This book covers information and procedures for deploying an application to an OC4J environment. This includes discussion of the deployment plan editor that comes with Oracle Enterprise Manager 10g.
Oracle Containers for J2EE Developer's Guide
This discusses items of general interest to developers writing an application to run on OC4J—issues that are not specific to a particular container such as the servlet, EJB, or JSP container. (An example is class loading.)
From the Oracle Application Server core documentation group:
Oracle Application Server Security Guide
Oracle Application Server Certificate Authority Administrator's Guide
Oracle Application Server Single Sign-On Administrator's Guide
Oracle Web Services Manager is a comprehensive solution for managing service oriented architectures. It allows IT managements to centrally define policies that govern Web services operations such as access policy, logging policy, and content validation, and then wrap these policies around services, with no modification to existing web services required.
Oracle Web Services Manager Quick Start Guide
Oracle Web Services Manager Installation Guide
Oracle Web Services Manager Administrator's Guide
Oracle Web Services Manager Deployment Guide
Oracle Web Services Manager Extensibility Guide
Printed documentation is available for sale in the Oracle Store at:
http://oraclestore.oracle.com/
This book is designed to be used with the Oracle Application Server Advanced Web Services Developer's Guide. The "Advanced" book describes topics beyond basic Web service assembly.
For your convenience, the contents of the Oracle Application Server Advanced Web Services Developer's Guide. are listed here.
Chapter 1, "Ensuring Interoperable Web Services"
Chapter 2, "Working with Message Attachments"
Chapter 3, "Managing Web Services"
Chapter 4, "Ensuring Web Services Security"
Chapter 5, "Ensuring Web Service Reliability"
Chapter 6, "Auditing and Tracing Messages"
Chapter 7, "Implementing Custom Serialization of Java Value Types"
Chapter 8, "Using JMS as a Web Service Transport"
Chapter 9, "Using Web Services Invocation Framework"
Chapter 10, "Using Web Service Providers"
Appendix A, "Understanding the Web Services Management Schema"
Appendix B, ""Oracle Web Services Client Schema"
Appendix C, "OracleAS Web Services Reliability Schema"
Appendix D, ""OracleAS Web Services Auditing Schema"
Appendix E, "OracleAS Web Services Tracing Schema"
Appendix F, "JAX-RPC Mapping File Descriptor"
Appendix G, "Web Service MBeans"
Appendix H, "Mapping Java Types to XML and WSDL Types"
Appendix I, "Troubleshooting"
Appendix J, "Third Party Licenses"
The following sections collate references to documentation that appear in the text of this manual:
Java 2 Platform Enterprise Edition (J2EE), version 5 (1.5) API specification:
Java 2 Platform Enterprise Edition (J2EE), version 1.4 API specification:
XML Schemas for J2EE Deployment Descriptors lists the document formats used by the Java 2 Platform, Enterprise Edition (J2EE) deployment descriptors which are described by J2EE 1.4 and later specifications:
J2EE client schema provides the XSD for a J2EE Web service client:
http://java.sun.com/xml/ns/j2ee/j2ee_web_services_client_1_1.xsd
Java API for XML-based RPC (JAX-RPC) to build Web applications and Web services. This functionality incorporates XML-based RPC functionality according to the SOAP 1.1 specification.
Java Servlet 2.4 specification:
http://www.jcp.org/aboutJava/communityprocess/final/jsr154/index.html
A list of OC4J schemas, including proprietary deployment descriptors:
Oracle UDDI v2.0 server implementation:
http://www.oracle.com/technology/tech/webservices/htdocs/uddi/index.html
Oracle Database JPublisher User's Guide
SOAP 1.1 and 1.2 specifications (main page):
SOAP 1.1 specifications:
specification:
SOAP 1.1 message encoding:
SOAP 1.1 binding schema:
http://schemas.xmlsoap.org/wsdl/soap/2003-02-11.xsd
The SOAP 1.2 binding schema is identical to the SOAP 1.1 binding schema, except that the target namespace is:
SOAP 1.2 specification:
SOAP 1.2 Part 1: Primer:
SOAP 1.2 Part 1: Messaging Format:
SOAP 1.2 Part 2 Recommendation (Adjuncts):
HTTP transport for SOAP 1.2:
SOAP binding schema:
Definition of the fault code element in the SOAP schema:
Web Services Description Language (WSDL) specifications:
Universal Description, Discovery and Integration specifications:
Key Transport algorithms:
RSA-1_5:
RSA-OAEP-MGF1P:
Signature keys:
The following text conventions are used in this document:
Convention | Meaning |
---|---|
boldface | Boldface type indicates graphical user interface elements associated with an action, or terms defined in text or the glossary. |
italic | Italic type indicates book titles, emphasis, or placeholder variables for which you supply particular values. |
monospace |
Monospace type indicates commands within a paragraph, URLs, code in examples, text that appears on the screen, or text that you enter. |