Web-Services Implementierung

Transkript

1 Web-Services Implementierung Praktikum Informationsintegration Agenda Aktueller Stand / Abgabe Implementierung Wie geht das mit Java und Tomcat? Service Client 2

2 Abgabe Teil 1 Ein paar Zahlen 29 in Goya eingetragen 24 Suchmaschinen in Liste 22 Suchmaschinen beschrieben 19 in Liste mit Ergebnisschema 22 Abgaben Davon eine leer Erstes Fazit Schwund ist immer Abgabe hat doch ganz gut geklappt Rechtzeitig anfangen ist immer eine gute Idee Details nächste Woche 3 Implementierung Diverse Toolkits, die helfen AXIS (Apache) JWSDP (Sun) ETTK (IBM) Anbindung an Servlet-Container Hier: Tomcat 4

3 Aufrufarten 1) Nutzer Browser Dienst Anwendung Einkaufsnachricht Ergebnisnachricht MHS Suchservice Suchmaschine Index 2) Nutzer Browser Dienst Anwendung Methodenaufruf Ergebnis zurückgeben RPC Suchservice Schnittstelle Index 5 4 Möglichkeiten RPC Interface und Implementierung aus WSDL generieren Service dynamisch erzeugen Methode aufrufen Ergebnis bekommen, Antwort interpretieren Java Interface definieren Implementierung erstellen Deployment Deskriptor erstellen WSDL, WAR-Datei automatisch generieren Tomcat bekanntgeben Technologien: JAX-RPC, SAAJ Nachrichten basiert Client erstellen SOAP-Nachricht erstellen Verbindung zu Port aufbauen SOAP-Nachricht schicken SOAP-Antwort empfangen, Antwort interpretieren Servlet erstellen WSDL erstellen Tomcat bekanntgeben Technologien: JAXM, JAXB, SAAJ Client, Aufruf Server 6

4 RPC: Überblick Selber machen generiert Bild aus: J2EE Tutorial, java.sun.com Zur Verfügung gestellt (Tomcat und JWSDP) 7 Web-Services in Tomcat HTTP-Server/Tomcat Java-Interface + Java-Klasse Automatische Generierung Client Methodenaufruf (RPC) WSDL JSP- Servlet HTTP HTML Suchmaschine Index 8

5 Implementierung Verwendete Techniken Java Java Web Service Development Pack Sun Microsystems Ist installiert Pfade? Skripte? 9 Pfadstruktur /local/huugle/wrapper/<suchmaschine>/ WEB-INF/ src/ lib/ build/ build.xml web.xml jaxrpc-ri.xml index.html ws_client.sh run_client.sh Web-Service-Dateien Quellen Web-Service Zusätzliche Bibliotheken WAR-Archiv Web-Service (temporär) Ant Build-Skript Service-Beschreibung Vorlage Deployment-Descriptor Infoseite Skript zur Erstellung des Client Skript zum Ausführen des Client 10

6 Anpassen web.xml Name der Suchmaschine, Beschreibung jaxrpc-ri.xml Endpoint Endpoint-Mapping build.xml Eigentlich nichts, evtl. Pfade, shell Alle drei Dateien liegen schon in den Verzeichnissen! 11 Web-Service: Schnittstelle package mac; import java.rmi.remote; import java.rmi.remoteexception; public interface HelloServiceIF extends Remote { public String sayhello(string name) throws RemoteException; } //end of interface In <suchmaschine>/src anlegen (auf package achten ) 12

