Creación de un proyecto de código de cadena con la CLI de Blockchain App Builder

Para crear un proyecto de código de cadenas al utilizar la CLI de Blockchain App Builder, debe andar un proyecto de código de cadenas desde un archivo de especificación detallado. A continuación, el proyecto generado contiene todos los archivos que necesita.

Antecedentes

El comando init de Blockchain App Builder inicializa y andamiaje un proyecto de código de cadenas listo para usar. Según una entrada simple, el comando init puede generar proyectos de código de cadenas complejos que incluyen las siguientes funciones:

Varios activos (modelos) y sus comportamientos (controladores)
Generación automática de métodos CRUD (creación/lectura/actualización/supresión) y no CRUD
Validación automática de argumentos
Determinación/anulación de argumentos
Capacidad de persistencia transparente (ORM)
La capacidad de llamar a consultas enriquecidas

El proyecto generado sigue el patrón de modelo/controlador y decorador, que permite que las propiedades de un activo que se mantienen en el libro mayor se especifiquen como campos con tipo y se amplíen con comportamientos y reglas de validación específicos. Este patrón reduce el número de líneas de código, lo que ayuda en la legibilidad y escalabilidad.

Requisitos

Antes de andamiar un proyecto, debe crear un archivo de especificación de entrada. Para obtener más información, consulte Archivo de especificación de entrada.

Andamio del proyecto Chaincode con el comando init

Si escribe ochain init -h, se mostrará el uso del comando con todas sus opciones. El comando init tiene las siguientes opciones:

--cc/-c:
Nombre del proyecto de código de cadenas. El valor por defecto es MyChaincode.
--lang/-l
Lenguaje del código de cadenas de andamios. Blockchain App Builder soporta Typescript (ts) y Go (go). Si no se especifica ninguna opción, el idioma se define por defecto en ts.
--conf/-f o --spec
La ruta a un archivo de especificación de entrada. Blockchain App Builder lee el archivo de especificación de entrada y genera el proyecto de andamios con muchas herramientas auxiliares, que ayudan a reducir el esfuerzo general de desarrollo. Aprovechar al máximo el archivo de especificación de entrada puede reducir significativamente el tiempo de desarrollo.

El archivo de especificación puede tener el formato yaml o json. Si no se especifica la ruta, se toma por defecto el directorio actual. Consulte Archivo de especificación de entrada.
--out/-o (Salida/S/O)
Directorio de salida del proyecto de código de cadenas de andamios. Si no se especifica, el proyecto andamio se genera en el directorio actual.

La salida es un proyecto de código de cadenas Typescript o Go totalmente contenido, ligero y escalable.
--root/-r
Válido y necesario solo para Ir. Directorio raíz de la variable GOHOME para los códigos de cadena Go. El valor por defecto es example.com.

Ejemplo

my-mac:~ name$ ochain init --cc MyNewTsProject --lang ts --conf spec.yml

Valores por Defecto

Si no se especifica ninguna opción en el comando ochain init, el nombre del proyecto andamio es MyChaincode y el idioma es TypeScript.

El archivo MyChaincode.model.ts solo contiene un activo, denominado MyAsset, con una propiedad denominada value. El archivo MyChaincode.controller.ts contiene un controlador con los métodos CRUD correspondientes para el modelo MyAsset.

Salida

Una vez completado el proceso, tendrá un proyecto de código de cadenas totalmente funcional que puede desplegar de forma local o en una instancia remota de Oracle Blockchain Platform. Para obtener una descripción detallada de los archivos creados, consulte:

Para obtener una visión general detallada de un proyecto basado en token, consulte también: