Главная / Action Script 3
(Только AIR)
Пакетflash.data
Классpublic class SQLConnection
НаследованиеSQLConnection Inheritance EventDispatcher Inheritance Object

Язык версии : ActionScript 3.0
Версии среды выполнения:  1.0

Экземпляр SQLConnection используется для управления созданием файлов локальной базы данных SQL (локальных баз данных) и подключением к ним.

Для создания или открытия файла локальной базы данных SQL используется метод open() или openAsync(). Если файл базы данных отсутствует, с помощью этих методов его можно создать при открытии подключения (необязательно). После того как подключение к базе данных будет создано, можно создавать и выполнять инструкции SQL в базе данных,.создав экземпляр SQLStatement и назначив экземпляр SQLConnection свойству sqlConnection объекта SQLStatement.

Класс SQLConnection также предоставляет состояние для инструкций SQL, включая механизм выполнения нескольких инструкций в одной транзакции с помощью методов begin(), commit() и rollback().

Кроме того, класс SQLConnection обеспечивает доступ к сведениям о схемах подключенных баз данных. Схема базы данных содержит определения ее таблиц, столбцов, индексов и триггеров. Дополнительные сведения см. в описании метода loadSchema().

Наконец, экземпляр SQLConnection может использоваться для получения уведомлений о событиях уровня базы данных и контроля всех аспектов конфигурации базы данных, включая размер страниц кэша, параметры отмены обработки и выполнения инструкций.

Экземпляр SQLConnection работает в одном или двух отдельных режимах выполнения: асинхронном и синхронном. Для синхронного выполнения при подключении к главной базе данных экземпляра SQLConnection нужно использовать метод open(). Для асинхронного выполнения при подключении к главной базе данных экземпляра подключения нужно использовать метод openAsync().

При асинхронном выполнении для определения завершения или сбоя операции используются прослушиватели или экземпляр Responder. Операции выполняются не в основном, а в фоновом потоке приложения, поэтому оно будет продолжать работать и взаимодействовать с пользователем даже во время выполнения операций с базой данных.

При асинхронном режиме выполнения сначала с помощью соответствующего метода вызывается определенная операция, а для определения ее завершения (или сбоя) необходимо зарегистрировать прослушиватель соответствующего события. Каждой операции соответствует событие, которое отправляется при ее успешном завершении. Например, если метод openAsync() завершается успешно (если открыто подключение базы данных), отправляется событие open. При сбое какой-либо операции отправляется событие error. Экземпляр SQLError в свойстве error объекта SQLErrorEvent содержит сведения об определенной ошибке, включая выполняемую операцию и причину ее сбоя.

При синхронном выполнении для определения завершения или сбоя операции не нужно регистрировать прослушиватели событий. Чтобы определить ошибки, заключите инструкции, которые их вызывают, в блоки try..catch. Из-за того что синхронные операции выполняются в основном потоке, при выполнении одной или нескольких операций с базой данных все функции приложения (включая обновление экрана и возможность работы с мышью и клавиатурой) приостанавливаются. Продолжительные операции могут привести к заметной остановке работы приложения.

См. также

flash.data.SQLStatement
flash.events.SQLEvent
flash.events.SQLErrorEvent
flash.errors.SQLError


Общедоступные свойства
 СвойствоОпределено
  AIR-only autoCompact : Boolean
[только для чтения] Указывает, было ли включено автоматическое сжатие при создании текущей базы данных (значение параметра autoCompact, указанное при вызове метода open() или openAsync(), с помощью которого была создана база данных).
SQLConnection
  AIR-only cacheSize : uint
Обеспечивает доступ к величине размера кэша данного подключения. Эта величина — максимальное количество дисковых страниц базы данных, которые могут одновременно находиться в памяти.
SQLConnection
  AIR-only columnNameStyle : String
Указывает, в каком виде имена столбцов представлены в результате выполнения инструкции SELECT.
SQLConnection
  AIR-only connected : Boolean
[только для чтения] Указывает, имеет ли экземпляр SQLConnection открытое подключение к файлу базы данных.
SQLConnection
 Inheritedconstructor : Object
Ссылка на объект класса или функцию конструктора для данного экземпляра объекта.
Object
  AIR-only inTransaction : Boolean
[только для чтения] Указывает, используется ли это подключение транзакциями в данный момент.
SQLConnection
  AIR-only lastInsertRowID : Number
[только для чтения] Последний идентификатор строки, созданный инструкцией SQL INSERT.
SQLConnection
  AIR-only pageSize : uint
[только для чтения] Указывает размер страницы базы данных (в байтах), заданный при создании текущей базы данных (значение параметра pageSize, указанное при вызове метода open() или openAsync(), с помощью которого была создана база данных).
SQLConnection
 Inheritedprototype : Object
[статические] Ссылка на модель объекта класса или функции.
Object
  AIR-only totalChanges : Number
[только для чтения] Содержит общее число изменений данных, выполненных с момента открытия подключения к базе данных.
SQLConnection
Общедоступные методы
 МетодОпределено
  
Создает экземпляр SQLConnection.
SQLConnection
  
AIR-only addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Регистрирует объект прослушивателя события в объекте EventDispatcher, в результате чего прослушиватель будет получать уведомления о событиях.
SQLConnection
  
AIR-only analyze(resourceName:String = null, responder:Responder = null):void
Собирает статистику об индексах базы данных и сохраняет ее в базе данных.
SQLConnection
  
AIR-only attach(name:String, reference:Object = null, responder:Responder = null):void
Добавляет новую базу данных в экземпляр SQLConnection, присваивая ей заданное имя.
SQLConnection
  
AIR-only begin(option:String = null, responder:Responder = null):void
Начинает транзакцию, в рамках которой в отношении базы данных подключения или сгруппированных баз данных выполняются инструкции SQL.
SQLConnection
  
AIR-only cancel(responder:Responder = null):void
Прерывает все инструкции SQL, выполняемые в текущий момент в базах данных, подключенных к экземпляру SQLConnection.
SQLConnection
  
AIR-only close(responder:Responder = null):void
Закрывает текущее подключение базы данных.
SQLConnection
  
AIR-only commit(responder:Responder = null):void
Фиксирует существующую транзакцию, в результате чего все действия, выполненные ее инструкциями, применяются к базе данных окончательно.
SQLConnection
  
AIR-only compact(responder:Responder = null):void
Освобождает все неиспользуемое место в базе данных.
SQLConnection
  
AIR-only deanalyze(responder:Responder = null):void
Удаляет все статистические данные, созданные методом analyze().
SQLConnection
  
AIR-only detach(name:String, responder:Responder = null):void
Отсоединяет дополнительную базу данных, ранее подключенную к экземпляру SQLConnection с помощью метода attach().
SQLConnection
 Inherited
Передает событие в поток событий.
EventDispatcher
  
Обеспечивает доступ к результату вызова метода loadSchema().
SQLConnection
 Inherited
Проверяет наличие у объекта EventDispatcher прослушивателей событий, которые зарегистрированы для получения уведомлений о событиях определенного типа.
EventDispatcher
 Inherited
Показывает, определено ли заданное свойство для объекта.
Object
 Inherited
Показывает, есть ли экземпляр класса Object в цепи прототипов объекта, заданного в качестве параметра.
Object
  
AIR-only loadSchema(type:Class = null, name:String = null, database:String = "main", includeColumnSchema:Boolean = true, responder:Responder = null):void
Загружает сведения о схеме данных из присоединенной или любой подключенной базы данных.
SQLConnection
  
AIR-only open(reference:Object = null, openMode:String = "create", autoCompact:Boolean = false, pageSize:int = 1024):void
Открывает подключение к файлу базы данных с заданным местоположением в файловой системе, создает и открывает новый файл базы данных с заданным местоположением или создает и открывает базу данных в оперативной памяти.
SQLConnection
  
AIR-only openAsync(reference:Object = null, openMode:String = "create", responder:Responder = null, autoCompact:Boolean = false, pageSize:int = 1024):void
Открывает подключение к файлу базы данных с заданным местоположением в файловой системе, создает и открывает новый файл базы данных с заданным местоположением или создает и открывает базу данных в оперативной памяти.
SQLConnection
 Inherited
