Fabric 1.0原始碼分析(9)configtx（配置交易）體系介紹

尹成發表於2018-05-20
原始碼
# Fabric 1.0原始碼筆記 之 configtx（配置交易）

## 1、configtx概述

configtx程式碼分佈在common/configtx目錄，目錄結構如下：

* api目錄，核心介面定義，如Manager、Resources、Transactional、PolicyHandler、Proposer、Initializer。
* initializer.go，Resources和Initializer介面實現。
* template.go，Template介面定義及實現。
* config.go，ConfigResult介面定義及實現。
* manager.go/update.go，Manager介面實現。
* util.go，configtx工具函式。

## 2、Template介面定義及實現

### 2.1、Template介面定義

```go
type Template interface {
    Envelope(chainID string) (*cb.ConfigUpdateEnvelope, error)
}
//程式碼在common/configtx/template.go
```

ConfigUpdateEnvelope定義：

```go
type ConfigUpdateEnvelope struct {
    ConfigUpdate []byte //type ConfigUpdate struct
    Signatures []*ConfigSignature //type ConfigSignature struct
}

type ConfigUpdate struct {
    ChannelId string
    ReadSet *ConfigGroup //type ConfigGroup struct
    WriteSet *ConfigGroup //type ConfigGroup struct
}

type ConfigSignature struct {
    SignatureHeader []byte
    Signature []byte
}

type ConfigGroup struct {
    Version uint64
    Groups map[string]*ConfigGroup
    Values map[string]*ConfigValue
    Policies map[string]*ConfigPolicy
    ModPolicy string
}
//程式碼在protos/common/configtx.pb.go
```

### 2.2、Template介面實現（simpleTemplate）

```go
type simpleTemplate struct {
    configGroup *cb.ConfigGroup
}

func NewSimpleTemplate(configGroups ...*cb.ConfigGroup) Template {
    sts := make([]Template, len(configGroups))
    for i, group := range configGroups {
        sts[i] = &simpleTemplate{
            configGroup: group,
        }
    }
    return NewCompositeTemplate(sts...)
}

func (st *simpleTemplate) Envelope(chainID string) (*cb.ConfigUpdateEnvelope, error) {
    config, err := proto.Marshal(&cb.ConfigUpdate{
        ChannelId: chainID,
        WriteSet: st.configGroup,
    })
    return &cb.ConfigUpdateEnvelope{
        ConfigUpdate: config,
    }, nil
}
//程式碼在common/configtx/template.go
```

### 2.3、Template介面實現（compositeTemplate）

```go
type compositeTemplate struct {
    templates []Template
}

func NewCompositeTemplate(templates ...Template) Template {
    return &compositeTemplate{templates: templates}
}

func (ct *compositeTemplate) Envelope(chainID string) (*cb.ConfigUpdateEnvelope, error) {
    channel := cb.NewConfigGroup()
    for i := range ct.templates {
        configEnv, err := ct.templates[i].Envelope(chainID)
        config, err := UnmarshalConfigUpdate(configEnv.ConfigUpdate)
        err = copyGroup(config.WriteSet, channel)
    }

    marshaledConfig, err := proto.Marshal(&cb.ConfigUpdate{
        ChannelId: chainID,
        WriteSet: channel,
    })
    return &cb.ConfigUpdateEnvelope{ConfigUpdate: marshaledConfig}, nil
}
//程式碼在common/configtx/template.go
```

### 2.4、Template介面實現（modPolicySettingTemplate）

```go
type modPolicySettingTemplate struct {
    modPolicy string
    template Template
}

func NewModPolicySettingTemplate(modPolicy string, template Template) Template {
    return &modPolicySettingTemplate{
        modPolicy: modPolicy,
        template: template,
    }
}

func (mpst *modPolicySettingTemplate) Envelope(channelID string) (*cb.ConfigUpdateEnvelope, error) {
    configUpdateEnv, err := mpst.template.Envelope(channelID)
    config, err := UnmarshalConfigUpdate(configUpdateEnv.ConfigUpdate)
    setGroupModPolicies(mpst.modPolicy, config.WriteSet)
    configUpdateEnv.ConfigUpdate = utils.MarshalOrPanic(config)
    return configUpdateEnv, nil
}
//程式碼在common/configtx/template.go
```

## 3、configtx工具函式

```go
func UnmarshalConfig(data []byte) (*cb.Config, error)
func UnmarshalConfigOrPanic(data []byte) *cb.Config
func UnmarshalConfigUpdate(data []byte) (*cb.ConfigUpdate, error)
func UnmarshalConfigUpdateOrPanic(data []byte) *cb.ConfigUpdate
func UnmarshalConfigUpdateEnvelope(data []byte) (*cb.ConfigUpdateEnvelope, error)
func UnmarshalConfigUpdateEnvelopeOrPanic(data []byte) *cb.ConfigUpdateEnvelope
func UnmarshalConfigEnvelope(data []byte) (*cb.ConfigEnvelope, error)
func UnmarshalConfigEnvelopeOrPanic(data []byte) *cb.ConfigEnvelope
//程式碼在common/configtx/util.go
```

## 4、Resources介面定義及實現

### 4.1、Resources介面定義

```go
type Resources interface {
    PolicyManager() policies.Manager //獲取通道策略管理器，即policies.Manager
    ChannelConfig() config.Channel //獲取通道配置
    OrdererConfig() (config.Orderer, bool) //獲取Orderer配置
    ConsortiumsConfig() (config.Consortiums, bool) //獲取config.Consortiums
    ApplicationConfig() (config.Application, bool) //獲取config.Application
    MSPManager() msp.MSPManager //獲取通道msp管理器，即msp.MSPManager
}
//程式碼在common/configtx/api/api.go
```

### 4.2、Resources介面實現

Resources介面實現，即resources結構體及方法。

```go
type resources struct {
    policyManager *policies.ManagerImpl
    configRoot *config.Root
    mspConfigHandler *configtxmsp.MSPConfigHandler
}
//程式碼在common/configtx/initializer.go
```

涉及方法如下：

```go
//獲取r.policyManager
func (r *resources) PolicyManager() policies.Manager
//獲取r.configRoot.Channel()
func (r *resources) ChannelConfig() config.Channel
//獲取r.configRoot.Orderer()
func (r *resources) OrdererConfig() (config.Orderer, bool)
//獲取r.configRoot.Application()
func (r *resources) ApplicationConfig() (config.Application, bool)
//獲取r.configRoot.Consortiums()
func (r *resources) ConsortiumsConfig() (config.Consortiums, bool)
//獲取r.mspConfigHandler
func (r *resources) MSPManager() msp.MSPManager
//構造resources
func newResources() *resources
//程式碼在common/configtx/initializer.go
```









網址：http://www.qukuailianxueyuan.io/



欲領取造幣技術與全套虛擬機器資料

區塊鏈技術交流QQ群：756146052  備註：CSDN

尹成學院微信：備註：CSDN






網址：http://www.qukuailianxueyuan.io/



欲領取造幣技術與全套虛擬機器資料

區塊鏈技術交流QQ群：756146052  備註：CSDN

尹成學院微信：備註：CSDN

相關文章