智能合约从入门到精通：Lib工具库（二）

简介：上一节，我们介绍智能合约开发中常用的Lib工具库的第一部分。由于内容较长，工具库我们将分两部分介绍，本文将介绍Lib工具库的第二部分：LibJson 、LibStack和LibLog。

LibJson

LibJson主要封装了对JSON格式的字符串一些操作；

支持直接调用、using for *;调用

注意：正如在Lib工具库说明中提到的，LibJson 库的使用稍微有点特殊：

不管是直接调用，还是using for *;方式调用，在合约方法中，如果要使用一次、或者多次LibJson库中的方法，则在第一次使用LibJsos库方法前，需要对被操作的json字符串进行如下操作：

//字符串入栈

LibJson.push(_json);

在最后一个LibJsos库方法之后，要进行如下操作

//出栈

LibJson.pop();

示例：

pragma solidity ^0.4.2;

 

import "./utillib/LibJson.sol";

 

contract TestManager {

 

    using LibJson for *;

 

    string[] public _arr;

 

    function test() constant returns(bool _ret) {

        string memory _json = "{\"errno\":27,\"hash\":\"0xf16a2a734ccf0456807e166ad310ec7767f71e8d4003154b73596741683c6433\",\"nodeId\":\"JZNCGP\",\"type\":1}";

       // step01: 字符串入栈

       LibJson.push(_json);

       // step02: 操作字符串，判断自否为一个合法的json格式

       bool isJson = _json.isJson();   

       //或者直接调用

       //bool isJson = LibJson.isJson(_json);

 

       _json.jsonRead("nodeId");     // "JZNCGP"

       // step03: 出栈

       LibJson.pop();

    }

}

• LibJson.push() 与 LibJson.pop() 一定是成对出现的；
• 当对字符串的操作结束后务必调用pop将栈中的元素移除掉；

JSON格式判断

描述：判断指定串是否为标准的JSON格式

结构定义

function isJson(string _json) internal constant returns(bool _ret)；

示例

string memory _json = "{\"errno\":27,\"hash\":\"0xf16a2a734ccf0456807e166ad310ec7767f71e8d4003154b73596741683c6433\",\"nodeId\":\"JZNCGP\",\"type\":1}";

bool _ret= _json.isJson();        //  _ret = true

读取JSON中key的值

描述：指定key读取JSON串中的值

结构定义

function jsonRead(string _json, string _keyPath) internal constant returns(string _ret);

示例

string memory _json = "{\"errno\":27,\"hash\":\"0xf16a2a734ccf0456807e166ad310ec7767f71e8d4003154b73596741683c6433\",\"nodeId\":\"JZNCGP\",\"type\":1}";

string memory _ret= _json.jsonRead("nodeId");        //  _ret = "JZNCGP"

判断JSON的key是否存在

描述：判断JSON中的key是否存在

结构定义

function jsonKeyExists(string _json, string _keyPath) internal constant returns(bool _ret)

示例

string memory _json = "{\"errno\":27,\"hash\":\"0xf16a2a734ccf0456807e166ad310ec7767f71e8d4003154b73596741683c6433\",\"nodeId\":\"JZNCGP\",\"type\":1}";

bool _ret= _json.jsonKeyExists("nodeId");        //  _ret = true

uint[]数组转JSON字符串

描述：将一个uint[]数组转为json格式字符串

结构定义

function toJsonArray(uint[] storage _self) internal constant returns(string _json);

Copy

示例

pragma solidity ^0.4.2;

 

import "LibJson.sol";

 

contract TestManager {

 

    using LibJson for *;

 

    uint[] public _arr;

 

    function test() constant returns(string _ret) {

            _arr.push(1);

            _arr.push(2);

            _ret = _arr.toJsonArray();    // _ret = [1,2]

    }

}

string[]数组转JSON字符串

描述：将一个uint[]数组转为json格式字符串

结构定义

function toJsonArray(string[] storage _self) internal constant returns(string _json);

示例

pragma solidity ^0.4.2;

 

import "LibJson.sol";

 

contract TestManager {

 

    using LibJson for *;

 

    string[] public _arr;

 

    function test() constant returns(string _ret) {

            _arr.push("1");

            _arr.push("2");

            _ret = _arr.toJsonArray();    // _ret = ["1","2"]

    }

}

字符串整形数组转uint[]

描述：将一个字符串的整形数组转为uint[]，如："[1,3,4]"

结构定义

function fromJsonArray(uint[] storage _self, string _json) internal returns(bool succ);

示例

pragma solidity ^0.4.2;

 

import "LibJson.sol";

 

contract TestManager {

 

    using LibJson for *;

 

    uint[] public _arr;

 

    function test() constant returns(string _ret) {

           string memory _json = "[1,2,3]";

           _arr.fromJsonArray(_json);    // _arr = [1,2,3],_arr.length = 3

    }

}

字符串数组转string[]

描述：将一个字符串的整形数组转为string[]，如：["1","3","4"]

结构定义

function fromJsonArray(uint[] storage _self, string _json) internal returns(bool succ);

示例

pragma solidity ^0.4.2;

 

import "LibJson.sol";

 

contract TestManager {

 

    using LibJson for *;

 

    string[] public _arr;

 

    function test() constant returns(string _ret) {

           string memory _json = "[\"1\",\"2\",\"3\"]";

           _arr.fromJsonArray(_json);    // _arr = ["1","2","3"],_arr.length = 3

    }

}

元素入栈

