Actionscript 3 Entwicklerhandbuch

ACTIONSCRIPT 3.0 ENTWICKLERHANDBUCH
Verarbeiten von Fehlern
Laufzeitfehler treten beim Ausführen einer Anwendung auf, nachdem diese kompiliert wurde. Es handelt sich dabei
um Fehler, die auftreten, während eine SWF-Datei in einer Flash-Laufzeitumgebung (wie Adobe Flash Player oder
Adobe AIR) wiedergegeben wird. In den meisten Fällen verarbeiten Sie Laufzeitfehler bei ihrem Auftreten, indem
Sie sie an den Benutzer melden und entsprechende Schritte unternehmen, damit die Anwendung dennoch weiter
ausgeführt werden kann. Wenn es sich um einen schwerwiegenden Fehler handelt, etwa wenn keine Verbindungen
mit Websites hergestellt oder erforderliche Daten nicht geladen werden können, ist es mithilfe der
Fehlerverarbeitung möglich, die Anwendung kontrolliert zu beenden.
Synchrone Fehler sind Laufzeitfehler, die gleichzeitig mit dem Aufrufen einer Funktion auftreten, beispielsweise
wenn Sie eine bestimmte Methode verwenden und das übergebene Argument ungültig ist, sodass die Flash-
Laufzeitumgebung eine Ausnahme auslöst. Die meisten Fehler sind synchron, d. h. sie treten zum Zeitpunkt der
Ausführung der Anweisung auf, und die Steuerung geht sofort auf die geeignetste catch-Anweisung über.
Beispielsweise wird mit dem folgenden Codeauszug ein Laufzeitfehler ausgelöst, da die browse()-Methode nicht
aufgerufen wird, bevor das Programm versucht, eine Datei hochzuladen:
var fileRef:FileReference = new FileReference();
try
{
fileRef.upload(new URLRequest("http://www.yourdomain.com/fileupload.cfm"));
}
catch (error:IllegalOperationError)
{
trace(error);
// Error #2037: Functions called in incorrect sequence, or earlier
// call was unsuccessful.
}
In diesem Fall wird ein synchroner Laufzeitfehler ausgelöst, da in Flash Player festgestellt wurde, dass die
browse()-Methode nicht aufgerufen wurde, bevor der Dateiuploadversuch erfolgt ist.
Detaillierte Informationen zur synchronen Fehlerverarbeitung finden Sie unter „Verarbeiten synchroner Fehler in
einer Anwendung“ auf Seite 62.
Asynchrone Fehler sind Laufzeitfehler, die zu verschiedenen Zeitpunkten während der Laufzeit auftreten. Sie lösen
Ereignisse aus, die von Ereignis-Listenern abgefangen werden. Bei einem asynchronen Vorgang initiiert eine
Funktion einen Vorgang, wartet jedoch nicht auf dessen Abschluss. Sie können Fehlerereignis-Listener erstellen,
die überwachen, ob die Anwendung oder der Benutzer einen bestimmten Vorgang ausführt. Wenn dieser Vorgang
fehlschlägt, fangen Sie den Fehler mit dem Ereignis-Listener ab und reagieren auf das Fehlerereignis. Der Ereignis-
Listener ruft dann eine Ereignisprozedurfunktion auf, um auf geeignete Weise auf den Fehler zu reagieren. Mit der
Ereignisprozedur kann beispielsweise ein Dialogfeld angezeigt werden, in dem der Benutzer zum Beheben des
Fehlers aufgefordert wird.
Rufen Sie sich das zuvor vorgestellte Beispiel für einen synchronen Fehler beim Dateiupload in Erinnerung. Wenn
Sie vor dem Start des Dateiuploads die browse()-Methode aufrufen, löst Flash Player verschiedene Ereignisse aus.
Beispielsweise wird beim Start des Uploads das open-Ereignis ausgelöst. Nach dem erfolgreichen Beenden des
Dateiuploads wird das complete-Ereignis ausgelöst. Da die Ereignisverarbeitung asynchron ist (d. h. nicht zu
bestimmten, bekannten Zeitpunkten erfolgt), verwenden Sie zum Warten auf diese Ereignisse die
addEventListener()-Methode, wie im folgenden Code dargestellt:
Letzte Aktualisierung 27.6.2012
57