ICE运行时环境备忘一

1、ICE运行环境的唯一句柄Communicator对象，其用来管理ICE运行环境下所有对象资源，包含但不限于：
   A、客户端线程池，主要用来进行AMI方法的回调接口调用，防止环形调用产生的死锁
   B、服务器端的线程池，主要用来接收和处理客户端的接口调用请求
   C、ICE运行环境对应的属性集合
   D、对象工厂，主要用来根据实例化接口对象
   E、日志对象和统计对象，其实现日志接口和统计接口用以实现ICE运行过程中的日志记录和网络传输统计
   F、缺省的路由器和定位器
   G、插件管理对象，用来管理ICE运行环境下的插件对象
   H、对象适配器ObjectAdapter，用以维护对象标示和服务对象之间的映射关系
2、Communicator对象的定义类似如下：
class CommunicatorI : public Communicator
{
public:
virtual void destroy();                   // 销毁通信器以及其所管理的ICE运行资源
virtual void shutdown();                  // 关闭通信器，不再接收客户端请求，但是正在执行的请求会执行完成
virtual void waitForShutdown();           // 等待当前通信器结束，意味着正在执行的所有请求都执行完毕
virtual bool isShutdown() const;          // 判断通信器是否已经关闭


virtual ObjectPrx stringToProxy(const std::string&) const;    // 根据对象标示获取对象的代理
virtual std::string proxyToString(const ObjectPrx&) const;    // 根据对象代理获取对象的标示


virtual ObjectPrx propertyToProxy(const std::string&) const;  // 根据给定的属性名称找到对应值的代理对象
virtual PropertyDict proxyToProperty(const ObjectPrx&, const std::string&) const;  // 返回代理对象的属性集


virtual Identity stringToIdentity(const std::string&) const;  // 将字符串标示转换成唯一ID
virtual std::string identityToString(const Identity&) const;  // 将唯一ID转换成字符串


virtual ObjectAdapterPtr createObjectAdapter(const std::string&);  // 通过名字创建对象适配器，端口在配置文件中配置(name.Endpoints)
virtual ObjectAdapterPtr createObjectAdapterWithEndpoints(const std::string&, const std::string&); //通过名称和端口创建适配器
virtual ObjectAdapterPtr createObjectAdapterWithRouter(const std::string&, const RouterPrx&);  // 通过名字和路由器来创建适配器


virtual PropertiesPtr getProperties() const;    // 获取通信器的属性集合
virtual LoggerPtr getLogger() const;            // 获取日志接口对象
virtual StatsPtr getStats() const;              // 获取统计接口对象
};
3、通信器Communicator的创建和初始化方法：
    Ice::CommunicatorPtr ic = Ice::Initialize(argc, argv, initdata);       // 通过命令行参数创建，会解析命令行中ICE相关属性
Ice::CommunicatorPtr ic = Ice::Initialize(initdata);                   // 通过初始化对象创建

Ice::InitializationData initdata;                                      // 构建初始化对象
initdata.properties = Ice::createProperties(args);                     // 设置初始化对象的属性集合
initdata.logger = new MyLoggerI;                                       // 设置对应的日志接口
initdata.stats = new MyStatsI;                                         // 设置对应的统计接口
4、对象适配器是ICE运行环境用来维护ASM的对象，管理ICE运行环境Activate Servant Map
   每个对象适配器有一个和多个接入端点可以接入
   每个对象适配器默认采用communicator的服务器线程进行消息处理，当然也可以通过指定<adapter-name>.ThreadPool.Size来指定自己的线程池
   可以通过Communicator中如下的方法创建一个ObjectAdapter对象：
   createObjectAdapter、createObjectAdapterWithEndpoints、createObjectAdapterWithRouter   
   Adapter对象提供了getName方法获取对象名称、getCommunicator方法获取其所在的通信器对象
   对象适配器是一个有状态的对象，其包含状态包括：Holding(初始状态，不接收请求)、Active(激活状态，正常处理)、Inactive(去激活状态，对象即将销毁)
   对象适配器提供了一系列的API来管理其状态转换：activate、hold、deactivate、waitForHold、waitForDeactivate、destory   
   对象适配器均有一个地址与其对应，类似如："tcp -h 10.0.0.1 -p 35840 -t 5000 -z:tcp -h 10.0.0.2 -p 35840 -t 5000 -z" (绑定两个地址，超时5s，支持压缩)
   可以调用objectadapter的getEndpoints返回所绑定的地址信息
5、Servant对象时真正的接口服务对象，要想提供服务，需要将Servant对象加入到某一个objectAdapter中，并指定一个对象标示
    virtual ObjectPrx add(const ObjectPtr&, const Identity&);      // 指定ID添加对象，一般调用该方法
    virtual ObjectPrx addWithUUID(const ObjectPtr&);               // 自动生成对象标示来添加对象，仅仅临时的服务对象调用该方法添加
virtual ObjectPtr remove(const Identity&);                     // 从objectadapter的ASM中移除一个服务对象

    virtual ObjectPrx createProxy(const Identity&) const;          // 创建servant对应的代理对象
    virtual ObjectPrx createDirectProxy(const Identity&) const;    // 创建servant的直接代理对象
    virtual ObjectPrx createIndirectProxy(const Identity&) const;  // 创建servant的间接代理对象
6、在生成的ICE接口方法代码中，每个映射方法的后面都携带了一个current参数，Current的定义如下：
   module Ice 
   {
        local dictionary<string, string> Context;
        enum OperationMode { Normal, \Idempotent };
        local struct Current 
   {
            ObjectAdapter adapter;    // 服务器的对象适配器，可以通过它再调用getCommunicator得到通信器
Connection con;           // 连接对象
            Identity id;              // 服务对象标示
            string facet;             // 
            string operation;         // 操作的名称
            OperationMode mode;       // 操作模式
            Context ctx;              // 操作上下文属性
int requestId;            // 请求ID
        };
    };