描述：当需要对JSON进行操作，如：isJson()、jsonRead()操作时需要先进行push()操作，与此同时当使用后一定使用pop()进行栈数据的移除;

结构定义

 function push(string _json) internal constant returns(uint _len) ;

Copy

示例

pragma solidity ^0.4.2;

 

import "LibJson.sol";

 

contract TestManager {

 

    using LibJson for *;

 

    string[] public _arr;

 

    function test() constant returns(string _ret) {

           string memory _json = "{\"errno\":27,\"hash\":\"0xf16a2a734ccf0456807e166ad310ec7767f71e8d4003154b73596741683c6433\",\"nodeId\":\"JZNCGP\",\"type\":1}";

           LibJson.push(_json);

           _json.isJson();

           _json.jsonRead("type");        // return 1

           LibJson.pop();

    }

}

元素出栈

描述：当需要对JSON进行操作，如：isJson()、jsonRead()操作时需要先进行push()操作，与此同时当使用后一定使用pop()进行栈数据的移除;

结构定义

function pop() internal constant;

示例

pragma solidity ^0.4.2;

 

import "LibJson.sol";

 

contract TestManager {

 

    using LibJson for *;

 

    function test() constant returns(string _ret) {

           string memory _json = "{\"errno\":27,\"hash\":\"0xf16a2a734ccf0456807e166ad310ec7767f71e8d4003154b73596741683c6433\",\"nodeId\":\"JZNCGP\",\"type\":1}";

           LibJson.push(_json);

           _json.isJson();

           _json.jsonRead("type");        // return 1

           LibJson.pop();

    }

}

LibStack

LibStack封装了对栈的使用，合约中通过栈进行字符串拼接操作。

仅支持直接调用

pragma solidity ^0.4.2;

 

import "./utillib/LibStack.sol";

 

contract TestManager {

 

    function test() constant returns(string _ret) {

        len = LibStack.push("{");

        len = LibStack.appendKeyValue("userAddr", "1");

        len = LibStack.appendKeyValue("name", "2");

        len = LibStack.append("}");

        _ret = LibStack.popex(len);

        // _ret = {"userAddr":"1","name":"2"}

    }

}

说明：

• 栈的使用开始前必须进行LlibStack.push();操作，如果没有固定元素可push一个空串；
• 每次入栈数据后会返回当前占中元素长度；
• 出栈时指定要出栈的长度，即可获得栈中的字符串信息

入栈

描述：对一个栈使用前必须要做的事，push()调用就新开了一个栈空间使用，如果没有固定元素可以push一个空字符串:LibStack.push("");

结构定义

function push(string _data) internal constant returns(uint _len);

示例

uint len = LibStack.push("");        // 返回当前栈中元素个数

出栈

描述：当需要获取栈中元素时调用popex()获取栈中数据.

结构定义

function popex() internal constant returns(string _ret);

示例

uint len = LibStack.push("");        // 返回当前栈中元素个数

len = LibStack,append("aaa");    // append 追加单个元素

string memory _ret = LibStack.popex(len);    // _ret = "aaa"

向栈追加单个元素

描述：当栈开辟空间后向栈中追加单个元素

结构定义

function append(string _data) internal constant returns(uint _len);

示例

uint len = LibStack.push("");        // 返回当前栈中元素个数

len = LibStack,append("aaa");    // append 追加单个元素

string memory _ret = LibStack.popex(len);    // _ret = "aaa"

向栈追加k-v键值对

描述：当栈开辟空间后向栈中追加k-v键值对

结构定义

function appendKeyValue(string _key, string _val) internal constant returns (uint _len) ;

function appendKeyValue(string _key, uint _val) internal constant returns (uint _len) ;

 function appendKeyValue(string _key, int _val) internal constant returns (uint _len) ;

 function appendKeyValue(string _key, address _val) internal constant returns (uint _len);

示例

uint len = LibStack.push("{");        // 返回当前栈中元素个数

len = LibStack,appendKeyValue("name","Tom");  

len = LibStack,appendKeyValue("age",1);

len = LibStack,appendKeyValue("creator",0x8affd1952705d8a908e016695c6e454ad39a1c6f);

len = LibStack,append("}");

string memory _ret = LibStack.popex(len);    

// _ret = {"name":"Tom","age":1,"creator":"0x8affd1952705d8a908e016695c6e454ad39a1c6f"}

LibLog

LibLog主要封装了日志打印操作，在合约中的输出日志体现在日志文件中进行输出

仅支持直接调用

日志输出(多元素)

描述：输入一个字符串进行日志输出

结构定义

function log(string _str) internal constant returns(uint _ret);

function log(string _str, string _str2, string _str3) internal constant returns(uint _ret);

function log(string _str, string _str2) internal constant returns(uint _ret);

示例

LibLog.log("hello world");

LibLog.log("hello world","01");

LibLog.log("hello world","01","02");

日志输出(不同类型)

描述：不同类型输入日志输出

结构定义

// 字符串 + 无符号整形

function log(string _str, uint _ui) internal constant returns(uint _ret);

 

// 字符串 + 有符号整形

function log(string _str, int _i) internal constant returns(uint _ret);

 

// 字符串 + 地址

 function log(string _str, address _addr) internal constant returns(uint _ret);

示例

LibLog.log("hello world",111);

LibLog.log("hello world",131);

LibLog.log("hello world",0x8affd1952705d8a908e016695c6e454ad39a1c6f);

参考内容：https://open.juzix.net/doc

智能合约开发教程视频：区块链系列视频课程之智能合约简介