Contents

Title and Copyright Information

Preface

• Documentation Accessibility
• Related Documents
• 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
• Applying Asynchronous Binding Declaration to WSDL
• Updating the build.xml File When Using Asynchronous Request-Response
• Creating the Asynchronous Client

3 Using Web Services Atomic Transactions

• Overview of Web Services Atomic Transactions
• Configuring the Domain Resources Required for Web Servcie Advanced Features
• Enabling Web Services Atomic Transactions on Web Services
  • Using the @Transactional Annotation in Your JWS File
    • Example: Using @Transactional Annotation on a Web Service Class
    • Example: Using @Transactional Annotation on a Web Service Method
    • Example: Using the @Transactional and the EJB @TransactionAttribute Annotations Together
  • Enabling Web Services Atomic Transactions Starting From WSDL
• Enabling Web Services Atomic Transactions on Web Service Clients
  • Using @Transactional Annotation with the @WebServiceRef Annotation
  • Passing the TransactionalFeature to the Client
• Configuring Web Services Atomic Transactions Using the Administration Console
  • Securing Messages Exchanged Between the Coordinator and Participant
  • Enabling and Configuring Web Services Atomic Transactions
• Using Web Services Atomic Transactions in a Clustered Environment
• More Examples of Using Web Services Atomic Transactions

4 Managing Web Services in a Cluster

• Overview of Web Services Cluster Routing
• Cluster Routing Scenarios
  • Scenario 1: Routing a Web Service Response to a Single Server
  • Scenario 2: Routing Web Service Requests to a Single Server Using Routing Information
  • Scenario 3: Routing Web Service Requests to a Single Server Using an ID
• How Web Service Cluster Routing Works
  • Adding Routing Information to Outgoing Requests
  • Detecting Routing Information in Incoming Requests
  • Routing Requests Within the Cluster
  • Maintaining the Routing Map on the Front-end SOAP Router
    • X-weblogic-wsee-storetoserver-list HTTP Response Header
    • X-weblogic-wsee-storetoserver-hash HTTP Response Header
• Configuring Web Services in a Cluster
  • Setting Up the WebLogic Cluster
  • Configuring the Domain Resources Required for Web Service Advanced Features in a Clustered Environment
  • Extending the Front-end SOAP Router to Support Web Services
  • Enabling Routing of Web Services Atomic Transaction Messages
  • Configuring the Identity of the Front-end SOAP Router
• Monitoring Cluster Routing Performance

5 Publishing a Web Service Endpoint

6 Using Callbacks

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

7 Optimizing Binary Data Transmission Using MTOM/XOP

• Sending Binary Data Using MTOM/XOP
  • Annotating the Data Types
    • Annotating the Data Types: Start From Java
    • Annotating the Data Types: Start From WSDL
  • Enabling MTOM on the Web Service
    • Enabling MTOM on the Web Service Using Annotation
    • Enabling MTOM on the Web Services Using WS-Policy File
  • Enabling MTOM on the Client
  • Setting the Attachment Threshold
• Streaming SOAP Attachments
  • Client Side Example
  • Server Side Example
  • Configuring Streaming SOAP Attachments
    • Configuring Streaming SOAP Attachments on the Server
    • Configuring Streaming SOAP Attachments on the Client

8 Creating Dynamic Proxy Clients

• Additional Considerations When Specifying WSDL Location

9 Using XML Catalogs

• Overview of XML Catalogs
• Defining and Referencing XML Catalogs
  • Defining an External XML Catalog
    • Creating an External XML Catalog File
    • Referencing the External XML Catalog File
  • Embedding an XML Catalog
    • Creating an Embedded XML Catalog
    • Referencing an Embedded XML Catalog
• Disabling XML Catalogs in the Client Runtime
• Getting a Local Copy of XML Resources

10 Creating and Using SOAP Message Handlers

• Overview of SOAP Message Handlers
• Adding Server-side SOAP Message Handlers: Main Steps
• Adding Client-side SOAP Message Handlers: Main Steps
• Designing the SOAP Message Handlers and Handler Chains
  • Server-side Handler Execution
  • Client-side Handler Execution
• Creating the SOAP Message Handler
  • Example of a SOAP Handler
  • Example of a Logical Handler
  • Implementing the Handler.handleMessage() Method
  • Implementing the Handler.handleFault() Method
  • Implementing the Handler.close() Method
  • Using the Message Context Property Values and Methods
  • 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 Handler Chains in the JWS File
• Creating the Handler Chain Configuration File
• Compiling and Rebuilding the Web Service
• Configuring the Client-side SOAP Message Handlers

11 Programming RESTful Web Services

• Overview of RESTful Web Services
• Programming RESTful Web Services: Main Steps
• Programming Guidelines for the RESTful Web Service
• Accessing the RESTful Web Service from a Client
• Securing RESTful Web Services

12 Programming Stateful JAX-WS Web Services Using HTTP Session

• Overview of Stateful Web Services
• Accessing HTTP Session on the Server
• Enabling HTTP Session on the Client
• Developing Stateful Services in a Cluster Using Session State Replication
• A Note About the JAX-WS RI @Stateful Extension

13 Publishing and Finding Web Services Using UDDI

• Overview of UDDI
  • UDDI and Web Services
  • UDDI and Business Registry
  • UDDI Data Structure
• WebLogic Server UDDI Features
• UDDI 2.0 Server
  • Configuring the UDDI 2.0 Server
  • Configuring an External LDAP Server
    • 51acumen.ldif File Contents
  • Description of Properties in the uddi.properties File
• UDDI Directory Explorer
• UDDI Client API
• Pluggable tModel
  • XML Elements and Permissible Values
  • XML Schema for Pluggable tModels
  • Sample XML for a Pluggable tModel