IBM WebSphere JAX-WS runtime environment

Java™ API for XML-Based Web Services (JAX-WS) is the next generation web services programming model. Using JAX-WS, development of web services and clients is simplified with greater platform independence for Java applications by the use of dynamic proxies and Java annotations.

Enabling the WebSphere JAX-WS runtime environment

You can create top-down or bottom-up Java web services and clients. EJB web service generation using the JAX-WS runtime environment is only supported by WebSphere® Application Server V7.0 and later, and WebSphere Application Server Liberty V8.5.5 and later.

The JAX-WS run time is enabled by default in WebSphere Application Server V7.0 and later. When you create web projects, so long as you select the default configuration for your version of WebSphere Application Server the correct facets are selected.

JAX-WS web service artifacts

A JAX-WS web service is contained within a web archive (WAR) file or a WAR module within an enterprise archive (EAR) file. A JAX-WS enabled WAR file contains:
A WEB-INF/web.xml file.
The web.xml does not contain servlet or servlet-mapping elements. The WebSphere Application Server run time defines them dynamically as the module is loaded.
Annotated classes that implement the web services, which are contained in the application module.
Annotated classes must contain, at a minimum, a web service implementation class that includes the @javax.jws.WebService annotation. The definition and specification of the web services-related annotations are provided by the JAX-WS and JSR-181 specifications. The web service implementation classes can exist within the WEB-INF/classes or directory within a Java archive (JAR) file that is contained in the WEB-INF/lib directory of the WAR file.
Web Services Description Language (WSDL) documents that describe the web services that are contained in the application module [optional].
You can optionally include WSDL documents in the JAX-WS application packaging. If the WSDL document for a particular web service is omitted, then the WebSphere Application Server runtime environment constructs the WSDL definition dynamically from the annotations that are contained in the web service implementation classes. You must include the @javax.jws.WebService, and optionally the @WebMethod, @WebParam, @WebResult, and @SOAPBinding annotations if the WSDL document is omitted.
Icon that indicates the type of topic Concept topic
Timestamp icon Last updated: July 17, 2017 21:58

File name: cjaxwsruntime.html