O'Reilly logo

Java Enterprise in a Nutshell, Third Edition by William Crawford, Jim Farley

Stay ahead with the world's most comprehensive technology and business learning platform.

With Safari, you learn the way you learn best. Get unlimited access to videos, live online training, learning paths, books, tutorials, and more.

Start Free Trial

No credit card required

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.

Web service declarations

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 ...

With Safari, you learn the way you learn best. Get unlimited access to videos, live online training, learning paths, books, interactive tutorials, and more.

Start Free Trial

No credit card required