WebLogic Web Services: Getting Started

Introduction and Roadmap

Document Scope and Audience

WebLogic Web Services Documentation Set

Guide to This Document

Related Documentation

Samples for the Web Services Developer

Avitek Medical Records Application (MedRec) and Tutorials

Web Services Examples in the WebLogic Server Distribution

Additional Web Services Examples Available for Download

Release-Specific WebLogic Web Services Information

Summary of WebLogic Web Services Features

Understanding WebLogic Web Services

What Are Web Services?

Why Use Web Services?

Anatomy of a WebLogic Web Service

Roadmap of Common Web Service Development Tasks

Standards Supported by WebLogic Web Services

BEA Implementation of Web Service Specifications

Web Services Metadata for the Java Platform (JSR-181) 2.0

Enterprise Web Services 1.2

Java API for XML-Based Web Services (JAX-WS) 2.0

Java Architecture for XML Binding (JAXB) 2.0

SOAP 1.1 and 1.2

SAAJ

WSDL 1.1

JAX-RPC 1.1

Web Services Security (WS-Security) 1.1

UDDI 2.0

JAX-R 1.0

WS-Addressing (August 2004 Member Submission)

WS-Policy 1.2 (April 2006 Member Submission)

WS-SecurityPolicy 1.2 (June 2006 Draft)

WS-ReliableMessaging 1.0 (February 2005 Member Submission)

WS-Trust 1.3 (February 2005 Member Submission)

WS-SecureConversation 1.3 (February 2005 Member Submission)

Additional Specifications Supported by WebLogic Web Services

Common Web Services Use Cases and Examples

Creating a Simple HelloWorld Web Service

Creating a Web Service With User-Defined Data Types

Creating a Web Service from a WSDL File

Invoking a Web Service from a Stand-alone JAX-RPC Java Client

Invoking a Web Service from a WebLogic Web Service

Iterative Development of WebLogic Web Services

Overview of the WebLogic Web Service Programming Model

Configuring Your Domain For Web Services Features

Iterative Development of WebLogic Web Services Starting From Java: Main Steps

Iterative Development of WebLogic Web Services Starting From a WSDL File: Main Steps

Creating the Basic Ant build.xml File

Running the jwsc WebLogic Web Services Ant Task

Examples of Using jwsc

Advanced Uses of jwsc

Running the wsdlc WebLogic Web Services Ant Task

Updating the Stubbed-Out JWS Implementation Class File Generated By wsdlc

Deploying and Undeploying WebLogic Web Services

Using the wldeploy Ant Task to Deploy Web Services

Using the Administration Console to Deploy Web Services

Browsing to the WSDL of the Web Service

Configuring the Server Address Specified in the Dynamic WSDL

Testing the Web Service

Integrating Web Services Into the WebLogic Split Development Directory Environment

Programming the JWS File

Overview of JWS Files and JWS Annotations

Programming the JWS File: Java Requirements

Programming the JWS File: Typical Steps

Example of a JWS File

Specifying That the JWS File Implements a Web Service

Specifying the Mapping of the Web Service to the SOAP Message Protocol

Specifying the Context Path and Service URI of the Web Service

Specifying That a JWS Method Be Exposed as a Public Operation

Customizing the Mapping Between Operation Parameters and WSDL Parts

Customizing the Mapping Between the Operation Return Value and a WSDL Part

Accessing Runtime Information about a Web Service Using the JwsContext

Guidelines for Accessing the Web Service Context

Methods of the JwsContext

Should You Implement a Stateless Session EJB?

Programming Guidelines When Implementing an EJB in Your JWS File

Example of a JWS File That Implements an EJB

Programming the User-Defined Java Data Type

Throwing Exceptions

Invoking Another Web Service from the JWS File

Programming Additional Miscellaneous Features Using JWS Annotations and APIs

Sending Binary Data Using MTOM/XOP

Streaming SOAP Attachments

Using SOAP 1.2

Specifying that Operations Run Inside of a Transaction

Getting the HttpServletRequest/Response Object

JWS Programming Best Practices

Implementing a JAX-WS 2.0 Web Service

Implementing a JAX-WS Web Service: Overview

Implementing a JAX-WS Web Service: Guidelines

Simple Example of Implementing a JAX-WS Web Service

Example of a JWS File That Implements a JAX-WS Web Service

Specifying a JAX-WS Web Service to the jwsc and clientgen Ant Tasks

Example of Invoking a JAX-WS Web Service

Data Types and Data Binding

Overview of Data Types and Data Binding

Supported Built-In Data Types

XML-to-Java Mapping for Built-In Data Types

Java-to-XML Mapping for Built-In Data Types

Supported User-Defined Data Types

Supported XML User-Defined Data Types

Supported Java User-Defined Data Types

Invoking Web Services

Overview of Web Services Invocation

Types of Client Applications

JAX-RPC

The clientgen Ant Task

Examples of Clients That Invoke Web Services

Invoking a Web Service from a Stand-alone Client: Main Steps

Using the clientgen Ant Task To Generate Client Artifacts

Getting Information About a Web Service

Writing the Java Client Application Code to Invoke a Web Service

Compiling and Running the Client Application

Sample Ant Build File for a Stand-Alone Java Client

Invoking a Web Service from Another Web Service

Sample build.xml File for a Web Service Client

Sample JWS File That Invokes a Web Service

Using a Stand-Alone Client JAR File When Invoking Web Services

Using a Proxy Server When Invoking a Web Service

Using the HttpTransportInfo API to Specify the Proxy Server

Using System Properties to Specify the Proxy Server

Client Considerations When Redeploying a Web Service

WebLogic Web Services Stub Properties

Setting the Character Encoding For the Response SOAP Message

Administering Web Services

Overview of WebLogic Web Services Administration Tasks

Administration Tools

Using the Administration Console

Invoking the Administration Console

How Web Services Are Displayed In the Administration Console

Creating a Web Services Security Configuration

Using the WebLogic Scripting Tool

Using WebLogic Ant Tasks

Using the Java Management Extensions (JMX)

Using the Java EE Deployment API

Using Work Managers to Prioritize Web Services Work and Reduce Stuck Execute Threads

Upgrading WebLogic Web Services From Previous Releases to 10.0

Upgrading a 9.2 WebLogic Web Service to 10.0

Upgrading a 9.0 or 9.1 WebLogic Web Service to 10.0

Upgrading an 8.1 WebLogic Web Service to 10.0

Upgrading an 8.1 Java Class-Implemented WebLogic Web Service to 10.0: Main Steps

Upgrading an 8.1 EJB-Implemented WebLogic Web Service to 10.0: Main Steps

8.1 SessionBean Class

8.1 Remote Interface

8.1 EJB Home Interface

Equivalent 10.0 JWS File

Mapping of servicegen Attributes to JWS Annotations or jwsc Attributes