Anzeige des Java Error Stack in Oracle Forms

Anzeige des Java Error Stack in Oracle Forms (Version 2.0) Juni 2008 Autoren: Jürgen Menge / Thomas Robert Seite 1 von 7

Oracle Forms bietet seit der Version 6i die Möglichkeit, serverseitig Java-Klassen zu importieren und über einen automatisch generierten PL/SQL-Wrapper Klassen-Methoden aus der Anwendungslogik der Form aufzurufen. Dieses Verfahren eignet sich zum Beispiel für: den Aufruf eigener Java-Klassen die Einbindung von Java APIs (Mail, BPEL, BI Publisher) den Aufruf von Web Services. Hat man die Form erfolgreich entwickelt, steht man jedoch vor einer größeren Hürde. In der Laufzeit-Umgebung müssen alle referenzierten Klassen im CLASSPATH angegeben sein. Anderenfalls stellt die Anwendung mit einer... raised unhandled exception ORA-105100 bzw.... raised unhandled exception ORA-105101 ihren Dienst ein, wenn der fragliche Java-Code aufgerufen wird. Wie kann man nun erfahren, welche Klassen bzw. welche Archive für eine erfolgreiche Ausführung fehlen? Duncan Mills und Jan Carlin haben in ihren Blogs ein Verfahren beschrieben, wie die Java- Fehlermeldungen (Java Error Stack) in der Form angezeigt werden können: http://groundside.com/blog/duncanmills.php?title=exception_handling_in_forms_java_integra&more=1&c=1&tb=1&pb=1 http://groundside.com/blog/jancarlin.php?title=extracting_a_stack_trace_from_a_java_exc&more=1&c=1&tb=1&pb=1 Allerdings musste der Beispiel-Code modifiziert werden, damit die Fehler tatsächlich sichtbar wurden und nicht die nächste Unhandled Exception bei der Aufbereitung des Fehlertextes auftrat. Die folgenden Erläuterungen beziehen sich auf Oracle Forms ab der Version 9.0.4. Für die Version Forms 9.0.2 wird eine Modifikation des Codes im letzten Abschnitt beschrieben. Seite 2 von 7

Anzeige des Java Error Stack (ab Forms 9.0.4) Hier kurz zusammengefasst die notwendigen Schritte: 1. Aufruf des Forms Builder Die zu importierenden Klassen müssen sich im CLASSPATH des Forms Builder befinden. Hierzu gibt es zwei Wege: Erweiterung des Registry-Schlüssels FORMS_BUILDER_CLASSPATH Aufruf des Forms Builders aus einem Script und Setzen der Umgebungs-variable FORMS_BUILDER_CLASSPATH unmittelbar vor dem Aufruf. Das folgende Script soll als Beispiel dienen: set FORMS_BUILDER_CLASSPATH=C:\ora_ods_1012\jdk\jre\lib\rt.jar;C:\ora_ods_1012\forms\java\frmbld.jar;C:\o ra_ods_1012jlib\importer.jar;c:\ora_ods_1012\jlib\debugger.jar;c:\ora_ods_1012\jlib\utj.jar;c:\ora_ods_1012\jlib\d fc.jar;c:\ora_ods_1012\jlib\help4.jar;c:\ora_ods_1012\jlib\oracle_ice.jar;c:\ora_ods_1012\jlib\jewt4.jar;c:\ora_ods _1012\jlib\ewt3.jar;C:\ora_ods_1012\jlib\share.jar;C:\ora_ods_1012\forms\java\frmwebutil.jar;C:\ora_ods_1012\for ms\java\frmall.jar;c:\ora_ods_1012\soap\lib\soap.jar;c:\jdev10132\webservices\lib\wsclient.jar;c:\ora_ods_1012\f orms\demos\jars\formsgraph.jar C:\ora_ods_1012\bin\frmbld.exe Neben den Klassen, die man direkt verwenden will, brauchen wir für die Fehleranzeige die Klassen: java.lang.exception java.lang.stacktraceelement Beide befinden sich in der Datei rt.jar im Oracle Home der Oracle Developer Suite (OH\jdk\jre\lib). 2. Import der benötigten Klassen in die Form Dazu rufen wir aus dem Menü des Forms Builders über Program => Import Java Classes... den Java Importer auf und importieren: die Klassen, die wir direkt aufrufen wollen java.lang.exception java.lang.stacktraceelement Die beiden Klassen können direkt in das Textfeld Import Classes eingegeben werden. Seite 3 von 7

