5.4.2.8 CITA预置智能合约包
预置智能合约包选自CITA提供的CitaBsnBaseContract.sol,可以为应用开发者提供对业务数据进行增删改查基本操作(Solidity语言编写)。应用开发者可以在此智能合约包的基础上根据应用业务需求进一步拓展合约功能。此合约支持存储的数据类型有bytes、bytes32。
下载地址: https://github.com/BSNDA/CITABaseContract
智能合约包功能如下:
1. 增加数据(insert)
输入参数说明
baseKey:需要插入数据信息的key
baseValue:需要插入数据信息的value
例:
{"baseKey":"000000000000000000000000000000000000000000000000000000000000008b",
"baseValue":"8b"}
其中baseKey是不能为空的byte32。baseValue可以是任意长度的bytes。如果baseKey已经存在,则直接返回已经存在,不能添加;如果不存在,则添加数据。
2. 修改数据(update)
输入参数说明
baseKey:需要插入数据信息的key
baseValue:需要插入数据信息的value
例:
{"baseKey":"000000000000000000000000000000000000000000000000000000000000008b",
"baseValue":"9a"}
其中baseKey是不能为空的bytes32,baseValue是bytes类型的数据。如果baseKey不存在,则无法更新,如果已经存在,则修改数据。
3. 删除数据(remove)
输入参数说明
baseKey:需要插入数据信息的key
例:
{"baseKey":"000000000000000000000000000000000000000000000000000000000000008b"}
其中baseKey的值不能为空,且必须存在,否则将无法删除。
4. 获取数据(retrieve)
输入参数说明
baseKey:需要插入数据信息的key
例:
{"baseKey":"000000000000000000000000000000000000000000000000000000000000008b"}
其中baseKey的值不能为空,且必须存在,否则将无法获取到相应的信息。
5. 根据index获取baseKey
输入参数说明
index:需要获取的baseKey的序号
例:
{"index":0}
其中index的值为uint类型的数据。