Contents

Title and Copyright Information

Preface

• Documentation Accessibility
• Conventions

1 Introduction to JAX-WS Web Services

• Overview of JAX-WS Web Service Development
  • The Programming Model—Metadata Annotations
  • The Development Model—Bottom-up and Top-down
    • Bottom-up Approach: Starting from Java
    • Top-down Approach: Starting from WSDL
• Roadmap for Implementing JAX-WS Web Services

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 or Singleton 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
• Using the Glassfish RI JAXB Data Binding and JAXB Providers
  • Configuring Global Server-Level Data Binding and JAXB Providers
  • Configuring Application-Level Data Binding and JAXB Providers
  • Configuring Java System Properties for JAXB

6 Developing WebLogic Web Service Clients

• Overview of WebLogic Web Services Client Development
• 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 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