從 main 函數開始
首先注冊 command, option 以及 subcommand ,每個 command 都是一個 App 對象，并為每個 App 對象設置回調set_callback。
獲取程序啟動時的指定參數，解析參數，從 App 對象的樹形結構中，找到指定的command 的，然后執行對應的回調函數。
設置命令及參數
- 聲名第一個
App類的對象，相當于cleos,再看指針，通過App的成員函數add_subcommand()實現，成功地實現了鏈表 -
add_subcommand函數 將option添加到vector subcommands_里，返回一個App對象, 返回的App對象可以繼續add_subcommand,形成一個樹型結構。 -
require_subcommand函數指定該 command 不是一個單獨有效的命令，需要一個subcommand. -
add_option函數將 創建Option對象，并將指針保存在vector options_中，每個對象可以無限擴展配置選項。 -
option調用required()方法，表示這個option需要一個參數 -
add_flag添加flag （不帶參數），內部會調用add_option方法。 -
set_callback函數給每個App對象設置一個回調.
option 對象
屬性
-
expected_:該option需要幾個參數 -
required_: 是否需要參數 -
pname_: 參數名，且不含前綴-或-- -
snames_: 參數名，以-為前綴 -
lnames_: 參數名，以--為前綴
解析參數
解析參數調用
app.parse(argc, argv);
parse
將命令行參數，存放在vector args 中,
std::vector<std::string> parse(int argc, char **argv) {
name_ = argv[0];
std::vector<std::string> args;
for(int i = argc - 1; i > 0; i--)
args.emplace_back(argv[i]);
return parse(args);
}
調用另一個parse方法
/// The real work is done here. Expects a reversed vector.
/// Changes the vector to the remaining options.
std::vector<std::string> &parse(std::vector<std::string> &args) {
_validate();
_parse(args);
run_callback();
return args;
}
_validate
首先_validate這個方法里檢查option選項有沒有沖突的
/// Check the options to make sure there are no conficts.
///
/// Currenly checks to see if mutiple positionals exist with -1 args
void _validate() const {
auto count = std::count_if(std::begin(options_), std::end(options_), [](const Option_p &opt) {
return opt->get_expected() == -1 && opt->get_positional();
});
if(count > 1)
throw InvalidError(name_ + ": Too many positional arguments with unlimited expected args");
for(const App_p &app : subcommands_)
app->_validate();
}
expected 解釋如下
/// The number of expected values, 0 for flag, -1 for unlimited vector
int expected_{1};
即， 0 代表的是添加的 flag 選項， -1 代表無限制的vector 選項
如果有相同名字的 vector 類型參數被指定，回拋出異常。
_parse
- 函數
void _parse(std::vector<std::string> &args)中， 首先循環調用_parse_single方法，處理參數所有參數。 - 處理當前
app對象的所有option對象，當該option被解析過后，調用該option的回調函數，將 解析后的results_作為參數，如下
/// Process the callback
void run_callback() const {
if(!callback_(results_))
throw ConversionError(get_name() + "=" + detail::join(results_));
if(!validators_.empty()) {
for(const std::string &result : results_)
for(const std::function<bool(std::string)> &vali : validators_)
if(!vali(result))
throw ValidationError(get_name() + "=" + result);
}
}
_parse_single
_parse_single 函數將參數分成POSITIONAL_MARK、SUBCOMMAND、LONG、SHORT、NONE五個種類。
-
SUBCOMMAND代表解析的該參數在subcommands列表中 -
LONG代表參數--XXX -
SHORT代表參數-XXX -
NONE代表參數XXX -
POSITIONAL_MARK攢不知什么作用
_parse_subcommand
如果找到對應名字的 subcommand (com)對象,彈出最后一個參數，執行 com->_parse(args)
_parse_long
取出當前參數，--name=value 格式，找出對應的option，設置給result 屬性
_parse_short
取出當前參數，-name 格式, 查找對應 option 對象，根據 option 對象的 expected 字段，接受剩余的 參數，并設置給 option 的result 屬性
_parse_positional
如果當前已接受的option 參數個數還未到達expected的數量，添加到vector parse_order_ 中。
callback
每個 command 或者 option 都可以設置一個回調， 解析命令行的參數后，會依次調用這些 callback
以新建一個賬戶為例:
createAccount->set_callback([this] {
if( !active_key_str.size() )
active_key_str = owner_key_str;
public_key_type owner_key, active_key;
try {
owner_key = public_key_type(owner_key_str);
} EOS_RETHROW_EXCEPTIONS(public_key_type_exception, "Invalid owner public key: ${public_key}", ("public_key", owner_key_str));
try {
active_key = public_key_type(active_key_str);
} EOS_RETHROW_EXCEPTIONS(public_key_type_exception, "Invalid active public key: ${public_key}", ("public_key", active_key_str));
auto create = create_newaccount(creator, account_name, owner_key, active_key);
if (!simple) {
if ( buy_ram_eos.empty() && buy_ram_bytes_in_kbytes == 0) {
.......
send_actions( { create, buyram, delegate } );
} else {
send_actions( { create, buyram } );
}
} else {
send_actions( { create } );
}
});
這段回調最終走到 send_actions , 再到 push_actions
void send_actions(std::vector<chain::action>&& actions, int32_t extra_kcpu = 1000, packed_transaction::compression_type compression = packed_transaction::none ) {
auto result = push_actions( move(actions), extra_kcpu, compression);
if( tx_print_json ) {
cout << fc::json::to_pretty_string( result ) << endl;
} else {
print_result( result );
}
}
fc::variant push_actions(std::vector<chain::action>&& actions, int32_t extra_kcpu, packed_transaction::compression_type compression = packed_transaction::none ) {
signed_transaction trx;
trx.actions = std::forward<decltype(actions)>(actions);
return push_transaction(trx, extra_kcpu, compression);
}
打包交易數據后，然后會走到push_transaction
fc::variant push_transaction( signed_transaction& trx, int32_t extra_kcpu = 1000, packed_transaction::compression_type compression = packed_transaction::none ) {
......
if (!tx_dont_broadcast) {
return call(push_txn_func, packed_transaction(trx, compression));
} else {
return fc::variant(trx);
}
}
最終會走到 call(push_txn_func, packed_transaction(trx, compression));
跟蹤push_txn_func會發現是個字符串
const string chain_func_base = "/v1/chain";
const string push_txn_func = chain_func_base + "/push_transaction";
call 函數最終調用：
template<typename T>
fc::variant call( const std::string& url,
const std::string& path,
const T& v ) {
try {
eosio::client::http::connection_param *cp = new eosio::client::http::connection_param(context, parse_url(url) + path,
no_verify ? false : true, headers);
return eosio::client::http::do_http_call( *cp, fc::variant(v), print_request, print_response );
}
catch(boost::system::system_error& e) {
......
}
}
do_http_call 函數就將打包好的參數，path 信息以http請求的形式發送出去了，返回值給cleos在命令行輸出
