Ice系列--傻瓜式服务开发IceBox

前言

　　相信大家在没有接触过框架之前，都自己或多或少的开发过一些应用服务。每个应用服务除了业务配置还有很多环境配置，资源配置等，这些跟部署相关的配置。服务跟配置文件是一种静态绑定的方式，更新配置还需要重启服务；即使要支持热加载配置，还需要自己实现一套机制。这种静态的方式缺乏灵活性，而且在微服务盛行的今天，无法应对服务的集中配置管理的需求。

　　为了解决这一问题，服务配置器模式（The Service Configurator pattern）被提了出来。服务配置器模式主要思想就是将服务实现与配置分离，实际上这就意味着配置进入通用超级服务（也就是服务管理程序）的服务程序可以被动态的加载。IceBox就是一种基于服务配置器模式实现的框架。

一个IceBox Server可以替换一个平时开发的庞大Ice Server。IceBox Server可以通过特定功能的服务进行远程配置。IceBox框架有以下几个优点：

• 配置进同一个IceBox Server的服务可以进行组合优化。例如Service-A和Service-B都配置在同一个IceBox Server时，Service-A调用Service-B的操作不需要走通常的RPC调用流程，直接可以像本地调用一样，不走TCP/UDP网络。
• 可以直接通过配置组成一个应用，不再需要编译链接。使得服务与应用分离，使得服务可以根据需要被组合和拆分。
• 对于Java应用而言，多个服务被组合在一个JVM实例中，相比于运行多个JVM实例的庞大应用服务，节约了系统资源。
• IceBox支持被集成到IceGrid中，可以进行统一的服务管理和部署。

开发IceBox服务

IceBox Service的接口

写一个IceBox服务需要实现IceBox Service的接口，一个启动服务接口--“start”，一个停止服务接口--"stop"。slice定义如下：

module IceBox
{
    local interface Service
    {
        void start(string name, Ice::Communicator communicator,
            Ice::StringSeq args);
        void stop();
    }
}
                

Ice服务实例（C++11）

完整源码见：https://github.com/GodMonking/ice-demo/tree/main/IceBox

slice文件

module Demo {

    interface Hello{

        void HelloWorld();

    }

}

上述接口Hello的实现类HelloI参考《Ice框架介绍》中的例子。

接下来实现一个IceBox服务，继承IceBox::Service，并实现启动和停止接口即可，代码实现如下：

//HelloServiceI.h

#include <IceBox/IceBox.h>

class HelloServiceI : public IceBox::Service
{
　　public:
   　　virtual void start(const std::string&, const std::shared_ptr<Ice::Communicator>&, const Ice::StringSeq&) override;
   　　virtual void stop() override;
　　private:
   　　std::shared_ptr<Ice::ObjectAdapter> _adapter;
};

//HelloServiceI.cpp

#include <Ice/Ice.h>
#include <HelloServiceI.h>
#include <HelloI.h>

using namespace std;
using namespace Demo;
extern "C"
{
    ICE_DECLSPEC_EXPORT IceBox::Service*
    create(const shared_ptr<Ice::Communicator>&)
    {
        return new HelloServiceI;
    }
}

void
HelloServiceI::start(const string &name,
                    const shared_ptr<Ice::Communicator>& communicator,
                    const Ice::StringSeq& args)
{
    _adapter = communicator->createObjectAdapter(name);
    auto object = make_shared<HelloI>();
    _adapter->add(object, Ice::stringToIdentity("HelloImp"));
    _adapter->activate();
    cout << "service start complete" << endl;
}

void
HelloServiceI::stop()
{
    _adapter->deactivate();
}

函数接口create就是IceBox服务实例创建入口。

Makefile如下：

CPP=c++
CXXFLAGS= -g -DICE_CPP11_MAPPING -m64 -O0 -fPIC -std=c++11
INC= -I.
LINK_LIB= -lIce++11 -lpthread

all: helloserver client

HelloServiceI.o:HelloServiceI.cpp HelloServiceI.h
    $(CPP) $(CXXFLAGS) $(INC) -c HelloServiceI.cpp
Client.o:Client.cpp Hello.h
    $(CPP) $(CXXFLAGS) $(INC) -c Client.cpp
Hello.o:Hello.cpp Hello.h
    $(CPP) $(CXXFLAGS) $(INC) -c Hello.cpp
HelloI.o:Hello.cpp Hello.h
    $(CPP) $(CXXFLAGS) $(INC) -c HelloI.cpp

helloserver:HelloServiceI.o Hello.o HelloI.o
    $(CPP) -shared -o libHelloI++11.so HelloServiceI.o Hello.o HelloI.o $(LINK_LIB)
client:Client.o Hello.o
    $(CPP) -o client Client.o Hello.o $(LINK_LIB)

clean:
    rm *.o libHelloI++11.so client -rf

最终编译得到libHelloI++11.so，即服务以动态库的形式被IceBox加载。服务启动命令：

icebox++11 –Ice.Config=config_path

配置IceBox服务

配置文件config-v1

IceBox.InstanceName=Mongking 1
IceBox.InheritProperties=1
IceBox.PrintServicesReady=MkIceBox 1
IceBox.ServiceManager.Endpoints=tcp -p 9999

#performance properties
IceBox.ThreadPool.Server.Size=4
IceBox.ThreadPool.Server.SizeMax=100
IceBox.ThreadPool.Server.SizeWarn=40
IceBox.ThreadPool.Client.Size=4
IceBox.ThreadPool.Client.SizeMax=100
IceBox.ThreadPool.Client.SizeWarn=40

#for system stronger
Ice.ACM.Client=300
Ice.ACM.Server=300

#log and trace
#Ice.LogFile=iceserver.log
Ice.PrintStackTraces=1
Ice.Trace.Network=2
Ice.Trace.ThreadPool=1
Ice.Warn.Connections=1
Ice.Warn.Dispatch=1
Ice.Warn.Endpoints=1

#服务配置
IceBox.Service.Hello=HelloI:create
Hello.Endpoints=tcp -p 20000

这里重点解释一下最后两行配置，“IceBox.Service.Hello”定义了一个名为Hello的IceBox服务，而值“HelloI:create”指明了该服务实例创建的入口即动态库libHelloI++11.so的create函数。

“Hello.Endpoints”表示Hello服务地址端口。

当然我们也可以配置多个服务实例到IceBox中，Config-v2:

…
#服务配置
IceBox.Service.Hello1=HelloI:create
Hello.Endpoints=tcp -p 20001
IceBox.Service.Hello2=HelloI:create
Hello.Endpoints=tcp -p 20002
IceBox.Service.Hello3=HelloI:create
Hello.Endpoints=tcp -p 20003

结尾

IceBox作为Ice架构体系中非常重要的组件，分离了服务实现和配置管理，简化了服务开发和提高了配置的灵活性，是基于IceGrid灵活部署方案的基础。