Contents

Title and Copyright Information

Preface

• Documentation Accessibility
• Conventions

1 Introduction

2 Invoking a Web Service Using Asynchronous Request-Response

• Overview of the Asynchronous Request-Response Feature
• Using Asynchronous Request-Response: Main Steps
• Configuring the Host WebLogic Server Instance for the Asynchronous Web Service
• Writing the Asynchronous JWS File
  • Coding Guidelines for Invoking a Web Service Asynchronously
  • Using Asynchronous Pre- and Post-call Contexts
  • Example of a Synchronous Invoke
• Updating the build.xml File When Using Asynchronous Request-Response
• Disabling The Internal Asynchronous Service
• Using Asynchronous Request Response With a Proxy Server

3 Using Web Services Reliable Messaging

• Overview of Web Service Reliable Messaging
  • Using WS-Policy to Specify Reliable Messaging Policy Assertions
  • Managing the Life Cycle of the Reliable Message Sequence
• Using Web Service Reliable Messaging: Main Steps
  • Prerequisites
• Configuring the Destination WebLogic Server Instance
• Configuring the Source WebLogic Server Instance
• Creating the Web Service Reliable Messaging WS-Policy File
  • Creating a Custom WS-Policy File Using WS-ReliableMessaging Policy Assertions Version 1.1
  • Creating a Custom WS-Policy File Using WS-ReliableMessaging Policy Assertions Version 1.0 (Deprecated)
  • Using Multiple Policy Alternatives
• Programming Guidelines for the Reliable JWS File
  • Using the @Policy Annotation
  • Using the @Oneway Annotation
  • Using the @BufferQueue Annotation
  • Using the @ReliabilityBuffer Annotation
• Configuring Reliable Messaging for a Reliable Web Service
  • Using the Administration Console
  • Using WLST
• Programming Guidelines for the JWS File That Invokes a Reliable Web Service
• Updating the build.xml File for a Client of a Reliable Web Service
• Using Reliable Messaging With MTOM
• Client Considerations When Redeploying a Reliable Web Service
• Using Reliable Messaging With a Proxy Server

4 Creating Conversational Web Services

• Overview of Conversational Web Services
• Creating a Conversational Web Service: Main Steps
• Programming Guidelines for the Conversational JWS File
• Programming Guidelines for the JWS File That Invokes a Conversational Web Service
• ConversationUtils Utility Class
• Updating the build.xml File for a Client of a Conversational Web Service
• Updating a Stand-Alone Java Client to Invoke a Conversational Web Service
• Example Conversational Web Service .NET Client
  • ConversationService.java File
  • Service.cs File
  • build.xml File
• Client Considerations When Redeploying a Conversational Web Service

5 Creating Buffered Web Services

• Overview of Buffered Web Services
• Creating a Buffered Web Service: Main Steps
• Configuring the Host WebLogic Server Instance for the Buffered Web Service
• Programming Guidelines for the Buffered JWS File
• Programming the JWS File That Invokes the Buffered Web Service
• Updating the build.xml File for a Client of the Buffered Web Service

6 Using the Asynchronous Features Together

• Using the Asynchronous Features Together
• Example of a JWS File That Implements a Reliable Conversational Web Service
• Example of Client Web Service That Asynchronously Invokes a Reliable Conversational Web Service

7 Using Callbacks to Notify Clients of Events

• Overview of Callbacks
• Callback Implementation Overview and Terminology
• Programming Callbacks: Main Steps
• Programming Guidelines for Target Web Service
• Programming Guidelines for the Callback Client Web Service
• Programming Guidelines for the Callback Interface
• Updating the build.xml File for the Client Web Service

8 Using JMS Transport as the Connection Protocol

• Overview of Using JMS Transport
• Using JMS Transport Starting From Java: Main Steps
• Using JMS Transport Starting From WSDL: Main Steps
• Configuring the Host WebLogic Server Instance for the JMS Transport Web Service
• Using the @WLJmsTransport JWS Annotation
• Using the <WLJmsTransport> Child Element of the jwsc Ant Task
• Updating the WSDL to Use JMS Transport
• Invoking a WebLogic Web Service Using JMS Transport
  • Overriding the Default Service Address URL
  • Using JMS BytesMessage Rather Than the Default TextMessage
  • Disabling HTTP Access to the WSDL File

9 Creating and Using SOAP Message Handlers

• Overview of SOAP Message Handlers
• Adding SOAP Message Handlers to a Web Service: Main Steps
• Designing the SOAP Message Handlers and Handler Chains
• Creating the GenericHandler Class
  • Implementing the Handler.init() Method
  • Implementing the Handler.destroy() Method
  • Implementing the Handler.getHeaders() Method
  • Implementing the Handler.handleRequest() Method
  • Implementing the Handler.handleResponse() Method
  • Implementing the Handler.handleFault() Method
  • Directly Manipulating the SOAP Request and Response Message Using SAAJ
    • The SOAPPart Object
    • The AttachmentPart Object
    • Manipulating Image Attachments in a SOAP Message Handler
• Configuring Handlers in the JWS File
  • @javax.jws.HandlerChain
  • @javax.jws.soap.SOAPMessageHandlers
• Creating the Handler Chain Configuration File
• Compiling and Rebuilding the Web Service
• Creating and Using Client-Side SOAP Message Handlers
  • Using Client-Side SOAP Message Handlers: Main Steps
  • Example of a Client-Side Handler Class
  • Creating the Client-Side SOAP Handler Configuration File
  • XML Schema for the Client-Side Handler Configuration File
  • Specifying the Client-Side SOAP Handler Configuration File to clientgen

10 Using Database Web Services

• Overview of Database Web Services
  • Database Call-in
  • Database Call-out
• Type Mapping Between SQL and XML
  • SQL to XML Type Mappings for Web Service Call-Ins
  • XML-to-SQL Type Mapping for Web Service Call-outs
• Developing Database Web Services Using Oracle JDeveloper

A Pre-Packaged WS-Policy Files for Reliable Messaging

• DefaultReliability1.1.xml (WS-Policy File)
• Reliability1.1_SequenceTransportSecurity.xml (WS-Policy File)
• Reliability1.1_SequenceSTR.xml (WS-Policy File)
• Reliability1.0_1.1.xml (WS-Policy.xml File)
• DefaultReliability.xml (WS-Policy File) [Deprecated]
• LongRunningReliability.xml (WS-Policy File) [Deprecated]