Показывает наличие заданного свойства и его перечисляемость.
Object
  
AIR-only removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void
Удаляет прослушиватель из объекта EventDispatcher.
SQLConnection
  
AIR-only rollback(responder:Responder = null):void
Выполняет откат существующей транзакции, созданной с помощью метода begin(), то есть все изменения, внесенные любыми инструкциями SQL в рамках данной транзакции, отменяются.
SQLConnection
 Inherited
Задает доступность динамического свойства для операций цикла.
Object
 Inherited
Возвращает строковое представление заданного объекта.
Object
 Inherited
Возвращает элементарное значение заданного объекта.
Object
 Inherited
Проверяет, зарегистрирован ли прослушиватель событий в объекте EventDispatcher или в любом из его предков для получения уведомлений о событиях определенного типа.
EventDispatcher
События
 Событие Сводка Определено
 Inherited[многоадресное событие] Отправляется, когда проигрыватель Flash Player перемещается в фокус операционной системы и становится активным.EventDispatcher
  Отправляется при успешном завершении операции analyze().SQLConnection
  Отправляется при успешном вызове метода attach().SQLConnection
  Отправляется при успешном вызове метода begin().SQLConnection
  Отправляется при успешном вызове метода cancel().SQLConnection
  Отправляется при успешном вызове метода close().SQLConnection
  Отправляется при успешном вызове метода commit().SQLConnection
  Отправляется при успешном вызове метода compact().SQLConnection
 Inherited[многоадресное событие] Отправляется, когда проигрыватель Flash Player покидает фокус операционной системы и становится неактивным.EventDispatcher
  Отправляется при успешном вызове метода deanalyze().SQLConnection
  Отправляется при изменении данных в любой таблице любой подключенной базы данных в результате выполнения команды SQL DELETE.SQLConnection
  Отправляется при успешном вызове метода detach().SQLConnection
  Отправляется, если любая из асинхронных операций объекта SQLConnection вызывает ошибку.SQLConnection
  Отправляется при изменении данных в любой таблице любой подключенной базы данных в результате выполнения команды SQL INSERT.SQLConnection
  Отправляется при успешном вызове метода openAsync().SQLConnection
  Отправляется при успешном вызове метода rollback().SQLConnection
  Отправляется при успешном вызове метода loadSchema() и готовности результатов схемы.SQLConnection
  Отправляется при изменении данных в любой таблице любой подключенной базы данных в результате выполнения команды SQL UPDATE.SQLConnection
Сведения о свойстве
AIR-only autoCompactсвойство
autoCompact:Boolean  [только для чтения]

Язык версии : ActionScript 3.0
Версии среды выполнения:  1.0

Указывает, было ли включено автоматическое сжатие при создании текущей базы данных (значение параметра autoCompact, указанное при вызове метода open() или openAsync(), с помощью которого была создана база данных). Если это свойство имеет значение true, неиспользуемое место автоматически удаляется из базы данных после каждой операции записи, тем самым уменьшая размер файла базы данных. Если это свойство имеет значение false, место, занимаемое данными до удаления, остается в базе данных и при необходимости используется повторно. Даже если свойство autoCompact имеет значение false, с помощью метода compact() можно выполнить принудительное восстановление неиспользуемого места.

Если свойство connected имеет значение false, это свойство имеет значение false.



Реализация
    public function get autoCompact():Boolean

См. также

AIR-only cacheSizeсвойство 
cacheSize:uint  [чтение и запись]

Язык версии : ActionScript 3.0
Версии среды выполнения:  1.0

Обеспечивает доступ к величине размера кэша данного подключения. Эта величина — максимальное количество дисковых страниц базы данных, которые могут одновременно находиться в памяти. Каждая страница использует около 1,5 КБ памяти (в зависимости от значения параметра pageSize, указанного при вызове метода open() или openAsync(), с помощью которого была создана база данных). Размер кэша по умолчанию равен 2000. Если в приложении выполняются операции UPDATE или DELETE, которые изменяют большое количество строк в базе данных, увеличив размер кэша, можно ускорить работу за счет повышенного потребления памяти.



Реализация
    public function get cacheSize():uint
    public function set cacheSize(value:uint):void

Выдает
IllegalOperationError — Если осуществляется попытка задать это свойство, когда экземпляр SQLConnection не подключен к базе данных (свойство connected имеет значение false), или если в текущий момент открыта транзакция (свойство inTransaction имеет значение true).

См. также

AIR-only columnNameStyleсвойство 
columnNameStyle:String  [чтение и запись]

Язык версии : ActionScript 3.0
Версии среды выполнения:  1.0

Указывает, в каком виде имена столбцов представлены в результате выполнения инструкции SELECT.

Константы, определенные в классе SQLColumnNameStyle, представляют собой возможные значения данного свойства:



Реализация
    public function get columnNameStyle():String
    public function set columnNameStyle(value:String):void

Выдает
IllegalOperationError — Если предпринимается попытка задать это свойство, когда экземпляр SQLConnection не подключен к базе данных (свойство connected имеет значение false).

См. также

AIR-only connectedсвойство 
connected:Boolean  [только для чтения]

Язык версии : ActionScript 3.0
Версии среды выполнения:  1.0

Указывает, имеет ли экземпляр SQLConnection открытое подключение к файлу базы данных.



Реализация
    public function get connected():Boolean

См. также

AIR-only inTransactionсвойство 
inTransaction:Boolean  [только для чтения]

Язык версии : ActionScript 3.0
Версии среды выполнения:  1.0

Указывает, используется ли это подключение транзакциями в данный момент.



Реализация
    public function get inTransaction():Boolean

См. также

AIR-only lastInsertRowIDсвойство 
lastInsertRowID:Number  [только для чтения]

Язык версии : ActionScript 3.0
Версии среды выполнения:  1.0

Последний идентификатор строки, созданный инструкцией SQL INSERT. Уникальный идентификатор строки в таблице, используемый для поиска в базе данных. Это значение часто генерируется базой данных.

Значение равно нулю, если ни одна база данных не подключена или не выполнено ни одной инструкции INSERT.

Идентификатор строки для однократного выполнения инструкции SQL INSERT можно получить через свойство lastInsertRowID объекта SQLResult, возвращенного методом getResult() объекта SQLStatement (когда он вызывается после отправки объектом SQLStatement события result).

Дополнительные сведения о первичных ключах и генерируемых идентификаторах строк см. в разделах "CREATE TABLE" и "Выражения" приложения "Поддержка SQL в локальных базах данных".



Реализация
    public function get lastInsertRowID():Number

См. также

AIR-only pageSizeсвойство 
pageSize:uint  [только для чтения]

Язык версии : ActionScript 3.0
Версии среды выполнения:  1.0

Указывает размер страницы базы данных (в байтах), заданный при создании текущей базы данных (значение параметра pageSize, указанное при вызове метода open() или openAsync(), с помощью которого была создана база данных).

Если свойство connected имеет значение false, это значение данного свойства равно 0.

Размер страницы базы данных можно менять (с помощью методов open() или openAsync()), пока в базе данных не будет создана первая таблица.



Реализация
    public function get pageSize():uint

См. также

AIR-only totalChangesсвойство 
totalChanges:Number  [только для чтения]

Язык версии : ActionScript 3.0
Версии среды выполнения:  1.0

Содержит общее число изменений данных, выполненных с момента открытия подключения к базе данных. Кроме отслеживания изменений, сделанных с помощью инструкций INSERT, DELETE и UPDATE, это значение включает изменения, вызванные триггерами.

При закрытии подключения к базе данных это значение сбрасывается в 0. Когда экземпляр SQLConnection не подключен к файлу базы данных, значение равно 0.



Реализация
    public function get totalChanges():Number

См. также

Сведения о конструкторе
AIR-only SQLConnection()Конструктор
public function SQLConnection()

Язык версии : ActionScript 3.0
Версии среды выполнения:  1.0

Создает экземпляр SQLConnection.


Выдает
SecurityError — если конструктор вызывается из какой-либо "песочницы" за пределами главной "песочницы" приложения.
Сведения о методе
AIR-only addEventListener()метод
override public function addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void

Язык версии : ActionScript 3.0
Версии среды выполнения:  1.0

