Die Nutzung von Webservices in der Oracle Datenbank. 11 März 2010

Transkript

1 Die Nutzung von Webservices in der Oracle Datenbank 11 März 2010

2 Agenda Vorstellung Apps Associates Einstieg und Definition Webservice Definition Application Server / Oracle Application Server Oracle Webservices auf Basis von PL/SQL, Java Oracle Webservice mit JDeveloper erstellen Webservice Beispiel Vorstellung SoapUI (Testen des Webservice) Webservice-Aufruf aus der Datenbank (PL/SQL) Die Nutzung von Webservices in der Oracle Datenbank 2

3 Apps Associates Gründung im Jahr 2002 von ehemaligen Mitarbeitern des Oracle Consulting Services Standorte: Boston (USA) Dortmund (Deutschland) Hyderabad (Indien) Weltweit ca. 300 Mitarbeiter Leistungen: Oracle Applications Managed Services Oracle Development Business Intelligence Die Nutzung von Webservices in der Oracle Datenbank 3

4 Einstieg Definition eines Webservices: Stellt grundsätzlich einen Dienst zur Verfügung Identifizierbar über eindeutige URI (Uniform Ressource Identifier) Unabhängig von Plattform & Programmiersprache Nutzung öffentlicher Standards (z.b. HTTP Protokoll) Client stellt Request an Webservice Request & Response in XML Unterschieden werden Header & Payload Informationen Webservice wird durch WSDL-File veröffentlicht Die Nutzung von Webservices in der Oracle Datenbank 4

5 Einstieg Webservice Nutzung öffentlicher Standards XML Datenformat SOAP Protokoll zur Datenübertragung WSDL Webservice definieren UDDI Webservice zur Verfügung stellen Quelle: Die Nutzung von Webservices in der Oracle Datenbank 5

6 Application Server Definition: Server in einem Computernetzwerk, auf dem Anwendungsprogramme ausgeführt werden Quelle: Die Nutzung von Webservices in der Oracle Datenbank 6

7 Application Server Oracle Application Server 10g Anwendungsserver der Firma Oracle Enthält unter anderem eine Implementierung der Java-EE (früher J2EE) Architektur Verwaltung mehrerer Container (OC4J) OC4J Server kleiner Bruder des Oracle Application Servers Lediglich der Java-EE Container ohne Apache-Webserver Hochverfügbarkeit-Features Management-Tools Die Nutzung von Webservices in der Oracle Datenbank 7

8 Oracle Webservice - Basis PL/SQL, Java Aufruf Package UTL_DBWS (seit Version 10g) Package UTL_HTTP Bereitstellen Nutzung der bereits vorhandenen Funktionalität der XML DB (seit Version 11g) Java-Wrapper erstellen und über Application Server veröffentlichen Die Nutzung von Webservices in der Oracle Datenbank 8

9 Oracle Webservice - JDeveloper Oracle JDeveloper Kompatibilität mit Java Developer Kit (JDK) Oracle JDeveloper JDK 5.0 oder 1.5 Version "5.0" Produktversion, "1.5 - Entwicklungsversion Installation von OC4J Server (Version ) Verbindung mit Application Server (Standalone OC4J) Verbindung mit Datenbank Logik (Package, Function) Die Nutzung von Webservices in der Oracle Datenbank 9

10 Webservice Logik Procedure Daten hinzufügen PROCEDURE add_machine ( p_seriennr VARCHAR2, p_produkt VARCHAR2, p_model VARCHAR2, p_standort VARCHAR2, p_stunden NUMBER, p_zustand VARCHAR2, v_return_msg OUT VARCHAR2 ) IS v_id xxapps.xx_machine_ws.id%type; BEGIN insert into xxapps.xx_machine_ws ( ID, SERIENNUMMER, PRODUKT, MODEL, STANDORT, ARBEITSSTUNDEN, ZUSTAND ) values ( XX_MACHINE_WS_SEQ.nextval, p_seriennr, p_produkt, p_model, p_standort, p_stunden, p_zustand ) returning id into v_id; commit; v_return_msg := 'Datensatz erfolgreich angelegt'; END; Die Nutzung von Webservices in der Oracle Datenbank 10

