1. Oracle Blockchain Platform verwenden
  2. Kettencodes mit Low-Code Blockchain App Builder erstellen
  3. Befehlszeilenschnittstelle von Blockchain App Builder verwenden
  4. Chaincode-Projekt mit der Blockchain App Builder-CLI erstellen
  5. Eingabespezifikationsdatei

Eingabespezifikationsdatei

Der Initialisierungsbefehl Blockchain App Builder liest die Eingabespezifikationsdatei und generiert das Gerüstprojekt mit mehreren Tools, um den Chaincode-Entwicklungsprozess zu unterstützen.

Mit der Spezifikationsdatei können Sie mehrere Assetdefinitionen und -verhalten, CRUD- und Nicht-CRUD-Methodendeklaration, benutzerdefinierte Methoden, Validierung von Argumenten, automatisches Marshalling/Unmarshalling, transparente Persistenzfunktion und Aufrufen von Rich Data-Abfragen mit SQL SELECTs oder der CouchDB Query Language angeben. Diese Funktionen werden für Sie generiert.

Informationen zum Angeben von Tokenassets finden Sie in den folgenden Themen:
Die Spezifikationsdatei kann in yaml oder json geschrieben werden. Sie können Beispielspezifikationsdateien in beiden Formaten im Blockchain App Builder-Package herunterladen:
  • Fabcar-Typescript.yml
  • Marbles-Go.yml

Hinweis:

Gemäß Go-Konventionen beginnen exportierte Namen mit einem Großbuchstaben. Daher müssen alle Anlageneigenschaften und -methoden Namen haben, die in der Spezifikationsdatei mit Großbuchstaben beginnen.

Struktur der Spezifikationsdatei

Normalerweise strukturieren Sie eine Spezifikationsdatei wie folgt:

assets: 
    name:
    type:
    properties:
        name:
        type:
        id:
        derived:
           strategy:
           algorithm:
           format:
        mandatory:
        default:
        validate:
    methods:
        crud:
        others:
customMethods:

Blockchain App Builder unterstützt zwei spezielle Assettypen, eingebettete Assets und Tokenassets, zusätzlich zu generischen Assets ohne angegebenen Typ. Die speziellen Assets werden im Abschnitt assets: der Spezifikationsdatei als type: embedded oder type: token definiert.

Tabelle 7-2: Beschreibungen und Beispiele für Spezifikationsdateiparameter

Eintrag Beschreibung Beispiele:
assets:

Diese Eigenschaft übernimmt die Definition und das Verhalten der Anlage. Sie können hier mehrere Anlagendefinitionen angeben.

  
name:

Den Namen des Assets.

Die folgenden Namen sind reserviert. Verwenden Sie diese Namen nicht für Assets.
  • account
  • role
  • hold
  • token
  • authorization
  • tokenAdmin
  • Account
  • Role
  • Hold
  • Token
  • Authorization
  • TokenAdmin
 
name: owner # Information about the owner
type:

Assettypen

Die folgenden speziellen Assettypen werden unterstützt:
  • embedded
  • token

Wenn Sie im Abschnitt assets keinen type-Parameter angeben, hat das Asset den generischen Typ.

 
type:

Typ: eingebettet

Wenn diese Eigenschaft auf embedded gesetzt ist, wird das Asset als eingebettetes Asset definiert. Eingebettete Anlagen haben keine CRUD-Methoden und müssen Teil einer anderen Anlage sein, die im Buch gespeichert werden soll.

Im Beispiel ist die Eigenschaft address eingebettet und in einem anderen Asset definiert.

Eingebettete Assets unterstützen keine zirkulären Referenzen. Beispiel: Im vorherigen Beispiel darf das Asset address keine Referenz auf das Asset employee enthalten.

Anlage: employee
name: employee
  properties:
     name: employeeId
     type: string
     mandatory: true
     id: true

     name: firstName
     type: string
     validate: max(30)
     mandatory: true

     name: lastName
     type: string
     validate: max(30)
     mandatory: true

     name: age
     type: number
     validate: positive(),min(18)

     name: address
     type: address
Asset: address
name: address

type: embedded

properties:
   name: street
   type: string

   name: city
   type: string

   name: state
   type: string

   name: country
   type: string
properties:

Beschreiben Sie alle Eigenschaften eines Assets.

  
name:

Der Name der Eigenschaft.

 
name: ownerId # Unique ID for each owner
id:
  • true

Gibt die ID dieses Assets an. Diese Eigenschaft ist obligatorisch.

 
name: owner            # Information about the owner
properties:
     name: ownerId    # Unique ID for each owner
     type: string
     mandatory: true
     id: true
     name: name        # Name of the owner
     type: string
     mandatory: true
