• eosiolib文件解析


    Source base on EOS version: 1.0.5,some photo except.
     
    在eos源码中,eosiolib库在源码中的位置如下:
    在eoscontractseosiolib一共有46个文件,其中很大部分都为头文件,具体的实现都在 eos/libraries/chain/wasm_interface.cpp中,下面我们对每个文件都做一个较为简单的介绍。
     

    action.h

    此头文件为接口函数,这些C API函数是在 eos/libraries/chain/wasm_interface.cpp 中实现的,主要提供给四大合约使用。
    主要包含有这些功能 :
    • action数据的读取;
    • 事务提交后的通知消息(观察者模式实现);
    • 执行action所需要的权限判断;
    • 其它辅助函数;
     

    action.hpp

    在action.hpp中定义了action结构体,它是Action打包后的数据形式,即所有push action产生的数据根据各自不同的数据格式进行封装打包和传送。其中还涉及到一些执行权限相关的结构体的定义permission_level,它的处理流程如下图展示:
    最后action将会放在对应的vector迭代器中。
     

    asset.hpp

    帐户资产的定义,即一个int64_t表示资金,symbol_type表示单位,目前被定义为SYS。
     

    chain.h

    查询区块链内部状态的API,目前用于获取活跃(Active)的生产者,是从controller中拿取的,源码在eos/libraries/chain/wasm_interface.cpp中实现。
     

    compiler_builtins.h

    工具链生成的编译器内嵌部件的API。
     

    contract.hpp

    定义所有智能合约的基类,如果自己写合约,需要从这个基类派生,然后使用eosiocpp工具将自己的头文件和源文件生成wasm文件及其相关的接口文件。编写智能合约需要注意各个文件名需要名称相同,因为加载智能合约时填写的参数是根据智能合约文件路径来的。
     

    core_symbol.hpp

    定义代币的单位。
     

    crypto.h

    对给定的数据进行各种hash运算并进行存储,或者对数据进行校验。源码在eos/libraries/chain/wasm_interface.cpp中实现。
     

    currency.hpp

    货币(token合约)的创建、发行、转帐、余额查询在里实现。
     

    datastream.hpp & serialize.hpp

    定义数据流操作,可以把自定义的类的数据成员放到vector<char>中,需要时可以再次读取出来,方便数据的传输。
     

    db.h

    函数都在eos/libraries/chain/wasm_interface.cpp中的database_api类中定义,部分直接定义,部分采用宏定义,源码实现在eoslibrarieschainapply_context.cpp中。提供了数据库的存储与查询的基本功能。其中使用的数据库是controller类中定义的数据,在这里只是一个引用。
     

    dispatcher.hpp

    定义了执行Action的函数模板execute_action,使用远程API调用Action时,会执行这个函数。其中有两个宏:
    • EOSIO_API_CALL  内部调用了execute_action函数,执行一个Action;
    • EOSIO_API 使用BOOST_PP_SEQ_FOR_EACH循环调用EOSIO_API_CALL,即调用多个Action;
    • EOSIO_ABI 里面是一个apply函数,后面还调用EOSIO_API这个宏,即它也是用来调用 execute_action来执行action的,在我们自行编写智能合约的时候在类内部最后会加上这个宏。所以当我们加载自己编写的智能合约时,会把编写好的指定的函数功能放到action上面去执行。
     

    eosio.hpp

    包含其它一些类型的定义。在开发智能合约时,一般都包含这个头文件进行智能合约的开发。
     

    eosiolib.cpp & memory.h & memory.hpp

    eosiolib中实现了eosio项目中自定义的内存管理,对常见的内存分配方式进行了重新编写(其实只是简单的封装而已)
     

    fixed_key.hpp

    固定大小的按键按字典顺序排序的key,使用数据成员std::array<word_t, num_words()>实现的。
     

    fixedpoint.hpp

    32/64/128/256位版本的不动点变量,暂时还不知道做什么用的。
     

    multi_index.hpp

    重新封装了多索引容器模板,最终里面还是使用的boost:multi_index,这一点没有变化,它具有以下几个特点:
    • Multi-Index表的二级索引数量不能超过16个;
    • Multi-Index表的表名不能超过12个字符;
    • Multi-Index表支持双向迭代,即const_iterator和const_reverse_iterator。
     
    很多类型都使用了它来存放,如生产者,投票,单例等等。
     

    optional.hpp

    可选类型,与boost:optinal基本一致
     

    permission.h & permission.hpp

    在eos/libraries/chain/wasm_interface.cpp的permission_api类中实现,事务提交时需要检验执行者的权限在这里。具体的校验在controller定义的数据库去比对了。
     

    print.h & print.hpp

    eosio中各种参数类型打印函数的定义,最终使用的是std::ostringstream类型。
     

    privileged.h & privileged.hpp、

    定义特权用户的各种资源限制,事务相关参数,块相关参数,以及数据传输时间间隔的各种限制。
     

    producer_schedule.hpp

    出块者相关信息的封装。
     

    public_key.hpp

    公匙
     

    reflect.hpp

    c++实现的反射器,带有大量的宏,可以自行分析下,下面有一个博客对此有些讲解:
     

    singleton.hpp

    单例模式的封装,也存储在multi_index中。
     

    stdlib.hpp

    //nothing
     

    symbol.hpp

    代币符号,规定为SYS
     

    system.h

    系统时间函数和静态断言的定义
     

    time.hpp

    时间相关,类似boost中的实现
     

    transaction.h & transaction.hpp

    事务相关,主要是对action用vector封装,另外,对nsaction的数据传输也做了各种限制,如预期时间,带宽,cpu算力,延迟传输等等。还有一个get action函数的实现,可以获取当前区块相关的数据。
     

    types.h & types.hpp

    eosiolib所有使用到的类型都在这里定义,以及name标识符与std::string类型之间转换函数的定义;
    所有文件相互间的引用关系如下:
     

    varint.hpp

    整型的定义,在datastream中有应用。
     

    vector.hpp

    字节数组
  • 相关阅读:
    反射
    IO流
    集合(下)
    集合(上)
    泛型
    异常
    常用类
    内部类
    将博客搬至CSDN
    DBMS_ERRLOG记录DML错误日志(二)
  • 原文地址:https://www.cnblogs.com/hbright/p/9234908.html
Copyright © 2020-2023  润新知