使用区块链应用构建器 CLI 创建链代码项目

要使用区块链应用程序构建器创建链代码项目,请从详细的规范文件中支架链代码项目。

背景信息

Blockchain App Builder 的 init 命令可初始化并支架现成的链代码项目。根据简单输入,init 命令可以生成包含以下功能的复杂链代码项目:
  • 多个资产(模型)及其行为(控制器)
  • 自动生成的 CRUD(创建/读取/更新/删除)和非 CRUD 方法
  • 自动验证参数
  • 编集/解编集论据
  • 透明持久性能力 (ORM)
  • 丰富的查询支持

生成的项目遵循模型/控制器和装饰器模式,该模式允许在分类账上维护的资产属性指定为类型字段,并使用特定行为和验证规则进行扩展。此模式可减少代码行数,这有助于提高可读性和可扩展性。

先决条件

在对项目进行脚手架之前,必须创建输入规范文件。有关更多信息,请参见 Input Specification File

使用 init 命令固定 Chaincode 项目

输入 ochain init -h 将列出命令用法和选项。init 命令具有以下选项:
  • --cc/-c:

    链代码项目的名称。默认值为 MyChaincode

  • --lang/l

    支架链代码的语言。Blockchain App Builder 支持 TypeScript (ts) 和 Go (go)。如果未指定选项,则语言缺省为 ts

  • --conf/-f--spec

    输入规范文件的路径。Blockchain App Builder 读取输入规范文件,并使用许多辅助工具生成支架式项目,这有助于减少整体开发工作。充分利用输入规范文件,可以显著缩短开发时间。

    规范文件可以采用 yamljson 格式。如果未指定路径,则缺省为当前目录。请参见 Input Specification File

  • --out/o

    脚手架链代码项目的输出目录。如果未指定,则会在当前目录中生成脚手架项目。

    输出是一个完全包含、轻量级和可扩展的 TypeScript 或 Go 链代码项目。

  • --root/r

    仅对 Go 有效且是必需的。Go 链代码的 GOHOME 变量中的根目录。默认值为 example.com

示例
ochain init --cc MyNewTsProject --lang ts --conf spec.yml

默认值

如果未在 ochain init 命令中指定任何选项,则脚手架项目的名称为 MyChaincode,语言为 TypeScript。

MyChaincode.model.ts 文件仅包含一个名为 MyAsset 的资产,并具有一个名为 value 的属性。MyChaincode.controller.ts 文件包含一个控制器,该控制器具有与 MyAsset 模型对应的 CRUD 方法。

输出

流程完成后,您将拥有一个功能完备的链代码项目,您可以在本地部署或部署到远程 Oracle Blockchain Platform 实例。有关所创建文件的详细概述,请参见: 有关基于令牌的项目详细概述,另请参见: