Webservices. Grundlagen, Beispiel, Tomcat, Apache Axis

Transkript

1 Webservices Grundlagen, Beispiel, Tomcat, Apache Axis Pratikum SWE 2 M. Löberbauer, T. Kotzmann, H. Prähofer 1

2 Was ist ein WebService Eine oder mehrere Methoden die über das Netzwerk aufgerufen werden können. Standardisierter Remote Procedure Call (RPC) Parameter und Rückgabewerte werden serialisiert. Nachrichtenbasiert XML Sprachunabhängig Java,.Net, Perl,... Vorteile Zentralisierung - Wartbarkeit Systemunabhängigkeit Standardisiert Entkopplung der Logik und der Darstellung Nachteile Zentralisierung - Verfügbarkeit Aufwand Authentifizierung Pratikum SWE 2 M. Löberbauer, T. Kotzmann, H. Prähofer 2

3 Aufruf eines WebServices Anwendung nutzt WebService Stub, sie kümmert sich nicht darum woher der Stub das Ergebnis hat. WebService Stub verpackt die Anforderung in XML und schickt sie dem Webserver Webserver (z.b.: Tomcat mit AXIS) erkennt die Anfrage und ruft das entsprechende WebService auf (Reflection) Webserver verpackt die Antwort in XML und schickt sie an den Stub Stub entpackt die Antwort und liefert das Ergebnis. Transportschicht Anwendung WebService Stub Webserver WebService Implementierung Pratikum SWE 2 M. Löberbauer, T. Kotzmann, H. Prähofer 3

4 XML XML ist: Extensible Markup Language Inspiriert durch SGML Einfach, flexibel, Textformat Portabel DTD, XML-Schema (XSD) XML is a markup language, and only a markup language. It's important to remember this fact. The XML hype has become so extreme that some people expect XML to do everything up to, and including, washing the family dog. XML In A Nutshell, Eliotte Rusty Harold & W. Scott Means XML ist nicht: Programmiersprache Netzwerkprotokoll Datenbank Pratikum SWE 2 M. Löberbauer, T. Kotzmann, H. Prähofer 4

5 WSDL Web Service Description Language Standard zur Beschreibung von Netzwerkdiensten Service - Adresse - Name Funktionen - Name - Parameter - Rückgabewert Typen - Beschreibung der verwendeten Typen in den Nachrichten Nachrichten - Aufbau der möglichen Nachrichten Plattformunabhängig Programmiersprachenunabhängig XML Pratikum SWE 2 M. Löberbauer, T. Kotzmann, H. Prähofer 5

6 SOAP Simple Object Access Protocol Ziele: Einfach Erweiterbar Leichtgewichtig Repräsentation: XML Standardisiertes Verpackungsprotokoll für Nachrichtenaustausch Entwickelt von: Microsoft IBM DevelopMentor (Don Box) UserLand (Dave Winer) Seit 2000 W3C Spezifikation ( Implementierungen: Apache Axis (früher Apache SOAP) Microsoft.NET Pratikum SWE 2 M. Löberbauer, T. Kotzmann, H. Prähofer 6

7 Beispiel SOAP Nachricht (Anfrage) POST /axis/services/test HTTP/1.0 Content-Type: text/xml; charset=utf-8 User-Agent: Axis/1.1 Header Host: localhost (HTTP & SOAP) SOAPAction: "" Content-Length: <?xml version="1.0" encoding="utf-8"?> <soapenv:envelope SOAP Envelope xmlns:soapenv=" xmlns:xsd=" xmlns:xsi=" instance"> <soapenv:body> SOAP Body <ns1:test soapenv:encodingstyle= " xmlns:ns1="testpack TestPack"/> </soapenv:body> </soapenv:envelope> Pratikum SWE 2 M. Löberbauer, T. Kotzmann, H. Prähofer 7

8 Beispiel SOAP Nachricht (Antwort) HTTP/ OK Content-Type: text/xml;charset=utf-8 Date: Thu, 29 Jan :04:44 GMT Header Server: Apache-Coyote/1.1 (HTTP & SOAP) Connection: close... <?xml version="1.0" encoding="utf-8"?> <soapenv:envelope SOAP Envelope xmlns:soapenv=" xmlns:xsd=" xmlns:xsi=" instance"> <soapenv:body> SOAP Body <ns1:testresponse soapenv:encodingstyle= " xmlns:ns1="testpack"> <testreturn xsi:type="xsd:string">test</testreturn> </ns1:testresponse> </soapenv:body> </soapenv:envelope> Pratikum SWE 2 M. Löberbauer, T. Kotzmann, H. Prähofer 8

9 WebServices in Java Application Server Apache Tomcat Bea Weblogic IBM WebSphere... SOAP Implementierung Apache AXIS IBM Web Service Toolkit Graham Glass GLUE... Axis Servlet1 Servlet2 Tomcat Pratikum SWE 2 M. Löberbauer, T. Kotzmann, H. Prähofer 9

10 Erstellen eines SOAP Beispiels Service Schnittstelle: "Test.java" package TestPack; public interface Test { public String test(); } oder "dummy"-implementierung: "Test.java" package TestPack; public class Test { public String test() { return ""; } } Pratikum SWE 2 M. Löberbauer, T. Kotzmann, H. Prähofer 10

11 Erstellen eines SOAP Beispiels Erstellen der WSDL java org.apache.axis.wsdl.java2wsdl [optionen] Klasse - --output <Name der Zieldatei> - --location <URL des Services> - --namespace <Ziel Namesraum> -... java org.apache.axis.wsdl.java2wsdl --output "Test.wsdl" --location " TestPack.Test xy.java javac xy.class Java2WSDL xy.wsdl Pratikum SWE 2 M. Löberbauer, T. Kotzmann, H. Prähofer 11

12 Erstellen eines SOAP Beispiels Erstellen der Stubs java org.apache.axis.wsdl.wsdl2java [Optionen] WSDL-URI - --server-side - --skeletondeploy <true false> - --output <Zielverzeichnis> java org.apache.axis.wsdl.wsdl2java --server-side --skeletondeploy true --output. Test.wsdl xy.wsdl WSDL2Java Serverseitige Dateien: xy.java, xysoapbindingimpl.java, xysoapbindingskeleton.java Dateien für deploy/undeploy: deploy.wsdd, undeploy.wsdd Clientseitige Dateien: xyservice.java, xyservicelocator.java xysoapbindingstub.java Pratikum SWE 2 M. Löberbauer, T. Kotzmann, H. Prähofer 12

13 Erstellen eines SOAP Beispiels Achtung "xy.java" überschreibt das Original package TestPack; public interface Test { public String test(); } /** * Test.java * * This file was auto-generated from WSDL * by the Apache Axis WSDL2Java emitter. */ package TestPack; public interface Test extends java.rmi.remote { public java.lang.string test() throws java.rmi.remoteexception; } Pratikum SWE 2 M. Löberbauer, T. Kotzmann, H. Prähofer 13

14 Erstellen eines SOAP Beispiels Implementierung in xysoapbindingimpl.java /** * TestSoapBindingImpl.java * * This file was auto-generated from WSDL * by the Apache Axis WSDL2Java emitter. */ package TestPack; public class TestSoapBindingImpl implements TestPack.Test{ public java.lang.string test() throws java.rmi.remoteexception { return null; return "Test"; } } Pratikum SWE 2 M. Löberbauer, T. Kotzmann, H. Prähofer 14

15 Erstellen eines SOAP Beispiels Kompilieren der java Dateien Kopieren von xy.class xysoapbindingimpl.class xysoapbindingskeleton.class nach "%CATALINA_HOME%\webapps\axis\WEB-INF\classes\<Namensraum>" Pratikum SWE 2 M. Löberbauer, T. Kotzmann, H. Prähofer 15

16 Erstellen eines SOAP Beispiels Installieren eines Webservices (deploy) java org.apache.axis.client.adminclient <Deployment Descriptor> java org.apache.axis.client.adminclient deploy.wsdd <deployment xmlns=" xmlns:java=" <service name="test" provider="java:rpc" style="rpc" use="encoded"> <parameter name="wsdltargetnamespace" value="testpack"/> <parameter name="wsdlserviceelement" value="testservice"/> <parameter name="wsdlserviceport" value="test"/> <parameter name="classname" value="testpack.testsoapbindingskeleton"/> <parameter name="wsdlporttype" value="test"/> <parameter name="allowedmethods" value="*"/> </service> </deployment> Pratikum SWE 2 M. Löberbauer, T. Kotzmann, H. Prähofer 16

17 Erstellen eines SOAP Beispiels Anzeigen installierter Services (list): java org.apache.axis.client.adminclient list Komfortabler über Entfernen (undeploy): java org.apache.axis.client.adminclient undeploy.wsdd <undeployment xmlns=" <service name="test"/> </undeployment> Pratikum SWE 2 M. Löberbauer, T. Kotzmann, H. Prähofer 17

18 Erstellen eines SOAP Beispiels Client: import TestPack.Test; import TestPack.TestServiceLocator; import javax.xml.rpc.serviceexception; import java.rmi.remoteexception; public class Client { public static void main(string args[]) throws ServiceException, RemoteException { Test t; TestServiceLocator locator; locator = new TestServiceLocator(); t = locator.gettest(); System.out.println(t.test()); } } Pratikum SWE 2 M. Löberbauer, T. Kotzmann, H. Prähofer 18

19 Ablauf Client: org.apache.axis.client.call org.apache.axis.client.stub java.rmi.remote invoke() TestPack.Test TestPack.TestSoapBindingStub test() org.apache.axis.client.service TestPack.TestService Client gettest() TestPack.TestServiceLocator Pratikum SWE 2 M. Löberbauer, T. Kotzmann, H. Prähofer 19

20 Ablauf Server: org.apache.axis.wsdl.skeleton java.rmi.remote TestPack.Test TestPack.TestSoapBindingImpl TestPack.TestSoapBindingSkeleton test() test() Axis Tomcat Pratikum SWE 2 M. Löberbauer, T. Kotzmann, H. Prähofer 20

21 Überwachen der Client/Server-Kommunikation java org.apache.axis.utils.tcpmon [List. Port] [Targ. Host] [Targ. Port] Anfrage Antwort Pratikum SWE 2 M. Löberbauer, T. Kotzmann, H. Prähofer 21

22 WebService mit.net TestService.asmx: WebService Language="C#" Class="TestService"%> using System.Web.Services; public class TestService : WebService { [WebMethod] public string GetTest() { return "Test"; } } Virtuelles Verzeichnis im IIS anlegen, TestService.asmx ablegen WSDL:.../TestService.asmx?WSDL Testseite:.../TestService.asmx?op=GetTest Pratikum SWE 2 M. Löberbauer, T. Kotzmann, H. Prähofer 22

23 Zusammenfassung Sprachunabhängig Java.NET (C#) XML Zentralisiert Wartbar Verfügbarkeit Logik und Darstellung entkoppelt Pratikum SWE 2 M. Löberbauer, T. Kotzmann, H. Prähofer 23

24 Tomcat 5 Voraussetzungen: Java SDK Version >= 1.3 Umgebungsvariablen - JAVA_HOME=C:\j2sdk1.4.2_02 - CATALINA_HOME=C:\Webservices\jakarta-tomcat Download: Starten: startup - CATALINA_HOME\bin\startup.bat - Linux: CATALINA_HOME/bin/startup.sh Betrieb: Stoppen: shutdown - Windows: CATALINA_HOME\bin\shutdown.bat - Linux: CATALINA_HOME/bin/shutdown.sh Pratikum SWE 2 M. Löberbauer, T. Kotzmann, H. Prähofer 24

25 Apache AXIS 1.1 Voraussetzungen: Java SDK Version >= 1.4 Servlet Container (z.b.: Tomcat) - JavaBeans Activation Framework - Download: Entpacken Kopieren??\Axis-1_1\webapps\axis -> CATALINA_HOME\webapps\??\jaf-1.0.2\activation.jar -> CATALINA_HOME\common\lib\ Umgebungsvariablen AXIS_HOME=c:\Webservices\axis-1_1 AXIS_LIB=%AXIS_HOME%\lib AXISCLASSPATH=%AXIS_LIB%\axis.jar;%AXIS_LIB%\commonsdiscovery.jar;%AXIS_LIB%\commonslogging.jar;%AXIS_LIB%\jaxrpc.jar;%AXIS_LIB%\saaj.jar;%AXIS_LIB%\log4j jar CLASSPATH=%CLASSPATH%;%AXISCLASSPATH% Pratikum SWE 2 M. Löberbauer, T. Kotzmann, H. Prähofer 25

26 Testen der Installation Pratikum SWE 2 M. Löberbauer, T. Kotzmann, H. Prähofer 26