区块链从零起步(P3)创建第一个应用

参考
https://hyperledger-fabric.readthedocs.io

该文教程分一下三步:

  1. 启动一个用于测试的区块链网络
  2. 学习如何使用智能合约
  3. 开发一个可以查询和修改的应用

启动网络

这次我们定位到fabcar文件夹:

git clone https://github.com/hyperledger/fabric-samples.git
cd fabric-samples/fabcar

启动:

./startFabric.sh

这个脚本做了以下事情:

  • 启动一个peer节点,order节点,证书和CLI容器
  • 创建一个channel,并把peer添加到channel
  • 安装智能合约(例如chaincode)到peer的文件系统,然后初始化chaincode到channel,实例化一个chaincode容器
  • 调用initLedger方法来初始化10辆汽车到channel账本

可以通过docker ps命令来查看当前脚本运行后的进程情况,接下来我们将重点放在应用上。下图描述了一个应用是如何与区块链网络交互的:

应用与网络的交互

应用使用API来调用智能合约(即这个demo中的chaincode),这些智能合约在主机的网络中用名字和版本唯一标识。例如,我们的chaincode容器名为dev-peer0.org1.example.com-fabcar-1.0,名字是fabcar,版本是1.0,peer运行在dev-peer0.org1.example.com

查询账本

你可以通过单参数、多参数、或者是JSON形式的参数来查询账本

我们之前已经把账本中初始化了10辆汽车,现在我们可以用query.js的代码来查询这些数据了。
再次之前,我们需要先安装一些node模块的sdk,定位到fabcar文件夹,执行:

npm install

然后运行脚本query.js,来得到账本中的汽车列表,这脚本中我们使用了queryAllCars方法:

node query.js

Query result count =  1
Response is  [{"Key":"CAR0", "Record":{"colour":"blue","make":"Toyota","model":"Prius","owner":"Tomoko"}},
{"Key":"CAR1",   "Record":{"colour":"red","make":"Ford","model":"Mustang","owner":"Brad"}},
{"Key":"CAR2", "Record":{"colour":"green","make":"Hyundai","model":"Tucson","owner":"Jin Soo"}},
{"Key":"CAR3", "Record":{"colour":"yellow","make":"Volkswagen","model":"Passat","owner":"Max"}},
{"Key":"CAR4", "Record":{"colour":"black","make":"Tesla","model":"S","owner":"Adriana"}},
{"Key":"CAR5", "Record":{"colour":"purple","make":"Peugeot","model":"205","owner":"Michel"}},
{"Key":"CAR6", "Record":{"colour":"white","make":"Chery","model":"S22L","owner":"Aarav"}},
{"Key":"CAR7", "Record":{"colour":"violet","make":"Fiat","model":"Punto","owner":"Pari"}},
{"Key":"CAR8", "Record":{"colour":"indigo","make":"Tata","model":"Nano","owner":"Valeria"}},
{"Key":"CAR9", "Record":{"colour":"brown","make":"Holden","model":"Barina","owner":"Shotaro"}}]

现在我们来看一下query.js代码里面到底发生了什么。
首先定义了一些变量,例如chaincode ID、channel名字以及网络端点等:

var options = {
      wallet_path : path.join(__dirname, './network/creds'),
      user_id: 'PeerAdmin',
      channel_id: 'mychannel',
      chaincode_id: 'fabcar',
      network_url: 'grpc://localhost:7051',

下面是构造一个查询请求:

// queryCar - requires 1 argument, ex: args: ['CAR4'],
// queryAllCars - requires no arguments , ex: args: [''],
const request = {
   chaincodeId: options.chaincode_id,
   txId: transaction_id,
   fcn: 'queryAllCars',
   args: ['']

我们定义chaincode_idfabcar,然后调用了queryAllCars方法,这个方法被定义在chaincode中。查看chaincode\fabcar\fabcar.go文件,我们可以看到这里面还定义了一些其他的方法,我们可以找到queryAllCars方法的位置:

func (s *SmartContract) queryAllCars(APIstub shim.ChaincodeStubInterface) sc.Response {

     startKey := "CAR0"
     endKey := "CAR999"

     resultsIterator, err := APIstub.GetStateByRange(startKey, endKey)

方法中使用shim接口的函数GetStateByRange来获得账本中startKeyendKey之间的数据。下图表示了一个app是如何调用chaincode中的不同方法的:

回到query.js,我们将request调用的方法修改为queryCar,并在args里面加上参数,来获取某一辆汽车的数据:

const request = {
      chaincodeId: options.chaincode_id,
      txId: transaction_id,
      fcn: 'queryCar',
      args: ['CAR4']

运行:

node query.js

{"colour":"black","make":"Tesla","model":"S","owner":"Adriana"}

现在,你应该知道了如何在chaincode中做基本的查询数据的操作,下面让我们来讲如何更新账本。

更新账本

账本更新的第一件事情,是要创建一个交易提议,类似于查询,我们需要先创建出一个request,然后调用channel.SendTransactionProposal的API来发送给peer背书。
然后会从network接收到这个交易提议的回复,应用可以将这个回复信息用于创建和签名一个交易请求。然后我们调用channel.sendTransactionAPI来将请求发送到ordering service,这笔交易将会被打包成一个block,然后投递到该channel的各个peer节点来进行验证(这个例子中我们只有一个单独的结点)。
最终,应用将使用eh.setPeerAddrAPI来连接结点的监听端口,调用eh.registerTxEvent来注册与这个交易ID相关的事件,我们可以通过这个API来得知这次事件的成功与否。
invode.js脚本中,就有用到上述提到的交易流程:

var request = {
    targets: targets,
    chaincodeId: options.chaincode_id,
    fcn: 'createCar',
    args: ['CAR10', 'Chevy', 'Volt', 'Red', 'Nick'],
    chainId: options.channel_id,
    txId: tx_id

我们创建了一个CAR10的请求,执行:

node invoke.js

The transaction has been committed on peer localhost:7053

节点发送了这次事件的通知,然后我们的应用通过eh.registerTxEventAPI接收到了这个通知,并知道了事件的成功。我们可以再调用查询接口验证一下:

Response is  {"colour":"Red","make":"Chevy","model":"Volt","owner":"Nick"}

最后,让我们来看看修改数据。将request中的方法改为changeCarOwner,修改对应参数如下:

var request = {
   targets: targets,
   chaincodeId: options.chaincode_id,
   fcn: 'changeCarOwner',
   args: ['CAR10', 'Barry'],
   chainId: options.channel_id,
   txId: tx_id

执行:

node invoke.js

查询验证:

Response is  {"colour":"Red","make":"Chevy","model":"Volt","owner":"Barry"}
最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 205,132评论 6 478
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 87,802评论 2 381
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 151,566评论 0 338
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 54,858评论 1 277
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 63,867评论 5 368
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 48,695评论 1 282
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 38,064评论 3 399
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 36,705评论 0 258
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 42,915评论 1 300
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,677评论 2 323
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 37,796评论 1 333
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 33,432评论 4 322
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 39,041评论 3 307
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 29,992评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,223评论 1 260
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 45,185评论 2 352
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 42,535评论 2 343

推荐阅读更多精彩内容