Auch wenn sich die services.xml in der Syntax unterscheiden, so kann man festhalten, dass beide Projekte an dieser Stelle nahezu die gleichen Konfigurationsmöglichkeiten bieten: Definition von Services, Festlegen von Methoden, Message Styles, Message Receivern/Invokern, Handlern usw. Für den XFire Web Service benötigt man unter Umständen noch eine web.xml, die eingehende Anfragen an das XFireServlet delegiert (Listing 6). Um die Archive zum Deployment des Web Services zu erzeugen, soll ein Ant-Skript zum Einsatz kommen. Listing 7 zeigt, wie so ein Skript aussehen könnte. In Abbildung 3 ist noch mal das komplette Eclipse-Projekt dargestellt.
Listing 6: web.xml für XFire------------------------------------------------------------------<!DOCTYPE web-appPUBLIC "-//Sun Microsystems, Inc.//DTD Web Application 2.3//EN""http://java.sun.com/dtd/web-app_2_3.dtd"><web-app><servlet><servlet-name>XFireServlet</servlet-name><display-name>XFire Servlet</display-name><servlet-class>org.codehaus.xfire.transport.http.XFireConfigurableServlet</servlet-class></servlet><servlet-mapping><servlet-name>XFireServlet</servlet-name><url-pattern>/servlet/XFireServlet/*</url-pattern></servlet-mapping><servlet-mapping><servlet-name>XFireServlet</servlet-name><url-pattern>/services/*</url-pattern></servlet-mapping></web-app>
Listing 7: Ant-Skript zum Bauen der Axis2- und XFire Web Services-----------------------------------------------------------------------------<?xml version="1.0"?><project name="BookService" basedir="." default="ErzeugeAAR"><property name="src.dir" value="src"/><property name="web.dir" value="war"/><property name="bin.dir" value="bin"/><property name="Axis2Config.dir" value="Axis2Config"/><property name="xfirelib" value="C:\xfire-1.2.1"/><property name="XFireConfig.dir" value="XFireConfig"/><property name="classes.dir" value="${web.dir}/WEB-INF/classes"/><property name="lib.dir" value="${web.dir}/WEB-INF/lib"/><property name="deploy.file" value="BookService"/><property name="deploy.path" value="C:\"/><target name="XFireStructure" depends=""description="[XFIRE] Struktur für WAR-File erzeugen"><mkdir dir="${web.dir}" /><mkdir dir="${web.dir}/WEB-INF" /><mkdir dir="${classes.dir}" /><mkdir dir="${classes.dir}/META-INF/xfire" /><copy todir="${classes.dir}" preservelastmodified="true"><fileset dir="${bin.dir}"includes="**/*.*"excludes="*.xml"/></copy><copy todir="${classes.dir}/META-INF/xfire" preservelastmodified="true"><fileset dir="${XFireConfig.dir}"includes="services.xml"/></copy><copy todir="${lib.dir}"><fileset dir="${xfirelib}" includes="xfire-all-1.2.1.jar" /> <fileset dir="${xfirelib}\lib" includes="*.jar" /></copy></target><target name="ErzeugeWAR" depends="XFireStructure"description="[XFIRE] WAR-File erzeugen"><war destfile="${deploy.path}/${deploy.file}.war"webxml="${XFireConfig.dir}/web.xml"><fileset dir="${web.dir}"><include name="**/*.*"/></fileset></war><copy todir="${deploy.path}" preservelastmodified="true"><fileset dir="."><include name="*.war"/></fileset></copy><delete dir="${web.dir}" /></target><target name="Axis2Structure" depends=""description="[AXIS2] Struktur für AAR-File erzeugen"><mkdir dir="${web.dir}" /><mkdir dir="${web.dir}/META-INF" /><copy todir="${web.dir}" preservelastmodified="true"><fileset dir="${bin.dir}"includes="**/*.*"excludes="*.xml"/></copy><copy todir="${web.dir}/META-INF" preservelastmodified="true"><fileset dir="${Axis2Config.dir}"includes="services.xml"/></copy></target><target name="ErzeugeAAR" depends="Axis2Structure"description="[AXIS2] AAR-File erzeugen"><jar destfile="${deploy.path}/${deploy.file}.aar"><fileset dir="${web.dir}"><include name="**/*.*"/></fileset></jar><copy todir="${deploy.path}" preservelastmodified="true"><fileset dir="."><include name="*.aar"/></fileset></copy><delete dir="${web.dir}" /></target></project>
Nach dem Ausführen des Tasks <ErzeugeAAR> sollte auf C:\ eine Datei mit dem Namen BookService.aar existieren, diese kann nun nach Axis2 hochgeladen werden. Unter folgendem URL ist die WSDL der Axis2-Version des Web Services jetzt verfügbar: http://localhost:8080/axis2/services/Book-Service?wsdl. Wird bei Axis2 ?wsdl durch ?xsd ersetzt, dann erhält man zusätzlich noch ein XML-Schema für den Service. Das Ausführen des Tasks <ErzeugeWAR> führt zur Datei BookService.war, die dann in einen Servlet-Container eingespielt werden kann. Die WSDL des XFire Web Services ist dann hier verfügbar: http://localhost:8080/BookService/services/BookService?wsdl.
Zum Abschluss fehlt noch der Client. Aus Platzgründen kann leider nur ein Client besprochen werden. Dieser soll mit Axis2 implementiert werden, da man hier aufgrund von AXIOM etwas aufwendiger (im Gegensatz zu einem XFire-Client) entwickeln muss. Der Client (Listing 8) ruft beide Methoden des Service auf und gibt die entsprechenden Bücher samt Autoren aus.
Listing 8: Ein Web-Service-Client, wie er mit Axis2 programmierbar ist-------------------------------------------------------------------------------package de.javamagazin;import java.util.ArrayList;import javax.xml.namespace.QName;import org.apache.axiom.om.OMElement;import org.apache.axis2.AxisFault;import org.apache.axis2.addressing.EndpointReference;import org.apache.axis2.client.Options;import org.apache.axis2.databinding.utils.BeanUtil;import org.apache.axis2.rpc.client.RPCServiceClient;public class Axis2Client {private static EndpointReference endpoint = new EndpointReference("http://localhost:8080/axis2/services/BookService");private static QName findBookOperation = new QName("http://javamagazin.de/xsd", "findBook");private static QName getBooksOperation = new QName("http://javamagazin.de/xsd", "getBooks");public static void main(String[] args) {try {Options options = new Options();options.setTo(endpoint);RPCServiceClient sender = new RPCServiceClient();sender.setOptions(options);ArrayList arguments = new ArrayList();arguments.add("978-3-935042-81-9");OMElement response = sender.invokeBlocking(findBookOperation,arguments.toArray());Book book = (Book) BeanUtil.deserialize(Book.class, response.getFirstElement());printBook(book);ArrayList resobj = new ArrayList();resobj.add(Book.class);resobj.add(Book.class);Object[] returned = sender.invokeBlocking(getBooksOperation,new ArrayList().toArray(), resobj.toArray());for (Object o : returned) {book = (Book) o;printBook(book);}} catch (AxisFault axisFault) {axisFault.printStackTrace();}}private static void printBook(Book book) {System.out.println("Title: " + book.getTitle());for (int i = 0; i < book.getAuthors().length; i++) {System.out.println("Autor " + i + ": "+ book.getAuthors()[i].getName() + ", "+ book.getAuthors()[i].getFirstName());}System.out.println("\n");}}
Interessant ist hier das Zusammenspiel mit AXIOM: Nachdem über einen RPCServiceClient die Methode aufgerufen wurde, bekommt man ein OM-Element zurück. Hierbei handelt es sich um das bereits angesprochene Wrapper-Objekt von AXIOM. Über eine Hilfsmethode der Klasse BeanUtil, ebenfalls Bestandteil von Axis2, lässt sich der Wrapper jedoch wieder sehr leicht in das erwartete Book-Objekt serialisieren.
