Erstellen eines Chaincode-Projekts mit der Visual Studio Code-Erweiterung von Blockchain App Builder

Um ein Chaincode-Projekt mit Blockchain App Builder zu erstellen, erstellen Sie ein Chaincode-Projekt aus einer detaillierten Spezifikationsdatei. Dadurch wird ein Projekt mit allen erforderlichen Dateien generiert.

Hintergrund

Blockchain App Builder initialisiert und entwickelt ein einsatzbereites Chaincode-Projekt. Der Befehl Create New Chaincode kann basierend auf einer einfachen Eingabe komplexe Chaincode-Projekte mit folgenden Features generieren:
  • Mehrere Assets (Modelle) und deren Verhalten (Controller)
  • CRUD (Erstellen/Lesen/Aktualisieren/Löschen) und Nicht-CRUD-Methoden automatisch generieren
  • Automatische Validierung von Argumenten
  • Marshalling/Unmarshalling von Argumenten
  • Transparente Persistenzfunktion (ORM)
  • Rich Query-Unterstützung
  • Transiente und private Datenunterstützung
  • Identity-Management

Das generierte Projekt folgt dem Modell-/Controller- und Dekorationsmuster. Dadurch können die Eigenschaften einer Anlage, die im Buch verwaltet werden, als typisierte Felder angegeben und mit bestimmten Verhaltensweisen und Validierungsregeln erweitert werden. Dies reduziert die Anzahl der Codezeilen, die bei der Lesbarkeit und Skalierbarkeit helfen können.

Spezifikationsdatei erstellen

Sie müssen zuerst eine Eingabespezifikationsdatei erstellen. Sie können die Beispielspezifikationsdateien, die als Teil von Blockchain App Builder installiert wurden, nicht ändern. Sie können sie jedoch duplizieren oder als Referenzdatei für Ihre eigenen Spezifikationsdateien verwenden.

  1. Wählen Sie im Bereich Spezifikationen die Option Neue Spezifikationsdatei erstellen aus.
  2. Führen Sie im Bereich Spezifikationsdetails die folgenden Schritte aus.
    • Geben Sie den Namen für die Spezifikationsdatei ein.
    • Wählen Sie den Dateityp. YAML- und JSON-Formate werden unterstützt.
    • Optional können Sie eine Bezeichnung für die Datei eingeben.
    • Mit der Dropdown-Liste Referenzdatei können Sie Ihre Spezifikationsdatei aus einer Datei in Ihrem Workspace generieren, wenn Sie eine Datei als Vorlage verwenden möchten. Wenn nichts ausgewählt ist, ist die erstellte Datei leer, und Sie können Ihre Spezifikation von Grund auf neu eingeben.
    • Geben Sie den Speicherort ein, an dem die Spezifikationsdatei auf dem System gespeichert werden soll.
    Klicken Sie auf Speichern.
Die Spezifikationsdatei wird erstellt und im Bereich Spezifikationen angezeigt. Klicken Sie darauf, um die Datei im Editor zu öffnen.

Spezifikationsdatei importieren

Wenn eine bereits vorhandene Spezifikationsdatei vorhanden ist, können Sie sie importieren.
  1. Klicken Sie im Bereich Spezifikationen auf Weitere Aktionen, und wählen Sie Spezifikation importieren aus.
  2. Navigieren Sie zu Ihrer Datei, und klicken Sie auf Spezifikation importieren.
Die Spezifikationsdatei wird importiert und im Bereich Spezifikationen angezeigt. Klicken Sie darauf, um die Datei im Editor zu öffnen.

Spezifikationsdatei duplizieren

Sie können auch eine Spezifikationsdatei duplizieren, die sich bereits im Bereich Spezifikationen befindet, indem Sie mit der rechten Maustaste darauf klicken und Duplizieren auswählen. Klicken Sie mit der rechten Maustaste auf die Datei, und wählen Sie Umbenennen, um den Namen zu aktualisieren.

Weitere Informationen zum Inhalt von Spezifikationsdateien finden Sie unter Eingabespezifikationsdatei. Verwenden Sie diese Informationen und die Beispielspezifikationsvorlagen, um den Spezifikationsinhalt zu erstellen.

Spezifikationsdatei validieren

Wenn Sie die YAML Language Support-Erweiterung installiert haben, wird die Spezifikationsdatei beim Eingeben automatisch validiert. Die folgenden Validierungsfunktionen werden automatisch unterstützt:
  • Befehlsabschluss
  • Abschluss skalarer Knoten auf Schemastandards
  • Kontextbezogene Hilfe, wenn Sie den Mauszeiger über eine Eigenschaft oder Methode bewegen
  • Einzüge für Arrayelemente beim Eingeben
  • Syntaxfehlererkennung

Das Chaincode-Projekt

Nachdem Sie eine Spezifikationsdatei erstellt haben, können Sie ein Chaincode-Projekt generieren.
  1. Wählen Sie im Bereich Chaincodes die Option Neuen Chaincode erstellen aus.
  2. Führen Sie im Bereich Chaincode-Details die folgenden Schritte aus.
    • Geben Sie den Namen des Chaincode-Projekts ein.
    • Wählen Sie die Sprache: TypeScript oder Go.
    • Wählen Sie die Spezifikationsdatei aus, die Sie zum Erstellen des Chaincodes verwenden.
    • Geben Sie den Speicherort oder die Go-Domain ein, an dem das Projekt in Ihrer lokalen Entwicklungsumgebung erstellt werden soll.
    Klicken Sie auf Create.
Wenn Ihr Projekt erstellt wird, wird es im Bereich Chaincodes angezeigt. Alle Dateien, die für den Chaincode erforderlich sind, sind im Projekt enthalten. Eine detaillierte Übersicht über die erstellten Dateien finden Sie unter: Eine detaillierte Übersicht über ein tokenbasiertes Projekt finden Sie auch unter:

Hinweis:

  • Im Bereich Chaincodes können Sie Inhalte im Chaincode-Projekt öffnen und bearbeiten. Sie können jedoch keine Dateien im Projekt hinzufügen, löschen oder umbenennen. Klicken Sie dazu mit der rechten Maustaste auf Ihr Projekt, und wählen Sie In Explorer öffnen aus. Dadurch wird das Projekt in der Visual Studio Code Explorer-Ansicht geöffnet.
  • Das Löschen oder Umbenennen von Dateien im Chaincode-Projekt kann möglicherweise die Verbindung zwischen den Projektdateien und der Spezifikationsdatei, mit der sie erstellt wurden, aufheben. Wenn Sie den Code zwischen den beiden synchronisieren möchten, ändern Sie die Dateinamen nicht.

Vorhandenes Chaincode-Projekt importieren

Wenn Sie ein Chaincode-Projekt über die CLI erstellt haben oder Ihren Visual Studio Code-Blockchain-Inhalt bereinigt haben und ein lokal gespeichertes Projekt importieren möchten, klicken Sie im Bereich Chaincodes auf das Symbol Weitere Aktionen..., und wählen Sie Chaincode importieren aus. Navigieren Sie zum Projekt, und klicken Sie auf Chaincode importieren.