7 Web-Service: Implementierung package mac; import java.rmi.remoteexception; public class HelloServiceImpl implements HelloServiceIF { public String sayhello(string name) throws RemoteException { return "Guten Tag, "+name+"!"; } //end of sayhello } //end of class In <suchmaschine>/src anlegen (auf package achten ) 13 web.xml <?xml version="1.0" encoding="utf-8"?> <!DOCTYPE web-app PUBLIC "-//Sun Microsystems, Inc.//DTD Web Application 2.3//EN" " <web-app> <display-name>hallo Webservice</display-name> <description> Ein WebService (JAX-RPC) der Guten Tag sagt </description> <session-config> <session-timeout>60</session-timeout> </session-config> </web-app> 14

8 jaxrpc-ri.xml <?xml version="1.0" encoding="utf-8"?> <webservices xmlns=" version="1.0" targetnamespacebase=" typenamespacebase=" urlpatternbase="/ws"> <endpoint name="hello" displayname="hello Service" description="einfacher Hello Service fuers Praktikum" interface="mac.helloserviceif" implementation="mac.helloserviceimpl"/> <endpointmapping endpointname="hello" urlpattern="/hello"/> </webservices> 15 Ablauf (1) Wo ist was installiert? /opt/jwsdp-1.6/ Für zu Hause Eclipse Web Tools Platform (WTP) Project Rüstet Eclipse auf, ähnlich ehemals IBM WSAD tools für developing J2EE Web applications HTML, XML, WSDL, Web service wizard, uvm. Tutorials, Hilfe

9 Ablauf (2) Dateien anlegen, Klassen schreiben /local/huugle/wrapper/<suchmaschine>/src/ mit ant kompilieren Nutzt build.xml, kompiliert Klassen Erstellt WSDL und WAR-Archiv in /build Dann nur noch WAR-Archiv in /WEB-INF entpacken 17 Ablauf (3) Web-Service Infos ansehen 18

10 Ablauf (4) WSDL anzeigen public String sayhello(string) 19 SSH Tunnel Tunnel legen Z.B. von zu Hause oder aus dem WLAN Über amsel/star/ Auf Mangold Port forwarding Genauso für Ssh Port 22 (SVN) Anleitung Im Wiki 20

11 Web-Services Implementierung Client Web-Services in Tomcat HTTP-Server/Tomcat Java-Interface + Java-Klasse Automatische Generierung Client Methodenaufruf (RPC) WSDL JSP- Servlet HTTP HTML Suchmaschine Index 22

12 Vorgehen - Übersicht Infos über Service besorgen URL, aus Liste 3 Möglichkeiten Static stubs Dynamic proxys Dynamic invocation interface Interface Definition besorgen Z.B. WSDL, erfragen, selbst erstellen 23 Web-Service-Informationen 24

13 Web-Service-Informationen WSDL anzeigen public String sayhello(string) 25 4 Möglichkeiten RPC Interface und Implementierung aus WSDL generieren Service dynamisch erzeugen Methode aufrufen Ergebnis bekommen, Antwort interpretieren Nachrichten basiert Client erstellen SOAP-Nachricht erstellen Verbindung zu Port aufbauen SOAP-Nachricht schicken SOAP-Antwort empfangen, Antwort interpretieren Client, Aufruf Java Interface definieren Implementierung erstellen Deployment Deskriptor erstellen WSDL, WAR-Datei automatisch generieren Tomcat bekanntgeben Technologien: JAX-RPC, SAAJ Servlet erstellen WSDL erstellen Tomcat bekanntgeben Technologien: JAXM, JAXB, SAAJ Server 26

14 Web-Service Client (1) package client; import java.net.url; import javax.xml.rpc.service; import javax.xml.rpc.servicefactory; import javax.xml.namespace.qname; import mac.helloserviceif; public class HelloClient { public static void main(string args[]) throws Exception { URL wsdlurl = new URL(" String wsdlnamespace = " String servicename = "Hello"; String portname = "HelloServiceIFPort"; 27 Web-Service-Informationen wsdlurl wsdlnamespace servicename portname Java-Interface 28

15 Web-Service Client (2) ServiceFactory sf = ServiceFactory.newInstance(); Service s = sf.createservice( wsdlurl, new QName(wsdlNamespace, servicename)); HelloServiceIF client = (HelloServiceIF)s.getPort( new QName(wsdlNamespace, portname), HelloServiceIF.class); String antwort = client.sayhello("jens"); System.out.println("Antwort = "+antwort); } //end of main } //end of class 29 Vorgehen (1) Java Klasse in src/ erstellen Auf package achten! Kompilieren ws_client.sh Achtung: Setzt Klassenpfad Aus <suchmaschine>/ 30

16 Vorgehen (2) HelloServiceIF Muss vorhanden sein Anhand WSDL selber schreiben Service-Betreiber fragen In Klassenpfad, auf package achten! HelloClient testen run_client.sh Achtung: Setzt Klassenpfad Aus <suchmaschine>/ 31 Interface SearchEngineWrapper // Set the proxy parameter public void setproxy(string proxyhost, String proxyport); // Get name/id of search engine that is queried public String getsearchengineid(); // true: everything ok, // false: only dummy, but gives back deterministic and useful results public boolean isworkingproperly(); // if already working properly: // true: service can be used as search engine can be reached // false: temporarily out of service public boolean isavailable(); 32

17 Interface SearchEngineWrapper /** * Queries the search engine. Takes a query object, extracts the information * from it, translates it to the format the search engibe requires and sends * a search request to the engine. Parses the result page, extracts the * information, packs it into a ResultSet object and gives it back. * q the query the answer, the results */ public ResultSet query(query q); Query/Result: nächste Woche genauer Nach Sichtung der Abgaben Für diese Woche: leere Klasse ok 33 Ausblick Diese Woche Rumpf-Service implementieren Soll laufen, ansprechbar sein Abgabe Sonntag: Rumpf-Webservice mit URL Test Skript, spricht alle mal an Nächsten Wochen Implementierung der Funktionalität Wie mappe ich die Sprache der Metasuchmaschine auf die Sprache der eigenen? Sonstige Funktionalität 34

18 Ausblick Nächste Woche: Feedback Teil 1 Fragen, Diskussion Query/Result Abgabetermin: Rumpf-Web-Service Fragen? 35