Getting Started With WebLogic Web Services Using JAX-WS

Introduction

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

Invoking a Web Service from a WebLogic Web Service

Developing WebLogic Web Services

Overview of the WebLogic Web Service Programming Model

Developing WebLogic Web Services Starting From Java: Main Steps

Developing 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

Java Requirements for a JWS File

Programming the JWS File: Typical Steps

Example of a JWS File

Specifying that the JWS File Implements a Web Service (@WebService Annotation)

Specifying the Mapping of the Web Service to the SOAP Message Protocol (@SOAPBinding Annotation)

Specifying That a JWS Method Be Exposed as a Public Operation (@WebMethod and @OneWay Annotations)

Customizing the Mapping Between Operation Parameters and WSDL Elements (@WebParam Annotation)

Customizing the Mapping Between the Operation Return Value and a WSDL Element (@WebResult Annotation)

Specifying the Binding to Use for an Endpoint (@BindingType Annotation)

Accessing Runtime Information About a Web Service

Accessing the Protocol Binding Context

Accessing the Web Service Context

Using the MessageContext Property Values

Should You Implement a Stateless Session EJB?

Programming the User-Defined Java Data Type

Invoking Another Web Service from the JWS File

Using SOAP 1.2

Validating the XML Schema

Enabling Schema Validation on the Server

Enabling Schema Validation on the Client

JWS Programming Best Practices

Using JAXB Data Binding

Overview of Data Binding Using JAXB

Developing the JAXB Data Binding Artifacts

Standard Data Type Mapping

Supported Built-In Data Types

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

XML Schema

Default Java Binding

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

Customizing Java-to-XML Schema Mapping Using JAXB Annotations

Example of JAXB Annotations

Specifying Default Serialization of Fields and Properties (@XmlAccessorType Annotation)

Mapping Properties to Local Elements (@XmlElement)

Specifying the MIME Type (@XmlMimeType Annotation)

Mapping a Top-level Class to a Global Element (@XmlRootElement)

Binding a Set of Classes (@XmlSeeAlso)

Mapping a Value Class to a Schema Type (@XmlType)

Customizing XML Schema-to-Java Mapping Using Binding Declarations

Creating an External Binding Declarations File

Creating an External Binding Declarations File Using JAX-WS Binding Declarations

Specifying the Root Element

Specifying Child Elements

Creating an External Binding Declarations File Using JAXB Binding Declarations

Specifying the Root Element

Specifying Child Elements

Embedding Binding Declarations

Embedding JAX-WS or JAXB Binding Declarations in the WSDL File

Embedding JAXB Binding Declarations in the XML Schema

JAX-WS Custom Binding Declarations

JAXB Custom Binding Declarations

Invoking Web Services

Overview of Web Services Invocation

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

Defining a Web Service Reference Using the @WebServiceRef Annotation

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

Client Considerations When Redeploying a Web Service

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

Migrating JAX-RPC Web Services and Clients to JAX-WS

Setting the Final Context Root of a WebLogic Web Service

Using WebLogic-specific Annotations

Generating a WSDL File

Using JAXB Custom Types

Using EJB 3.0

Migrating from RPC Style SOAP Binding

Updating SOAP Message Handlers

Invoking JAX-WS Clients