接着上一讲,这一讲继续讲解函数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