Регистрирует объект прослушивателя события в объекте EventDispatcher, в результате чего прослушиватель будет получать уведомления о событиях. Регистрировать прослушиватели событий можно во всех узлах списка отображения для определенного типа события, фазы и приоритета.

После успешной регистрации прослушивателя событий нельзя изменить его приоритет путем дополнительных вызовов метода addEventListener(). Чтобы изменить приоритет прослушивателя, необходимо сначала вызвать метод removeListener(). Затем можно зарегистрировать прослушиватель еще раз с новым уровнем приоритета.

Следует учесть, что после регистрации прослушивателя последующие вызовы метода addEventListener() с другим значением свойства type или useCapture приводят к регистрации другого прослушивателя. Например, если сначала был зарегистрирован прослушиватель со свойством useCapture в значении true, он прослушивает события только в фазе захвата. Если вызвать метод addEventListener() еще раз с тем же объектом прослушивателя, но со свойством useCapture в значении false, то будет два прослушивателя: один — прослушивающий в фазе захвата, а другой — в фазах назначения и восходящей цепочки.

Нельзя зарегистрировать прослушиватель событий только для фазы цели или только для фазы пузырей. Эти фазы объединяются при регистрации, так как фаза пузырей применяется только к предкам целевого узла.

Если прослушиватель событий больше не нужен, его можно удалить, вызвав метод removeEventListener(); иначе могут возникнуть проблемы с памятью. Объекты с зарегистрированным прослушивателями событий не очищаются из памяти автоматически, так как сборщик мусора не удаляет объекты, на которые есть ссылки.

Копирование экземпляра EventDispatcher не приведет к копированию всех присоединенных к нему прослушивателей событий. (Если для вновь созданного узла требуется прослушиватель событий, его необходимо добавить после создания узла.) Однако если экземпляр EventDispatcher перемещается, все зарегистрированные для него прослушиватели событий перемещаются вместе с ним.

Если прослушиватель регистрируется для узла в тот момент, когда на нем обрабатывается событие, то в текущей фазе он не запускается, однако может запуститься в следующей фазе потока события, например в фазе пузырей.

Если прослушиватель событий удаляется из узла в момент обработки события, он все равно запускается текущими действиями. После удаления прослушиватель событий больше не вызывается (если не будет снова зарегистрирован для дальнейшей обработки).

Параметры

type:String — Тип события.
 
listener:Function — Функция прослушивателя, обрабатывающая событие. Эта функция должна принимать объект Event в качестве единственного параметра и не должна что-либо возвращать, как показано в примере:

function(evt:Event):void

У этой функции может быть любое имя.

 
useCapture:Boolean (default = false) — Определяет, работает ли прослушиватель в фазе захвата или в фазах цели и пузырей. Если параметр useCapture имеет значение true, прослушиватель обрабатывает событие только в фазе захвата, а в фазе цели и пузырей не работает. Если параметр useCapture имеет значение false, прослушиватель обрабатывает событие только в фазе цели или пузырей. Чтобы прослушивать событие во всех трех фазах, метод addEventListener необходимо вызвать дважды: первый раз с параметром useCapture в значении true, а второй — с параметром useCapture в значении false.
 
priority:int (default = 0) — Уровень приоритета прослушивателя событий. Приоритет определяется 32-разрядным целым числом со знаком. Чем больше число, тем выше приоритет. Все прослушиватели событий с приоритетом n обрабатываются перед прослушивателями с приоритетом n-1. Если у двух или более прослушивателей одинаковый приоритет, они обрабатываются в порядке добавления. Значение приоритета по умолчанию равно 0.
 
useWeakReference:Boolean (default = false) — Определяет сильную или слабую степень ссылки на прослушиватель. Сильная ссылка (по умолчанию) запрещает прослушивателю выполнять сборку мусора. Слабая ссылка не препятствует этому.

Функции элементов на уровне класса не подвергаются очистке при сборке мусора, поэтому параметр useWeakReference может иметь значение true для функций элементов на уровне класса, не опасаясь их очистке. Если параметру useWeakReference присвоить значение true для прослушивателя, который является вложенной внутренней функцией, то он будет очищен и перестанет быть постоянным. Если создаются ссылки на внутреннюю функцию (путем ее сохранения в другой переменной), то она не будет очищаться и останется постоянной.

AIR-only analyze()метод 
public function analyze(resourceName:String = null, responder:Responder = null):void

Язык версии : ActionScript 3.0
Версии среды выполнения:  1.0

Собирает статистику об индексах базы данных и сохраняет ее в базе данных. Статистика может использоваться оптимизатором запросов (той частью ядра СУБД, которая определяет самый эффективный способ выполнения каждой инструкции). Статистика помогает оптимизатору запросов лучшим образом выбрать один или несколько индексов при выполнении определенного запроса.

Если в базе данных определены индексы, но метод analyze() не вызван, среда выполнения все равно будет использовать их при выполнении инструкции. Но без дополнительных статистических данных, которые формируются с помощью метода analyze(), среда выполнения может выбрать не самый эффективный индекс для определенного запроса.

При изменении данных таблицы (в результате выполнения инструкций INSERT, UPDATE или DELETE) изменяются также и индексы, связанные с этой таблицей. Статистические данные, которые формируются с помощью метода analyze(), не обновляются автоматически. Следовательно, после большого числа изменений данных может быть полезным повторный вызов метода analyze(). Однако польза, полученная от вызова метода analyze(), зависит от нескольких факторов, включая число индексов в таблице, соотношение числа измененных строк и общего числа строк в таблице, степень изменения проиндексированных данных таблицы и того, насколько измененные данные отличаются от ранее измененных данных.

Параметр resourceName указывает, выполняется ли операция для индексов всех подключенных баз данных, определенной базы данных или определенной таблицы.

Каждый раз при вызове данного метода все ранее созданные статистические данные стираются и повторно создаются для базы данных или таблицы, указанной в параметре resourceName (или для всех таблиц всех подключенных баз данных, если параметр resourceName имеет значение null). Этот метод можно вызывать в любое время, пока открыто подключение базы данных. Операция analyze() и ее статистические данные не включаются в транзакцию. Несмотря на это, не рекомендуется вызывать метод analyze(), если в данный момент в базе данных открыта транзакция (свойство inTransaction имеет значение true). Это связано с тем, что при вызове метода analyze() не учитываются любые изменения данных, схем таблиц или индексов, которые были выполнены в транзакции, но еще не были зафиксированы, следовательно, на момент фиксации транзакции данные метода analyze() будут устаревшими.

Для удаления статистических данных, созданных с помощью метода analyze(), используется метод deanalyze().

Параметры

resourceName:String (default = null) — Имя базы данных или таблицы, индексы которых требуется проанализировать. Если указанный ресурс является таблицей, которая имеет уникальное среди всех подключенных баз данных имя, необходимо указать только имя таблицы. Тем не менее, чтобы избежать неоднозначности, если имя таблицы окажется неуникальным, его можно указать в виде [database-name].[table-name]. Если параметр resourceName имеет значение null (по умолчанию), анализируются все индексы подключенных баз данных.
 
responder:Responder (default = null) — Объект, для которого определены методы, вызываемые при успешном выполнении или сбое операции. В асинхронном режиме выполнения, если аргумент responder имеет значение null, по окончании выполнения отправляется событие analyze или error.


События
analyze:SQLEvent — Отправляется после успешного завершения операции.
 
error:SQLErrorEvent — Отправляется после сбоя операции в асинхронном режиме выполнения.

Выдает
IllegalOperationError — Если данный метод вызывается, когда экземпляр SQLConnection не подключен к базе данных (свойство connected имеет значение false).
 
SQLError — если произошел сбой операции в синхронном режиме выполнения.

См. также

AIR-only attach()метод 
public function attach(name:String, reference:Object = null, responder:Responder = null):void

Язык версии : ActionScript 3.0
Версии среды выполнения:  1.0

Добавляет новую базу данных в экземпляр SQLConnection, присваивая ей заданное имя. Подключение базы данных позволяет использовать ее в инструкциях SQL, выполняемых применительно к экземпляру SQLConnection.

