Tester le code de chaîne au moyen de Visual Studio Code

Si votre code de chaîne est exécuté sur un réseau, vous pouvez tester l'une des méthodes générées. En outre, si vous choisissez de créer la méthode executeQuery lors du développement de votre code de chaîne, vous pouvez exécuter des interrogations enrichies SQL si votre code de chaîne est déployé dans un réseau Oracle Blockchain Platform.

Tester le code de chaîne sur un réseau Hyperledger Fabric local

Une fois que votre projet de code de chaîne est exécuté sur un réseau local, vous pouvez le tester.

Le générateur d'applications Blockchain contient un assistant intégré qui vous aide à appeler ou à interroger votre code de chaîne.

1. Sélectionnez votre projet de code de chaîne dans le volet Codes de chaîne. Dans le volet Détails du code de chaîne, sélectionnez Exécuter. Le nom du code de chaîne est déjà sélectionné. Assurez-vous que l'environnement cible est réglé à Environnement local, de sorte que le canal utilise par défaut le seul canal disponible.
2. Dans le champ Fonction, sélectionnez une méthode dans la liste déroulante. Chaque méthode disponible dans le code de chaîne est répertoriée.
3. Dans le champ Paramètre de fonction, cliquez sur le bouton Actions supplémentaires. Cette opération lance une fenêtre affichant les propriétés disponibles pour la méthode sélectionnée. Entrez les propriétés, puis cliquez sur Omettre pour toute propriété non obligatoire que vous ne souhaitez pas soumettre lorsque vous appelez la méthode. Cliquez sur Enregistrer.
4. Cliquez sur Appeler.

La fenêtre de la console Sortie affiche que la fonction a été appelée. Sinon, dans le volet Actions de code de chaîne, la fenêtre Sortie de la fonction affiche la sortie. Cliquez sur Actions supplémentaires pour voir la sortie formatée.

Pour enregistrer la méthode et les paramètres que vous venez d'exécuter, cliquez sur Enregistrer et entrez un nom et une description. La fonction est enregistrée dans votre projet de code de chaîne dans le dossier Queries. Pour l'utiliser de nouveau, cliquez dessus avec le bouton droit de la souris et sélectionnez Ouvrir.

Si vous apportez des modifications au fichier de contrôleur qui modifient les méthodes, sélectionnez l'icône Recharger en haut du volet Exécution du code de chaîne. La modification sera ensuite reflétée dans la liste déroulante Fonction.

Note :

Si vous ne voulez pas utiliser l'assistant pour les tests, vous pouvez également exécuter les outils de ligne de commande du générateur d'applications Blockchain dans la fenêtre Terminal de Visual Studio Code. Pour plus d'informations sur les tests à partir de la ligne de commande, voir Tester le code de chaîne sur un réseau Hyperledger Fabric local.

Test local de plusieurs utilisateurs de jeton

Pour tester localement un projet de jeton avec plusieurs utilisateurs, vous pouvez utiliser la propriété tokenUser pour modifier l'appelant de chaque transaction. Chaque projet de code de chaîne échafaudé inclut un fichier .ochain.json, qui stocke les métadonnées du code de chaîne. Vous modifiez l'appelant en mettant à jour la valeur du champ tokenUser dans le fichier .ochain.json.

{
  "name": "digiCurrCC",
  "description": "Chaincode package for digiCurrCC",
  "chaincodeName": "digiCurrCC",
  "chaincodeType": "node",
  "configFileLocation": "/Users/user1/token.yml",
  "appBuilderVersion": "21.2.3",
  "nodeVersion": "v12.18.1",
  "tokenUser": "admin"
}

Lorsqu'un projet fait l'objet d'un échafaudage, la propriété tokenUser est réglée à l'utilisateur admin par défaut du réseau local. Pour modifier l'appelant d'une transaction, modifiez la propriété tokenUser pour qu'elle corresponde à la propriété user_id qui a été définie lors de la création du compte lors de l'appel de la méthode createAccount (TypeScript) ou CreateAccount (Go).

Installation et déploiement automatiques après la mise à jour

Chaque fois que vous mettez à jour et enregistrez votre code de chaîne, les modifications sont compilées, installées et déployées automatiquement. Il n'est pas nécessaire d'arrêter ou de réactiver le réseau local. Tous les projets seront automatiquement compilés et déployés pour chaque modification.

Tester les opérations de cycle de vie sur un réseau Oracle Blockchain Platform distant

Une fois que le projet de code de chaîne a été déployé sur votre réseau Oracle Blockchain Platform distant, vous pouvez le tester.

Vous testez le code de chaîne exécuté sur un réseau Oracle Blockchain Platform distant comme il est testé sur un réseau local, comme décrit à la section Tester votre code de chaîne sur un réseau Hyperledger Fabric local.

Vous pouvez utiliser les mêmes commandes pour effectuer toutes les transactions de méthode sur un réseau Oracle Blockchain Platform Cloud ou Enterprise Edition distant; tout ce qui est pris en charge sur le réseau local est également pris en charge sur le réseau distant. Sélectionnez l'instance Oracle Blockchain Platform comme environnement cible lors de l'exécution des tests.

