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