本文重要描述使用hyperledger-composer開(kāi)發(fā)基于fabric的商業(yè)網(wǎng)絡(luò)（chaincode）的邏輯仅讽，對(duì)于fabric網(wǎng)絡(luò)的搭建只進(jìn)行簡(jiǎn)略的描述

架構(gòu)圖

Hyperledger-composer的架構(gòu)圖

1. 創(chuàng)建business network

?導(dǎo)入business network的參考實(shí)例误债，在其上進(jìn)行定制化的改寫(xiě)。

.通過(guò)下面的命令引入基本的樣板夸溶，其中包含了model,participant,transaction,ACL,以及附加于transaction之上的回調(diào)函數(shù)

git clone https://github.com/hyperledger/composer-sample-networks.git

解壓后進(jìn)入下面的目錄

?? composer-sample-networks git:(master) ls

LICENSE? ? ? README.md? ? lerna.json? node_modules package.json packages? ? scripts

?? composer-sample-networks git:(master) cd packages

?? packages git:(master) ls

animaltracking-network? ? bond-network? ? ? ? ? ? ? digitalproperty-network? perishable-network

basic-sample-network? ? ? carauction-network? ? ? ? marbles-network? ? ? ? ? vehicle-lifecycle-network

以basic-sample-network為例查看如何定制化自身的商業(yè)網(wǎng)絡(luò)

?? basic-sample-network git:(master) ls

README.md? ? ? dist? ? ? ? ? ? header.txt? ? ? jsdoc.conf? ? ? ? ? ? ? logs? ? ? ? ? ? node_modules? ? permissions.acl ?config? ? ? ? ? features? ? ? ? index.js? ? ? ? lib? ? ? ? ? ? models? ? ? ? ? package.json? ? test

其中我們需要修改的文件主要有package.json（項(xiàng)目的啟動(dòng)測(cè)試命令，名稱，依賴環(huán)境等）稿黄，permissions.acl（CURD權(quán)限的限定）,models/sample.cto(asset定義，asset操作者的定義跌造，asset操作動(dòng)作的定義（如交易）)杆怕，lib/sample.js(asset操作動(dòng)作執(zhí)行之后需要執(zhí)行的操作族购，類似回調(diào)函數(shù))。

單元測(cè)試3中生成陵珍，修改后的商業(yè)網(wǎng)絡(luò)邏輯

首先下載依賴庫(kù)

?? basic-sample-network git:(master) cnpm install

執(zhí)行測(cè)試邏輯

?? basic-sample-network git:(master) npm test

得到全部passing則為測(cè)試成功

打包上文中構(gòu)建的商業(yè)網(wǎng)絡(luò)

?basic-sample-networkgit:(master)?composer archive create -a dist/simple-network.bna--sourceType dir --sourceName .

?distgit:(master)?ls

basic-sample-network.bna?

此文件即為生成的商業(yè)網(wǎng)絡(luò)文件寝杖，包含了上述的各種配置

2. 構(gòu)建測(cè)試環(huán)境

此時(shí)有兩種選擇，一種選擇本地化部署local-play-ground互纯，另一種選擇為使用online-play-ground來(lái)進(jìn)行部署測(cè)試. 具體的部署請(qǐng)參考藍(lán)色的鏈接瑟幕。

如下圖所示，點(diǎn)擊左下角的紅圈留潦，將上一步驟產(chǎn)生的bna文件進(jìn)行導(dǎo)入只盹。

play-ground示意圖

導(dǎo)入后的結(jié)果如下圖所示，可以看到我們之前主要定義的文件都在左側(cè)有所顯示兔院。如果要進(jìn)行測(cè)試殖卑，請(qǐng)點(diǎn)擊Test按鈕，可以進(jìn)行模擬的測(cè)試坊萝。

導(dǎo)入模板后的play-ground示意圖

