Artifacts used to develop web services
With development artifacts, we can develop an enterprise bean or a JavaBeans module into web services based on the Web Services for Java EE specification.
To create a web service from an enterprise bean or from a JavaBeans module, the following files are added to the respective JAR file or WAR modules at assembly time:
- WSDL Extensible Markup Language (XML) file
The WSDL XML file describes the web service that is implemented.
- Service Endpoint Interface
A Service Endpoint Interface is the Java interface corresponding to the web service port type implemented. The Service Endpoint Interface is defined by the JAX-WS or JAX-RPC web services run time that you are using.
- webservices.xml
The webservices.xml file contains the Java EE deployment descriptor of the web service specifying how the web service is implemented. The webservices.xml file is defined in the Web Services for Java EE specification.
For JAX-WS web services, the use of the webservices.xml deployment descriptor is optional. We can use annotations to specify all of the information contained within the deployment descriptor file. We can use the deployment descriptor file to augment or override existing JAX-WS annotations. Information defined in the webservices.xml deployment descriptor overrides any corresponding information specified by annotations.
For JAX-RPC applications, deployment descriptors are required to specify how the web service is implemented.
- ibm-webservices-bnd.xmi (JAX-RPC applications only)
This file contains WebSphere product-specific deployment information and is defined in the ibm-webservices-bnd.xmi deployment descriptor. assembly properties. See the JAX-RPC web services deployment descriptor settings information to learn more about this deployment descriptor.
- Java API for XML-based remote procedure call (JAX-RPC) mapping file
The JAX-RPC mapping deployment descriptor specifies how Java elements are mapped to and from WSDL file elements.
The following files are added to an application client, enterprise beans or web module to permit a Web Services for Java EE client access to web services:
- WSDL file
The WSDL file is provided by the web service implementer.
- Java interfaces for the web service
The Java interfaces are generated from the WSDL file as specified by the JAX-WS or JAX-RPC specification. These bindings are the Service Endpoint Interface based on the WSDL port type, or the service interface, which is based on the WSDL service.
- ibm-webservicesclient-bnd.xmi (JAX-RPC applications only)
This file contains WebSphere product-specific deployment information, such as security information for JAX-RPC applications. For JAX-WS applications, deployment descriptors are not supported and have been replaced by the use of annotations.
- Other JAX-RPC binding files
Additional JAX-RPC binding files that support the client application in mapping SOAP to the Java language are generated from WSDL by the WSDL2Java command tool.
Related tasks
Task overview: Implement web services applications Implement web services applications with JAX-WS Implement web services applications from existing WSDL files with JAX-WS Implement web services applications with JAX-RPC Implement web services applications from existing WSDL files with JAX-RPC
JAX-RPC web services enabled module - deployment descriptor settings (ibm-webservices-bnd.xmi file) WSDL2Java command for JAX-RPC applications Web services specifications and APIs