Поделиться через

Экземпляр событий ADO: ADO и WFC

  • Статья

ADO для классов Windows Foundation (ADO/WFC) основывается на модели событий ADO и представляет упрощенный интерфейс программирования приложений. Как правило, ADO/WFC перехватывает события ADO, объединяет параметры события в один класс событий, а затем вызывает обработчик событий.

Использование событий ADO в ADO/WFC

  1. Определите собственный обработчик событий для обработки события. Например, если вы хотите обработать событие ConnectComplete в семействе ConnectionEvent, можно использовать следующий код:

    public void onConnectComplete(Object sender,ConnectionEvent e)  
{  
    System.out.println("onConnectComplete:" + e);  
}

  2. Определите объект обработчика для представления обработчика событий. Объект обработчика должен иметь тип данных ConnectEventHandler для события типа ConnectionEventили типа данных RecordsetEventHandler для события типа RecordsetEventEvent. Например, напишите следующий код для обработчика событий ConnectComplete:

    ConnectionEventHandler handler =   
    new ConnectionEventHandler(this, "onConnectComplete");

    Первый аргумент конструктора ConnectionEventHandler является ссылкой на класс, содержащий обработчик событий, названный во втором аргументе.

  3. Добавьте обработчик событий в список обработчиков, назначенных для обработки определенного типа события. Используйте метод с именем, например, addOnEventName(обработчик).

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

    Обработчик событий ADO/WFC передает параметры ADO ConnectionEvent в экземпляре класса ADO/WFC ConnectionEvent или ADO RecordsetEvent в экземпляре класса ADO/WFC RecordsetEvent. Эти классы ADO/WFC объединяют параметры событий ADO; То есть каждый класс ADO/WFC содержит один элемент данных для каждого уникального параметра во всех методах ADO ConnectionEvent или RecordsetEvent.

  5. Затем ADO/WFC вызывает обработчик событий с объектом события ADO/WFC. Например, обработчик onConnectComplete имеет сигнатуру:

    public void onConnectComplete(Object sender,ConnectionEvent e)

    Первый аргумент — это тип объекта, отправляющего событие (Connection или Recordset), а второй аргумент — объект события ADO/WFC (ConnectionEvent или RecordsetEvent).

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

  6. Вернитесь из обработчика событий в обработчик ADO/WFC для события ADO. ADO/WFC копирует соответствующие элементы данных событий ADO/WFC обратно в параметры события ADO, а затем обработка события ADO завершается.

  7. По завершении обработки удалите обработчик из списка обработчиков событий ADO/WFC. Используйте метод, например, с именем removeOnEventName(обработчик).

См. также

Сводка обработчика событий ADO
ADO — индекс синтаксиса WFC
параметры события
Как обработчики событий взаимодействуют друг с другом
типы событий