Genera API wrapper mediante Visual Studio Code

La versione avanzata di Blockchain App Builder consente di generare le API wrapper in Visual Studio Code.

Quando si generano le API wrapper in Visual Studio Code, viene richiesto se sovrascrivere i package API wrapper precedenti esistenti nella posizione di selezione.

Il gateway API limita a 50 il numero di instradamenti che è possibile creare in una singola distribuzione. Se si tenta di generare più di 50 API wrapper, viene richiesto se creare più gateway. La creazione di più gateway con lo stesso prefisso del percorso di distribuzione mantiene un percorso di base coerente in tutti gli endpoint API wrapper. Se si sceglie di non creare più gateway, la generazione dell'API wrapper viene annullata. È inoltre possibile riutilizzare i gateway esistenti, come descritto nei passi riportati di seguito.

  1. Selezionare il progetto codice concatenato nel riquadro Codici concatenati.
  2. Fare clic con il pulsante destro del mouse sul nome del codice concatenato, quindi selezionare Genera package API wrapper. Viene visualizzato il riquadro Oracle Blockchain Platform - Generazione package API wrapper.
  3. Immettere le variabili di configurazione descritte nella tabella riportata di seguito.
    Campo Descrizione Valore predefinito
    OCID compartimento OCID del compartimento in Oracle Cloud Infrastructure (OCI). nessuno
    Nome compartimento Nome del compartimento OCI. nessuno
    Dominio di Identity Il dominio di Identity da utilizzare. nessuno
    Canale Blockchain Nome del canale Oracle Blockchain Platform in cui viene distribuito il codice concatenato. nessuno
    URL blockchain URL di Oracle Blockchain Platform associato alla distribuzione del codice concatenato. nessuno
    Posizione Directory di sistema in cui generare il pacchetto API wrapper. nessuno
    Nuovo gateway API Per creare gateway API, selezionare Sì, quindi specificare un nome visualizzato gateway. Per riutilizzare i gateway API esistenti, selezionare No, quindi specificare un array di identificativi Oracle Cloud (OCID) per i gateway API esistenti da riutilizzare nel formato seguente. È necessario specificare un gateway ogni 50 API wrapper. 
    ["ocid1.apigateway.xxx", "ocid1.apigateway.yyy"]
    		 Sì
    Prefisso percorso di distribuzione Prefisso del percorso di distribuzione nel gateway API, che specifica il percorso in cui vengono distribuiti gli instradamenti. Il prefisso del percorso di distribuzione deve iniziare con una barra (/). /<ChaincodeName>
    Sincronizzazione blockchain Il valore di sincronizzazione da includere nel payload per le chiamate API. true
    Timeout blockchain Valore di timeout da includere nel payload per le chiamate API. 6.000
    Nome criterio Nome del criterio che consente la gestione controllata e l'accesso alle API tramite autorizzazioni definite per gruppi e compartimenti nell'organizzazione ChaincodeName
    Nome visualizzato VCN Nome visualizzato della rete cloud virtuale OCI. ChaincodeName
    Nome visualizzato applicazione Nome visualizzato dell'applicazione OCI. ChaincodeName
    Nome visualizzato gateway Nome visualizzato del gateway API. ChaincodeName
    Nome visualizzato distribuzione Nome visualizzato del gateway API. ChaincodeName
    Nome repository OCI Nome del repository del registro OCI, che deve essere composto da tutte le lettere minuscole. ChaincodeName in caratteri minuscoli
  4. Fare clic su Salva.
  5. Fare clic sulla scheda Mapping. Il riquadro Mapping mostra una tabella di tutte le API del controller disponibili nel codice concatenato. Ogni metodo dispone di un endpoint API corrispondente, che è possibile modificare in base alle esigenze. Selezionare la casella di controllo Genera API wrapper corrispondente per includere l'API del controller nel package dell'API wrapper. Fare clic su Select All per includere tutte le API controller.
  6. Fare clic su Salva.
  7. Fare clic su Genera. Il package API wrapper e la raccolta Postman associata vengono generati.