JAX-WS application deployment model

JAX-WS application deployment model

The administration function of WAS is enhanced to support installing and deploying Java API for XML Web Services (JAX-WS) applications like any other WAS applications.
A JAX-WS application is packaged as a WAR file or a WAR module within an EAR file. The JAX-WS application deployment model is similar to the Java API for XML Remote Protocol Call (JAX-RPC) Web services application model. The main difference between them is that JAX-RPC Web services application requires you to add additional bindings and deployment descriptors for application deployment. A JAX-WS application does not require additional bindings and deployment descriptors for deployment. We can deploy your JAX-WS applications as you would deploy any other WAS application.
JAX-WS Web services is a rewrite of JAX-RPC Web services. The table compares the Web services stack for both JAX-WS and JAX-RPC Web services.

JAX-RPC Web services JAX-WS Web services
Bindings are proprietary Bindings are based on the open source Java API for XML Bindings (JAXB)
Parsing is proprietary Parsing is based on the open source Java Specification Request (JSR) 173
No Java annotations support Support for Java annotations such as @WebService, @WebMethod, @WebParam, @WebResult, and @SOAPBinding
During deployment, some deployment descriptor files are created in a JAX-RPC based service and client.
The following files are created on the services side, when it is an EJB based Web service and EJB based module:

webservices.xml
<name_of_service>_mapping.xml
ibm-webservices-bnd.xmi
ibm-webservices-ext.xmi

When the service is a Java Beans-based or Web module-based service, the following files and deployment descriptors are required:

webservices.xml
<name_of_service>_mapping.xml
In the web.xml, there is no additional content
ibm-webservices-bnd.xmi
ibm-webservices-ext.xmi

The web.xml exists in both EJB and Java Beansbased services. However, there is no additional content added to the file during deployment of a Web service application or module.

For JAX-WS Web services, the use of the webservices.xml deployment descriptor is optional because we can use annotations to specify all of the information contained within the deployment descriptor file. Use the deployment descriptor file to augment or override existing JAX-WS annotations. Any information that you define in the webservices.xml deployment descriptor overrides any corresponding information specified by annotations.

For transitioning users: In WAS V7.0, the default annotation support behavior has changed. In the V6.1 Feature Pack for Web services, the default behavior is to scan pre-Java EE 5 Web app modules to identify JAX-WS services and to scan pre-Java EE 5 Web app modules and EJB modules for service clients during application installation. For V 7.0, the default behavior is to not scan pre-Java EE 5 modules for annotations during application installation or server startup. You can preserve compatibility with feature packs from previous releases by either setting the UseWSFEP61ScanPolicy property in the META-INF/MANIFEST.MF of a WAR file or EJB module or by defining the Java virtual machine custom property, com.ibm.websphere.webservices.UseWSFEP61ScanPolicy, on servers to request scanning during application installation and server startup. To learn more about annotations scanning, see the JAX-WS annotations documentation.trns

Related concepts

JAX-WS application packaging
Develop JAX-RPC Web services deployment descriptor templates for a Java Beans implementation
Web services

Related tasks

Develop a webservices.xml deployment descriptor for JAX-WS applications
Deploy enterprise apps
Deploy Web services applications onto appservers

Related

Artifacts used to develop Web services
JAX-WS annotations
Web services specifications and APIs

JAX-RPC Web services	JAX-WS Web services
Bindings are proprietary	Bindings are based on the open source Java API for XML Bindings (JAXB)
Parsing is proprietary	Parsing is based on the open source Java Specification Request (JSR) 173
No Java annotations support	Support for Java annotations such as @WebService, @WebMethod, @WebParam, @WebResult, and @SOAPBinding
During deployment, some deployment descriptor files are created in a JAX-RPC based service and client. The following files are created on the services side, when it is an EJB based Web service and EJB based module: webservices.xml <name_of_service>_mapping.xml ibm-webservices-bnd.xmi ibm-webservices-ext.xmi When the service is a Java Beans-based or Web module-based service, the following files and deployment descriptors are required: webservices.xml <name_of_service>_mapping.xml In the web.xml, there is no additional content ibm-webservices-bnd.xmi ibm-webservices-ext.xmi The web.xml exists in both EJB and Java Beansbased services. However, there is no additional content added to the file during deployment of a Web service application or module.	For JAX-WS Web services, the use of the webservices.xml deployment descriptor is optional because we can use annotations to specify all of the information contained within the deployment descriptor file. Use the deployment descriptor file to augment or override existing JAX-WS annotations. Any information that you define in the webservices.xml deployment descriptor overrides any corresponding information specified by annotations.