Если база данных уже подключена с использованием заданного имени, вызов метода attach() приведет к отправке события error. Тем не менее, одну и ту же базу данных можно подключить несколько раз, используя уникальные имена. К одному экземпляру SQLConnection можно подключить не более 10 баз данных.

Любая инструкция SQL может быть выполнена применительно к базе данных, подключенной с помощью метода attach(). Этот метод вызывается для главной базы данных (базы данных, которая подключена с помощью метода open() или openAsync()). Инструкция SQL может обращаться к таблицам в любых базах данных, которые подключены к экземпляру SQLConnection, связанному с данной инструкцией. Также возможно обращение одной инструкции к таблицам из нескольких баз данных. Когда среда выполнения анализирует имена таблиц в инструкции, она осуществляет поиск по базам данных экземпляра SQLConnection в порядке их подключения, начиная с базы данных, которая была подключена с помощью метода open() или openAsync(). Чтобы в явном виде указать имя таблицы, в инструкции нужно использовать имя базы данных (как указано в передаваемом в метод attach() параметре name).

Для удаления базы данных, подключенной с помощью метода attach(), используется метод detach(). При закрытии экземпляра SQLConnection (с помощью метода close()) все подключенные базы данных отсоединяются.

Подключенная база данных использует тот же режим выполнения (синхронный или асинхронный), что и главная, в зависимости от метода, с помощью которого была подключена главная база данных open() или openAsync().

Параметры

name:String — Имя, используемое для определения только что подключенной базы данных. Это имя можно использовать в инструкциях SQL, чтобы в явном виде указать принадлежность таблицы определенной базе данных в формате [database-name].[table-name]. Имена main и temp зарезервированы и не могут использоваться.
 
reference:Object (default = null) — Ссылка на подключаемый файл базы данных (экземпляр flash.filesystem.File). Если ссылка ссылается на отсутствующий файл, то создается новый файл базы данных или генерируется ошибка в зависимости от значения, указанного в параметре openMode при вызове метода open() или openAsync() для подключения главной базы данных.

Если параметр имеет значение null, то создается и подключается база данных в оперативной памяти.

 
responder:Responder (default = null) — Объект, для которого определены методы, вызываемые при успешном выполнении или сбое операции. При асинхронном режиме выполнения, если аргумент responder имеет значение null, по окончании выполнения отправляется событие attach или error.


События
attach:SQLEvent — Отправляется после успешного завершения операции.
 
error:SQLErrorEvent — Отправляется после сбоя операции в асинхронном режиме выполнения.

Выдает
ArgumentError — Если параметр name является пустой строкой ("") или имеет значение null, или если значение параметра reference не является экземпляром flash.filesystem.File.
 
IllegalOperationError — Если экземпляр SQLConnection не подключен к базе данных (свойство connected имеет значение false), или если в данный момент открыта транзакция (свойство inTransaction имеет значение true).
 
SQLError — если произошел сбой операции в синхронном режиме выполнения.

См. также

AIR-only begin()метод 
public function begin(option:String = null, responder:Responder = null):void

Язык версии : ActionScript 3.0
Версии среды выполнения:  1.0

Начинает транзакцию, в рамках которой в отношении базы данных подключения или сгруппированных баз данных выполняются инструкции SQL.

По умолчанию каждая инструкция SQL выполняется в рамках своей транзакции, которая завершается после успешного выполнения или сбоя инструкции. При создании транзакции с помощью метода begin() создается новая ручная транзакция. После этого все инструкции SQL, выполненные применительно к экземпляру SQLConnection, находятся внутри транзакции, поэтому все действия и изменения, которые ими выполнены, можно зафиксировать (сделать постоянными) или откатить (отменить) не по одному, а только все одновременно.

Вложенные транзакции запрещены (вложенные вызовы метода begin() игнорируются). Для завершения транзакции используется метод commit() или rollback() в зависимости от того, что необходимо сделать с изменениями, сделанными инструкциями из транзакции: сделать их постоянными или отменить.

В транзакции могут быть как инструкции, выполняемые в одной базе данных, так и инструкции, выполняемые в различных подключенных базах данных.

Параметры

option:String (default = null) — Указывает стратегию блокировки, используемую данной транзакцией. Может принимать значение одной из констант, определенных в классе SQLTransactionLockType:
  • SQLTransactionLockType.DEFERRED обозначает, что блокировка не выполняется до первой операции чтения или записи.
  • SQLTransactionLockType.EXCLUSIVE обозначает, что блокировка выполняется при первой возможности, при этом другие экземпляры подключения SQLConnection не осуществлять в базе данных операции чтения и записи.
  • SQLTransactionLockType.IMMEDIATE обозначает, что блокировка выполняется при первой возможности, при этом другие экземпляры SQLConnection смогут осуществлять операции чтения из базы данных, но не смогут осуществлять операции записи.

Значение по умолчанию (null) эквивалентно константе SQLTransactionLockType.DEFERRED.

 
responder:Responder (default = null) — Объект, для которого определены методы, вызываемые при успешном выполнении или сбое операции. При асинхронном режиме выполнения, если аргумент responder имеет значение null, по окончании выполнения отправляется событие begin или error.


События
begin:SQLEvent — Отправляется после завершения операции.
 
error:SQLErrorEvent — Отправляется после сбоя операции в асинхронном режиме выполнения.

Выдает
IllegalOperationError — Если данный метод вызывается, когда экземпляр SQLConnection не подключен к базе данных (свойство connected имеет значение false).
 
ArgumentError — Если указанный параметр не является одной из констант класса SQLTransactionLockType.
 
SQLError — если произошел сбой операции в синхронном режиме выполнения.

См. также

AIR-only cancel()метод 
public function cancel(responder:Responder = null):void

Язык версии : ActionScript 3.0
Версии среды выполнения:  1.0

Прерывает все инструкции SQL, выполняемые в текущий момент в базах данных, подключенных к данному экземпляру SQLConnection. Этот метод используется для завершения продолжительных или вышедших из-под контроля запросов.

Если в момент вызова метода cancel() выполняются инструкции, этот метод прерывает их выполнение и выполняет откат всех незавершенных обновлений или транзакций. Если в текущий момент нет выполняемых инструкций, этот метод выполняет откат открытой транзакции, в противном случае ничего не происходит.

Параметры

responder:Responder (default = null) — Объект, для которого определены методы, вызываемые при успешном выполнении или сбое операции. При асинхронном режиме выполнения, если аргумент responder имеет значение null, по окончании выполнения отправляется событие cancel или error.


События
cancel:SQLEvent — Отправляется после успешного завершения операции.
 
error:SQLErrorEvent — Отправляется после сбоя операции в асинхронном режиме выполнения.

Выдает
IllegalOperationError — Если этот метод вызван, когда экземпляр SQLConnection не подключен к базе данных (свойство connected имеет значение false).
 
SQLError — Если произошел сбой операции в синхронном режиме выполнения.

См. также

AIR-only close()метод 
public function close(responder:Responder = null):void

Язык версии : ActionScript 3.0
Версии среды выполнения:  1.0

Закрывает текущее подключение базы данных. Также происходит отсоединение всех подключенных баз данных.

Если во время вызова метода close() есть открытая транзакция, она фиксируется. При очистке экземпляра SQLConnection среда выполнения автоматически вызывает метод close(), включая те случаи, когда приложение AIR закрыто, а экземпляр SQLConnection по-прежнему подключен к базе данных.

Параметры

responder:Responder (default = null) — Объект, для которого определены методы, вызываемые при успешном выполнении или сбое операции. При асинхронном режиме выполнения, если аргумент responder имеет значение null, по окончании выполнения отправляется событие close или error.


События
close:SQLEvent — Отправляется после успешного завершения операции.
 
error:SQLErrorEvent — Отправляется после сбоя операции в асинхронном режиме выполнения.

Выдает
SQLError — Если произошел сбой операции в синхронном режиме выполнения.
AIR-only commit()метод 
public function commit(responder:Responder = null):void

Язык версии : ActionScript 3.0
Версии среды выполнения:  1.0

Фиксирует существующую транзакцию, в результате чего все действия, выполненные ее инструкциями, применяются к базе данных окончательно.

Параметры

