ITPub博客

首页 > 区块链 > 区块链 > 区块链教程Fabric1.0源代码分析Ledger(账本)一

区块链教程Fabric1.0源代码分析Ledger(账本)一

原创 区块链 作者:兄弟连区块链入门教程 时间:2018-10-31 16:36:27 0 删除 编辑

区块链教程 之Fabric1.0源代码分析Ledger(账本)一,2018年下半年,区块链行业正逐渐褪去发展之初的浮躁、回归理性,表面上看相关人才需求与身价似乎正在回落。但事实上,正是初期泡沫的渐退,让人们更多的关注点放在了区块链真正的技术之上。

Fabric 1.0源代码笔记 之 Ledger(账本)

1、Ledger概述

Ledger,即账本数据库。Fabric账本中有四种数据库,idStore(ledgerID数据库)、blkstorage(block文件存储)、statedb(状态数据库)、historydb(历史数据库)。
其中idStore、historydb使用leveldb实现,statedb可选择使用leveldb或couchDB。而blkstorage中index部分使用leveldb实现,实际区块链数据存储使用文件实现。

  • idStore,默认目录/var/hyperledger/production/ledgersData/ledgerProvider,更详细内容,参考:Fabric 1.0源代码笔记 之 Ledger #idStore(ledgerID数据库)

  • blkstorage,默认目录/var/hyperledger/production/ledgersData/chains,更详细内容,参考:Fabric 1.0源代码笔记 之 Ledger #blkstorage(block文件存储)

  • statedb,默认目录/var/hyperledger/production/ledgersData/stateLeveldb,更详细内容,参考:Fabric 1.0源代码笔记 之 Ledger #statedb(状态数据库)

  • historydb,默认目录/var/hyperledger/production/ledgersData/historyLeveldb,更详细内容,参考:Fabric 1.0源代码笔记 之 Ledger #historydb(历史数据库)

2、Ledger代码目录结构

Ledger相关代码分布在common/ledger、core/ledger和protos/ledger目录下。目录结构如下:

  • common/ledger目录

    • ledger_interface.go,定义了通用接口Ledger、ResultsIterator、以及QueryResult和PrunePolicy(暂时均为空接口)。

    • blkstorage目录,blkstorage相关接口及实现。

    • util/leveldbhelper目录,LevelDB数据库操作的封装。

  • core/ledger目录

    • kv_ledger_provider.go,实现PeerLedgerProvider接口,即Provider结构体及其方法,以及idStore结构体及方法。

    • kv_ledger.go,实现PeerLedger接口,即kvLedger结构体及方法。

    • txmgmt目录,交易管理。

    • history/historydb目录,historydb相关接口及实现。

    • statedb目录,statedb相关接口及实现。

    • ledger_interface.go,定义了核心接口PeerLedgerProvider、PeerLedger、ValidatedLedger(暂时未定义)、QueryExecutor、HistoryQueryExecutor和TxSimulator。

    • kvledger目录,目前PeerLedgerProvider、PeerLedger等接口仅有一种实现即:kvledger。

    • ledgermgmt/ledger_mgmt.go,Ledger管理相关函数实现。

    • ledgerconfig/ledger_config.go,Ledger配置相关函数实现。

    • util目录,Ledger工具相关函数实现。

3、核心接口定义

PeerLedgerProvider接口定义:提供PeerLedger实例handle。

type PeerLedgerProvider interface {
    Create(genesisBlock *common.Block) (PeerLedger, error) //用给定的创世纪块创建Ledger
    Open(ledgerID string) (PeerLedger, error) //打开已创建的Ledger
    Exists(ledgerID string) (bool, error) //按ledgerID查Ledger是否存在
    List() ([]string, error) //列出现有的ledgerID
    Close() //关闭 PeerLedgerProvider}//代码在core/ledger/ledger_interface.go

PeerLedger接口定义:
PeerLedger和OrdererLedger的不同之处在于PeerLedger本地维护位掩码,用于区分有效交易和无效交易。

type PeerLedger interface {
    commonledger.Ledger //嵌入common/ledger/Ledger接口
    GetTransactionByID(txID string) (*peer.ProcessedTransaction, error) //按txID获取交易
    GetBlockByHash(blockHash []byte) (*common.Block, error) //按blockHash获取Block
    GetBlockByTxID(txID string) (*common.Block, error) //按txID获取包含交易的Block
    GetTxValidationCodeByTxID(txID string) (peer.TxValidationCode, error) //获取交易记录验证的原因代码
    NewTxSimulator() (TxSimulator, error) //创建交易模拟器,客户端可以创建多个"TxSimulator"并行执行
    NewQueryExecutor() (QueryExecutor, error) //创建查询执行器,客户端可以创建多个'QueryExecutor'并行执行
    NewHistoryQueryExecutor() (HistoryQueryExecutor, error) //创建历史记录查询执行器,客户端可以创建多个'HistoryQueryExecutor'并行执行
    Prune(policy commonledger.PrunePolicy) error //裁剪满足给定策略的块或交易}//代码在core/ledger/ledger_interface.go

未完待续欢迎继续关注兄弟连区块链教程分享!



来自 “ ITPUB博客 ” ,链接:http://blog.itpub.net/31557831/viewspace-2218240/,如需转载,请注明出处,否则将追究法律责任。

请登录后发表评论 登录
全部评论

注册时间:2018-10-11

  • 博文量
    79
  • 访问量
    45068