Java Enterprise in a Nutshell, Third Edition

Web Services (webservices.xml)

SOAP web services are implemented in J2EE using JAX-RPC, and service implementations can take the form of a basic Java bean deployed as a web component or a stateless session EJB component. In either case, a webservices.xml deployment descriptor is used within the component archive (the war file or ejb-jar.xml file) to declare and configure the web services implemented by the components in the archive.

Figure A-15 shows the overall XML schema structure used in webservices.xml files.

Example A-15 shows sample web service declarations, annotated with descriptive comments.

Figure A-15. Web service declarations

Example A-15. Annotated web service declarations

<?xml version="1.0" encoding="UTF-8"?>
<webservices xmlns="http://java.sun.com/xml/ns/j2ee"
                               xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
                               xsi:schemaLocation="http://java.sun.com/xml/ns/j2ee
                                   http://java.sun.com/xml/ns/j2ee/j2ee_web_services_1_1.xsd"
                               version="1.1">
                      <description>Web services contained in my application</description>
                      <display-name>Web services</display-name>
                      <icon>
                          <small-icon>icons/my-small-ws-icon.jpg</small-icon>
                          <large-icon>icons/my-large-ws-icon.jpg</large-icon>
                      </icon> <!-- Each webservice-description element defines a full web service implemented somewhere in the surrounding component archive (web or EJB). Each service specifies a WSDL file and a JAX-RPC mapping file ...