responder:Responder (default = null) — Объект, для которого определены методы, вызываемые при успешном выполнении или сбое операции. При асинхронном режиме выполнения, если аргумент responder имеет значение null, по окончании выполнения отправляется событие commit или error.


События
commit:SQLEvent — Отправляется после успешного завершения операции.
 
error:SQLErrorEvent — Отправляется после сбойного завершения операции.

Выдает
IllegalOperationError — Если экземпляр SQLConnection не подключен к базе данных (свойство connected имеет значение false), или если в данный момент нет открытых транзакций (свойство inTransaction имеет значение false).

См. также

AIR-only compact()метод 
public function compact(responder:Responder = null):void

Язык версии : ActionScript 3.0
Версии среды выполнения:  1.0

Освобождает все неиспользуемое место в базе данных. После удаления объекта (таблицы, индекса или триггера) из базы данных остается пустое место. Из-за этого файл базы данных становится больше, чем необходимо, но операции INSERT выполняются быстрее. Со временем из-за операций INSERT и DELETE структура файла базы данных становится фрагментированной, из-за чего замедляется доступ к содержимому базы данных. Данный метод сжимает файл базы данных, уничтожая пустые страницы и располагая данные таблиц без разрывов, а в противном случае — очищает структуру файла базы данных.

Операцию compact() нельзя выполнить применительно к файлу подключенной базы данных, а только к файлу главной (исходной) базы данных, который открыт с помощью экземпляра SQLConnection. Эта операция завершается сбоем, если есть активная транзакция, и не выполняет никаких действий применительно к базе данных, которая хранится в оперативной памяти.

Параметры

responder:Responder (default = null) — Объект, для которого определены методы, вызываемые при успешном выполнении или сбое операции. При асинхронном режиме выполнения, если аргумент responder имеет значение null, по окончании выполнения отправляется событие compact или error.


События
compact:SQLEvent — Отправляется после успешного завершения операции.
 
error:SQLErrorEvent — Отправляется после сбоя операции в асинхронном режиме выполнения.

Выдает
IllegalOperationError — Если экземпляр SQLConnection не подключен к базе данных (свойство connected имеет значение false), или если в данный момент открыта транзакция (свойство inTransaction имеет значение true).
 
SQLError — Если произошел сбой операции в синхронном режиме выполнения.
AIR-only deanalyze()метод 
public function deanalyze(responder:Responder = null):void

Язык версии : ActionScript 3.0
Версии среды выполнения:  1.0

Удаляет все статистические данные, созданные методом analyze().

Так как статистика, создаваемая методом analyze(), занимает место в базе данных, с помощью вызова метода deanalyze() можно его освободить, например после удаления некоторых индексов или таблиц.

Данная операция не включена в активную транзакцию.

Параметры

responder:Responder (default = null) — Объект, для которого определены методы, вызываемые при успешном выполнении или сбое операции. При асинхронном режиме выполнения, если аргумент responder имеет значение null, по окончании выполнения отправляется событие deanalyze или error.


События
deanalyze:SQLEvent — Отправляется после успешного завершения операции.
 
error:SQLErrorEvent — Отправляется после сбоя операции в асинхронном режиме выполнения.

Выдает
IllegalOperationError — Если этот метод вызван, когда экземпляр SQLConnection не подключен к базе данных (свойство connected имеет значение false).
 
SQLError — Если произошел сбой операции в синхронном режиме выполнения.

См. также

AIR-only detach()метод 
public function detach(name:String, responder:Responder = null):void

Язык версии : ActionScript 3.0
Версии среды выполнения:  1.0

Отсоединяет дополнительную базу данных, ранее подключенную к экземпляру SQLConnection с помощью метода attach(). Один и тот же файл базы данных может быть подключен несколько раз под разными именами, поэтому, если отсоединить одно подключение, остальные продолжат работать. Базу данных нельзя отсоединить, если в ней открыта транзакция (если свойство inTransaction имеет значение true).

Параметры

name:String — Заданное имя отсоединяемой базы данных.
 
responder:Responder (default = null) — Объект, для которого определены методы, вызываемые при успешном выполнении или сбое операции. При асинхронном режиме выполнения, если аргумент responder имеет значение null, по окончании выполнения отправляется событие detach или error.


События
detach:SQLEvent — Отправляется после успешного завершения операции.
 
error:SQLErrorEvent — Отправляется после сбоя операции в асинхронном режиме выполнения.

Выдает
ArgumentError — Если аргумент name имеет значение null или содержит пустую строку ("").
 
IllegalOperationError — Если этот метод вызван, когда экземпляр SQLConnection не подключен к базе данных (свойство connected имеет значение false) или в рамках экземпляра подключения SQLConnection открыта транзакция (свойство inTransaction имеет значение true).
 
SQLError — Если произошел сбой операции в синхронном режиме выполнения.

См. также

AIR-only getSchemaResult()метод 
public function getSchemaResult():SQLSchemaResult

Язык версии : ActionScript 3.0
Версии среды выполнения:  1.0

Обеспечивает доступ к результату вызова метода loadSchema(). Метод getSchemaResult() работает как очередь результатов с порядком доступа к элементам "первым поступил — первым обслужен" (FIFO, First In — First Out). Каждый раз после завершения вызова метода loadSchema() (каждый раз, когда в асинхронном режиме выполнения отправляется событие schema) в очередь добавляется новый объект SQLSchemaResult. Каждый раз при вызове метода getSchemaResult() возвращается и удаляется из очереди самый первый результат (тот, который был добавлен в очередь первым). Если в очереди не осталось объектов, метод getSchemaResult() возвращает null.

Если подключение базы данных закрыто, метод возвращает null.

Возвращает
SQLSchemaResult

См. также

AIR-only loadSchema()метод 
public function loadSchema(type:Class = null, name:String = null, database:String = "main", includeColumnSchema:Boolean = true, responder:Responder = null):void

Язык версии : ActionScript 3.0
Версии среды выполнения:  1.0

Загружает сведения о схеме данных из присоединенной или любой подключенной базы данных. Схема данных отражает структуру таблиц, столбцов, индексов и триггеров базы данных.

Для обращения к загруженной схеме данных используется метод SQLConnection.getSchemaResult().

В асинхронном режиме выполнения событие schema отправляется в случае успешного завершения операции. В случае сбоя операции отправляется событие error.

Сочетание значений параметров type и name определяет тип данных схемы, создаваемой с помощью метода loadSchema(), а следовательно, и значения свойств создаваемого экземпляра SQLSchemaResult. В нижеприведенной таблице перечислены допустимые пары аргументов type и name и формируемые в результате данные схемы:

аргумент typeаргумент nameОбъекты, для которых извлекаются данные схемы:
nullnullвсе объекты базы данных (все таблицы, представления, триггеры и индексы)
SQLIndexSchemanullвсе индексы базы данных
SQLIndexSchemaдопустимое имя таблицывсе индексы, определенные для заданной таблицы
SQLIndexSchemaдопустимое имя индексазаданный индекс
SQLTableSchemanullвсе таблицы базы данных
SQLTableSchemaдопустимое имя таблицызаданная таблица
SQLTriggerSchemanullвсе триггеры базы данных
SQLTriggerSchemaдопустимое имя таблицывсе триггеры, связанные с заданной таблицей
SQLTriggerSchemaдопустимое имя представлениявсе триггеры, связанные с заданным представлением
SQLTriggerSchemaдопустимое имя триггеразаданный триггер
SQLViewSchemanullвсе представления базы данных
SQLViewSchemaдопустимое имя представлениязаданное представление

Если сочетание аргументов type и name не соответствует ни одному из перечисленных, в асинхронном режиме выполнения отправляется событие error, а в синхронном — генерируется исключение. Например, если аргумент type имеет значение SQLViewSchema, а аргумент name содержит имя таблицы (вместо имени представления), возникнет ошибка, указывающая на отсутствие в базе данных объекта указанного типа с заданным именем.

Параметры

type:Class (default = null) — Указывает тип загружаемой схемы данных. Значение null (по умолчанию) обозначает, что вся схема данных загружена. Если в качестве этого параметра указать значение, отличное от null, это сузит область полученной в результате схемы данных, при этом из результатов будут удалены все потенциально ненужные сведения, а сама операция станет более эффективной. Значение должно представлять собой имя одного из следующих классов:
  • SQLIndexSchema
  • SQLTableSchema
  • SQLTriggerSchema
  • SQLViewSchema
 
