1/11
Contents
Title and Copyright Information
Preface
Documentation Accessibility
Conventions
1
Introduction
2
Use Cases and Examples
Creating a Simple HelloWorld Web Service
Sample HelloWorldImpl.java JWS File
Sample Ant Build File for HelloWorldImpl.java
Creating a Web Service With User-Defined Data Types
Sample BasicStruct JavaBean
Sample ComplexImpl.java JWS File
Sample Ant Build File for ComplexImpl.java JWS File
Creating a Web Service from a WSDL File
Sample WSDL File
Sample TemperaturePortType Java Implementation File
Sample Ant Build File for TemperatureService
Invoking a Web Service from a Java SE Application
Sample Java Client Application
Sample Ant Build File For Building Java Client Application
Invoking a Web Service from a WebLogic Web Service
Sample ClientServiceImpl.java JWS File
Sample Ant Build File For Building ClientService
3
Developing WebLogic Web Services
Overview of the WebLogic Web Service Programming Model
Configuring Your Domain For Advanced Web Services Features
Resources Required by Advanced Web Service Features
Scripts for Extending a Domain for Advanced Web Service Features
Configuring a Domain for Advanced Web Service Features Using the Configuration Wizard
Creating a Domain With the Web Services Extension Template
Extending a Domain With the Web Services Extension Template
Using WLST to Extend a Domain With the Web Services Extension Template
Updating Resources Added After Extending Your Domain
Troubleshooting Problems When Applying the WebLogic Advanced Web Services for JAX-WS Extension Template
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
Web service is not a callback service and can be invoked using HTTP/S
Web service is a callback service
Web service is invoked using a proxy server
Testing the Web Service
Integrating Web Services Into the WebLogic Split Development Directory Environment
4
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
5
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
6
Invoking Web Services
Overview of Web Services Invocation
Invoking a Web Service from a Java SE Client
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 Java Client
Invoking a Web Service from a WebLogic Web Service
Sample build.xml File for a Web Service Client
Sample JWS File That Invokes a Web Service
Configuring Web Service Clients
Defining a Web Service Reference Using the @WebServiceRef Annotation
Managing Client Identity
Defining the Client ID During Port Initialization
Accessing the Server-generated Client ID
Client Identity Lifecycle
Using a Proxy Server When Invoking a Web Service
Using the ClientProxyFeature API to Specify the Proxy Server
Using System Properties to Specify the Proxy Server
Client Considerations When Redeploying a Web Service
Client Considerations When Web Service and Client Are Deployed to the Same Managed Server
7
Administering Web Services
Overview of WebLogic Web Services Administration Tasks
Administration Tools
Using the WebLogic Server Administration Console
Invoking the Administration Console
How Web Services Are Displayed In the Administration Console
Creating a Web Services Security Configuration
Using the Oracle Enterprise Manager Fusion Middleware Control
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
Monitoring Web Services and Clients
Monitoring Web Services
Monitoring Web Service Clients
8
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
Scripting on this page enhances content navigation, but does not change the content in any way.