Tester des projets de jeton sur un réseau Oracle Blockchain Platform distant

Vous pouvez tester les projets de code de chaîne qui fonctionnent avec des jetons à l'aide du générateur d'applications Blockchain, du mandataire REST d'Oracle Blockchain Platform ou de la trousse SDK Hyperledger Fabric.

Générateur d'applications Blockchain

Vous pouvez utiliser l'extension Visual Studio Code pour appeler des transactions avec plusieurs utilisateurs afin de tester les codes de chaîne de jeton. Pour effectuer un test avec plusieurs utilisateurs, modifiez les paramètres d'autorisation (nom d'utilisateur et mot de passe) dans l'onglet Environnements, puis enregistrez l'environnement. Lors de l'appel de transactions, sélectionnez le même environnement dans la liste déroulante, puis exécutez la transaction.

Mandataire REST d'Oracle Blockchain Platform

Vous pouvez utiliser le mandataire REST d'Oracle Blockchain Platform pour exécuter le code de chaîne de jeton sur un réseau Oracle Blockchain Platform distant. Utiliser un client mandataire REST, tel que le client REST Postman, pour tester votre projet de code de chaîne.

Pour tester plusieurs utilisateurs, modifiez les paramètres d'autorisation (nom d'utilisateur et mot de passe) dans votre client REST ou connectez-vous à une autre instance d'Oracle Blockchain Platform.

Exécuter des interrogations enrichies SQL Berkeley DB

Si vous choisissez de créer la méthode executeQuery lors du développement du code de chaîne, vous pouvez exécuter des interrogations enrichies SQL si votre code de chaîne est déployé dans un réseau Oracle Blockchain Platform.

Si vous avez utilisé executeQuery dans la section customMethods du fichier de spécification, une méthode executeQuery correspondante sera créée dans le contrôleur.

Fichier de spécification :

customMethods:
    - executeQuery
    - "fetchRawMaterial(supplierid: string, rawMaterialSupply: number)"
    - "getRawMaterialFromSupplier(manufacturerId: string, supplierld: string, rawMaterialSupply: number)"
    - "createProducts(manufacturerId: string, rawMaterialConsumed: number, productsCreated: number)"
    - "sendProductsToDistribution()"

Fichier de contrôleur :

**
*
* BDB sql rich queries can be executed in OBP CS/EE.
* This method can be invoked only when connected to remote OBP CS/EE network.
*
*/
@Validator(yup.string())
public async executeQuery(query: string) {
    const result = await OchainController.query(query); 
    return result;
}

Vous pouvez appeler cette méthode pour exécuter des interrogations Berkeley DB SQL enrichies sur le réseau Oracle Blockchain Platform. Vous devez sélectionner l'environnement Oracle Blockchain Platform que vous avez créé en tant qu'environnement cible lors de l'exécution des interrogations.

Exemple :

1. Dans le volet Détails du code de chaîne, sélectionnez Exécuter. Le nom du code de chaîne, l'environnement cible et le canal sont déjà spécifiés à partir de l'étape de déploiement.
2. Dans le champ Nom de la fonction, sélectionnez executeQuery dans la liste déroulante.
3. Dans le champ Paramètre de fonction, cliquez sur Actions supplémentaires. Cela lance une fenêtre dans laquelle vous pouvez entrer la chaîne d'interrogation. Entrez les arguments de votre interrogation, puis cliquez sur Enregistrer.
4. Cliquez sur Interrogation.

La fenêtre Sortie s'ouvre et affiche l'interrogation en cours d'exécution, ainsi que le résultat.

ochain query executeQuery "SELECT key, valueJson FROM <STATE> WHERE
json_extract(valueJson, '$.rawMaterialAvailable') = 4" 

L'ensemble de l'interrogation SQL est pris dans l'argument, de sorte que vous pouvez apporter des modifications à votre interrogation à la volée.

Générer des commandes d'interface de ligne de commande à partir d'interrogations

Si vous avez enregistré des interrogations dans un projet de code de chaîne dans Visual Studio Code, vous pouvez générer automatiquement les commandes d'interface de ligne de commande équivalentes.

Vous devez avoir au moins une interrogation enregistrée dans un projet de code de chaîne pour générer des commandes d'interface de ligne de commande pour macOS, Linux et Microsoft Windows.

1. Développez le projet dans le volet Codes de chaîne.
2. Cliquez avec le bouton droit de la souris sur Interrogations.
3. Cliquez sur Générer des commandes de l'interface de ligne de commande.

Deux fichiers texte sont générés et affichés dans la section Interrogations du volet Codes de chaîne : CLIcommandsForLinux.txt et CLIcommandsForWindows.txt. Sélectionnez le nom du fichier pour ouvrir le fichier et afficher les commandes d'interface de ligne de commande correspondantes.