QAnywhere 用户指南

编写 QAnywhere 客户端应用程序

初始化 QAnywhere 客户端 API

使用 QAnywhere 发送或接收消息之前，必须完成下面的初始化任务。

设置 C++ 应用程序 

初始化 QAnywhere 客户端 API (C++)

1. 包含 QAnywhere 头文件。

   #include <qa.hpp>

   qa.hpp 定义 QAnywhere 类。

2. 初始化 QAnywhere。

   为此，初始化用于创建 QAManager 对象的工厂。

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

3. 创建 QAManager 对象。

   您可以按以下方法创建缺省 QAManager 对象：

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

   可以以编程方式或使用属性文件自定义 QAManager 对象。

   • 若要以编程方式自定义 QAManager，请使用 setProperties 方法。

     有关详细信息，请参见以编程方式设置属性。

   • 若要使用属性文件，请在 createQAManager 方法中指定属性文件：

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

     此处，qa_mgr.props 是远程设备上的属性文件的名字。

     有关详细信息，请参见在文件中设置属性。

4. 初始化 QAManager 对象。

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

   open 方法的参数是确认模式，它指示确认消息的方式。它必须为 IMPLICIT_ACKNOWLEDGEMENT 或 EXPLICIT_ACKNOWLEDGEMENT。使用隐式确认时，客户端一接收到消息就立即进行确认。使用显式确认时，必须在 QAManager 上调用 acknowledgement 方法对消息进行确认。

   有关详细信息，请参见QAManager 类。

设置 .NET 应用程序 

Visual Studio .NET 项目必须进行两项更改后才能使用：

• 添加对 QAnywhere .NET DLL 的引用。添加引用可通知 Visual Studio.NET 包含哪个 DLL 以找到 QAnywhere .NET API 的代码。

• 在源代码中添加一行以引用 QAnywhere .NET API 类。要使用 QAnywhere .NET API，您必须在源代码中添加一行以引用数据提供程序。您必须为 C# 添加与 Visual Basic.NET 不同的语句行。

此外，您还必须初始化 QAnywhere 客户端 API。

在 Visual Studio .NET 项目中添加对 QAnywhere .NET API 的引用

1. 启动 Visual Studio .NET 并打开您的项目。

2. 在 [Solution Explorer] 窗口中，右击 [References] 文件夹，然后从弹出式菜单中选择 [Add Reference]。

   即显示 [Add Reference] 对话框。

3. 在 [.NET] 选项卡上，单击 [Browse]，找到 iAnywhere.QAnywhere.Client.dll。（缺省位置为 \Program Files\Sybase\SQL Anywhere 9\win32）。选择 DLL 然后单击 [Open]。

   注意，对每个 Windows 和 Windows CE 版本，都分别有一个 DLL 版本。

4. 您可以验证 DLL 是否已添加到项目中。打开 [Add Reference] 对话框，然后单击 [.NET] 选项卡。iAnywhere.QAnywhere.Client.dll 将显示在 [Selected Components] 列表中。单击 [OK] 关闭对话框。

   DLL 将添加到项目的 [Solution Explorer] 窗口的 [References] 文件夹。

在源代码中引用数据提供程序类。 

在代码中引用 QAnywhere .NET API 类

1. 启动 Visual Studio .NET 并打开您的项目。

2. 如果使用 C#，请将下面的语句行添加到项目开始处的 using 指令列表中：

   using iAnywhere.QAnywhere.Client;

3. 如果使用 Visual Basic .NET，请将下面的语句行添加到项目开始处的 Public Class Form1 语句行之前：

   Imports iAnywhere.QAnywhere.Client

   并不严格要求使用该语句。但是，它使您可以使用 QAnywhere 类的简写形式。即使没有该语句，您仍可以在代码中使用

   iAnywhere.QAnywhere.Client.QAManager 
   mgr = 
    new iAnywhere.QAnywhere.Client.QAManagerFactory.Instance.CreateQAManager(
   "qa_manager.props" );

   代替

   QAManager mgr = QAManagerFactory.Instance.CreateQAManager(
    "qa_manager.props" );

初始化 QAnywhere 客户端 API (.NET)

1. 包含 iAnywhere.QAnywhere.Client 命名空间。

   using iAnywhere.QAnywhere.Client;

2. 创建 QAManager 对象。

   您可以按以下方法创建缺省 QAManager 对象：

   QAManager mgr;
   mgr = QAManagerFactory.Instance.CreateQAManager( null );

   也可以使用属性文件来创建自定义的 QAManager 类。属性文件在 CreateQAManager 方法中指定：

   mgr = QAManagerFactory.Instance.CreateQAManager( 
     "qa_mgr.props" );

   此处，qa_manager.props 是远程设备上的属性文件的名字。

3. 初始化 QAManager 对象。

   mgr.Open(
      AcknowledgementMode.EXPLICIT_ACKNOWLEDGEMENT);

   open 方法的参数是确认模式，它指示确认消息的方式。它必须为 IMPLICIT_ACKNOWLEDGEMENT 或 EXPLICIT_ACKNOWLEDGEMENT。使用隐式确认时，客户端一接收到消息就立即进行确认。使用显式确认时，必须在 QAManager 上调用 acknowledgement 方法对消息进行确认。

   有关详细信息，请参见类 QAManager。

现在，您就可以发送消息了。

SQL Anywhere Studio 9.0.2
版权所有 © 1989–2005 Sybase, Inc. 部分版权所有 © 2001–2005 iAnywhere Solutions, Inc. 保留所有权利。