lunes, 10 de marzo de 2014

Grails, API REST: Hola mundo




Bienvenido, en este tutorial aprenderás los primeros pasos para crear una API REST con Grails.

Introducción a Grails 

Te recomiendo visitar el sitio oficial de Grails (http://grails.org). Grails es un framework para crear aplicaciones web en muy poco tiempo, todo lo que hagamos en grails, está escrito en Groovy - lenguaje de programación -, groovy es muy fácil de aprender, tiene una sintaxis muy similar a la de Java. En éste tutorial veremos como toda nuestra aplicación web está desarrollada en groovy. Grails compila su código a través de JVM (Java Virtual Machines), por lo tanto, es necesario tener instalado el JDK de Java. 

¿Qué es REST?

REST.- Es una técnica propuesta para utilizar el protocolo HTTP y crear servicios web. Te recomiendo visitar está web, para conocer más acerca de REST http://asiermarques.com/2013/conceptos-sobre-apis-rest/


Instalando Grails

Para instalar Grails es necesario bajar los binarios, los cuales encontrarás aquí: http://grails.org/download

UNIX(OSX)/LINUX:
  1. Ubicar el directorio donde descomprimiste los binarios de grails.
  2. Abrir la terminal y escribir el siguiente comando:  export GRAILS_HOME=/ruta/grails
  3. Agregar grails las variables de entorno así: PATH="$PATH:$GRAILS_HOME/bin"
Windows
  1. Ubicar el directorio donde descomprimiste los binarios de grails.
  2. Abrir Mi equipo > Propiedades > Configuración avanzada > Variables de entorno
  3. Editamos la variable "PATH" y ponemos la ruta: ";C:/ruta/grails/bin"
Creando proyecto

Una vez instalado correctamente, vamos a la consola ó terminal y ejecutamos el comando 

grails create-app miapp

Nos movemos a la carpeta donde se creó la aplicación y si todo salió bien podemos correr nuestra primera aplicación con el comando


run-app

Abrimos http://localhost:8080/miapp en nuestro navegador y debe aparecer algo como esto:





Editamos el archivo "HelloController.groovy" que está en miapp/grails-app/controllers/miapp