這一節大部分內容整理自ICE中文手冊,在這里我特別感謝馬維達同志的翻譯給我們的學習帶來了方便。
讀服務端代碼
文件server.cpp.
#include <Ice/Ice.h>
#include "../print.h"
using namespace std;
using namespace Demo;
//慣例,用后綴I 表示這個類實現一個接口
class PrinterI : public Printer {
public:
virtual void printString(const string& s, const Ice::Current&);
};
/*
打開print.h,看看PrinterI父類的定義
namespace Demo {
class Printer : virtual public Ice::Object {
public:
//純虛函數,不能實例化
virtual void printString(const std::string&,
//第二個參數有缺省值,實現中可以不使用
const Ice::Current&= Ice::Current()) = 0;
};
};
*/
void PrinterI::printString(const string& s, const Ice::Current&)
{
cout << s << endl;
}
int main(int argc, char* argv[])
{
//程序的退出時的狀態,就是否成功執行
int status = 0;
//來包含Ice run time 的主句柄 (main handle)
Ice::CommunicatorPtr ic;
try {
//初始化Ice run time (argc和argv是run time命令參數;
//就這個例子而言,服務器不需要任何命令行參數)。
//initialize 返回一個指向Ice::Communicator對象的智能指針,
//這個指針是Ice run time 的主句柄。
ic = Ice::initialize(argc, argv);
//調用Communicator 實例上的createObjectAdapterWithEndpoints,
//創建一個對象適配器(比如:網卡就是一種適配器)。
//參數是"SimplePrinterAdapter" (適配器的名字)
//和"default -p 10000"(用缺省協議(TCP/IP),偵聽端口10000 的請求。)
//顯然,在應用中硬編碼對象標識和端口號,是一種糟糕的做法,
//但它目前很有效;我們將在以后看到在架構上更加合理的做法。
Ice::ObjectAdapterPtr adapter
= ic->createObjectAdapterWithEndpoints(
"SimplePrinterAdapter", "default -p 10000");
//服務器端run time 已經初始化,實例化一個PrinterI 對象,
//為我們的Printer 接口創建一個servant(serv 服務+-ant人,背一下單詞)。
Ice::ObjectPtr object = new PrinterI;
//我們調用適配器的add,告訴它有了一個新的servant ;
//傳給add 的參數是剛才實例化的servant,再加上一個標識符。
//在這里,"SimplePrinter" 串是servant 的名字
//(如果我們有多個打印機,每個打印機都可以有不同的名字,
//更正確的說法是,都有不同的對象標識)。
adapter->add(object,
Ice::stringToIdentity("SimplePrinter"));
//調用適配器的activate 方法激活適配器
//(適配器一開始是在暫停(holding)狀態創建的;
//這種做法在下面這樣的情況下很有用:
//我們有多個servant,它們共享同一個適配器,
//而在所有servant實例化之前我們不想處理請求)。
//一旦適配器被激活,服務器就會開始處理來自客戶的請求。
adapter->activate();
//最后,我們調用waitForShutdown。
//這個方法掛起發出調用的線程直到服務器實現終止
//——或者是通過發出一個調用關閉run time,
ic->waitForShutdown();
}
catch (const Ice::Exception& e) {
cerr << e << endl;
status = 1;
} catch (const char* msg) {
cerr << msg << endl;
status = 1;
}
if (ic) {
try {
//必須調用Communicator::destroy結束Ice run time。
//destroy 會等待任何還在運行的操作調用完成。
//此外, destroy 還會確保任何還未完成的線程都得以匯合(joined),
//并收回一些操作系統資源,比如文件描述符和內存。
//決不要讓你的main 函數不調用destroy 就終止,
//否則,后果無法想象。
ic->destroy();
} catch (const Ice::Exception& e) {
cerr << e << endl;
status = 1;
}
}
return status;
}
注意,盡管以上的代碼不算少,但它們對所有的服務器都是一樣的。你可以把這些代碼放在一個輔助類里,然后就無需再為它費心了(Ice 提供了這樣的輔助類,叫作Ice::Application,參見 10.3.1 節) 。就實際的應用代碼而言,服務器只有幾行代碼:六行代碼定義PrinterI 類,再加上三2 行代碼實例化一個PrinterI 對象,并向對象適配器注冊它。
讀客戶端代碼
文件client.cpp.
#include <Ice/Ice.h>
#include "..\print.h"
using namespace std;
using namespace Demo;
int main(int argc, char* argv[])
{
int status = 0;
Ice::CommunicatorPtr ic;
try {
ic = Ice::initialize(argc, argv);
//stringToProxy 返回的代理(Proxy)類型是Ice::ObjectPrx,
//這種類型位于接口和類的繼承樹的根部(接口的基類)。
Ice::ObjectPrx base
=ic->stringToProxy( "SimplePrinter:default -p 10000");
//但要實際要與我們的打印機交談,
//我們需要的是Printer 接口、不是Object 接口的代理。
//為此,需要調用PrinterPrx::checkedCast 進行向下轉換(向下轉型)。
//這個方法會發送一條消息給服務器,
//詢問“這是Printer 接口的代理嗎?”
//如果回答“是”,就會返回Printer 的一個代理;
//如果代理代表的是其他類型的接口,返回一個空代理
PrinterPrx printer = PrinterPrx::checkedCast(base);
//測試向下轉型是否成功,若不成功,就拋出出錯消息并終止客戶。
if (!printer) throw "Invalid proxy";
//現在,我們在我們的地址空間里有了一個激活的代理,
//可以調用printString 方法,
//把享譽已久的 "Hello World!" 串傳給它。
//服務器會在它的終端上打印這個串。
printer->printString("Hello World!");
}
catch (const Ice::Exception& ex) {
cerr << ex << endl;
status = 1;
} catch (const char* msg) {
cerr << msg << endl;
status = 1;
}
if (ic)
ic->destroy();
return status;
}
如果出現任何錯誤,客戶會打印一條出錯消息。例如,如果我們沒有先啟動服務器就運行客戶,我們會得到:
Network.cpp:471: Ice::ConnectFailedException:
connect failed: Connection refused
(由于windows下的命令行窗口在出錯后會一閃就消失,不過我們可以在client.cpp的main函數的return status;之前加上system("PAUSE");然后再在VS2003.net中把client設置為啟動項目,重新編譯,運行。OK,可以看到結果了。)