OpenRTMFP/Cumulus Primer（4）CumulusServer启动流程分析
OpenRTMFP/Cumulus Primer（4）CumulusServer启动流程分析
- 作者：柳大·Poechant（钟超）
- 博客：Blog.CSDN.net/Poechant
- 邮箱：zhongchao.ustc#gmail.com (# -> @)
- 日期：April 14th, 2012
首先要知道的是，OpenRTMFP/Cumulus中使用到的库有 Poco、OpenSSL 和 Lua。
1 main.cpp 中的 main() 函数
入口在 main.cpp 中：
int main(int argc, char* argv[]) {
先检查内存泄露，不过目前这个开发中的项目还没有实现这个功能，只是个空函数：
DetectMemoryLeak();
然后会创建一个匿名的 CumulusServer 对象，并调用其 run() 函数，该函数由 CumulusServer 从 ServerApplication 中继承而来，而 ServerApplication 由是从 Application 继承而来的。CumulusServer 对象调用 run() 函数，实际是 ServerApplication 的 run() 函数，ServerApplication 的 run() 函数则是调用 Application 的函数，而该 run() 函数则是先调用 initialize() 函数，然后调用 main() 函数，然后调用 uninitialize() 函数。如果 initialize() 函数被调用时抛出异常，则不会执行 main() 函数，但仍然会执行 uninitialize() 函数：
// Runs the application by performing additional initializations
// and calling the main() method.
return CumulusServer().run(argc, argv);
}
2 main.cpp 中的 CumulusServer() 构造函数
CumulusServer 的构造函数定义为：
CumulusServer(): _helpRequested(false), // 显示帮助信息
_pCirrus(NULL),
_middle(false),
_isInteractive(true),
_pLogFile(NULL) {
}
3 main.cpp 中的 CumulusServer 的 initialize() 成员函数
在执行 main() 函数之前，CumulusServer 会启动 initialize() 函数，传入的参数就是 CumulusServer 自己，可以猜到 Poco::Util::Application 的 run 方法中，调用该函数时的参数是this。
void initialize(Application& self) {
调用父函数 ServerApplication 的初始化函数：
ServerApplication::initialize(self);
再继续下面的源码分析之前，先要知道，根据Poco::Util::Application，Application 类有一些内置的配置属性，如下：
- application.path: 可执行文件的绝对路径；
- application.name: 可执行文件的文件名（含扩展名）；
- application.baseName: 可执行文件的文件名（不含扩展名）
- application.dir: 可执行文件的所在目录；
- application.configDir: 配置文件所在目录；
所以下面就读取了可执行文件的所在目录，其中第二个参数表示默认值（即当前目录）：
string dir = config().getString("application.dir", "./");
然后读取配置文件，目录为上一句所得到的dir，文件名（不含扩展名）为application.basename内置配置属性值，其默认值为CumulusServer，然后加上点和扩展名.ini。
loadConfiguration(dir
+ config().getString("application.baseName", "CumulusServer")
+ ".ini");
这样就加载完配置了。然后查看当前的进程是从命令行运行的（命令行是交互的，所以是 interactive），还是以 daemon 方式运行的，这个函数是ServerApplication的一个成员函数：
_isInteractive = isInteractive();
然后获取表示日志文件所在目录的字符串，其中logs.directory是外置配置属性（配置文件中），其默认值为上面获取到的可执行文件路径（一般为当前路径）与logs的组合，即一般为当前目录下的logs目录：
string logDir(config().getString("logs.directory", dir + "logs"));
创建日志文件目录：
File(logDir).createDirectory();
日志文件绝对路径，logs为默认的日志文件名（不含扩展名的部分），扩展名用0：
_logPath = logDir + "/" + config().getString("logs.name", "log") + ".";
_pLogFile = new File(_logPath + "0");
用日志流打开日志文件（方式为追加写入）：
_logStream.open(_pLogFile->path(), ios::in | ios::ate);
Logs 是一个方法类（其中的 public 函数都是静态的），SetLogger的作用就是将Logs中的似有静态成员设置为某个 Cumulus::Logger 对象（由于 CumulusServer 继承了 Cumulus::Logger）。
Logs::SetLogger(*this);
}
4 main.cpp 中的 CumulusServer 的 main() 成员函数
OpenRTMFP/Cumulus是一个基于Poco::Util::Application的服务端应用（准确的说是基于Poco::Util::ServerApplication的服务端应用）。如果没有特殊的启动要求，可以调用Poco/Application.h中定义的宏POCO_APP_MAIN来完成初始化、日志和启动（该宏会根据不同的平台启用不同的main()函数）。
run() 函数在调用完 initialize() 函数后，会调用 CumulusServer 中的 main() 函数，该 main() 函数的定义在 main.cpp 中：
int main(const std::vector<std::string>& args) {
首先看是否是要求帮助信息，displayHelp是借助Poco::Util::HelpFormatter实现的，CumulusServer的构造函数会在调用时将_helpRequested设置为false。
if (_helpRequested) {
displayHelp();
}
如果不是，则进入启动状态，首先创建一个RTMFPServerParams对象params，用来存储OpenRTMFP/CumulusServer的基本配置信息。
else {
try {
RTMFPServerParams params;
params存储CumulusServer的端口号和CumulusEdge的端口号：
params.port = config().getInt("port", params.port);
UInt16 edgesPort = config().getInt("edges.port",
RTMFP_DEFAULT_PORT+1);
if(config().getBool("edges.activated",false)) {
if(edgesPort==0)
WARN("edges.port must have a positive value if \
edges.activated is true. Server edges is \
disactivated.");
params.edgesPort=edgesPort;
}
_pCirrus为SocketAddress的成员，是封装IP地址和端口号的对象。
params.pCirrus = _pCirrus;
params.middle = _middle;
UDB 所使用的缓冲区大小：
params.udpBufferSize = config().getInt("udpBufferSize",
params.udpBufferSize);
params.keepAliveServer = config().getInt(
"keepAliveServer",params.keepAliveServer);
params.keepAlivePeer = config().getInt("keepAlivePeer",
params.keepAlivePeer);
失败前CumulusEdge的尝试次数：
params.edgesAttemptsBeforeFallback = config().getInt(
"edges.attemptsBeforeFallback",
params.edgesAttemptsBeforeFallback);
Server server(config().getString("application.dir","./"),
*this,config());
server.start(params);
waitForTerminationRequest()函数是main()函数中必须调用的，意为等待终止运行的操作请求。
// wait for CTRL-C or kill
waitForTerminationRequest();
一旦接收到终止操作的请求，就会执行下面这句，用以退出OpenRTMFP/Cumulus的运行：
// Stop the server
server.stop();
catch 一些可能产生的异常：
} catch(Exception& ex) {
FATAL("Configuration problem : %s",ex.displayText().c_str());
} catch (exception& ex) {
FATAL("CumulusServer : %s",ex.what());
} catch (...) {
FATAL("CumulusServer unknown error");
}
}
OpenRTMFP/CumulusServer 停止运行：
return Application::EXIT_OK;
}
-
转载请注明来自柳大的CSDN博客：Blog.CSDN.net/Poechant
-