Fabric 1.0原始碼分析(27) Orderer #configupdate(處理通道配置更新)
# Fabric 1.0原始碼筆記 之 Orderer #configupdate(處理通道配置更新)
## 1、configupdate概述
configupdate,用於接收配置交易,並處理通道配置更新。
相關程式碼在orderer/configupdate目錄。
## 2、SupportManager介面定義及實現
### 2.1、SupportManager介面定義
```go
type SupportManager interface {
GetChain(chainID string) (Support, bool)
NewChannelConfig(envConfigUpdate *cb.Envelope) (configtxapi.Manager, error)
}
//程式碼在orderer/configupdate/configupdate.go
```
### 2.2、SupportManager介面實現
SupportManager介面實現,即configUpdateSupport結構體及方法。
```go
type configUpdateSupport struct {
multichain.Manager //type multiLedger struct
}
func (cus configUpdateSupport) GetChain(chainID string) (configupdate.Support, bool) {
return cus.Manager.GetChain(chainID)
}
//程式碼在orderer/server.go
```
multichain.Manager介面及實現multiLedger,見[Fabric 1.0原始碼筆記 之 Orderer #multichain(多鏈支援包)](multichain.md)
## 3、Support介面定義及實現
### 3.1、Support介面定義
```go
type Support interface {
ProposeConfigUpdate(env *cb.Envelope) (*cb.ConfigEnvelope, error)
}
//程式碼在orderer/configupdate/configupdate.go
```
### 3.2、Support介面實現
Support介面實現,即configManager結構體及方法。
```go
type configManager struct {
api.Resources
callOnUpdate []func(api.Manager)
initializer api.Initializer
current *configSet
}
func (cm *configManager) processConfig(channelGroup *cb.ConfigGroup) (*configResult, error) //./config.go
func (cm *configManager) commitCallbacks() //./manager.go
func (cm *configManager) ProposeConfigUpdate(configtx *cb.Envelope) (*cb.ConfigEnvelope, error) //./manager.go
func (cm *configManager) proposeConfigUpdate(configtx *cb.Envelope) (*cb.ConfigEnvelope, error) //./manager.go
func (cm *configManager) prepareApply(configEnv *cb.ConfigEnvelope) (*configResult, error) //./manager.go
func (cm *configManager) Validate(configEnv *cb.ConfigEnvelope) error //./manager.go
func (cm *configManager) Apply(configEnv *cb.ConfigEnvelope) error //./manager.go
func (cm *configManager) ChainID() string //./manager.go
func (cm *configManager) Sequence() uint64 //./manager.go
func (cm *configManager) ConfigEnvelope() *cb.ConfigEnvelope //./manager.go
func (cm *configManager) verifyDeltaSet(deltaSet map[string]comparable, signedData []*cb.SignedData) error //./update.go
func (cm *configManager) authorizeUpdate(configUpdateEnv *cb.ConfigUpdateEnvelope) (map[string]comparable, error) //./update.go
func (cm *configManager) policyForItem(item comparable) (policies.Policy, bool) //./update.go
func (cm *configManager) computeUpdateResult(updatedConfig map[string]comparable) map[string]comparable //./update.go
//程式碼在common/configtx/manager.go
```
## 4、ConfigUpdateProcessor介面定義及實現
### 4.1、ConfigUpdateProcessor介面定義
```go
type ConfigUpdateProcessor interface {
Process(envConfigUpdate *cb.Envelope) (*cb.Envelope, error)
}
//程式碼在orderer/common/broadcast/broadcast.go
```
### 4.2、ConfigUpdateProcessor介面實現
ConfigUpdateProcessor介面實現,即Processor結構體及方法。
```go
type Processor struct {
signer crypto.LocalSigner
manager SupportManager //即type configUpdateSupport struct,或者即multichain.multiLedger
systemChannelID string
systemChannelSupport Support
}
//構造Processor
func New(systemChannelID string, supportManager SupportManager, signer crypto.LocalSigner) *Processor
//獲取channelID
func channelID(env *cb.Envelope) (string, error)
//處理通道配置更新
func (p *Processor) Process(envConfigUpdate *cb.Envelope) (*cb.Envelope, error)
func (p *Processor) existingChannelConfig(envConfigUpdate *cb.Envelope, channelID string, support Support) (*cb.Envelope, error)
func (p *Processor) proposeNewChannelToSystemChannel(newChannelEnvConfig *cb.Envelope) (*cb.Envelope, error)
func (p *Processor) newChannelConfig(channelID string, envConfigUpdate *cb.Envelope) (*cb.Envelope, error)
//程式碼在orderer/configupdate/configupdate.go
```
#### 4.2.1、func New(systemChannelID string, supportManager SupportManager, signer crypto.LocalSigner) *Processor
```go
func New(systemChannelID string, supportManager SupportManager, signer crypto.LocalSigner) *Processor {
support, ok := supportManager.GetChain(systemChannelID)
return &Processor{
systemChannelID: systemChannelID,
manager: supportManager,
signer: signer,
systemChannelSupport: support,
}
}
//程式碼在orderer/configupdate/configupdate.go
```
#### 4.2.2、func (p *Processor) Process(envConfigUpdate *cb.Envelope) (*cb.Envelope, error)
```go
func (p *Processor) Process(envConfigUpdate *cb.Envelope) (*cb.Envelope, error) {
channelID, err := channelID(envConfigUpdate)
support, ok := p.manager.GetChain(channelID) //存在
if ok {
return p.existingChannelConfig(envConfigUpdate, channelID, support)
}
return p.newChannelConfig(channelID, envConfigUpdate) //不存在
}
//程式碼在orderer/configupdate/configupdate.go
```
#### 4.2.3、func (p *Processor) existingChannelConfig(envConfigUpdate *cb.Envelope, channelID string, support Support) (*cb.Envelope, error)
```go
func (p *Processor) existingChannelConfig(envConfigUpdate *cb.Envelope, channelID string, support Support) (*cb.Envelope, error) {
configEnvelope, err := support.ProposeConfigUpdate(envConfigUpdate)
return utils.CreateSignedEnvelope(cb.HeaderType_CONFIG, channelID, p.signer, configEnvelope, msgVersion, epoch)
}
//程式碼在orderer/configupdate/configupdate.go
```
#### 4.2.4、func (p *Processor) newChannelConfig(channelID string, envConfigUpdate *cb.Envelope) (*cb.Envelope, error)
```go
func (p *Processor) newChannelConfig(channelID string, envConfigUpdate *cb.Envelope) (*cb.Envelope, error) {
ctxm, err := p.manager.NewChannelConfig(envConfigUpdate) //建立新的通道
newChannelConfigEnv, err := ctxm.ProposeConfigUpdate(envConfigUpdate) //建立新的通道後處理通道配置
newChannelEnvConfig, err := utils.CreateSignedEnvelope(cb.HeaderType_CONFIG, channelID, p.signer, newChannelConfigEnv, msgVersion, epoch)
return p.proposeNewChannelToSystemChannel(newChannelEnvConfig)
}
//程式碼在orderer/configupdate/configupdate.go
```
## 5、詳解configManager結構體
### 5.1、configManager結構體定義及方法
```go
type configManager struct {
api.Resources
callOnUpdate []func(api.Manager)
initializer api.Initializer
current *configSet
}
func validateConfigID(configID string) error
func validateChannelID(channelID string) error
func NewManagerImpl(envConfig *cb.Envelope, initializer api.Initializer, callOnUpdate []func(api.Manager)) (api.Manager, error)
func (cm *configManager) commitCallbacks()
func (cm *configManager) ProposeConfigUpdate(configtx *cb.Envelope) (*cb.ConfigEnvelope, error)
func (cm *configManager) proposeConfigUpdate(configtx *cb.Envelope) (*cb.ConfigEnvelope, error)
func (cm *configManager) prepareApply(configEnv *cb.ConfigEnvelope) (*configResult, error)
func (cm *configManager) Validate(configEnv *cb.ConfigEnvelope) error
func (cm *configManager) Apply(configEnv *cb.ConfigEnvelope) error
func (cm *configManager) ChainID() string
func (cm *configManager) Sequence() uint64
func (cm *configManager) ConfigEnvelope() *cb.ConfigEnvelope
func proposeGroup(result *configResult) error
func processConfig(channelGroup *cb.ConfigGroup, proposer api.Proposer) (*configResult, error)
func (cm *configManager) processConfig(channelGroup *cb.ConfigGroup) (*configResult, error)
func (c *configSet) verifyReadSet(readSet map[string]comparable) error
func ComputeDeltaSet(readSet, writeSet map[string]comparable) map[string]comparable
func validateModPolicy(modPolicy string) error
func (cm *configManager) verifyDeltaSet(deltaSet map[string]comparable, signedData []*cb.SignedData) error
func verifyFullProposedConfig(writeSet, fullProposedConfig map[string]comparable) error
//驗證所有修改的配置都有相應的修改策略,返回修改過的配置的對映map[string]comparable
func (cm *configManager) authorizeUpdate(configUpdateEnv *cb.ConfigUpdateEnvelope) (map[string]comparable, error)
func (cm *configManager) policyForItem(item comparable) (policies.Policy, bool)
func (cm *configManager) computeUpdateResult(updatedConfig map[string]comparable) map[string]comparable
//Envelope轉換為ConfigUpdateEnvelope
func envelopeToConfigUpdate(configtx *cb.Envelope) (*cb.ConfigUpdateEnvelope, error)
//程式碼在common/configtx/manager.go
```
### 5.2、func (cm *configManager) ProposeConfigUpdate(configtx *cb.Envelope) (*cb.ConfigEnvelope, error)
```go
func (cm *configManager) ProposeConfigUpdate(configtx *cb.Envelope) (*cb.ConfigEnvelope, error) {
return cm.proposeConfigUpdate(configtx)
}
func (cm *configManager) proposeConfigUpdate(configtx *cb.Envelope) (*cb.ConfigEnvelope, error) {
//Envelope轉換為ConfigUpdateEnvelope
configUpdateEnv, err := envelopeToConfigUpdate(configtx)
//驗證所有修改的配置都有相應的修改策略,返回修改過的配置的對映map[string]comparable
configMap, err := cm.authorizeUpdate(configUpdateEnv)
channelGroup, err := configMapToConfig(configMap) //ConfigGroup
//實際呼叫processConfig(channelGroup, cm.initializer),並最終呼叫proposeGroup(configResult)
result, err := cm.processConfig(channelGroup)
result.rollback()
return &cb.ConfigEnvelope{
Config: &cb.Config{
Sequence: cm.current.sequence + 1,
ChannelGroup: channelGroup,
},
LastUpdate: configtx,
}, nil
}
//程式碼在common/configtx/manager.go
```
補充ConfigUpdateEnvelope:
```go
type ConfigUpdateEnvelope struct {
ConfigUpdate []byte //type ConfigUpdate struct
Signatures []*ConfigSignature
}
type ConfigUpdate struct {
ChannelId string
ReadSet *ConfigGroup
WriteSet *ConfigGroup
}
type ConfigGroup struct {
Version uint64
Groups map[string]*ConfigGroup
Values map[string]*ConfigValue
Policies map[string]*ConfigPolicy
ModPolicy string
}
//程式碼在protos/common/configtx.pb.go
```
補充ConfigGroup:
```go
### 5.3、func (cm *configManager) authorizeUpdate(configUpdateEnv *cb.ConfigUpdateEnvelope) (map[string]comparable, error)
```go
func (cm *configManager) authorizeUpdate(configUpdateEnv *cb.ConfigUpdateEnvelope) (map[string]comparable, error) {
//反序列化configUpdateEnv.ConfigUpdate
configUpdate, err := UnmarshalConfigUpdate(configUpdateEnv.ConfigUpdate)
readSet, err := MapConfig(configUpdate.ReadSet) //map[string]comparable
err = cm.current.verifyReadSet(readSet)
writeSet, err := MapConfig(configUpdate.WriteSet) //map[string]comparable
//從writeSet中逐一對比readSet,去除沒有發生變更的
deltaSet := ComputeDeltaSet(readSet, writeSet)
signedData, err := configUpdateEnv.AsSignedData() //轉換為SignedData
err = cm.verifyDeltaSet(deltaSet, signedData) //校驗deltaSet
fullProposedConfig := cm.computeUpdateResult(deltaSet) //合併為fullProposedConfig
err := verifyFullProposedConfig(writeSet, fullProposedConfig)
return fullProposedConfig, nil
}
//程式碼在common/configtx/update.go
```
補充comparable:
```go
type comparable struct {
*cb.ConfigGroup
*cb.ConfigValue
*cb.ConfigPolicy
key string
path []string
}
//程式碼在common/configtx/compare.go
```
### 5.4、func (cm *configManager) processConfig(channelGroup *cb.ConfigGroup) (*configResult, error)
```go
func (cm *configManager) processConfig(channelGroup *cb.ConfigGroup) (*configResult, error) {
configResult, err := processConfig(channelGroup, cm.initializer)
err = configResult.preCommit()
return configResult, nil
}
//程式碼在common/configtx/config.go
```
補充configResult:
```go
type configResult struct {
tx interface{}
groupName string
groupKey string
group *cb.ConfigGroup
valueHandler config.ValueProposer
policyHandler policies.Proposer
subResults []*configResult
deserializedValues map[string]proto.Message
deserializedPolicies map[string]proto.Message
}
func NewConfigResult(config *cb.ConfigGroup, proposer api.Proposer) (ConfigResult, error)
func (cr *configResult) JSON() string
func (cr *configResult) bufferJSON(buffer *bytes.Buffer)
//cr.valueHandler.PreCommit(cr.tx)
func (cr *configResult) preCommit() error
//cr.valueHandler.CommitProposals(cr.tx)
//cr.policyHandler.CommitProposals(cr.tx)
func (cr *configResult) commit()
//cr.valueHandler.RollbackProposals(cr.tx)
//cr.policyHandler.RollbackProposals(cr.tx)
func (cr *configResult) rollback()
func proposeGroup(result *configResult) error
func processConfig(channelGroup *cb.ConfigGroup, proposer api.Proposer) (*configResult, error)
//程式碼在common/configtx/config.go
```
#### 5.4.1、func processConfig(channelGroup *cb.ConfigGroup, proposer api.Proposer) (*configResult, error)
```go
func processConfig(channelGroup *cb.ConfigGroup, proposer api.Proposer) (*configResult, error) {
helperGroup := cb.NewConfigGroup()
helperGroup.Groups[RootGroupKey] = channelGroup
configResult := &configResult{
group: helperGroup,
valueHandler: proposer.ValueProposer(),
policyHandler: proposer.PolicyProposer(),
}
err := proposeGroup(configResult)
return configResult, nil
}
//程式碼在common/configtx/config.go
```
#### 5.4.2、func proposeGroup(result *configResult) error
```go
func proposeGroup(result *configResult) error {
subGroups := make([]string, len(result.group.Groups))
i := 0
for subGroup := range result.group.Groups {
subGroups[i] = subGroup
i++
}
valueDeserializer, subValueHandlers, err := result.valueHandler.BeginValueProposals(result.tx, subGroups)
subPolicyHandlers, err := result.policyHandler.BeginPolicyProposals(result.tx, subGroups)
for key, value := range result.group.Values {
msg, err := valueDeserializer.Deserialize(key, value.Value)
result.deserializedValues[key] = msg
}
for key, policy := range result.group.Policies {
policy, err := result.policyHandler.ProposePolicy(result.tx, key, policy)
result.deserializedPolicies[key] = policy
}
result.subResults = make([]*configResult, 0, len(subGroups))
for i, subGroup := range subGroups {
result.subResults = append(result.subResults, &configResult{
tx: result.tx,
groupKey: subGroup,
groupName: result.groupName + "/" + subGroup,
group: result.group.Groups[subGroup],
valueHandler: subValueHandlers[i],
policyHandler: subPolicyHandlers[i],
deserializedValues: make(map[string]proto.Message),
deserializedPolicies: make(map[string]proto.Message),
})
err := proposeGroup(result.subResults[i])
}
return nil
}
//程式碼在common/configtx/config.go
```
網址:http://www.qukuailianxueyuan.io/
欲領取造幣技術與全套虛擬機器資料
區塊鏈技術交流QQ群:756146052 備註:CSDN
尹成學院微信:備註:CSDN
網址:http://www.qukuailianxueyuan.io/
欲領取造幣技術與全套虛擬機器資料
區塊鏈技術交流QQ群:756146052 備註:CSDN
尹成學院微信:備註:CSDN
相關文章
- Fabric 1.0原始碼分析(25) Orderer原始碼
- Fabric 1.0原始碼分析(26)Orderer #ledger(Orderer Ledger)原始碼
- Fabric 1.0原始碼分析(28) Orderer #localconfig(Orderer配置檔案定義)原始碼
- Fabric 1.0原始碼分析(29) Orderer #multichain(多鏈支援包)原始碼AI
- Fabric 1.0原始碼分析(30) Orderer #BroadcastServer(Broadcast服務端)原始碼ASTServer服務端
- Fabric 1.0原始碼分析(6)configtx(配置交易) #ChannelConfig(通道配置)原始碼
- Fabric 1.0原始碼分析(7)configtx(配置交易) #configtxgen(生成通道配置)原始碼
- Fabric 1.0原始碼分析(42)scc(系統鏈碼) #cscc(通道相關)原始碼
- Fabric 1.0原始碼分析(31) Peer原始碼
- Fabric 1.0原始碼分析(8)configtx(配置交易) #genesis(系統通道創世區塊)原始碼
- Fabric 1.0原始碼分析(40) Proposal(提案)原始碼
- Fabric 1.0原始碼分析(3)Chaincode(鏈碼)原始碼AI
- Fabric 1.0原始碼分析(18) Ledger(賬本)原始碼
- Fabric 1.0原始碼分析(43) Tx(Transaction 交易)原始碼
- Fabric 1.0原始碼分析(47)Fabric 1.0.4 go程式碼量統計原始碼Go
- Fabric 1.0原始碼分析(42)scc(系統鏈碼)原始碼
- Fabric 1.0原始碼分析(13)events(事件服務)原始碼事件
- Fabric 1.0原始碼分析(39) policy(背書策略)原始碼
- Fabric 1.0原始碼分析(15)gossip(流言演算法)原始碼Go演算法
- Fabric 1.0原始碼分析(23)LevelDB(KV資料庫)原始碼資料庫
- Fabric 1.0原始碼分析(44)Tx #RWSet(讀寫集)原始碼
- HyperLedger Fabric 1.0的Transaction處理流程
- Fabric 1.0原始碼分析(9)configtx(配置交易)體系介紹原始碼
- Fabric 1.0原始碼分析(14) flogging(Fabric日誌系統)原始碼
- Fabric 1.0原始碼分析(10)consenter(共識外掛)原始碼
- Fabric 1.0原始碼分析(35)Peer #EndorserServer(Endorser服務端)原始碼Server服務端
- Fabric 1.0原始碼分析(36) Peer #EndorserClient(Endorser客戶端)原始碼client客戶端
- Fabric 1.0原始碼分析(41)putils(protos/utils工具包)原始碼
- Fabric 1.0原始碼分析(45)gRPC(Fabric中註冊的gRPC Service)原始碼RPC
- Fabric 1.0原始碼分析(5)Chaincode(鏈碼)體系總結原始碼AI
- Fabric 1.0原始碼分析(2) blockfile(區塊檔案儲存)原始碼BloC
- Fabric 1.0原始碼分析(19) Ledger #statedb(狀態資料庫)原始碼資料庫
- Fabric 1.0原始碼分析(21)Ledger #historydb(歷史資料庫)原始碼資料庫
- Fabric 1.0原始碼分析(22)Ledger #blkstorage(block檔案儲存)原始碼BloC
- Fabric 1.0原始碼分析(32) Peer #peer node start命令實現原始碼
- Fabric 1.0原始碼分析(20) Ledger #idStore(ledgerID資料庫)原始碼資料庫
- Fabric 1.0原始碼分析(37) Peer #DeliverClient(Deliver客戶端)原始碼client客戶端
- Fabric 1.0原始碼分析(38) Peer #BroadcastClient(Broadcast客戶端)原始碼ASTclient客戶端