Download Kukulkan VS Code Extension

• Kukulkan VS Code Extension
• Kukulkan Shell (Instalador .deb o ejecutable .exe)
• Herramienta JPS (Añadir al PATH {PATH_DE_JDK}/bin)
• Git

Comandos básicos

• help: Display help about available commands.
• clear: Clear the shell screen
• stacktrace: Display the full stacktrace of the last error
• stop-process: Detiene un proceso Java

Nota:
Kukulkan Shell cuenta con función de autocompletado de los comandos al presionar la tecla TAB.
Por ejemplo, sta + TAB completará el comando stacktrace en la línea de comandos.

Comandos de navegación

• pwd: Show the current direction
• cd: Change directory
• dir, ll, ls: List the currents files

NAME
    create-project - Generate a Project from an Archetype Catalog

SYNOPSYS
    create-project [--app-name] string  [--packaging] string  [[--database-type] database-type]  

OPTIONS
    --app-name  string

        [Mandatory]
        [no puede ser null]

    --packaging  string

        [Mandatory]
        [no puede ser null]

    --database-type  database-type

        [Optional, default = NO_SQL_MONGODB]

Ejemplo:

create-project --app-name demo  --packaging mx.infotec.dads.demo --database-type SQL_MYSQL

Nota: Si se encuentra git instalado se realizan las siguientes acciones luego de crear el nuevo proyecto:

• Crea un nuevo repositorio
• Añade todos los archivos creados al stage
• Se hace un commit al repositoro
• Se crea la rama develop y se mueve hacia dicha rama

Prompt

Cuando se navega a un directorio que contiene a la raíz de un proyecto generado con Kukulkán, el prompt se muestra diferente:

kukulkan @app @git/develop

• @app: indica que el directorio contiene un proyecto generado con Kukulkán
• @git/develop: indica que el proyecto utiliza git como Software de Control de Versiones, seguido del nombre de la rama en que se encuentra el proyecto.

NAME
    config - Configurate the project

SYNOPSYS
    config [[--type] configuration-type]  

OPTIONS
    --type  configuration-type

        [Optional, default = FRONT_END]

Este comando es un wrapper de los siguientes comandos:

• yarn install: Instala las dependencias Node
• bower install: Instala las dependencias Bower
• gulp: Inyecta dependencias al index.html

NAME
    run - Run a Spring-Boot App

SYNOPSYS
    run [[--profile] profile]  

OPTIONS
    --profile  profile

        [Optional, default = DEV]

El DSL de Kukulkan se utiliza para definir un modelo de dominio, con entidades y relaciones.

Declaración de entidades

Sintaxis:

entity <entity-name> [entity-table-name] {
    [<attribute-name> : <data-type> [<validator>*]
}

Declarar una entidad sin atributos

entity Person

Declarar una entidad con atributos

entity Person {
    name: String required,
    lastName: String
}

Todas las entidades contienen un atributo id por defecto.

Tipos de dato:

• String
• Integer
• Long
• BigDecimal
• Float
• Double
• Boolean
• Date
• LocalDate
• ZonedDateTime
• Instant
• Blob
• AnyBlob
• ImageBlob

Guía de relaciones con JPA

Sintaxis:

entity <entity-name> (entity-table-name) {
    <relationship-type> [to-source-attribute-name] <attribute-name> : <entity>
}

Tipos de relación:

• OneToOne
• OneToMany
• ManyToOne
• ManyToMany

Relación Unidireccional

entity Person {
    name: String,
    OneToOne address: Address
}
entity Address {
    street: String
}

Relación Bidireccional

entity Person {
    name: String,
    OneToOne (person) address: Address
}
entity Address {
    street: String required
}

Nótese que en las relaciones bidireccionales se define un elemento extra (person), esto significa que:

• en la entidad Person se creará un atributo del tipo Address.
• en la entidad Address se creará un atributo del tipo Person.

Display field

El display field es el atributo de la entidad que se muestra en la interfaz gráfica cuando es referenciada mediante una relación con otra entidad. Por defecto es el atributo id pero se puede cambiar usando el símbolo de flecha -> en la declaración de la entidad. Por ejemplo:

entity Person {
    name: String,
    OneToOne address: Address
}
entity Address {
    -> street: String required
}

Se usará street, en lugar de id, como display field en el formulario de creación/edición de la entidad Person.

Relación con CoreUser

En el DSL de Kukulkan, CoreUser es una palabra reservada para representar a la entidad User que se crea junto con el arquetipo. Esta entidad se puede asociar con cualquier otra definida por el usuario pero solo tiene soporte para los tipos de relación unidireccional OneToOne, ManyToOne y ManyToMany. Por ejemplo:

entity Person {
    OneToOne user: CoreUser
}

Nótese que no es necesario declarar ni importar a CoreUser en el modelo de dominio.

NAME
    add-entities-from-language - Generate all the entities that come from a file with .3k or .kukulkan extension

SYNOPSYS
    add-entities-from-language [--file-name] string  [[--exclude-layers] string]  

OPTIONS
    --file-name  string

        [Mandatory]

    --exclude-layers  string

        [Optional, default = @all]

Nota:
Luego de la adición de entidades al proyecto Kukulkán Shell ejecuta el comando config --type FRONT_END para asegurarse que los archivos generados en el front-end sean inyectados al index.html, entre otras acciones.

Cliente (Front-end, AngularJS)

Servidor (Back-end, Spring Boot)