区块链服务 BCS-概述:SDK逻辑结构

时间:2024-07-01 09:12:15

SDK逻辑结构

SDK主要提供消息封装、发送模块及相应的配套组件。配套组件主要包含异常处理、配置文件解析、节点获取等功能接口。

  • 消息封装

    由于消息类型较多,因此按类型进行了分类封装。消息封装相关接口均在build这个包下面,包含了ContractRawMessage、QueryRawMessage这几种消息构造的封装类。

    • ContractRawMessage:包含交易背书、落盘两阶段消息的构建。
    • QueryRawMessage:包含所有查询相关接口的消息构建,目前支持交易详情查询、链状态查询、区块查询、合约信息查询等接口。
  • 消息发送

    同消息封装类接口,按类型进行了分类封装。消息发送相关接口均包含在action这个包下面,包含了ContractAction、QueryAction、EventAction这几种消息发送的封装类。

    • ContractAction:对应ContractRawMessage封装的消息的发送。
    • QueryAction:对应QueryRawMessage中封装的消息的发送。
    • EventAction:主要用于监听消息的最终状态,因为参数仅包含交易ID,消息封装的方法直接内置。同时所有的消息发送接口均提供同步和异步两种接口。

      同步接口入参均为需要发送的消息,返回值为一个ListenableFuture对象,用于监听消息发送结果。

      异步接口则传入需要发送消息的同时,还需要传入一个StreamObserver对象,用于异步获取消息发送结果。

support.huaweicloud.com/devg-bcs/bcs_devg_01_017.html