Grails Support for VS Code

Soporte avanzado para el desarrollo de aplicaciones Grails en Visual Studio Code, inspirado en la experiencia de IntelliJ IDEA. Compatible con Grails 2.x hasta 7+.

Características

📝 Autocompletado Inteligente

El servidor LSP analiza tu proyecto en tiempo real e indexa dominios, controllers y servicios al abrir el workspace.

Domain Classes y GORM

Propiedades del dominio al escribir instancia.
Dynamic finders: Book.findByTitle(, Book.findAllByAuthor(
Métodos estáticos: list(), get(), count(), exists(), withCriteria { }, where { }
Métodos de instancia: save(), delete(), validate(), hasErrors(), refresh()
Relaciones hasMany y belongsTo

Controllers

Variables de scope: params, request, response, session, flash
render( y redirect( con sus named arguments (view:, model:, action:, controller:)
Al escribir view: " muestra las vistas GSP disponibles con navegación de carpetas
Al escribir controller: " lista los controllers del proyecto
Al escribir action: " lista las acciones del controller destino

Servicios

Al escribir miServicio. muestra los métodos del servicio parseados en tiempo real
Sugerencias de inyección de servicios disponibles en el proyecto

Imports

import com.miPaquete. autocompleta con dominios, controllers y servicios del proyecto sin duplicar texto

// Autocompletado de propiedades del dominio
def book = Book.findByTitle("Groovy")
book.   // → muestra: title, author, price, save(), delete(), validate()...

// Autocompletado de vistas
render(view: "/layouts/")  // → muestra carpetas y .gsp dentro de views/layouts/

// Autocompletado de métodos del servicio
securityService.   // → muestra métodos definidos en SecurityService.groovy

🔍 Navegación (Ctrl+Click / Cmd+Click)

Desde	Cursor sobre	Navega a
Controller	Nombre de Domain Class	Domain class
Controller	`book.title`	Línea exacta de `String title` en el dominio
Controller	`book?.id`	Línea exacta (safe navigation soportado)
Controller	`Area.findByNombre(`	Línea de `String nombre` en `Area.groovy`
Controller	`render(view: 'show')`	`views/book/show.gsp`
Controller	`render(view: '/layouts/main')`	`views/layouts/main.gsp`
Controller	`render(template: 'row')`	`views/book/_row.gsp`
Controller	`redirect(action: 'logIn')`	Línea de `def logIn()` en el mismo controller
Controller	`redirect(controller: 'book', action: 'show')`	Línea de `def show()` en `BookController`
Controller	`securityService.registerMember(`	Línea exacta del método en `SecurityService`
Controller	`renderResponse(`	Línea del método local en el mismo archivo
Cualquier archivo	`BookController`	`BookController.groovy`
Cualquier archivo	`def bookService`	`BookService.groovy`
GSP	`<g:render template="row">`	`_row.gsp` en la misma carpeta
GSP	`controller="book" action="show"`	Línea de `def show()` en `BookController`

class BookController {
    def bookService           // Ctrl+Click → BookService.groovy

    def show() {
        def book = Book.get(params.id)   // Ctrl+Click en Book → Book.groovy
        book.title                        // Ctrl+Click en title → línea exacta
        bookService.findRelated(book)     // Ctrl+Click en findRelated → método exacto
        render(view: "show")              // Ctrl+Click en "show" → show.gsp
    }
}

🏗️ Vista de Proyecto (panel lateral)

Un panel dedicado en la barra de actividad muestra solo las carpetas relevantes de tu proyecto Grails, similar a IntelliJ IDEA:

GRAILS PROJECT
└── grails-app
    ├── controllers
    ├── domain
    ├── services
    ├── views
    ├── conf
    ├── i18n
    └── taglib
├── src/main/groovy
├── src/main/resources
├── test
└── web-app

Se actualiza automáticamente al crear o eliminar archivos.

⚡ Integración con Grails CLI

Comandos disponibles desde Ctrl+Shift+P (Cmd+Shift+P en Mac) o como botones en el panel:

Comando	Descripción
`Grails: Run App`	`grails run-app`
`Grails: Run App (Debug)`	`grails run-app --debug-jvm`
`Grails: Stop App`	`grails stop-app`
`Grails: Run Tests`	`grails test-app`
`Grails: Clean`	`grails clean`
`Grails: Create Controller`	Pide nombre, ejecuta `grails create-controller`
`Grails: Create Domain Class`	Pide nombre, ejecuta `grails create-domain-class`
`Grails: Create Service`	Pide nombre, ejecuta `grails create-service`
`Grails: Generate All`	Scaffold completo con `grails generate-all`

Todos los comandos reusan el mismo terminal "Grails" en lugar de abrir uno nuevo cada vez.

Compatibilidad

Grails	Spring Boot	Groovy	Java	Estado
2.x	—	2.x	7+	✅ Soportado
3.x	1.x	2.x	8+	✅ Soportado
4.x	2.x	2.x	8+	✅ Soportado
5.x	2.6+	3.x	11+	✅ Soportado
6.x	3.x	4.x	17+	✅ Soportado
7+	3.2+	4.x	17+	✅ Soportado

Detección automática de versión desde gradle.properties, build.gradle, build.gradle.kts y application.properties.

Requisitos

VS Code 1.80.0 o superior
Un proyecto que contenga la carpeta grails-app/
Node.js (incluido con VS Code)

Instalación

Desde VS Code Marketplace

Abre VS Code
Ve a Extensiones (Ctrl+Shift+X / Cmd+Shift+X)
Busca "Grails Support for VS Code"
Haz clic en Instalar

Desde VSIX

code --install-extension grails-extension-vscode-0.3.1.vsix

Uso

La extensión se activa automáticamente al abrir cualquier carpeta que contenga grails-app/. El indexado del proyecto ocurre al iniciar y se actualiza automáticamente cuando guardas archivos .groovy.

Para ver los logs del servidor LSP: Ver → Output → Grails Language Server

Reportar Problemas

Si encuentras algún bug o tienes sugerencias:

Abrir un Issue en GitHub
Incluye la versión de Grails de tu proyecto
Adjunta los logs del servidor (Ver → Output → Grails Language Server)
Indica tu sistema operativo (Linux / Mac / Windows)

Contribuir

¡Las contribuciones son bienvenidas! Lee CONTRIBUTING.md o abre un PR directamente.

Fork el proyecto
Crea tu rama (git checkout -b feature/MiMejora)
Commit tus cambios (git commit -m 'feat: descripción')
Push (git push origin feature/MiMejora)
Abre un Pull Request

Al contribuir aceptas que tu código se distribuye bajo la misma licencia del proyecto (GPL v3 + restricción no comercial).

Licencia

GPL v3 con restricción de uso no comercial — ver LICENSE para los términos completos.

En resumen: puedes usar, modificar y distribuir libremente este software, pero no puedes cobrar por él ni por ningún trabajo derivado.

Grails Support For VS Code

Johan Mixtega Cisneros