Oracle® Application Server Advanced Web Services Developer's Guide 10g (10.1.3.1.0) Part Number B28975-02 |
|
|
View PDF |
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.
This preface contains these topics:
Oracle Application Server Advanced Web Services Developer's Guide is intended for application programmers and system administrators who perform the following tasks:
Configure software installed on the Oracle Application Server.
Create programs that implement Web services.
Create programs that run as Web services Clients.
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 Web Services Developer's Guide
This book describes how to use the 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.
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. These strategies include 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 book 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 Web Services Developer's Guide. The "Developer's Guide" describes how to use the WebServicesAssembler tool to assemble Web services from a variety of resources: Java classes, EJBs, database resources, JMS destinations and J2SE 5.0 Annotations.
For your convenience, the contents of the Oracle Application Server Web Services Developer's Guide are listed here.
Chapter 1, "Web Services Overview"
Chapter 2, "Development and Documentation Roadmap"
Chapter 3, "Oracle Application Server Web Services Architecture and Life Cycle"
Chapter 4, "Getting Started"
Chapter 5, "Oracle Application Server Web Services Messages"
Chapter 6, "Assembling a Web Service from a WSDL"
Chapter 7, "Assembling a Web Service with Java Classes"
Chapter 8, "Assembling a Web Service with EJBs"
Chapter 9, "Assembling Web Services with JMS Destinations"
Chapter 10, "Assembling Database Web Services"
Chapter 11, "Assembling Web Services with Annotations"
Chapter 12, "Assembling REST Web Services"
Chapter 13, "Testing Web Service Deployment"
Chapter 14, "Assembling a J2EE Web Service Client"
Chapter 15, "Assembling a J2SE Web Service Client"
Chapter 16, "Understanding JAX-RPC Handlers"
Chapter 17, "Processing SOAP Headers"
Chapter 18, "Using WebServicesAssembler"
Chapter 19, "Packaging and Deploying Web Services"
Appendix A, "Web Service Client APIs and JARs"
Appendix B, "Oracle Implementation of the WSDL 1.1 API"
Appendix C, "oracle-webservices.xml Deployment Descriptor Schema"
Appendix D, "service-ref-mapping Schema"
Appendix E, "Error Message Prefixes"
Appendix F, "Troubleshooting"
Appendix G, "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 approved OC4J schemas, including proprietary deployment descriptors:
Oracle implementation of UDDI V2.0 that runs on OC4J:
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. |