最后需要說(shuō)明的是孵稽，如果使用online-play-ground的話，所有的運(yùn)行默認(rèn)是跑在瀏覽器的內(nèi)存中十偶。在local-play-ground中菩鲜，可以選擇跑在瀏覽器的內(nèi)存之中，也可以實(shí)際鏈接到某個(gè)區(qū)塊鏈網(wǎng)絡(luò)之中扯键。如下圖所示睦袖，通過(guò)點(diǎn)擊右上角圓圈所示的按鈕，進(jìn)入到配置鏈接網(wǎng)絡(luò)界面荣刑，左邊方形按鈕中列舉了所有可用的fabric網(wǎng)絡(luò)（web browser為在瀏覽器中模擬運(yùn)行馅笙，hlfabric為導(dǎo)入的本地區(qū)塊鏈網(wǎng)絡(luò)），現(xiàn)在我們選擇的是hlfabric的網(wǎng)絡(luò)厉亏。在中間菱形的部分即為我們現(xiàn)在鏈接fabric網(wǎng)絡(luò)的屬性董习，包含order地址，MSPID,ca地址等等的信息爱只。 如果要導(dǎo)入新的網(wǎng)絡(luò)皿淋，左側(cè)紅色方框下方進(jìn)行操作即可（導(dǎo)入什么？請(qǐng)看這里connection profile）

3. 啟動(dòng)本Fabric網(wǎng)絡(luò)以及composer相關(guān)工具的安裝

如何啟動(dòng)本地fabric網(wǎng)絡(luò)恬试，不是本文的重點(diǎn)窝趣，請(qǐng)參見(jiàn)下面的鏈接

https://hyperledger.github.io/composer/installing/development-tools.html

在部署之前，我們需要安裝composer給我們提供的一些依賴包训柴，從而方便的通過(guò)SDK與fabric網(wǎng)絡(luò)進(jìn)行交互

安裝composer-cli

cnpm install -g composer-cli

包含了所有通過(guò)命令行進(jìn)行商業(yè)網(wǎng)絡(luò)構(gòu)建的指令

安裝generator-hyperledger-composer

cnpm install -g generator-hyperleger-composer

其實(shí)一個(gè)yoeman的插件哑舒，通過(guò)這個(gè)插件可以快速構(gòu)造基于Rest的調(diào)用

安裝composer-rest-server

cnpm install -g composer-rest-server

基于loopback的插件，基于其可以快速構(gòu)建對(duì)于商業(yè)網(wǎng)絡(luò)中model的rest格式調(diào)用幻馁，并以web頁(yè)面的形式呈現(xiàn)

安裝yoeman文件

cnpm install -g yo

其是一個(gè)能夠快速生成application的工具（如angular）洗鸵，和generator-hyperledger-composer進(jìn)行結(jié)合使用能夠使得生成的application和商業(yè)網(wǎng)絡(luò)進(jìn)行交互越锈。

4. 部署到Fabric網(wǎng)絡(luò)之中

部署

測(cè)試完畢，F(xiàn)abric網(wǎng)絡(luò)搭建完畢以后膘滨，我們接下來(lái)要做的就是將我們的商業(yè)網(wǎng)絡(luò)部署到其之上甘凭。

distgit:(master)?composer network deploy -a my-network.bna -p hlfv1 -i admin -s adminpw

其中my-network.bna是我們?cè)诓襟E1中創(chuàng)建的商業(yè)網(wǎng)絡(luò)定義文件，hlfv1為我們?cè)诓襟E3中創(chuàng)建的fabric本地網(wǎng)絡(luò)火邓，利用其生成的connection profile連接丹弱。

部署完畢后出現(xiàn)以下的內(nèi)容表示成功

? Deploying business network definition. This may take a minute...

Command succeeded

5. 與部署到Fabric網(wǎng)絡(luò)之中的商業(yè)邏輯（Chaincode）進(jìn)行交互

在進(jìn)行這一步之前，我們?cè)賮?lái)看一個(gè)邏輯圖

hyperledger-composer項(xiàng)目示意圖

通過(guò)這圖我們可以看出贡翘，我們利用前端的restAPI接口調(diào)用中間層（play grouand等）蹈矮，然后中間層利用SDK與后端真實(shí)的Fabric網(wǎng)絡(luò)進(jìn)行交互。我們接下來(lái)解決的就是建立Restful接口鸣驱，SDK會(huì)在相應(yīng)的程序中自動(dòng)加載泛鸟。

1. ?方案1建立angular前端應(yīng)用以及Rest Server進(jìn)行連接

?basic-sample-networkgit:(master)?yo hyperledger-composer

2. ?只利用Rest-server

?basic-sample-networkgit:(master)?composer-rest-server

basic-sample-networkgit:(master)?

composer-rest-server

參考：https://hyperledger.github.io/composer/tutorials/developer-guide.html