Menü

Mail Listen Archiv | Code Startseite | Anzeige aller Code Fragmente

4D Code Library

4D Support Center - 4D Code Beispiel zum Thema:

XErr-Modul

Erfaßt von: Maurice Perriard am 01.06.2006 ; -
Letzte Änderung: 28.07.2006

Kurzbeschriebung:

Erweitertes Error-Handling inkl. Aufruf-Folge und Erzeugung eigener Fehler Logging der Aufrufe, zur Laufzeit ein-/ausschaltbar Profiler zur Geschwindigkeitsoptimierung;;;;;;;;

Beschreibung

*** XErr-Modul ***

Aufruf-Folge:
Im Header JEDER Methode (Projekt-, Formular-, Objekt-) muss als erstes ein Aufruf von XErr_RegisterMethod(currentMethodName) stehen. Damit wird die aktuelle Methode im Aufruf-Folge-Stapel gespeichert. Mit einem darauf folgenden Aufruf von XErr_Modified(who_when_what) können Details zur letzten Änderung im Stapel gespeichert werden. Der Befehl XErr_SetLineNumber(lineNumber) ermöglicht die Angabe einer Integer-Zeilennummer (-32768-32767), mit der Methoden in kleinere Einheiten unterteilt werden können. Auf der letzten Zeile JEDER Methode muss schliesslich ein Aufruf von XErr_UnregisterMethod stehen. Damit wird der Stapel beim Verlassen der Methode wieder aufgeräumt.

Eigene Fehler:
Mit der Methode XErr_CallErrorHandler(errorCode; errorDescription) kann der aktuell installierte Error-Handler mit eigenen Fehlern aufgerufen werden.

Temporärer Error-Handler:
Um einen Fehler dort zu behandeln, wo er entsteht und nicht viele spezialisierte Error-Handler schreiben zu müssen, kann ein temporärer Error-Handler eingerichtet werden:
$errorHandler_S:=Method called on error   `Aktuellen Error-Handler speichern
XErr_ResetErrorCodeAndDesc   `Error-Handler zurücksetzen
ON ERR CALL("XErr_ErrorCatcher")   `Temporären Error-Handler aktivieren
   `Gefährliche Aktion ausführen
Case of
   :(XErr_GetErrorCode_mL=999)   `Fehler 999 behandeln
   `...
End case
XErr_ResetErrorCodeAndDesc   `Error-Handler zurücksetzen
ON ERR CALL($errorHandler_S)   `Vorherigen Error-Handler wieder installieren

Logging und Profiling:
Für Debug-Zwecke kann es manchmal sehr nützlich sein, wenn man die Ausführung des Programms loggen kann. Mit XErr_StartLogging können vier Arten von Logs global eingeschaltet werden:
PROFILER: Aktiviert die Zeitmessung. Beim Ausschalten wird das Log in ein Geschwindigkeitsprofil umgewandelt. Das Profil hat die Spalten Methodenname, Aufruf-Häufigkeit, Minimale Zeit, Durchschnittliche Zeit, Maximale Zeit. 
DEBUG_LOG: Mit dieser Option wird ein Debug-Log geschrieben, das gleich aussieht, wie das von 4D erstellte. Es werden aber nur die eigenen Methodenaufrufe mitgeschrieben (und das auch vor 2004.3). 
4D_DEBUG_LOG_BASIC/_DETAILED aktiviert das 4D-Debug-Log (ab 2004.3)
Zum Ausschalten des Loggings wird XErr_StopLogging mit dem entsprechenden Log-Typ als Parameter aufgerufen. 
Diese beiden Methoden können/sollten um eine Auswahl-Möglichkeit erweitert werden. Die entsprechenden Stellen sind im Code auskommentiert, da vermutlich eigene Auswahl-Dialoge bereits vorhanden sind.

Generell:
Die Methoden sind in ihrem Header dokumentiert. Dort sind auch die Parameter beschrieben. 
Es empfiehlt sich, zum Einfügen einer "leeren" Methode (sowie des Headers/Footers in bestehende Methoden) Makros zu machen. 
Zur Geschwindigkeitsoptimierung kann auf das Register/Unregister verzichtet werden. Wenn aus einer solchen Methode andere Methoden aufgerufen werden, kann die Aufruf-Folge allerdings schwer zu lesen sein, weil eine Stufe fehlt. 
"On Startup" und "On Server Startup" muss die Methode XErr_Startup ausgeführt werden.

Dieser Beitrag besteht aus 20 Methoden:
XErr_RegisterMethod(currentMethodName)
XErr_Modified(who_when_version)
XErr_SetLineNumber(lineNumber)
XErr_UnregisterMethod
xerr_InitProcess
XErr_GetErrorCode_mL -> errorCode
XErr_GetErrorDescription_mT -> errorDescription
XErr_GetCallingMethodName_mS -> callingMethodName
XErr_GetCallChain_mT{(delimiter {;mode})} -> callChain
XErr_CallErrorHandler(code; description)
XERR_ErrorHandler
XErr_ResetErrorCodeAndDesc
XErr_ErrorCatcher
XErr_Startup
XErr_InitErrorHandler(Error)
XErr_StartLogging{(logType)}
XErr_StopLogging{(logType)}
xerr_CompileProfile
compiler_xerr
XArr_FindInSortedArray_mL(arrPtr;valuePtr {;startIndex{;returnInsertIndex{;insertAscending}}}) -> elementIndex

Beschreibung ändern (nur für Autor - Kennwort geschützt) Keine Beschreibung für XErr-Modul

4D Code Beispiel

Anhang laden (7377 Bytes).

Hinweis: der Anhang wurde von 4D nicht getestet noch auf Funktion oder Viren überprüft.
Wir empfehlen als Anhang ausschließlich das .zip Format zu verwenden, das Sie vor dem Öffnen selbst mit einem aktuellen Viren-Scanner überprüfen sollten. Wir raten vom Öffnen von anderen Formaten ab.

Code ändern (nur für Autor - Kennwort geschützt)

Zurück

When the solution matters

International Sites

4D Produkte

Referenzen

Corporate

Support

Vertrieb

Menü

4D Code Library