区块链服务 BCS-REST API Demo:配置应用

时间：2023-11-01 16:25:45

区块链服务 BCS

在“实例管理”界面，在实例卡片中，单击“获取客户端配置”。
勾选“Peer节点证书”，指定节点组织选择organization，勾选“用户证书”并下载。
下载Demo项目工程：fabric-restapi-demo.zip，并将Demo项目代码工程包下载解压到本地并使用IDE打开。
本Demo是一个golang编写的REST客户端，通过REST API服务来调用链代码，实现链代码a给b转账的功能，请用GoLand等个人喜欢的IDE打开。项目的内容如下图所示：
将下载的用户证书解压到项目的usercrypto目录下。如图所示：

修改参数配置。

修改src/restapi目录下的main.go文件，参考如下截图及表格。

点击放大

针对需要参与背书的每个peer节点，对其构造一个OrgPeer结构体，将组织ID和peer节点的域名传入，并将该结构体添加进OrgPeer类型的数组中，经json.Marshal()方法转换为字节数组，最后会转换成字符串类型传入。其中OrgPeer结构体定义如下：

type OrgPeer struct {

OrgId string `json:"orgId"`

PeerDomainName string `json:"peerDomainName"`

}

表4 参数表
参数	说明
Endpoint	RESTAPI服务的访问IP和端口。具体获取方法如下：在已购买区块链实例卡片中，单击“容器集群”名称，进入云容器引擎CCE页面。单击实例所在集群名称，进入集群信息页面。在左侧导航栏，单击“工作负载”。在“无状态负载”页签，单击baas-restapi工作负载名称，进入详情页面，然后单击实例所在节点跳转至节点管理页面获取节点的弹性公网ip，该弹性公网ip为RESTAPI服务访问IP，端口固定为32621。
Path	RESTAPI服务的访问路径，保持不变。
CryptoMethod	加密算法，如果是ECDSA算法填写“SW”。
SignCert	用户下载的证书中的签名证书路径。
PrvKey	用户下载证书中的签名私钥。
InvokeReq	请求body的参数，请按照部署的链码实际情况填写，可参考如下InvokeReq参数表。
QueryReq	与InvokeReq类似，按照部署链码的实际情况填写。

表5 InvokeReq参数表
参数	说明	范例
SignGzipSwitch	Sign是否选择Gzip压缩。0表示否，1表示是。	"1"
ChannelId	区块链通道名称。	"channel"
ChaincodeId	链代码名称。	"testcode"
ChaincodeVersion	链代码版本。	"1.0"
UserId	由组织CA签发的用户ID，目前区块链实例默认生成的都为User1。	"User1"
OrgId	区块链组织ID。说明：在“通道管理”页面中，单击通道名称后的“查看节点”，查看“MSP标识”，去掉MSP即为区块链组织ID。例如：MSP标识为"1232b2032faafee152b58cd82cecf52e49a22a38MSP"，区块链组织ID为"1232b2032faafee152b58cd82cecf52e49a22a38”。	"1232b2032faafee152b58cd82cecf52e49a22a38"
OrgPeers	各个Peer节点的组织ID和域名。	"[{OrgId:" 1232b2032faafee152b58cd82cecf52e49a22a38", PeerDomainName:"peer-1232b2032faafee152b58cd82cecf52e49a22a38-0 .peer-1232b2032faafee152b58cd82cecf52e49a22a38.default.svc.cluster.local "}]"
Opmethod	区块链链码调用类型，目前只有两类：invoke和query。	"invoke"
Args	链码调用参数。	'["invoke","a","b","100"]' （第一个参数为invoke的调用函数，可以是其他值如：move，query等等）

配置完成后，构建并运行main()来运行该Demo项目。
代码中将读取conf.yaml以及main.go中的参数QueryReq和InvokeReq请求，并调用RESTAPI的接口"/v1/chaincode/operation"来调用链代码，实现a给b转账功能。运行结果如下：

本Demo用一个简单的REST客户端调用RESTAPI服务实现了调用链代码，返回的invoke结果为一个base64加密的TransactionID，query结果为base64加密的数据值。代码仅供参考，可以通过该项目代码理解如何调用RESTAPI服务。