Creazione di istanze di eventi ADO: ADO e WFC

  • Articolo

ADO per Windows Foundation Classes (ADO/WFC) si basa sul modello di evento ADO e presenta un'interfaccia di programmazione delle applicazioni semplificata. In generale, ADO/WFC intercetta gli eventi ADO, consolida i parametri dell'evento in una singola classe di evento e quindi chiama il gestore dell'evento.

Per usare gli eventi ADO in ADO/WFC

  1. Definire un gestore dell'evento personalizzato per elaborare un evento. Ad esempio, se si vuole elaborare l'evento ConnectComplete nella famiglia ConnectionEvent, è possibile usare questo codice:

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

  2. Definire un oggetto gestore per rappresentare il gestore dell'evento. L'oggetto gestore deve essere di tipo di dati ConnectEventHandler per un evento di tipo ConnectionEvent o di tipo di dati RecordsetEventHandler per un evento di tipo RecordsetEvent. Ad esempio, scrivere il codice seguente per il gestore dell'evento ConnectComplete:

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

    Il primo argomento del costruttore ConnectionEventHandler è un riferimento alla classe che contiene il gestore dell'evento denominato nel secondo argomento.

  3. Aggiungere il gestore dell'evento a un elenco di gestori designati per elaborare un particolare tipo di evento. Usare il metodo con un nome, ad esempio addOnEventName(gestore).

  4. ADO/WFC implementa internamente tutti i gestori dell'evento ADO. Pertanto, un evento causato da un'operazione Connection o Recordset viene intercettato da un gestore dell'evento ADO/WFC.

    Il gestore dell'evento ADO/WFC passa parametri ADO ConnectionEvent in un'istanza della classe ConnectionEvent ADO/WFC o parametri ADO RecordsetEvent in un'istanza della classe RecordsetEvent ADO/WFC. Queste classi ADO/WFC consolidano i parametri dell'evento ADO; ovvero ogni classe ADO/WFC contiene un membro dati per ogni parametro univoco in tutti i metodi ADO ConnectionEvent o RecordsetEvent.

  5. ADO/WFC chiama quindi il gestore dell'evento con l'oggetto evento ADO/WFC. Ad esempio, il gestore onConnectComplete ha una firma simile alla seguente:

    public void onConnectComplete(Object sender,ConnectionEvent e)

    Il primo argomento è il tipo di oggetto che ha inviato l'evento (Connection o Recordset) e il secondo argomento è l'oggetto evento ADO/WFC (ConnectionEvent o RecordsetEvent).

    La firma del gestore dell'evento è più semplice di un evento ADO. Tuttavia, è comunque necessario comprendere il modello di eventi ADO per sapere quali parametri si applicano a un evento e come rispondere.

  6. Tornare dal gestore dell'evento al gestore ADO/WFC per l'evento ADO. ADO/WFC ricopia i membri dei dati dell'evento ADO/WFC pertinenti nei parametri dell'evento ADO e quindi il gestore dell'evento ADO li restituisce.

  7. Al termine dell'elaborazione, rimuovere il gestore dall'elenco dei gestori degli eventi ADO/WFC. Usare il metodo con un nome, ad esempio removeOnEventName(gestore).

Vedi anche

Riepilogo dei gestori eventi ADO
Indice sintassi ADO - WFC
Parametri evento
Interazione tra i gestori eventi
Tipi di eventi