使用區塊鏈 App 產生器 CLI 建立鏈碼專案
若要在使用 Blockchain App Builder CLI 時建立鏈碼專案,請從詳細的規格檔案建立鏈碼專案。產生的專案接著會包含所有檔案,而不是您需要的檔案。
背景
init
命令會初始化並鷹架現成的鏈碼專案。根據簡單輸入,init
指令可產生包含下列功能的複雜鏈碼專案:
- 多重資產 (模型) 及其行為 (控制器)
- 自動產生 CRUD (建立 / 讀取 / 更新 / 刪除) 和非 CRUD 方法
- 自動驗證引數
- 引數的封送處理 / 解除封送處理
- 透明保存能力 (ORM)
- 呼叫 Rich Query 的能力
產生的專案會遵循模型 / 控制器與裝飾樣式,允許將分類帳上維護的資產屬性指定為輸入欄位,並以特定行為與驗證規則進行延伸。此模式會減少程式碼行的數目,進而協助實現可讀性與擴展性。
先決條件
鷹架專案之前,您必須先建立輸入規格檔案。如需詳細資訊,請參閱輸入規格檔案。
使用 init
命令建立鏈碼專案結構
ochain init -h
將會列出命令用法及其所有選項。init
指令具有下列選項:
- --cc/-c:
鏈碼專案的名稱。預設值是
MyChaincode
。 - -- 語言 /-l
結構化鏈碼的語言。Blockchain App Builder 支援 Typescript (
ts
) 和 Go (go
)。如果未指定任何選項,語言會預設為ts
。 - --conf/-f 或 --spec
輸入規格檔案的路徑。Blockchain App Builder 會讀取輸入規格檔案,並使用許多協助程式工具產生鷹架式專案,以協助減少整體開發工作。充分利用輸入規格檔案,可大幅縮短開發時間。
規格檔案的格式可以是
yaml
或json
。如果未指定此路徑,則預設為目前的目錄。請參閱輸入規格檔案。 - -- 輸出 /- 輸出
鷹架鏈碼專案的輸出目錄。如果未指定,便會在目前的目錄中產生鷹架式專案。
輸出是完全包含、輕量且可擴展的 Typescript 或 Go 鏈碼專案。
- -- 根 /-r
只有執行才有效且必要。您 Go 鏈碼之 GOHOME 變數中的根目錄。預設值是
example.com
。
my-mac:~ name$ ochain init --cc MyNewTsProject --lang ts --conf spec.yml
預設值
如果 ochain init
指令中未指定任何選項,則鷹架專案的名稱為 MyChaincode
,語言為 TypeScript。
MyChaincode.model.ts
檔案只包含一個名為 MyAsset
的資產,一個特性名為 value
。MyChaincode.controller.ts
檔案包含一個具有 MyAsset
模型之對應 CRUD 方法的控制器。
輸出