Основные сведения о файлах AIR

Adobe AIR 1.0 и более новых версий

Краткое описание работы с файловой системой в AIR и примеры кода можно найти в следующих статьях по быстрому началу работы в центре Adobe Developer Connection:

В Adobe AIR есть классы, используемые для создания, доступа и управления файлами и папками. Они содержатся в пакете flash.filesystem. Ниже указаны способы их применения:

Классы File

Описание

File

Объект File представляет собой путь к файлу или каталогу. Объект File используется для создания указателя на файл или папку для взаимодействия с ними.

FileMode

Класс FileMode определяет строковые константы, которые применяются в параметре fileMode методов open() и openAsync() класса FileStream. Параметр fileMode этих методов определяет доступные действия объекта FileStream при открытии файла, включая запись, чтение, добавление и обновление данных.

FileStream

Объект FileStream открывает файлы для чтения и записи. После создания объекта File, указывающего на новый или существующий файл, этот указатель передается объекту FileStream, чтобы данные в файле можно было открывать и работать с ними.

Некоторые методы класса File имеют как синхронную, так и асинхронную версии:

  • File.copyTo() и File.copyToAsync()

  • File.deleteDirectory() и File.deleteDirectoryAsync()

  • File.deleteFile() и File.deleteFileAsync()

  • File.getDirectoryListing() и File.getDirectoryListingAsync()

  • File.moveTo() и File.moveToAsync()

  • File.moveToTrash() и File.moveToTrashAsync()

Кроме того, операции FileStream могут выполняться синхронно или асинхронно в зависимости от того, каким методом объект FileStream открывает файл: open() или openAsync().

Асинхронные версии позволяют запускать фоновые процессы и отправлять события после их завершения (или в случае ошибки). Во время работы этих асинхронных фоновых процессов может исполняться другой код. Для асинхронных версий операций необходимо настроить функции прослушивателей событий с помощью метода addEventListener() объекта File или FileStream, вызывающего функцию.

Синхронные версии упрощают написание кода, так как он не зависит от прослушивателей событий. Тем не менее, так как вместе с синхронным методом не может исполняться другой код, важные процессы, например визуализация экранных объектов и анимация, могут приостанавливаться.