11 Webservice Logik Function Daten abrufen FUNCTION get_machine( p_seriennr IN VARCHAR2 ) RETURN xxapps_machine_rec IS v_machine_found xxapps.xx_machine_ws%rowtype; v_machine_return xxapps_machine_rec; BEGIN SELECT * INTO v_machine_found FROM xxapps.xx_machine_ws WHERE xxapps.xx_machine_ws.seriennummer = p_seriennr; v_machine_return := xxapps_machine_rec( v_machine_found.seriennummer, v_machine_found.produkt, v_machine_found.model, v_machine_found.standort, v_machine_found.arbeitsstunden, v_machine_found.zustand ); RETURN v_machine_return; END; Die Nutzung von Webservices in der Oracle Datenbank 11

12 WSDL (WebService Definition Language) <definitions name="xxapps_adddata_ws" targetnamespace=" xmlns=" xmlns:tns=" xmlns:soap12=" xmlns:mime=" xmlns:tns0=" xmlns:xsd=" xmlns:soap=" > <types> <schema xmlns=" targetnamespace=" elementformdefault="qualified" xmlns:tns=" xmlns:wsdl=" xmlns:xsi=" xmlns:soap11-enc=" <element name="addmachineelement"> <complextype> <sequence> <element name="pseriennr" type="string" nillable="true"/> <element name="pprodukt" type="string" nillable="true"/> [...] Die Nutzung von Webservices in der Oracle Datenbank 12

13 Oracle Webservice Request/Response Procedure Daten hinzufügen Die Nutzung von Webservices in der Oracle Datenbank 13

14 Oracle Webservice Request/Response Function Daten abrufen Die Nutzung von Webservices in der Oracle Datenbank 14

15 Webservice Aufruf aus Datenbank PROCEDURE call_webservice( p_seriennr VARCHAR2, p_produkt VARCHAR2, p_model VARCHAR2, p_standort VARCHAR2, p_stunden NUMBER, p_zustand VARCHAR2 ) IS l_envelope_template VARCHAR2(10000); l_http_req Utl_Http.Req; l_http_resp Utl_Http.Resp; BEGIN BEGIN -- Envelope zum Versenden uber Webservice erstellen l_envelope_template := '<soapenv:envelope xmlns:soapenv=" ' xmlns:typ=" ' <soapenv:header/>' ' <soapenv:body>' ' <typ:addmachineelement>' ' <typ:pseriennr>' p_seriennr '</typ:pseriennr>' ' <typ:pprodukt>' p_produkt '</typ:pprodukt>' ' <typ:pmodel>' p_model '</typ:pmodel>' ' <typ:pstandort>' p_standort '</typ:pstandort>' ' <typ:pstunden>' p_stunden '</typ:pstunden>' ' <typ:pzustand>' p_zustand '</typ:pzustand>' ' </typ:addmachineelement>' ' </soapenv:body>' '</soapenv:envelope>'; END; Die Nutzung von Webservices in der Oracle Datenbank 15

16 Webservice Aufruf aus Datenbank BEGIN -- HTTP Request: Start l_http_req := utl_http.begin_request( url => ' method => 'POST', http_version => 'HTTP/1.1' ); END; BEGIN -- HTTP Request: Header und Envelope schreiben -> Format und Zeichensatz utl_http.set_header( r => l_http_req, name => 'Content-Type', value => 'text/xml;charset=utf-8' ); -- HTTP Request: Header und Envelope schreiben -> Länge angeben utl_http.set_header( r => l_http_req, name => 'Content-Length', value => length(l_envelope_template) ); -- HTTP Request: Header und Envelope schreiben -> SOAPAction definieren utl_http.set_header( r => l_http_req, name => 'SOAPAction', value => 'addmachine' ); Die Nutzung von Webservices in der Oracle Datenbank 16

17 Webservice Aufruf aus Datenbank -- HTTP Request: Header und Envelope schreiben -> Envelope schicken utl_http.write_text( r => l_http_req, data => l_envelope_template ); END; BEGIN -- HTTP Antwort erwarten l_http_resp := utl_http.get_response(l_http_req); -- Antwort lesen --utl_http.read_text( --r => l_http_resp, --data => l_soap_response --); END; BEGIN -- HTTP Verbindung beenden utl_http.end_response( r => l_http_resp ); END; END; Die Nutzung von Webservices in der Oracle Datenbank 17

18 Fragen & Antworten Kontakt: Apps Associates GmbH Flughafenring Dortmund Vielen Dank! Christian Müller: Geschäftsführung David Michel Software Development Download Präsentation Die Nutzung von Webservices in der Oracle Datenbank 18