PL/SQL-Code mit APEX generieren

Transkript

1 PL/SQL-Code mit APEX generieren DOAG-Webinar am Andreas Wismann WHEN OTHERS Beratung Programmierung Coaching rund um Oracle Application Express

2 Einstieg PL/SQL-Programme oft strukturell identisch Zeitintensive Codierung Fehlerquellen automatisieren?

3 Die Zutaten EXCEPTION-Handling Autonome Transaktion Object Types Pipelined Functions APEX Collections plsqldoc (JavaDoc)

4 Was soll generiert werden?

5

6

7

8 Der Quellcode enthält Einen Kommentarblock Eine Methoden-Initialisierung mit Parameter-Logging Einen NULL-Befehl, damit der Code kompiliert Einen Exception-Handler, der im Fehlerfall alle geloggten Parameter in eine Tabelle schreibt Saubere Formatierung und Einrückung

9 Exkurs: Der Editor PL/SQL Developer noformat-kommentare schützen den Quelltext vor Beautifier-Umformatierung plsqldoc-plugin erzeugt die technische Dokumentation Beispiel

10 plsqldoc /** * Nimmt die vollständige Signatur einer Methode entgegen und liefert eine * typisierte Methodendefinition zurück, wenn ein eingegebene Text syntaktisch * korrekt war und erfolgreich analysiert werden konnte. * i_method_signature IN VARCHAR2 * Im Erfolgsfall eine Variable vom Typ t_method, die alle Bestandteile * der Methode enthält, bei Misserfolg NULL. Wird von der APEX-Applikation aufgerufen. * */

11 Parameter-Logging PL/SQL bietet keinen generischen Ansatz zum Auslesen der Werte von Function/Procedure- Parametern Durch Code-Generierung wird dieses Feature bequem "simuliert" Im Fehlerfall können die Inhalte aller Parameter in eine Tabelle geschrieben werden

12 Parameter-Logging c_paramlist CONSTANT LOGS.LOGS_PARAMLIST%TYPE := 'i_param_1=' i_param_1 chr(10) 'i_param_2=' to_date(i_param_2, 'DD.MM.YYYY HH24:MI:SS'); i_param_1=beitragsrückerstattung i_param_2= :00:00

13 Parameter-Logging to_char existiert nicht für alle Datentypen (z.b. BOOLEAN) daher für diverse Datentypen passenden Code generieren lassen CASE i_boolean WHEN TRUE then 'TRUE' WHEN FALSE then 'FALSE' ELSE 'NULL' END to_char(i_date, 'YYYY.MM.DD HH24:MI:SS')

14 Parameter-Logging Für Objekttypen: eigene to_string-methode schreiben. Namenskonvention ist Hinweis auf Objekttyp: versende_rechnung (i_rechnung T_RECHNUNG) v_parametername := CASE WHEN v_method_parameter.p_type = 'OBJECT' THEN v_method_parameter.p_name '.to_string()' ELSE v_method_parameter.p_name -- "normale" Datentypen END;

15 Exception Handling Entweder überhaupt keins oder: konsistent und überall Fachliche Fehler abfangen (z.b. WHEN NO_DATA_FOUND THEN RETURN NULL;) Technische Fehler hochgeben (z.b. WHEN OTHERS THEN RAISE;)

16 EXCEPTION HANDLING EXCEPTION WHEN OTHERS THEN -- den Fehlerzustand aufzeichnen: logger.error( i_unit => c_unit,i_paramlist => c_paramlist,i_line => $$PLSQL_LINE,i_action => v_action,i_comment => NULL -- ergänzen ); -- und das Problem nach "oben" weiterreichen: RAISE;

17 Dies wird im Fehlerfall notiert

18 Autonome Transaktion PROCEDURE log ( ) IS PRAGMA AUTONOMOUS TRANSACTION; BEGIN INSERT INTO LOGS ( ) VALUES ( ); COMMIT; EXCEPTION WHEN OTHERS THEN ROLLBACK; RAISE; END;

19 Autonome Transaktion Zum Sichern der aufgezeichnteten Parameter Muss entweder "committen" oder "rollbacken" unabhängig vom sonstigen Programmablauf Debugging Tracing ("Mitschreiben") während der Entwicklung zu beliebigen Zwecken

20 Package "LOGGER" logger.trace Loglevel 0 logger.info Loglevel 1 logger.debug Loglevel 2 logger.warning Loglevel 3 logger.error Loglevel 4 logger.fatal Loglevel 5

21 Fehler-Logging nicht explizit codieren, was implizit verfügbar ist! SQLCODE SQLERRM v('app_session') v('app_id') v('app_page_id') v('request') dbms_utility.format_error_backtrace() dbms_utility.format_call_stack()

22 $$PLSQL_UNIT Name der aktuell ausgeführten Standalone- Funktion bzw. -Prozedur oder Name der aktuell ausgeführten Package (dann jedoch nicht inklusive des Methoden- Namens!) dbms_output.put_line($$plsql_unit);

23 $$PLSQL_LINE Zeilennummer des aktuell ausgeführten Befehls im Quelltext auch in anonymen Blöcken definiert dbms_output.put_line($$plsql_line);

24 APEX Collection speichert alle im Formular eingegebenen Funktions- bzw. Prozedurparameter beliebig viele Zeilen ("Member") benannt: "METHOD_PARAMETERS"

25 create_collection_from_query select * from apex_collections

26 Tabular Forms-Benutzereingaben C001 C002 C003 C049 C050 N001 N005 D001 D005 BLOB001 CLOB001 XMLTYPE001

27 Literaturempfehlungen Kurzübersicht Konzepte, Befehle und Parameter anschauliche Beispiele 7,40

28 Literaturempfehlungen Der Klassiker von Steven Feuerstein & Bill Prybil > 1200 Seiten auch auf deutsch 43,95

29 Lesetipp Expert Oracle Application Express behandelt APEX 4 ausführlicher Teil zu Tabular Forms gute Einführung zu APEX-Collections Charts, Dynamic Actions, Plugins u.v.m.

30 Andreas Wismann WHEN OTHERS Beratung Programmierung Coaching rund um Oracle Application Express