name:String (default = null) — Указывают, для каких ресурсов загружается схема данных. Использование данного значения в зависимости от заданного аргумента type. Обычно это значение представляет собой имя объекта базы данных, например имя таблицы, индекса, представления и т. д. Если оно задано, то в результат попадает только схема объекта базы данных с указанным именем.

Если задано недопустимое значение, отправляется событие error (или генерируется ошибка в синхронном режиме выполнения). Чтобы значение параметра type было допустимым, оно должно соответствовать типу указанного объекта, как указано в описании метода.

Если аргумент name имеет значение null, в результат попадут все схемы заданного типа. Если задано недопустимое значение, отправляется событие error.

 
database:String (default = "main") — Имя базы данных, для которой загружается схема данных. Если задано недопустимое значение, отправляется событие error.
 
includeColumnSchema:Boolean (default = true) — Указывает, содержит ли в результат сведения о схеме столбцов таблиц и представлений.
 
responder:Responder (default = null) — Объект, для которого определены методы, вызываемые при успешном выполнении или сбое операции. При асинхронном режиме выполнения, если аргумент responder имеет значение null, по окончании выполнения отправляется событие schema или error.


События
schema:SQLEvent — Отправляется после успешного завершения операции.
 
error:SQLErrorEvent — Отправляется после сбойного завершения операции.

Выдает
IllegalOperationError — Если данный метод вызывается, когда экземпляр SQLConnection не подключен к базе данных (свойство connected имеет значение false).
 
ArgumentError — Когда указанное значение аргумента type представляет собой недопустимый тип.
 
SQLError — Если при использовании синхронного режима выполнения в качестве параметров имени или базы данных указано недопустимое значение.

См. также

AIR-only open()метод 
public function open(reference:Object = null, openMode:String = "create", autoCompact:Boolean = false, pageSize:int = 1024):void

Язык версии : ActionScript 3.0
Версии среды выполнения:  1.0

Открывает подключение к файлу базы данных с заданным местоположением в файловой системе, создает и открывает новый файл базы данных с заданным местоположением или создает и открывает базу данных в оперативной памяти.

Операции создания и открытия базы данных, а также все остальные операции, выполняемые с использованием данного экземпляра SQLConnection, выполняются синхронно при открытии базы данных с помощью этого метода. Это включает в себя выполнение инструкций и другие операции, выполняемые экземпляром SQLStatement, связанным с данным экземпляром SQLConnection. Для асинхронного выполнения операций вместо него подключение базы данных следует открывать с помощью метода openAsync().

Базе данных, присоединенной с помощью метода open(), автоматически назначается имя main, которое можно использовать для явного указания имен таблиц в инструкциях SQL в формате [database-name].[table-name].

Параметры

reference:Object (default = null) — Местоположение открытого файла базы данных. Значение должно быть экземпляром класса flash.filesystem.File. Если параметр имеет значение null, то создается и подключается база данных в оперативной памяти.
 
openMode:String (default = "create") — Указывает режим, в котором будет открыта база данных. Может принимать значение любой константы, определенной в классе SQLMode. Значением по умолчанию является SQLMode.CREATE, которое указывает, что в случае отсутствия файла базы данных с заданным местоположением он будет создан. Если параметр openMode имеет значение SQLMode.READ, а указанный файл отсутствует, отправляется событие ошибки. Данный параметр игнорируется, если параметр reference имеет значение null.
 
autoCompact:Boolean (default = false) — Указывает, выполняется ли в базе данных автоматическое занятие неиспользуемого места. Этот параметр допустим только при создании новой базы данных или при открытии файла базы данных, в которой нет созданных таблиц. По умолчанию место, которое освобождается при удалении данных, остается в базе данных и при необходимости используется повторно. Если этому параметру задать значение true, свободное место будет повторно использоваться базой данных автоматически. Это может со временем привести к фрагментации данных в базе данных и отрицательно сказаться на производительности, потому что каждый раз при записи данных в базу потребуется дополнительная обработка. Чтобы в любое время принудительно восстановить неиспользуемое место в файле базы данных и дефрагментировать этот файл, используется метод compact().

Этот параметр игнорируется, если параметр openMode имеет значение SQLMode.READ.

 
pageSize:int (default = 1024) — Указывает размер страницы базы данных (в байтах). Этот параметр допустим только при создании новой базы данных или при открытии файла базы данных, в которой нет созданных таблиц. Значением должна быть степень двойки, которая больше или равна 512, но меньше или равна 32768. Значением по умолчанию является 1024 байта. Данное значение можно задать только до создания таблиц. При попытке изменить это значение после создания таблиц будет выдана ошибка.


События
open:SQLEvent — Отправляется после успешного завершения операции.

Выдает
IllegalOperationError — Если экземпляр SQLConnection уже имеет открытое подключение к базе данных (свойство connected имеет значение true).
 
SQLError — При сбое операции. Соединение никогда не остается открытым после сбоя операции.
 
ArgumentError — Если параметр reference имеет значение, отличное от экземпляра flash.filesystem.File.
 
ArgumentError — Если задан недопустимый параметр pageSize. Включает передачу размера страницы, если используется режим SQLMode.READ.

См. также

AIR-only openAsync()метод 
public function openAsync(reference:Object = null, openMode:String = "create", responder:Responder = null, autoCompact:Boolean = false, pageSize:int = 1024):void

Язык версии : ActionScript 3.0
Версии среды выполнения:  1.0

Открывает подключение к файлу базы данных с заданным местоположением в файловой системе, создает и открывает новый файл базы данных с заданным местоположением или создает и открывает базу данных в оперативной памяти.

Операции создания и открытия базы данных, а также все остальные операции, выполняемые с использованием данного экземпляра SQLConnection, выполняются асинхронно при открытии базы данных с помощью этого метода. Это включает в себя выполнение инструкций и другие операции, выполняемые экземпляром SQLStatement, связанным с данным экземпляром SQLConnection. Для синхронного выполнения операций вместо него подключение базы данных следует открывать с помощью метода open().

Базе данных, присоединенной с помощью метода openAsync(), автоматически назначается имя main, которое можно использовать для явного указания имен таблиц в инструкциях SQL в формате [database-name].[table-name].

Параметры

reference:Object (default = null) — Местоположение открытого файла базы данных. Значение должно быть экземпляром класса flash.filesystem.File. Если параметр имеет значение null, то создается и подключается база данных в оперативной памяти.
 
openMode:String (default = "create") — Указывает режим, в котором будет открыта база данных. Может принимать значение любой константы, определенной в классе SQLMode. Значением по умолчанию является SQLMode.CREATE, которое указывает, что в случае отсутствия файла базы данных с заданным местоположением он будет создан. Если параметр openMode имеет значение SQLMode.READ, а указанный файл отсутствует, отправляется событие ошибки. Этот параметр игнорируется, если параметр reference имеет значение null.
 
responder:Responder (default = null) — Объект, для которого определены методы, вызываемые при успешном выполнении или сбое операции. Если аргумент responder имеет значение null, по окончании выполнения отправляется событие open или error.
 
autoCompact:Boolean (default = false) — Указывает, выполняется ли в базе данных автоматическое занятие неиспользуемого места. Этот параметр допустим только при создании новой базы данных или при открытии файла базы данных, в которой нет созданных таблиц. По умолчанию место, которое освобождается при удалении данных, остается в базе данных и при необходимости используется повторно. Если этому параметру задать значение true, свободное место будет повторно использоваться базой данных автоматически. Это может со временем привести к фрагментации данных в базе данных и отрицательно сказаться на производительности, потому что каждый раз при записи данных в базу потребуется дополнительная обработка. Чтобы в любое время принудительно восстановить неиспользуемое место в файле базы данных и дефрагментировать этот файл, используется метод compact().

