4 Upgrading WebLogic Web Services

Learn the procedures for upgrading WebLogic and RESTful web services to Oracle WebLogic Server 15c.

This chapter includes the following section:

Upgrading a WebLogic JAX-RPC Web Service to the WebLogic JAX-WS Stack

The WebLogic JAX-WS run time is based on the JAX-WS (Jakarta XML Web Services) 3.0 specification and the Jakarta Enterprise Web Services 2.0 specification. Starting with JAX-WS 2.0, the JAX-WS technology has replaced JAX-RPC in the Jakarta Platform and in WebLogic Server. JAX-RPC Web Services in WebLogic applications should be upgraded to JAX-WS.

Note:

Support for JAX-RPC has been removed in WebLogic Server 15.1.1.0.0.

This section summarizes how to upgrade a WebLogic JAX-RPC web service to use the WebLogic JAX-WS stack, with respect to upgrading:

From:
  • JAX-RPC supported in Java EE 7 and WLS 12.2.1.4, or
  • JAX-RPC supported as an optional technology in Jakarta EE 8 and WLS 14.1.1 and 14.1.2
To:
  • Jakarta XML Web Services in WLS 15.1.1

Upgrading your WebLogic Server JAX-RPC Web service includes the following high-level tasks:

  • Upgrade any web service EJBs from 2.x to 3.x.

    JAX-WS supports EJB 3.0 and 3.x. It does not support EJB 2.x.

  • Upgrade your JWS, mapping any proprietary JAX-RPC features to similar JAX-WS features.

    Note that there is not a one-to-one correspondence between WebLogic JAX-RPC web service features and JAX-WS 12.x features.

  • Update the Ant build script that builds the web service to change the value of the type attribute on the jws, wsdlc, and clientgen tasks to be "JAXWS" (for example, type="JAXWS").

  • Generate new JAX-WS clients using the JAX-WS clientgen Ant task.

JAX-WS Upgrade Considerations

When upgrading to JAX-WS, you should consider the following:

  • The JAX-WS specification supports the document-literal and rpc-literal styles, but not rpc-encoded.

  • SOAP Arrays are not supported by JAX-WS.

See Developing JAX-WS Web Services for Oracle WebLogic Server.