ICE的異步方法調用

異步方法調用（Asynchronous Method Invocation，簡稱AMI）

下面這種情況就是AMI調用：“斧頭幫”大哥（客戶端）叫小弟（服務器端）去幹收租的活（遠程調用），並且給小弟一把煙花炮竹（回調類）。囑咐說： “我還有其它事情要打掃打掃，如果你的事情辦完了，就放'OK'煙花；如果遇到反抗，就放'斧頭'煙花！”(服務器答覆)。說完，這位大哥就可以放心的做其它事去了，直到看到天上煙花盛開，根據"OK"或"斧頭"狀再作處理。

AMI是針對客戶端而言的，當客戶端使用AMI發出遠程調用時，客戶端需要提供一個實現了回調接口的類用於接收通知。然後不等待調用完成立即返回，這時可以繼續其它活動，當得到服務器端的答覆時，客戶端的回調類中的方法就會被執行。

例：修改原Helloworld 客戶端，使用異步方法遠程調用printString。

首先，要修改原來的Printer.ice定義文件，在printString方法前加上["ami"]元標識符。

module Demo{
interface Printer
{
    ["ami"
]  void
 printString(string s);
};
};

同樣，再用slice2cpp Printer.ice生成Printer.h和Printer.cpp文件，並把這兩個文件加入原項目（如果是直接修改之前的代碼的話，因爲原先已經加入了這兩個文件，這步可以跳過）。

觀察生成的Printer.h文件，可以找到這個定義：

namespace
 Demo
{
class
 AMI_Printer_printString :  public
 ::IceInternal::OutgoingAsync
{
public
:
    virtual
  void
 ice_response() = 0;
    virtual
  void
 ice_exception( const
 ::Ice::Exception&) = 0;
...
};
}

這裏的AMI_Printer_printString 就是printString方法的AMI回調接口，可以發現它AMI回調接口類名的規律是AMI_類名_方法名。

這個接口提供了兩個方法：

void ice_response(<params>);
    表明操作已成功完成。各個參數代表的是操作的返回值及out 參數。如果操作的有一個非 void返回類型，ice_response 方法的第一個參數就是操作的返回值。操作的所有out 參數都按照聲明時的次序，跟在返回值的後面。

void ice_exception(const Ice::Exception &);
    表明拋出了本地或用戶異常。

同時，slice2cpp還爲Printer代理類生成了異步版本的printString方法：

namespace
 IceProxy  //是代理類
{
namespace
 Demo
{
class
 Printer :  virtual
  public
 ::IceProxy::Ice::Object
{
    ...
public
:
    bool
 printString_async( const
 ::Demo::AMI_Printer_printStringPtr&,
        const
 ::std::string&);
    bool
 printString_async( const
 ::Demo::AMI_Printer_printStringPtr&,
        const
 ::std::string&,  const
 ::Ice::Context&);
    ...
};
}
}

結合這兩樣東西（AMI_Printer_printString 接口和printString_async 方法），我們的客戶端AMI調用方法爲：

1. 實現AMI_Printer_printString接口的ice_response和ice_exception方法，以響應遠程調用完成後的工作。
2. 把上面實現的回調對象作爲printString_async的參數啓動遠程調用，然後可以做其它事了。
3. 當得到服務端答覆後，AMI_Printer_printString接口的ice_response的方法被調用。

演示代碼(客戶端)：

#include <ice/ice.h>
#include <printer.h>

using
  namespace
 std;
using
  namespace
 Demo;

//實現AMI_Printer_printString接口
struct
 APP : AMI_Printer_printString
{
    virtual
  void
 ice_response()
    {
        cout << "printString完成"
 << endl;
    }
    virtual
  void
 ice_exception( const
 ::Ice::Exception& e)
    {
        cout << "出錯啦："
 << e << endl;
    }
};

class
 MyApp:  public
 Ice::Application{
public
:
    virtual
  int
 run( int
 argc,  char
*argv[])
    {
        Ice::CommunicatorPtr ic = communicator();

        Ice::ObjectPrx base =
            ic->stringToProxy("SimplePrinter:default -p 10000"
);

        Demo::PrinterPrx printer = PrinterPrx::checkedCast(base);
        if
(!printer)  throw
  "Invalid Proxy!"
;

        // 使用AMI異步調用
        printer->printString_async(new
 APP, "Hello World!"
);
        cout << "做點其它的事情..."
 << endl;
        system("pause"
);
        return
 0;
    }
};

int
 main( int
 argc,  char
* argv[])
{
    MyApp app;
    return
 app.main(argc,argv);
}

服務端代碼不變，編譯運行，效果應該是調用printer->printString_async之後還能"做點其它的事情..."，當服務端完成後客戶端收到通知，顯示"printString完成"。

另外，爲了突出異步效果，可以修改服務器端代碼，故意把printString執行得慢一點：

struct
 PrinterImp : Printer{
    virtual
  void
 printString( const
 ::std::string& s,
        const
 ::Ice::Current&)
    {
        Sleep(1000);
        cout << s << endl;
    }
};
直接做具體工作，完成後在末尾調用回調類的ice_response方法告知客戶端已完成。這種方案就和之前普通版的服務端一樣，是同步執行的。
把回調類和請求所需要的參數放入一個指定的位置，再由其它線程取出執行和通知客戶端。這種方案就是異步分派方法，具體實現時還可以有多種方式，如使用命令模式把參數和具體操作直接封裝成一個對象放入隊列，然後由另一線程（或線程池）取出執行。後面的示例代碼爲了簡單起見直接使用了Windows API中的線程池功能，而且也沒有使用隊列。