Vor dem Import müssen im Java Importer die Optionen Include inherited methods/fields Include get/set for public Fields aktiviert werden. Befinden sich die Klassen nicht im FORMS_BUILDER_CLASSPATH, treten beim Import Fehler auf. 3. Schreiben der Anwendungslogik Für alle importierten Klassen wird jeweils ein PL/SQL-Package generiert. In der Form können nun Methoden der importierten Klasse aufgerufen werden, indem die entsprechenden PL/SQL Procedures bzw. Functions in der Programmlogik (Trigger, Program Units) verwendet werden. Seite 4 von 7

4. Einbau des Exception Handlers zur Anzeige der Fehlermeldungen Folgender Programmcode muss im Trigger bzw. der Program Unit eingefügt werden, in dem Methoden der importierten Klasse aufgerufen werden. < A n w e n d u n g s l o g i k > exception --check for ORA-105100 when ORA_JAVA.JAVA_ERROR then message('unable to call out to Java, ' ORA_JAVA.LAST_ERROR); --check for ORA-105101 when ORA_JAVA.EXCEPTION_THROWN then raisedexception := exception_.new(ora_java.last_exception); begin :control.excep := 'Exception: ' Exception_.toString(raisedException); exception when ORA_JAVA.JAVA_ERROR then message('unable to call out to Java, ' ORA_JAVA.LAST_ERROR); end; --Get an array of StackTraceElement from the Exception stack_trace:=exception_.getstacktrace(raisedexception); --Loop over all the Elements for i in 0..ora_java.get_array_length(stack_trace) loop --Get each Element stacktrcelement:=ora_java.get_object_array_element(stack_trace, i); --Make a string out of it and add it to the error field :control.excep:=:control.excep (10) stacktraceelement.tostring(stacktrcelement); end loop; ORA_JAVA.CLEAR_EXCEPTION; when OTHERS then message('problem!'); end; Die hervorgehobenen Zeilen machen den Unterschied zu den genannten Blogs deutlich. Die innere Exception fängt Fehler ab, die beim Aufruf der Methode Exception_.troString auftreten können. Zur Anzeige der Fehlermeldungen wird ein mehrzeiliges Textfeld im Control-Block angelegt (CONTROL.EXCEP). 5. Festlegen einer Konfiguration und eines Environment Files Für den Test ist es zweckmäßig in der Datei formsweb.cfg eine benannte Konfiguration einzurichten und dieser eine eigene Environment-Datei zuzuordnen. [webservice] envfile=webservice.env... Seite 5 von 7

In der Environment-Datei müssen in der Umgebungsvariable CLASSPATH alle Verzeichnisse bzw. jar-archive mit den benötigten Klassen aufgelistet sein. 6. Testen der Form auf Basis der festgelegtenkonfiguration Aufruf der Form im Browser mit der festglegten Konfiguration http://<host>:<port>/forms/frmservlet?config=webservice&... Beim Auführen von Methoden der importierten Klasse werden auftretende Fehler im Textfeld angezeigt. In den meisten Fällen wird eine Class not found -Meldung darauf hinweisen, dass im CLASSPATH noch Einträge fehlen. Zur Laufzeit kann der CLASSPATH in der Environment-Datei jederzeit erweitert werden, ohne den OC4J für Forms neu zu starten. Lediglich die Form muss beendet und neu aufgerufen werden. So ist ein relativ rasches Arbeiten möglich, um alle benötigten Klassen zu finden und im CLASSPATH festzulegen. Seite 6 von 7

Anzeige des Java Error Stack (Forms 9.0.2) Da Oracle Forms 9.0.2 mit Java 1.3 ausgeliefert wird, steht für die Klasse Exception kein Konstruktor zur Verfügung, dem die originale Exception übergeben werden kann. In diesem Fall sollte man anstelle von java.lang.exception die Klasse java.lang.throwable importieren. Man kann jetzt im Code des Exception Handling (Schritt 4) die Zeile: raisedexception := exception_.new(ora_java.last_exception); durch message(throwable.tostring(ora_java.last_exception)); oder durch :control.excep := 'Exception: ' throwable.tostring(ora_java.last_exception); ersetzen. Die Verwendung von Throwable anstelle von Exception hat folgende Auswirkungen: es werden auch Fehler sichtbar, die keine Exception auslösen es kann nur der Fehler, nicht aber der komplette Stack Trace ausgegeben werden. Seite 7 von 7