Этот параметр игнорируется, если параметр openMode имеет значение SQLMode.READ.

 
pageSize:int (default = 1024) — Указывает размер страницы базы данных (в байтах). Этот параметр допустим только при создании новой базы данных или при открытии файла базы данных, в которой нет созданных таблиц. Значением должна быть степень двойки, которая больше или равна 512, но меньше или равна 32768. Значением по умолчанию является 1024 байта. Данное значение можно задать только до создания таблиц. При попытке изменить это значение после создания таблиц будет выдана ошибка.


События
open:SQLEvent — Отправляется после успешного завершения операции.
 
error:SQLErrorEvent — Отправляется после сбоя операции. Соединение никогда не остается открытым после сбоя операции.

Выдает
IllegalOperationError — Если экземпляр SQLConnection уже имеет открытое подключение к базе данных (свойство connected имеет значение true).
 
ArgumentError — Если параметр reference имеет значение, отличное от экземпляра flash.filesystem.File.
 
ArgumentError — Если задан недопустимый параметр pageSize. Включает передачу размера страницы, если используется режим SQLMode.READ.

См. также

AIR-only removeEventListener()метод 
override public function removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void

Язык версии : ActionScript 3.0
Версии среды выполнения:  1.0

Удаляет прослушиватель из объекта EventDispatcher. Если для объекта EventDispatcher нет зарегистрированного прослушивателя, то вызов этого метода игнорируется.

Параметры

type:String — Тип события.
 
listener:Function — Удаляемый объект прослушивателя.
 
useCapture:Boolean (default = false) — Указывает, зарегистрирован ли прослушиватель для фазы захвата либо для фаз цели и пузырей. Если прослушиватель зарегистрирован и для фазы захвата и для фаз цели и пузырей, метод removeEventListener() необходимо вызвать дважды: один раз с useCapture() в значении true, а другой раз с useCapture() в значении false.

AIR-only rollback()метод 
public function rollback(responder:Responder = null):void

Язык версии : ActionScript 3.0
Версии среды выполнения:  1.0

Выполняет откат существующей транзакции, созданной с помощью метода begin(), то есть все изменения, внесенные любыми инструкциями SQL в рамках данной транзакции, отменяются.

Параметры

responder:Responder (default = null) — Объект, для которого определены методы, вызываемые при успешном выполнении или сбое операции. При асинхронном режиме выполнения, если аргумент responder имеет значение null, по окончании выполнения отправляется событие rollback или error.


События
rollback:SQLEvent — Отправляется после успешного завершения операции.
 
error:SQLErrorEvent — Отправляется после сбоя операции в асинхронном режиме выполнения.

Выдает
IllegalOperationError — Если экземпляр SQLConnection не подключен к базе данных (свойство connected имеет значение false) или если в текущий момент нет открытых транзакций (свойство inTransaction имеет значение false).
 
SQLError — Если произошел сбой операции в синхронном режиме выполнения.

См. также

Сведения о событии
AIR-only analyze Событие
Тип объекта события: flash.events.SQLEvent
свойство SQLEvent.type = flash.events.SQLEvent.ANALYZE

Язык версии : ActionScript 3.0
Версии среды выполнения:  1.0

Отправляется при успешном завершении операции analyze().

Константа SQLEvent.ANALYZE определяет значение свойства type объекта analyze. Этот тип события отправляется, когда успешно завершается выполнение метода SQLConnection.analyze(). Объект события analyze имеет следующие свойства:
СвойствоЗначение
bubblesfalse
cancelablefalse; нет поведения по умолчанию для отмены.
currentTargetОбъект, активно обрабатывающий объект Event с помощью прослушивателя событий.
targetОбъект SQLConnection, выполнивший операцию.

См. также

AIR-only attach Событие  
Тип объекта события: flash.events.SQLEvent
свойство SQLEvent.type = flash.events.SQLEvent.ATTACH

Язык версии : ActionScript 3.0
Версии среды выполнения:  1.0

Отправляется при успешном вызове метода attach().

Константа SQLEvent.ATTACH определяет значение свойства type объекта Attach. Этот тип события отправляется, когда успешно завершается выполнение метода SQLConnection.attach(). Объект события attach имеет следующие свойства.
СвойствоЗначение
bubblesfalse
cancelablefalse; нет поведения по умолчанию для отмены.
currentTargetОбъект, активно обрабатывающий объект Event с помощью прослушивателя событий.
targetОбъект SQLConnection, выполнивший операцию.

См. также

AIR-only begin Событие  
Тип объекта события: flash.events.SQLEvent
свойство SQLEvent.type = flash.events.SQLEvent.BEGIN

Язык версии : ActionScript 3.0
Версии среды выполнения:  1.0

Отправляется при успешном вызове метода begin().

Константа SQLEvent.BEGIN определяет значение свойства type объекта события begin. Этот тип события отправляется, когда успешно завершается выполнение метода SQLConnection.begin(). Объект события begin имеет следующие свойства.
СвойствоЗначение
bubblesfalse
cancelablefalse; нет поведения по умолчанию для отмены.
currentTargetОбъект, активно обрабатывающий объект Event с помощью прослушивателя событий.
targetОбъект SQLConnection, выполнивший операцию.

См. также

AIR-only cancel Событие  
Тип объекта события: flash.events.SQLEvent
свойство SQLEvent.type = flash.events.SQLEvent.CANCEL

Язык версии : ActionScript 3.0
Версии среды выполнения:  1.0

Отправляется при успешном вызове метода cancel().

Константа SQLEvent.CANCEL определяет значение свойства type объекта события cancel. Этот тип события отправляется, когда успешно завершается выполнение метода SQLConnection.cancel(). Объект события cancel имеет следующие свойства.
СвойствоЗначение
bubblesfalse
cancelablefalse; нет поведения по умолчанию для отмены.
currentTargetОбъект, активно обрабатывающий объект Event с помощью прослушивателя событий.
targetОбъект SQLConnection или SQLStatement, выполнивший операцию.

См. также

AIR-only close Событие  
Тип объекта события: flash.events.SQLEvent
свойство SQLEvent.type = flash.events.SQLEvent.CLOSE

Язык версии : ActionScript 3.0
Версии среды выполнения:  1.0

Отправляется при успешном вызове метода close().

Константа SQLEvent.CLOSE определяет значение свойства type объекта события close. Этот тип события отправляется, когда успешно завершается выполнение метода SQLConnection.close(). Объект события close имеет следующие свойства.
СвойствоЗначение
bubblesfalse
cancelablefalse; нет поведения по умолчанию для отмены.
currentTargetОбъект, активно обрабатывающий объект Event с помощью прослушивателя событий.
targetОбъект SQLConnection, выполнивший операцию.

См. также

AIR-only commit Событие  
Тип объекта события: flash.events.SQLEvent
свойство SQLEvent.type = flash.events.SQLEvent.COMMIT

Язык версии : ActionScript 3.0
Версии среды выполнения:  1.0

Отправляется при успешном вызове метода commit().

Константа SQLEvent.COMMIT определяет значение свойства type объекта события commit. Этот тип события отправляется, когда успешно завершается выполнение метода SQLConnection.commit(). Объект события commit имеет следующие свойства.
СвойствоЗначение
bubblesfalse
cancelablefalse; нет поведения по умолчанию для отмены.
currentTargetОбъект, активно обрабатывающий объект Event с помощью прослушивателя событий.
targetОбъект SQLConnection, выполнивший операцию.

См. также

AIR-only compact Событие  
Тип объекта события: flash.events.SQLEvent
свойство SQLEvent.type = flash.events.SQLEvent.COMPACT

Язык версии : ActionScript 3.0
Версии среды выполнения:  1.0

Отправляется при успешном вызове метода compact().

Константа SQLEvent.COMPACT определяет значение свойства type объекта события compact. Этот тип события отправляется, когда успешно завершается выполнение метода SQLConnection.compact(). Объект события compact имеет следующие свойства.
СвойствоЗначение
bubblesfalse
cancelablefalse; нет поведения по умолчанию для отмены.
currentTargetОбъект, активно обрабатывающий объект Event с помощью прослушивателя событий.
targetОбъект SQLConnection, выполнивший операцию.

См. также

AIR-only deanalyze Событие  
Тип объекта события: flash.events.SQLEvent
свойство SQLEvent.type = flash.events.SQLEvent.DEANALYZE

