Skip Headers

Oracle® Application Server Web Services Developer's Guide 10g Release 3 (10.1.3) B14434-01 |
| Home | Solution Area | Contents | Index

Previous | Next |

# Preface

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:

- Intended Audience

- Documentation Accessibility

- Related Documents

- Conventions

## Intended Audience

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

## Documentation Accessibility

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.

## Related Documents

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 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 (not to be confused with the Oracle Application Server 10g Security Guide), 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 Administrator's Guide

- Oracle Application Server Certificate Authority Administrator's Guide

- Oracle Application Server Single Sign-On Administrator's Guide

- Oracle Application Server Enterprise Deployment Guide

For Oracle Web Services Manager:

- Oracle Web Services Manager User and Administrator Guide

- Oracle Web Services Manager Extensibility Guide

- Oracle Web Services Manager Installation and Deployment Guide

- Oracle Web Services Manager Upgrade Guide

Printed documentation is available for sale in the Oracle Store at:

`http://oraclestore.oracle.com/`

### Contents of the Oracle Application Server Advanced Web Services Developer's Guide

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 Logging Messages"

- Chapter 7, "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, "JAX-RPC Mapping File Descriptor"

- Appendix C, "Web Service MBeans"

- Appendix D, "Mapping Java Types to XML and WSDL Types"

- Appendix E, "Troubleshooting"

### Links to Related Specifications

The following sections collate references to documentation that appear in the text of this manual:

- Java Technology Documents

- OC4J-Related Documents

- SOAP-Related Documents

- WSDL-Related Documents

- UDDI-Related Documents

- Encryption-Related Documents

### Java Technology Documents

- Java 2 Platform Enterprise Edition (J2EE), version 1.4 API specification:

  `http://java.sun.com/j2ee/1.4/docs/api`

- 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:

  `http://java.sun.com/xml/ns/j2ee/`

- 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.

  `http://java.sun.com/webservices/jaxrpc/index.jsp`

- Java Servlet 2.4 specification:

  `http://www.jcp.org/aboutJava/communityprocess/final/jsr154/index.html`

### OC4J-Related Documents

- A list of OC4J schemas, including proprietary deployment descriptors:

  `http://www.oracle.com/technology/oracleas/schema/index.html`

- Oracle UDDI v2.0 server implementation:

  `http://www.oracle.com/technology/tech/webservices/htdocs/uddi/index.html`

- Oracle Database JPublisher User's Guide

### SOAP-Related Documents

- SOAP 1.1 and 1.2 specifications (main page):

  `http://www.w3.org/TR/SOAP`

- SOAP 1.1 specifications:

  - specification:

    `http://www.w3.org/TR/2000/NOTE-SOAP-20000508/`

  - SOAP 1.1 message encoding:

    `http://schemas.xmlsoap.org/soap/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:

    `http://schemas.xmlsoap.org/wsdl/soap12/`

- SOAP 1.2 specification:

  - SOAP 1.2 Part 1: Primer:

    `http://www.w3.org/TR/soap12-part0/`

  - SOAP 1.2 Part 1: Messaging Format:

    `http://www.w3.org/TR/soap12-part1/`

  - SOAP 1.2 Part 2 Recommendation (Adjuncts):

    `http://www.w3.org/TR/soap12-part2/`

  - SOAP 1.2 message encoding:

    `http://www.w3.org/2003/05/soap-encoding/`

  - HTTP transport for SOAP 1.2:

    `http://www.w3.org/2003/05/soap/bindings/HTTP`

  - SOAP binding schema:

    `http://schemas.xmlsoap.org/wsdl/soap/2003-02-11.xsd`

  - Definition of the fault code element in the SOAP schema:

    `http://schemas.xmlsoap.org/soap/envelope/2004-01-21.xsd`

### WSDL-Related Documents

Web Services Description Language (WSDL) specifications:

`http://www.w3.org/TR/wsdl`

### UDDI-Related Documents

Universal Description, Discovery and Integration specifications:

`http://www.uddi.org/`

### Encryption-Related Documents

- Key Transport algorithms:

  - RSA-1_5:

    `http://www.w3.org/2001/04/xmlenc#rsa-1_5`

  - RSA-OAEP-MGF1P:

    `http://www.w3.org/2001/04/xmlenc#rsa-oaep-mgf1p`

- Signature keys:

  - RSA-SHA1:

    `http://www.w3.org/2000/09/xmldsig#rsa-sha1`

  - RSA-MD5:

    `http://www.w3.org/2001/04/xmldsig-more#rsa-md5`

  - HMAC-SHA1:

    `http://www.w3.org/2000/09/xmldsig#hmac-sha1`

  - DSA-SHA1:

    `http://www.w3.org/2000/09/xmldsig#dsa-sha1`

## Conventions

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.