Podstawowe informacje o plikach AIR

Adobe AIR 1.0 i wersje późniejsze

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:

Budowanie edytora plików tekstowych (Flash)
Budowanie edytora plików tekstowych (Flex)
Budowanie aplikacji przeszukiwania katalogów (Flex)
Zapis i odczyt w pliku/z pliku XML preferencji (Flex)
Kompresowanie plików i danych (Flex)

Ś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 manipulowanie danymi w pliku.

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 i dlatego istotne procesy, takie jak renderowanie obiektów wyświetlanych i animacji, mogą zostać wstrzymane.