Bevor Sie unter Verwendung von QAnywhere C++-Clients Nachrichten versenden oder empfangen können, müssen Sie die folgenden Initialisierungsaufgaben durchführen.

♦  So initialisieren Sie die QAnywhere C++-API

1. Beziehen Sie die QAnywhere-Headerdatei ein.

   #include <qa.hpp>

   qa.hpp legt die QAnywhere-Klassen fest.

2. Initialisieren Sie QAnywhere.

   Um das zu erreichen, initialisieren Sie ein factory-Objekt zur Erstellung von QAManager-Objekten.

   QAManagerFactory * factory; factory = QAnywhereFactory_init(); if( factory == NULL ) { // Fatal error. }

   Weitere Informationen zu QAManagerFactory finden Sie unter QAManagerFactory-Klasse.

3. Erstellen Sie eine QAManager-Instanz.

   Sie können ein Standard-QAManager-Objekt wie folgt erstellen:

   QAManager * mgr; // Create a manager mgr = factory->createQAManager( NULL ); if( mgr == NULL ) { // fatal error }

   Weitere Hinweise finden Sie unter QAManager-Klasse.

   Tipp

   Um hohe Parallelität zu gewährleisten, sollten Multi-Thread-Anwendungen ein QAManager-Objekt für jeden Thread erstellen. Weitere Hinweise finden Sie unter Hinweise zu Multi-Threading.

   Sie können ein QAManager-Objekt mittels Programmcode anpassen oder eine Eigenschaftsdatei verwenden.

   • Um das QAManager-Objekt im Programmcode anzupassen, verwenden Sie setProperty().

     Weitere Hinweise finden Sie unter Konfigurationseigenschaften des QAnywhere-Managers im Programmcode festlegen.

   • Um eine Eigenschaftsdatei zu verwenden, geben Sie die Eigenschaftsdatei in createQAManager() an:

     mgr = factory->createQAManager( "qa_mgr.props" );

     Dabei gilt: qa_mgr.props ist der Name der Eigenschaftsdatei auf dem entfernten Gerät.

     Weitere Hinweise finden Sie unter Konfigurationseigenschaften des QAnywhere-Managers in einer Datei festlegen.

4. Initialisieren Sie das QAManager-Objekt.

   qa_bool rc; rc=mgr->open( AcknowledgementMode::IMPLICIT_ACKNOWLEDGEMENT );

   Das Argument für die open-Methode ist ein Bestätigungsmodus, der festlegt, wie die Nachrichten bestätigt werden sollen. Es muss entweder IMPLICIT_ACKNOWLEDGEMENT oder EXPLICIT_ACKNOWLEDGEMENT sein . Bei impliziter Bestätigung werden Meldungen bestätigt, wenn sie vom Client empfangen werden. Bei expliziter Bestätigung müssen Sie eine der Bestätigungsmethoden im QAManager-Objekt aufrufen, um die Nachricht zu bestätigen.

   Weitere Informationen zu Bestätigungsmodi finden Sie unter AcknowledgementMode-Klasse.

Sie sind nun bereit, Nachrichten zu versenden.

Siehe auch

• QAnywhere C++-API-Referenz