REST Services To-Go Einfacher Einstieg in die REST Programmierung

Transkript

1 REST Services To-Go Einfacher Einstieg in die REST Programmierung Version 1.0 Seite 1

2 Zur Person Marcus Blum Oracle Forms seit 1994 (Forms 3 / Oracle 6 aufwärts) Fokus auf Oracle APEX seit 2007 (APEX 3.0 aufwärts) Side-Skill: Embedded-Systeme Seite 2

3 Agenda Kurzer Überblick Was ist REST Grundlagen zum Bereitstellen von REST Live-Demo Seite 3

4 Was ist REST? REST := Representational State Transfer ( Roy Fielding, 2000) Webservice (Client <-> Server) Zustandslos Offenes Protokoll, keine Lizenzkosten HTTP Protokoll für Firewalls meist offen Adressierung mittels eindeutigem URL-Pfad z.b. Seite 4

5 Was kann man mit REST anfangen? Bereitstellung einer eigenen Schnittstelle Technischer Datenaustausch mit Kunden / Partnern Kopplung von Systemen Einbinden von Hardware Kassensysteme, Messdatenerfassung, Mobile Devices Anzapfen von Diensten für eigene Zwecke European VAT Number Validation API Seite 5

6 Beispiel: VAT Number Validation Seite 6

7 Wer benutzt REST? Twitter, Wordpress, Linkedin Seite 7

8 REST und die Datenbank Kein proprietärer Treiber nötig Keine Installation, Updates etc. auf Clients nötig Datenverkehr über HTTP(s) Jedes System, das HTTP beherrscht kann REST-Services bedienen (alte oder zukünftige Systeme) Standardport (Firewall) Kapselung (Query unter eigener Kontrolle) Authentifizierung mit OAuth2 Seite 8

9 REST und die Datenbank HTTP-Methoden GET : Retrieve the resource contents. POST : Store a new resource. PUT : Update an existing resource. DELETE : Remove a resource. Seite 9

10 Was ist ORDS Bereitstellen von REST Services (Konsumieren z.b. mit APEX) Lizenzkostenfrei, geht aus APEX hervor (ehemals APEX Listener) Keine Programmierkenntnisse in Java etc. nötig Tabellen und PL/SQL Eigenes Schema (Repository) Nahtlose Integration mit APEX und SQL-Developer Seite 10

11 Was ist ORDS ORDS bietet 2 Möglichkeiten, REST Services zur Verfügung zu stellen: AUTO Rest Keine Programmierung nötig (und auch nicht möglich!) Sehr schnell umsetzbar Selbstdefiniertes REST Beliebig Programmierbar Intensive Einarbeitung Seite 11

12 Was ist ORDS AUTO-Rest Freigabe einer Tabelle Keine(!) Programmierung Standardmethoden und Return Codes (200 = OK, 201 = Created ) WHERE ist implementiert JSON als Rückgabewert { ID" :79, NAME": MILLER" } Seite 12

13 Was ist ORDS Selbstdefinierte REST Services PL/SQL Code, Query freie Programmierung JSON, CSV, XML oder Text als Rückgabe Eigene Status-Codes Seite 13

14 Demo I Seite 14

15 ORDS - Auto Rest ORDS.ENABLE_SCHEMA(p_enabled => TRUE, p_schema => 'SCOTT', p_url_mapping_type => 'BASE_PATH', p_url_mapping_pattern => 'scott', p_auto_rest_auth => FALSE); ORDS.ENABLE_OBJECT(p_enabled p_schema p_object p_object_type p_object_alias p_auto_rest_auth => TRUE, => 'SCOTT', => 'DEPT', => 'TABLE', => 'dept', => FALSE); Beispiel: Seite 15

16 ORDS - Auto Rest SELECT Seite 16

17 ORDS - Auto Rest INSERT POST: Content-Type: application/json Payload: {"empno":79,"ename":"jbond","job":"spy","deptno":10 } Seite 17

18 UPDATE (upsert) ORDS - Auto Rest PUT: Content-Type: application/json Payload : { "empno":76,"ename":"jbond","job":"spy","deptno":11} Seite 18

19 ORDS - Auto Rest DELETE DELETE: Seite 19

20 Demo II Seite 20

21 ORDS - selbstdefinierte REST Methoden ORDS.define_module( p_module_name => 'rest_emp_v01', p_base_path => 'rest_emp_v01/', p_items_per_page => 0); ORDS.define_template( p_module_name p_pattern => 'rest_emp_v01', => 'emp/'); ORDS.define_handler( p_module_name => 'rest_emp_v01', p_pattern => 'emp/', p_method => 'GET', p_source_type => ORDS.source_type_query, p_source => 'SELECT * FROM emp', p_items_per_page => 0); Seite 21

22 ORDS - selbstdefinierte REST Methoden HTTP-Methoden DELETE : Remove a resource. GET : Retrieve the resource contents. POST : Store a new resource. PUT : Update an existing resource. Seite 22

23 Praxistip Debugging einschalten: default.xml <entry key="debug.debugger">true</entry> <entry key="debug.printdebugtoscreen">true</entry> Seite 23

24 Links ORDS Homepage Exzellente Quelle mit Anleitungen Seite 24

25 Danke für Ihr Interesse Königsdorfer Straße Wolfratshausen. Mail: Web: Tel Seite 25