Язык версии : ActionScript 3.0
Версии среды выполнения:  1.0

Отправляется при успешном вызове метода deanalyze().

Константа SQLEvent.DEANALYZE определяет значение свойства type объекта события deanalyze. Этот тип события отправляется, когда успешно завершается выполнение метода SQLConnection.deanalyze(). Объект события deanalyze имеет следующие свойства.
СвойствоЗначение
bubblesfalse
cancelablefalse; нет поведения по умолчанию для отмены.
currentTargetОбъект, активно обрабатывающий объект Event с помощью прослушивателя событий.
targetОбъект SQLConnection, выполнивший операцию.

См. также

AIR-only delete Событие  
Тип объекта события: flash.events.SQLUpdateEvent
свойство SQLUpdateEvent.type = flash.events.SQLUpdateEvent.DELETE

Язык версии : ActionScript 3.0
Версии среды выполнения:  1.0

Отправляется при изменении данных в любой таблице любой подключенной базы данных в результате выполнения команды SQL DELETE. Данные могут измениться непосредственно в результате выполнения инструкции DELETE с помощью экземпляра SQLStatement или косвенно, в результате запуска триггера в ответ на выполнение инструкции.

Константа SQLUpdateEvent.DELETE определяет значение свойства typeсобытия delete для SQLConnection. Объект события delete имеет следующие свойства.
СвойствоЗначение
bubblesfalse
cancelablefalse; нет поведения по умолчанию для отмены.
currentTargetОбъект, активно обрабатывающий объект Event с помощью прослушивателя событий.
rowIDУникальный идентификатор строки, которая была вставлена, удалена или обновлена.
targetОбъект SQLConnection, для которого выполнялась операция.
tableИмя таблицы, в которой произошло изменение.

См. также

AIR-only detach Событие  
Тип объекта события: flash.events.SQLEvent
свойство SQLEvent.type = flash.events.SQLEvent.DETACH

Язык версии : ActionScript 3.0
Версии среды выполнения:  1.0

Отправляется при успешном вызове метода detach().

Константа SQLEvent.DETACH определяет значение свойства type объекта события detach. Этот тип события отправляется, когда успешно завершается выполнение метода SQLConnection.detach().
СвойствоЗначение
bubblesfalse
cancelablefalse; нет поведения по умолчанию для отмены.
currentTargetОбъект, активно обрабатывающий объект Event с помощью прослушивателя событий.
targetОбъект SQLConnection, выполнивший операцию.

См. также

AIR-only error Событие  
Тип объекта события: flash.events.SQLErrorEvent
свойство SQLErrorEvent.type = flash.events.SQLErrorEvent.ERROR

Язык версии : ActionScript 3.0
Версии среды выполнения:  1.0

Отправляется, если любая из асинхронных операций объекта SQLConnection вызывает ошибку. Экземпляр события SQLErrorEvent, которое отправляется в том случае, если свойство error объекта события содержит сведения об операции, при выполнении которой возникла ошибка.

Константа SQLErrorEvent.ERROR определяет значение свойства type события ошибки, отправляемого, когда вызов метода экземпляра SQLConnection или SQLStatement завершается ошибкой. Объект события error имеет следующие свойства.
СвойствоЗначение
bubblesfalse
cancelablefalse; нет поведения по умолчанию для отмены.
errorОбъект SQLError, содержащий информацию о типе возникшей ошибки и о вызвавшей ее операции.
currentTargetОбъект, активно обрабатывающий объект Event с помощью прослушивателя событий.
targetОбъект SQLConnection или SQLStatement, сообщающий об ошибке.
AIR-only insert Событие  
Тип объекта события: flash.events.SQLUpdateEvent
свойство SQLUpdateEvent.type = flash.events.SQLUpdateEvent.INSERT

Язык версии : ActionScript 3.0
Версии среды выполнения:  1.0

Отправляется при изменении данных в любой таблице любой подключенной базы данных в результате выполнения команды SQL INSERT. Данные могут измениться непосредственно в результате выполнения инструкции INSERT с помощью экземпляра SQLStatement или косвенно, в результате запуска триггера в ответ на выполнение инструкции.

Константа SQLUpdateEvent.INSERT определяет значение свойства typeсобытия insert для SQLConnection. Объект события insert имеет следующие свойства.
СвойствоЗначение
bubblesfalse
cancelablefalse; нет поведения по умолчанию для отмены.
currentTargetОбъект, активно обрабатывающий объект Event с помощью прослушивателя событий.
rowIDУникальный идентификатор строки, которая была вставлена, удалена или обновлена.
targetОбъект SQLConnection, для которого выполнялась операция.
tableИмя таблицы, в которой произошло изменение.

См. также

AIR-only open Событие  
Тип объекта события: flash.events.SQLEvent
свойство SQLEvent.type = flash.events.SQLEvent.OPEN

Язык версии : ActionScript 3.0
Версии среды выполнения:  1.0

Отправляется при успешном вызове метода openAsync().

Константа SQLEvent.OPEN определяет значение свойства type объекта события open. Этот тип события отправляется, когда успешно завершается выполнение метода SQLConnection.open() или SQLConnection.openAsync() Объект события open имеет следующие свойства.
СвойствоЗначение
bubblesfalse
cancelablefalse; нет поведения по умолчанию для отмены.
currentTargetОбъект, активно обрабатывающий объект Event с помощью прослушивателя событий.
targetОбъект SQLConnection, выполнивший операцию.

См. также

AIR-only rollback Событие  
Тип объекта события: flash.events.SQLEvent
свойство SQLEvent.type = flash.events.SQLEvent.ROLLBACK

Язык версии : ActionScript 3.0
Версии среды выполнения:  1.0

Отправляется при успешном вызове метода rollback().

Константа SQLEvent.ROLLBACK определяет значение свойства type объекта события rollback. Этот тип события отправляется, когда успешно завершается выполнение метода SQLConnection.rollback(). Объект события rollback имеет следующие свойства.
СвойствоЗначение
bubblesfalse
cancelablefalse; нет поведения по умолчанию для отмены.
currentTargetОбъект, активно обрабатывающий объект Event с помощью прослушивателя событий.
targetОбъект SQLConnection, выполнивший операцию.

См. также

AIR-only schema Событие  
Тип объекта события: flash.events.SQLEvent
свойство SQLEvent.type = flash.events.SQLEvent.SCHEMA

Язык версии : ActionScript 3.0
Версии среды выполнения:  1.0

Отправляется при успешном вызове метода loadSchema() и готовности результатов схемы.

Константа SQLEvent.SCHEMA определяет значение свойства type объекта события schema. Отправляется, когда успешно завершается выполнение метода SQLConnection.loadSchema(). После отправки события SQLEvent.SCHEMA можно вызвать метод SQLConnection.getSchemaResult() для получения данных схемы. Объект события schema имеет следующие свойства:
СвойствоЗначение
bubblesfalse
cancelablefalse; нет поведения по умолчанию для отмены.
currentTargetОбъект, активно обрабатывающий объект Event с помощью прослушивателя событий.
targetОбъект SQLConnection, выполнивший операцию.

См. также

AIR-only update Событие  
Тип объекта события: flash.events.SQLUpdateEvent
свойство SQLUpdateEvent.type = flash.events.SQLUpdateEvent.UPDATE

Язык версии : ActionScript 3.0
Версии среды выполнения:  1.0

Отправляется при изменении данных в любой таблице любой подключенной базы данных в результате выполнения команды SQL UPDATE. Данные могут измениться непосредственно в результате выполнения инструкции UPDATE с помощью экземпляра SQLStatement или косвенно, в результате запуска триггера в ответ на выполнение инструкции.

Константа SQLUpdateEvent.UPDATE определяет значение свойства typeсобытия update для SQLConnection.

Объект события update имеет следующие свойства.

СвойствоЗначение
bubblesfalse
cancelablefalse; нет поведения по умолчанию для отмены.
currentTargetОбъект, активно обрабатывающий объект Event с помощью прослушивателя событий.
rowIDУникальный идентификатор строки, которая была вставлена, удалена или обновлена.
targetОбъект SQLConnection, для которого выполнялась операция.
tableИмя таблицы, в которой произошло изменение.

См. также