type:

Attributtypen

Die folgenden allgemeinen Eigenschaftstypen werden unterstützt:
  • number
  • float
  • string
  • boolean
  • date
  • array
Bei Go-Kettencodes wird number int zugeordnet und float float64 zugeordnet. Andere Typen werden derzeit nicht unterstützt, einschließlich der folgenden Typen:
  • complex
  • unsigned/signed int
  • 8/16/32/64 bits
 
name: year        # Model year
                    type: number
                    mandatory: true
                    validate: min(1910),max(2020)
                    name: color       # Color - no validation as color names are innumerable
                    type: string
                    mandatory: true
derived:

Diese Eigenschaft gibt an, dass die ID-Eigenschaft von anderen Schlüsseln abgeleitet wird. Abhängige Eigenschaften müssen den Datentyp string und kein eingebettetes Asset aufweisen.

Diese Eigenschaft hat zwei obligatorische Parameter:
  • strategy: Übernimmt die Werte concat oder hash.
  • format: Übernimmt ein Array von Spezifikationszeichenfolgen und -werten, die von der Strategie verwendet werden sollen.
Beispiel 1:
  • Die Eigenschaft employeeID hängt von den Eigenschaften firstName und lastName ab.
  • Diese Eigenschaft ist eine Verkettung der im Array format aufgeführten Werte.
  • IND%1#%2%tIND ist der 0. Index im Array und beschreibt das endgültige Format.
  • %n ist ein Positionsbezeichner, der seine Werte aus den anderen Indizes im Array übernimmt.
  • %t gibt an, dass der Wert im Kanalheader stub.timestamp lauten muss.
  • Wenn Sie das Zeichen % in der Zeichenfolge format verwenden müssen, muss es mit einem anderen % maskiert werden.
  • Das endgültige Format in diesem Beispiel lautet: INDfirstName#lastName1606885454916IND.
Beispiel 2:
  • Wenn Sie hash verwenden, müssen Sie auch den Parameter algorithm verwenden. Der Standardwert ist sha256. md5 wird ebenfalls unterstützt.
  • IND%1#%2%t ist der 0. Index im Array und beschreibt das endgültige Format.
  • %n ist ein Positionsbezeichner, der seine Werte aus den anderen Indizes im Array übernimmt.
  • %t gibt an, dass der Wert im Kanalheader stub.timestamp lauten muss.
  • Wenn Sie das Zeichen % in der Zeichenfolge format verwenden müssen, muss es mit einem anderen % maskiert werden.
Beispiel 1
name: employee
  properties:
     name: employeeId
     type: string
     mandatory: true
     id: true
     derived:
         strategy: concat
         format: ["IND%1#%2%tIND","firstName","lastName"]

     name: firstName
     type: string
     validate: max(30)
     mandatory: true

     name: lastName
     type: string
     validate: max(30)
     mandatory: true

     name: age
     type: number
     validate: positive(),min(18)
Beispiel 2
name: account
  properties:
     name: accountId
     type: string
     mandatory: true
     id: true
     derived:
         strategy: hash
         algorithm: 'sha256'
         format: ["IND%1#%2%t","bankName","ifsccode"]

     name: bankName
     type: string
     validate: max(30)
     mandatory: true

     name: ifsccode
     type: string
     mandatory: true
mandatory:
  • true
  • false

Die entsprechende Eigenschaft ist erforderlich und kann beim Erstellen einer Anlage nicht übersprungen werden.

 
name: phone       # Phone number - validate as (ddd)-ddd-dddd where dashes could also be periods or spaces
type: string
mandatory: true
validate: /^\(?([0-9]{3})\)?[-. ]?([0-9]{3})[-. ]?([0-9]{4})$/
name: cars        # The list of car VINs owned by this owner
type: string[]
mandatory: false
default:

Dadurch erhalten Sie den Standardwert dieser Eigenschaft.

  
validate:

Die angegebene Eigenschaft wird anhand einiger der von Blockchain App Builder bereitgestellten Out-of-Box-Validierungen validiert. Sie können Validierungen verketten, wenn Sie sicherstellen, dass die Kette gültig ist.

Wenn die Eigenschaft validate nicht angegeben wird, wird die Validierung nur für die Eigenschaft type ausgeführt.

 
validate:

Typ: Zahl
  • positiv()
  • negativ()
  • Minuten()
  • max()

Diese Validierungen können durch Komma getrennt miteinander verkettet werden. 

name: offerApplied
type: number
validate: negative(),min(-4)
name: year  # Model year
type: number
mandatory: true
validate: min(1910),max(2020)
validate:

Typ: Zeichenfolge
  • min()
  • max()
  • email()
  • url()
  • /regex/ - Unterstützt PHP regex

Bei Go-Kettencodes müssen reguläre Ausdrücke, die bestimmte reservierte Zeichen oder Leerzeichen enthalten, ordnungsgemäß mit Escapezeichen versehen werden.

 
name: website 
type: string
mandatory: false
validate: url()
name: phone  # Phone number - validate as (ddd)-ddd-dddd where dashes could also be periods or spaces
type: string
mandatory: true
validate: /^\(?([0-9]{3})\)?[-. ]?([0-9]{3})[-. ]?([0-9]{4})$/
name: Color #Color can be red, blue, or green
type: string
mandatory: true
validate: /^\\s*(red|blue|green)\\s*$/
validate:

type: boolean
  • true
  • false

Im Beispiel entspricht die Validierung der Eigenschaft active dem Typ selbst (boolean). 

name: active
type: boolean
validate:

Typ: Array

Durch den Typ selbst wird in Form von type: number[] vermittelt, dass das Array vom Typ "Zahl" ist.

Sie können Limits für das Array im Format number[1:5] eingeben. Das bedeutet, dass die Mindestlänge 1, die Höchstlänge 5 ist. Wenn eines vermieden wird, wird nur min/max berücksichtigt. 

name: items
type: number[:5]
validate:

Typ: Datum
  • min()
  • max()
Datum muss eines der folgenden Formate aufweisen:
  • YYYY-MM-DD
  • YYYY-MM-DDTHH:MM:SSZ, wobei T das Datum von der Uhrzeit trennt, und Z UTC angibt. Zeitzonenverschiebungen können die Z wie in -05:00 für die zentrale Sommerzeit ersetzen. 
name: expiryDate
type: date
validate: max('2020-06-26')
name: completionDate
type: date
validate: min('2020-06-26T02:30:55Z')
methods:

Verwenden Sie diese Option, um anzugeben, welche der CRUD-Methoden (Erstellen/Lesen/Aktualisieren/Löschen) oder zusätzliche Methoden generiert werden sollen.

Wenn nichts eingegeben wird, werden standardmäßig alle CRUD- und anderen Methoden generiert.

 
methods:
    crud: [create, getById, update, delete]
    others: [getHistoryById, getByRange]
crud:
  • create
  • getByID (lesen)
  • update
  • delete

Wenn dieses Array leer bleibt, werden keine CRUD-Methoden erstellt.

Wenn der Parameter crud überhaupt nicht verwendet wird, werden standardmäßig alle vier Methoden erstellt.

Der Parameter crud kann nicht auf token- und embedded-Assets angewendet werden. 

methods:
    crud: [create, getById, delete]
    others: [] # no other methods will be created
others:
  • getHistoryById
  • getByRange

getHistoryById gibt die Historie des Assets in einer Liste zurück.

getByRange gibt alle Assets in einem bestimmten Bereich zurück. Weitere Informationen finden Sie in "getByRange" (TypeScript) und "GetByRange" (Los).

Wenn dieses Array leer bleibt, werden keine anderen Methoden erstellt.

Wenn der Parameter others überhaupt nicht verwendet wird, werden beide Methoden standardmäßig erstellt.

Der Parameter others kann nicht auf token- und embedded-Assets angewendet werden. 

methods:
    crud: [create, delete]
    others: [] # no other methods will be created
      methods:
        crud: [create, getById, update, delete]
        others: [getHistoryById, getByRange]
customMethods:

Diese Eigenschaft erstellt nicht verwendbare benutzerdefinierte Methodenvorlagen in der Hauptcontrollerdatei. Er nimmt die Methodensignatur an und erstellt die Funktionsdeklaration in der Controller-Datei.

Hier können Sie sprachspezifische Funktionsdeklarationen angeben.

Wir stellen eine benutzerdefinierte Methode mit dem Namen executeQuery bereit. Wenn sie der Spezifikationsdatei hinzugefügt wird, wird detailliert beschrieben, wie Berkeley DB SQL- und CouchDB Rich-Abfragen ausgeführt werden können. Diese Methode kann nur aufgerufen werden, wenn Sie mit Oracle Blockchain Platform Cloud oder Enterprise Edition verbunden sind.

TypeScript

customMethods:
    - executeQuery
    - "buyCar(vin: string, buyerId: string, sellerId: string, price: number, date: Date)"
    - "addCar(vin: string, dealerId: string, price: number, date: Date)"

Los

customMethods:
    - executeQuery
    - "BuyCar(vin string, buyerId string, sellerId string, price int)"
    - "AddCar(vin string, dealerId string, price int)"