Écrire un code de chaîne
Un code de chaîne est écrit dans Go, Node.js ou Java, puis emballé dans un fichier .zip installé sur le réseau Oracle Blockchain Platform.
Les codes de chaîne définissent le schéma de données dans le livre, l'initialiser, compléter les mises à jour lorsqu'ils sont déclenchés par des applications et répondre aux interrogations. Les codes de chaîne peuvent également publier des événements qui permettent aux applications d'être avisées et de terminer des opérations en aval. Par exemple, une fois que des bons de commande, des factures et des enregistrements de livraison ont été mis en correspondance par un code de chaîne, il peut reporter un événement afin qu'une application abonnée puisse traiter les paiements connexes et mettre à jour un système ERP interne.
Ressources pour le développement de code de chaîne
Oracle Blockchain Platform utilise Hyperledger Fabric comme base. Utiliser la documentation sur Hyperledger Fabric pour écrire des codes de chaîne valides.
-
Bienvenue dans Hyperledger Fabric. Lisez les sections Key Concepts and Tutorials (Concepts clés et tutoriels) avant d'écrire votre propre code de chaîne.
-
Langage de programmation Go. Les compilateurs, outils et bibliothèques Go fournissent une variété de ressources qui simplifient l'écriture de codes de chaîne.
-
Cim pour ensemble. Le code de chaîne fournit des API permettant au code de chaîne d'accéder à ses variables d'état, d'obtenir le contexte de transaction et d'appeler d'autres codes de chaîne. La documentation de simulation du paquetage décrit la syntaxe réelle requise pour votre code de chaîne.
Oracle Blockchain Platform fournit des exemples téléchargeables qui vous aident à comprendre l'écriture des codes de chaîne et des applications. Voir À quoi servent les échantillons de code de chaîne?
Vous pouvez ajouter une syntaxe d'interrogation enrichie à vos codes de chaîne pour interroger la base de données d'état. Voir Syntaxe d'interrogation enrichie SQL et CouchDB Syntaxe d'interrogation enrichie.
Package a Go Chaincode
Après avoir écrit votre code de chaîne, compressez-le dans un fichier au format .zip. Il n'est pas nécessaire de créer un ensemble pour le code de chaîne de Go ou de le signer : le processus d'installation et de déploiement d'Oracle Blockchain Platform le fait pour vous, comme décrit dans Flux de travail type pour déployer des codes de chaîne.
Si votre code de chaîne comporte des dépendances externes, vous pouvez les placer dans le répertoire des fournisseurs de votre fichier .zip.
Vendez les codes de chaîne Shim for Go
La dépendance de réduction de chaîne de caractères Go n'est plus incluse dans Hyperledger Fabric. La cale doit maintenant être vendue (importée) pour les codes de chaîne Go avant d'être installées sur un pair.
Vous pouvez utiliser des modules Go ou un outil de tierce partie, tel que le fournisseur de la chaîne pour fournisseur la copie de code de chaîne et la mettre à jour vers la version qui fonctionne avec Hyperledger Fabric.
Pour plus d'informations, voir Modifications de la couche de code de chaîne (Go chaincode uniquement) et Mettre à niveau les codes de chaîne avec la couche de chaîne vendue dans la documentation sur Hyperledger Fabric. Pour plus d'informations sur les modules Go, voir Informations de référence sur les modules Go.
Collaborer un code de chaîne Node.js
package.json avec deux sections :
-
La section
scriptsdéclare comment lancer le code de chaîne. -
La section
dependenciesspécifie les dépendances.
Voici un exemple de code de chaîne package.json pour un code de chaîne Node.js :
{
"name": "chaincode_example02",
"version": "1.0.0",
"description": "chaincode_example02 chaincode implemented in Node.js",
"engines": {
"node": ">=8.4.0",
"npm": ">=5.3.0"
},
"scripts": { "start" : "node chaincode_example02.js" },
"engine-strict": true,
"license": "Apache-2.0",
"dependencies": {
"fabric-shim": "~1.3.0"
}
}
- Le fichier
package.jsondoit se trouver dans le répertoire racine. - Le fichier d'entrée JavaScript peut être localisé n'importe où dans le paquetage.
- Si
"start" : "node <start>.js"n'est pas spécifié dans le fichierpackage.json, le fichierserver.jsdoit se trouver dans le répertoire racine.
Compresser le code de chaîne et le fichier d'ensemble au format .zip pour l'installer sur Oracle Blockchain Platform.
Collaborer un code de chaîne Java
Si vous écrivez un code de chaîne Java, vous pouvez choisir Gradle ou Maven pour créer le code de chaîne.
.zip pour l'installer sur Oracle Blockchain Platform. La liste suivante présente des exemples de fichiers dans un paquetage de code de chaîne :Archive: example_gradle.zip
Length Date Time Name
--------- ---------- ----- ----
610 02-14-2019 01:36 build.gradle
54 02-14-2019 01:28 settings.gradle
0 02-14-2019 01:28 src/
0 02-14-2019 01:28 src/main/
0 02-14-2019 01:28 src/main/java/
0 02-14-2019 01:28 src/main/java/org/
0 02-14-2019 01:28 src/main/java/org/hyperledger/
0 02-14-2019 01:28 src/main/java/org/hyperledger/fabric/
0 02-14-2019 01:28 src/main/java/org/hyperledger/fabric/example/
5357 02-14-2019 01:28 src/main/java/org/hyperledger/fabric/example/SimpleChaincode.java
--------- -------
6021 10 files.zip pour l'installer sur Oracle Blockchain Platform. La liste suivante présente des exemples de fichiers dans un paquetage de code de chaîne :Archive: example_maven.zip
Length Date Time Name
--------- ---------- ----- ----
3313 02-14-2019 01:52 pom.xml
0 02-14-2019 01:28 src/
0 02-14-2019 01:28 src/chaincode/
0 02-14-2019 01:28 src/chaincode/example/
4281 02-14-2019 01:28 src/chaincode/example/SimpleChaincode.java
--------- -------
7594 5 filesTest d'un code de chaîne
Tester le code de chaîne après l'avoir écrit. Voir les sujets suivants :
Installation et déploiement d'un code de chaîne
Après avoir testé le code de chaîne, vous pouvez le déployer en suivant les informations du flux de travail type pour déployer les codes de chaîne.
Mise à niveau d'un code de chaîne
Mettre à niveau un code de chaîne déployé en suivant les étapes sous Mettre à niveau un code de chaîne.