Actionscript 3 Entwicklerhandbuch

ACTIONSCRIPT 3.0 ENTWICKLERHANDBUCH
Ziehen und Ablegen in AIR
Implementieren der IFilePromise-Schnittstelle
Adobe AIR 2 und höher
Zum Bereitstellen von Dateizusagen für Ressourcen, die sich nicht über ein URLFilePromise-Objekt aufrufen lassen,
können Sie die IFilePromise-Schnittstelle in einer benutzerdefinierten Klasse implementieren. Die IFilePromise-
Schnittstelle definiert die Methoden und Eigenschaften, die die AIR-Laufzeit für den Zugriff auf die Daten verwendet,
die in eine Datei geschrieben werden sollen, wenn die Dateizusage abgelegt wird.
Eine IFilePromise-Implementierung übergibt ein anderes Objekt an die AIR-Laufzeit, das die Daten für die
Dateizusage bereitstellt. Dieses Objekt muss die IDataInput-Schnittstelle implementieren, die von der AIR-Laufzeit
zum Lesen der Daten verwendet wird. Beispielsweise verwendet die URLFilePromise-Klasse, die IFilePromise
implementiert, ein URLStream-Objekt als Datenprovider.
AIR kann die Daten synchron oder asynchron lesen. Die IFilePromise-Implementierung meldet den unterstützten
Zugriffsmodus durch Rückgabe des entsprechenden Wertes in der isAsync-Eigenschaft. Für den asynchronen
Datenzugriff muss das Datenprovider-Objekt die IEventDispatcher-Schnittstelle implementieren und die
erforderlichen Ereignisse auslösen, wie open, progress und complete.
Als Datenprovider für eine Dateizusage können Sie eine benutzerdefinierte Klasse oder eine der folgenden integrierten
Klassen verwenden:
ByteArray (synchron)
FileStream (synchron oder asynchron)
Socket (asynchron)
URLStream (asynchron)
Zum Implementieren der IFilePromise-Schnittstelle müssen Sie Code für die folgenden Funktionen und
Eigenschaften angeben:
open():IDataInput – Gibt das Datenprovider-Objekt zurück, aus dem die Daten für die zugesagte Datei gelesen
werden. Das Objekt muss die IDataInput-Schnittstelle implementieren. Wenn die Daten asynchron bereitgestellt
werden, muss das Objekt auch die IEventDispatcher-Schnittstelle implementieren und die erforderlichen
Ereignisse auslösen (siehe „Verwenden eines asynchronen Datenprovider in einer Dateizusage“ auf Seite 666).
get relativePath():String – Gibt den Pfad, einschließlich des Namens, für die erstellte Datei an. Dieser Pfad
wird relativ zu dem Ablageort aufgelöst, den der Anwender beim Ziehen und Ablegen ausgewählt hat. Um
sicherzustellen, dass der Pfad das passende Trennzeichen für das Host-Betriebssystem verwendet, geben Sie die
File.separator-Konstante an, wenn Sie Pfade festlegen, die Verzeichnisse enthalten. Sie können eine Set-Funktion
hinzufügen oder einen Konstruktorparameter verwenden, damit der Pfad zur Laufzeit festgelegt werden kann.
get isAsync():Boolean – Informiert die AIR-Laufzeit, ob das Datenprovider-Objekt die Daten synchron oder
asynchron bereitstellt.
close():void – Wird von der Laufzeit aufgerufen, wenn die Daten vollständig gelesen wurden (oder wenn ein
Fehler verhindert, dass die Daten weiter gelesen werden können). Diese Funktion kann zur Ressourcenbereinigung
verwendet werden.
reportError( e:ErrorEvent ):void – Wird von der Laufzeit aufgerufen, wenn beim Lesen der Daten ein
Fehler auftritt.
Alle IFilePromise-Methoden werden während einer Drag & Drop-Operation, die die Dateizusage umfasst, von der
Laufzeit aufgerufen. Normalerweise sollte die Anwendungslogik keine dieser Methoden direkt aufrufen.
Letzte Aktualisierung 27.6.2012
664