Créer un projet de code de chaîne avec l'interface de ligne de commande du générateur d'applications de chaîne de blocs

Pour créer un projet de code de chaîne avec le générateur d'applications Blockchain, vous copiez un projet de code de chaîne à partir d'un fichier de spécification détaillé.

Arrière-plan

La commande init du générateur d'applications Blockchain initialise et échafaude un projet de code de chaîne prêt à l'emploi. Basée sur une entrée simple, la commande init peut générer des projets de code de chaîne complexes comportant les fonctions suivantes :

Plusieurs ressources (modèles) et leurs comportements (contrôleurs)
Méthodes CRUD (Créer/Lire/Mettre à jour/Supprimer) et non CRUD générées automatiquement
Validation automatique des arguments
Marquage/déconversion des arguments
Capacité de persistance transparente (ORM)
Prise en charge étendue des interrogations

Le projet généré suit le modèle de modèle/contrôleur et de décorateur, ce qui permet aux propriétés d'une immobilisation qui sont tenues à jour dans le livre d'être spécifiées en tant que champs typés et étendues avec des comportements et des règles de validation spécifiques. Ce modèle réduit le nombre de lignes de code, ce qui peut faciliter la lisibilité et l'évolutivité.

Conditions requises

Avant d'échafauder un projet, vous devez créer un fichier de spécification d'entrée. Pour plus d'informations, voir Fichier de spécification d'entrée.

Échafaudage du projet de code de chaîne avec la commande init

L'entrée de ochain init -h répertorie l'utilisation et les options de la commande. La commande init comporte les options suivantes :

--cc/-c :
Nom du projet de code de chaîne. La valeur par défaut est MyChaincode.
--lang/l
Langage du code de chaîne échafaudé. Le générateur d'applications Blockchain prend en charge TypeScript (ts) et Go (go). Si aucune option n'est spécifiée, la langue par défaut est ts.
--conf/-f ou --spec
Chemin d'accès à un fichier de spécification d'entrée. Blockchain App Builder lit le fichier de spécification d'entrée et génère le projet échafaudé avec de nombreux outils d'aide, qui aident à réduire l'effort global de développement. Tirer pleinement parti du fichier de spécification d'entrée peut réduire considérablement le temps de développement.

Le fichier de spécification peut être au format yaml ou json. Si le chemin d'accès n'est pas indiqué, il s'agit par défaut du répertoire courant. Voir Fichier de spécification d'entrée.
--out/-o
Répertoire de sortie du projet de code de chaîne échafaudé. S'il n'est pas spécifié, le projet échafaudé est généré dans le répertoire courant.

La sortie est un projet de chaîne de blocs TypeScript ou Go entièrement contenu, léger et évolutif.
--root/-r
Valide et requis uniquement pour Go. Répertoire racine de la variable GOHOME pour vos codes de chaîne Go. La valeur par défaut est example.com.

Exemple

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

Valeurs par défaut

Si aucune option n'est spécifiée dans la commande ochain init, le nom du projet échafaudé est MyChaincode et la langue est TypeScript.

Le fichier MyChaincode.model.ts contient une seule ressource, nommée MyAsset, avec une propriété nommée value. Le fichier MyChaincode.controller.ts contient un contrôleur avec les méthodes CRUD correspondantes pour le modèle MyAsset.

Sortie

Une fois le processus terminé, vous aurez un projet de code de chaîne entièrement fonctionnel que vous pourrez déployer localement ou vers une instance Oracle Blockchain Platform distante. Pour un aperçu détaillé des fichiers créés, voir :

Pour un aperçu détaillé d'un projet basé sur un jeton, voir aussi :