比特币源码研读12-程序入口函数解析(11)

接着上一讲,这一讲继续讲解函数AppInitParameterInteraction。这个函数代码有点多,刚大概数了下,到RPC命令注册函数这里差不多一半,也就是说,我们已经研读了该函数的一半代码,只剩下一半了。坚持吧,骚年,胜利女神就在不远处向我们招手。

下面就是RPC命令注册函数,一行代码,看似简单,实则内涵丰富的很呢。

RegisterAllCoreRPCCommands(tableRPC);

在 register.h 便可找到其定义,函数里面又包含有五个格式类似的函数。这几乎注册了所有核心的命令,包括区块链、P2P网络、常用工具、挖矿以及交易等核心命令。

static inline void RegisterAllCoreRPCCommands(CRPCTable &t)

{

    RegisterBlockchainRPCCommands(t);

    RegisterNetRPCCommands(t);

    RegisterMiscRPCCommands(t);

    RegisterMiningRPCCommands(t);

    RegisterRawTransactionRPCCommands(t);

}

1. 区块链之RPC命令

根据目录结构以及命名规则,很容易就可以找到第一个注册函数RegisterBlockchainRPCCommands实现于 rpc 目录下的blockchain.cpp.

void RegisterBlockchainRPCCommands(CRPCTable &t)

{

    for (unsigned int vcidx = 0; vcidx < ARRAYLEN(commands); vcidx++)

        t.appendCommand(commands[vcidx].name, &commands[vcidx]);

}

commands 是一个命令数组,存储了所有blockchain命令,如下图所示。然后将命令追加到CRPCTable,CRPCTable 即调度表变量,专门用来存储RPC命令。

2. P2P网络之RPC命令

位于 net.cpp,与blockchain RPC同样的道理,将P2P 网络的命令添加到 CRPCTable变量,完成注册命令的功能。

void RegisterNetRPCCommands(CRPCTable &t)

{

    for (unsigned int vcidx = 0; vcidx < ARRAYLEN(commands); vcidx++)

        t.appendCommand(commands[vcidx].name, &commands[vcidx]);

}

以下为P2P网络的命令集合:

3. 常用工具之RPC命令

misc.cpp 中定义RegisterMiscRPCCommands函数如下:

void RegisterMiscRPCCommands(CRPCTable &t)

{

    for (unsigned int vcidx = 0; vcidx < ARRAYLEN(commands); vcidx++)

        t.appendCommand(commands[vcidx].name, &commands[vcidx]);

}

所有命令都存于常量数组 commands。

下面的截图就是调用getinfo命令返回的结果,其中就有客户端版本,网络协议版本,钱包版本以及该钱包余额,当前区块高度,挖矿难度等,都是经常看到也经常用到的数据,有兴趣可以看看源码深入了解下。

tips: 命令输入路径:比特币核心 -- Help 菜单 -- Debug window

4. 挖矿之RPC命令

挖矿命令注册函数RegisterMiningRPCCommands定义于mining.cpp:

void RegisterMiningRPCCommands(CRPCTable &t)

{

    for (unsigned int vcidx = 0; vcidx < ARRAYLEN(commands); vcidx++)

        t.appendCommand(commands[vcidx].name, &commands[vcidx]);

}

所有挖矿命令如下图所示,其中,getmininginfo命令可以查看当前的区块高度,大小,挖矿难度值,网络哈希值,交易池大小等。

5. 交易之RPC命令

交易命令注册函数RegisterRawTransactionRPCCommands定义于rawtransaction.cpp:

void RegisterRawTransactionRPCCommands(CRPCTable &t)

{

    for (unsigned int vcidx = 0; vcidx < ARRAYLEN(commands); vcidx++)

        t.appendCommand(commands[vcidx].name, &commands[vcidx]);

}

所有交易命令如下图所示,

接下来就是注册钱包的RPC命令,根据宏定义判断是否使用了钱包模块,是的话才需要注册RPC命令。

#ifdef ENABLE_WALLET

    RegisterWalletRPCCommands(tableRPC);

#endif

首先判断参数-disablewallet,如果为true,那么直接退出;反之,将所有钱包命令加总在CRPCTable。其中,命令均在 rpcwallet.cpp文件里面。

void RegisterWalletRPCCommands(CRPCTable &t)

{

    if (GetBoolArg("-disablewallet", false))

        return;

    for (unsigned int vcidx = 0; vcidx < ARRAYLEN(commands); vcidx++)

        t.appendCommand(commands[vcidx].name, &commands[vcidx]);

}


继续往下看,-timeout是设置连接超时的参数,如果该值为非正数,那么将设置为默认的5000毫秒,即5秒。

nConnectTimeout = GetArg("-timeout", DEFAULT_CONNECT_TIMEOUT);

    if (nConnectTimeout <= 0)

        nConnectTimeout = DEFAULT_CONNECT_TIMEOUT;

这一节讲的RPC命令挺实用的,大家可以多了解一下,方便以后的网站或应用开发。下一节继续我们的参数交互之旅。有问题欢迎留言,一起探讨哦。

区块链研习社源码研读班 Jacky

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
平台声明:文章内容(如有图片或视频亦包括在内)由作者上传并发布,文章内容仅代表作者本人观点,简书系信息发布平台,仅提供信息存储服务。

推荐阅读更多精彩内容