Crea un progetto Chaincode con l'estensione codice VS di Blockchain App Builder

Per creare un progetto Chaincode quando si utilizza Blockchain App Builder, è necessario impiantare un progetto chaincode da un file di specifica dettagliato. Questo genera un progetto con tutti i file necessari.

Presupposto

Blockchain App Builder inizializza e impalcerà un progetto di codice concatenato immediatamente. In base a un input semplice, Crea nuovo codice concatenato può generare progetti di codici concatenati complessi con funzioni quali:

Più asset (modelli) e loro comportamenti (controllori)
Genera automaticamente metodi CRUD (Crea/Leggi/Aggiorna/Elimina) e non CRUD
Convalida automatica degli argomenti
Marshalling/unmarshalling di argomenti
Capacità di persistenza trasparente (ORM)
Richiamo delle interrogazioni
Supporto di dati transitori e privati
Identity management

Il progetto generato segue il modello/controller e il pattern decorator, che consente di specificare le proprietà di un cespite gestite nel libro contabile come campi tipizzati ed estese con comportamenti specifici e regole di convalida. In questo modo si riduce il numero di righe di codice che facilitano la leggibilità e la scalabilità.

Crea un file di specifica

Prima di iniziare, è necessario creare un file di specifica di input. Si noti che non è possibile modificare i file di specifica di esempio installati come parte di Blockchain App Builder, ma è possibile duplicarli o utilizzarli come file di riferimento per i propri file di specifica.

Nel riquadro Specifiche, selezionare Crea nuovo file specifica.
Viene visualizzato il riquadro Dettagli specifiche:
- Immettere il nome del file di specifica.
- Selezionare il tipo di file: YAML e JSON sono supportati.
- Se necessario, immettere una descrizione per il file.
- L'elenco a discesa File di riferimento consente di generare il file di specifica da un file preesistente nell'area di lavoro se si dispone di un file che si desidera utilizzare come modello. Se non viene selezionato alcun elemento, il file creato sarà vuoto ed è possibile immettere la specifica da zero.
- Immettere la posizione in cui si desidera memorizzare il file di specifica nel sistema.
Fare clic su Salva.

Il nuovo file di specifica viene creato e visualizzato nel riquadro Specifiche. Clicca su di esso per aprirlo nell'editor.

Importare un file di specifica

Se si dispone di un file di specifica preesistente, è possibile importarlo:

Nel riquadro Specifiche, fare clic su Altre azioni e selezionare Importa specifica.
Individuare il file e fare clic su Specifica di importazione.

Il file di specifica viene importato e viene visualizzato nel riquadro Specifiche. Clicca su di esso per aprirlo nell'editor.

Duplica di un file di specifica

È inoltre possibile duplicare un file di specifica già presente nel riquadro Specifiche facendo clic con il pulsante destro del mouse e selezionando Duplica. Fare clic con il pulsante destro del mouse sul file e selezionare Nome per aggiornare il nome.

I dettagli relativi al contenuto dei file di specifiche sono descritti di seguito: File di specifica di input. Utilizzare queste informazioni e i modelli di specifica di esempio per creare il contenuto della specifica.

Convalidare un file di specifica

Se è stata installata l'estensione YAML Language Support, il file di specifica viene convalidato automaticamente durante la digitazione. Le funzioni di convalida riportate di seguito sono supportate automaticamente:

Completamento comando
Completamento dei nodi scalari ai valori predefiniti dello schema
Guida contestuale quando si passa il puntatore del mouse su una proprietà o un metodo
Indenti per gli elementi dell'array durante la digitazione
Rilevamento errori di sintassi

Impalcatura del progetto Chaincode

Quando hai un file di specifica che soddisfa le tue esigenze, genera il tuo progetto con codice concatenato.

Nel riquadro Codici di catena, selezionare Crea nuovo codice di catena.
Viene visualizzato il riquadro Dettagli codice di connessione:
- Immettere il nome del progetto con codice concatenato.
- Selezionare la lingua: TypeScript o Vai.
- Selezionare il file di specifica che si sta utilizzando per creare il codice concatenato.
- Immettere la posizione o il dominio Go in cui si desidera creare il progetto nell'ambiente di sviluppo locale.
Fare clic su Crea.

Quando il progetto viene creato, verrà visualizzato nel riquadro Codici di catena. Tutti i file richiesti dal codice concatenato saranno nel progetto. Per una panoramica dettagliata dei file creati, vedere:

Per una panoramica dettagliata di un progetto basato su token, vedere anche:

Nota

Il riquadro Codici di catena consente di aprire e utilizzare il contenuto all'interno del progetto con codice concatenato, ma non consente di aggiungere, eliminare o rinominare i file all'interno del progetto. A tale scopo, fare clic con il pulsante destro del mouse sul progetto e selezionare Apri in Explorer. Il progetto viene aperto nella vista VS Code Explorer.
L'eliminazione o la ridenominazione dei file nel progetto chaincode può potenzialmente interrompere il collegamento tra i file di progetto e il file di specifica utilizzato per crearlo. Se si prevede di sincronizzare il codice tra i due, non modificare i nomi dei file.

Importa un progetto Chaincode esistente

Se è stato creato un progetto con codice concatenato tramite l'interfaccia CLI o se è stato eseguito il cleanup del contenuto della blockchain di VS Code e si desidera importare un progetto salvato localmente, nel riquadro Codici di catena fare clic sull'icona Altre azioni... e selezionare Importa codice concatenato. Individuare il progetto e fare clic su Importa codice concatenato.