Skrócone omówienie i przykłady kodu ilustrujące pracę z systemem plików w środowisku AIR zawierają następujące artykuły z serii Quick Start w witrynie Adobe Developer Connection:
Środowisko Adobe AIR udostępnia klasy przeznaczone do uzyskiwania dostępu, tworzenia i zarządzania plikami i folderami. Te klasy, dostępne w pakiecie flash.filesystem, mają następujące zastosowania:
|
Klasy File
|
Opis
|
|
File
|
Obiekt File reprezentuje ścieżkę do pliku lub katalogu. Obiekt File służy do utworzenia wskaźnika do pliku lub folderu, który inicjuje interakcję z plikiem lub folderem.
|
|
FileMode
|
Klasa FileMode definiuje stałe w postaci ciągu znaków używane w parametrze
fileMode
metod
open()
i
openAsync()
klasy FileStream. Parametr
fileMode
tych metod określa możliwości obiektu FileStream po otwarciu pliku, łącznie z odczytem, zapisem, dołączaniem i aktualizacją.
|
|
FileStream
|
Obiekt FileStream służy do otwierania plików do odczytu i zapisu. Po utworzeniu obiektu File, który wskazuje na nowy lub istniejący plik, należy przekazać ten wskaźnik do obiektu FileStream, aby umożliwić otwarcie, a następnie odczytywanie lub zapisywanie danych.
|
Niektóre metody w klasie File mają wersje synchroniczne i asynchroniczne:
-
File.copyTo()
i
File.copyToAsync()
-
File.deleteDirectory()
i
File.deleteDirectoryAsync()
-
File.deleteFile()
i
File.deleteFileAsync()
-
File.getDirectoryListing()
i
File.getDirectoryListingAsync()
-
File.moveTo()
i
File.moveToAsync()
-
File.moveToTrash()
i
File.moveToTrashAsync()
Ponadto operacje FileStream mogą działać synchronicznie lub asynchronicznie w zależności od sposobu, w jaki obiekt FileStream otwiera plik: poprzez wywołanie metody
open()
lub poprzez wywołanie metody
openAsync()
.
Wersje asynchroniczne umożliwiają inicjowanie procesów, które działają w tle, a także wywoływanie zdarzeń po zakończeniu tych procesów (lub w przypadku wystąpienia zdarzeń błędów). Podczas tych asynchronicznych procesów wykonywanych w tle może być wykonywany inny kod. W przypadku asynchronicznych wersji operacji należy skonfigurować funkcje detektora zdarzeń, korzystając w tym celu z metody
addEventListener()
obiektu File lub obiektu FileStream, który wywołuje funkcję.
Wersje synchroniczne umożliwiają pisanie prostszego kodu, który nie jest oparty na konfigurowaniu detektorów zdarzeń. Podczas wykonywania metody synchronicznej nie jest możliwe wykonywanie innego kodu, dlatego istotne procesy, takie jak renderowanie obiektów ekranowych i animacji, mogą zostać opóźnione.
