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 Client
  • 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 Web Services Features
• 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 not a callback service and can be invoked using JMS Transport
  • 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 the Context Path and Service URI of the Web Service (@WLHttpTransport 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)
• Accessing Run-Time Information About a Web Service
  • Using JwsContext to Access Run-Time Information
    • Guidelines for Accessing the Web Service Context
    • Methods of the JwsContext
  • Using the Stub Interface to Access Run-Time Information
• 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

5 Understanding Data Binding

• Overview of 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

6 Invoking Web Services

• Overview of Web Services Invocation
  • Invoking Web Services Using JAX-RPC
  • Examples of Clients That Invoke Web Services
• 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 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

7 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
  • Monitoring Web Services and Clients
• 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

8 Upgrading WebLogic Web Services From Previous Releases to 10.3.x

• Upgrading a 9.2 or 10.0 WebLogic Web Service to 10.3.x
• Upgrading a 9.0 or 9.1 WebLogic Web Service to 10.3.x
• Upgrading an 8.1 WebLogic Web Service to 10.3.x
  • Upgrading an 8.1 Java Class-Implemented WebLogic Web Service to 10.3.x: Main Steps
    • Example of an 8.1 Java File and the Corresponding 10.3.x JWS File
    • Example of an 8.1 and Updated 10.3.x Ant Build File for Java Class-Implemented Web Services
  • Upgrading an 8.1 EJB-Implemented WebLogic Web Service to 10.3.x: Main Steps
    • Example of 8.1 EJB Files and the Corresponding 10.3.x JWS File
    • Example of an 8.1 and Updated 10.3.x Ant Build File for an 8.1 EJB-Implemented Web Service
  • Mapping of servicegen Attributes to JWS Annotations or jwsc Attributes