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 to all users, including users that are disabled. 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.

Deaf/Hard of Hearing Access to Oracle Support Services

To reach Oracle Support Services, use a telecommunications relay service (TRS) to call Oracle Support at 1.800.223.1711. An Oracle Support Services engineer will handle technical issues and provide customer support according to the Oracle service request process. Information about TRS is available at http://www.fcc.gov/cgb/consumerfacts/trs.html, and a list of phone numbers is available at http://www.fcc.gov/cgb/dro/trsphonebk.html.

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

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/

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

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 5 (1.5) API specification:

  http://java.sun.com/javaee/5/docs/api

• 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/

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