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
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
Creating an External Binding Declarations File Using JAXB Binding Declarations
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