Início Rápido

As informações que seguem tornam simples iniciar um projeto Grails. Também está disponível um screencast com os passos para criar uma pequena aplicação.

• Início Rápido
• Crie um projeto Grails
• Configure uma Fonte de Dados (Opcional)
• Crie uma Classe de Domínio
• Crie um controlador
• Iniciando o Grails
• O que vem depois

Crie um projeto Grails

Uma vez instalado o Grails, você poderá utilizar uma função interna para criar novos projetos:

grails create-app

A função irá solicitar o nome do seu projeto e então irá criar a estrutura do projeto como exibido abaixo:

%PROJECT_HOME%
    + grails-app
       + conf                 ---> local dos artefatos de configuração, 
                                   como fontes de dados
           + hibernate             ---> opcional; configurações hibernate
           + spring                ---> opcional; configurações spring
       + controllers          ---> local dos artefatos de controladores
       + domain               ---> local das classes de domínio
       + i18n                 ---> local dos pacotes de mensagens i18n
       + services             ---> local dos serviços
       + taglib               ---> local das tag libraries
       + util                 ---> local das classes utilitárias 
                                   especiais (ex., codecs, etc.)
       + views                ---> local das visões
           + layouts              ---> local dos layouts
   + lib
   + scripts                  ---> scripts
   + src
       + groovy               ---> opcional; local para arquivos fonte em 
                                   Groovy (para tipos outros que não 
                                   estão em grails-app/*)
       + java                 ---> opcional; local para arquivos fontes
                                   em Java
   + test                     ---> classes de testes geradas
   + web-app
       + WEB-INF

Configure uma Fonte de Dados (Opcional)

A função "create-app", criou um artefato de fonte de dados do Grails para você no diretório "<..>/grails-app/conf", ele é chamado DataSource.groovy e possuí closures para cada um dos ambientes padrão: Development, TestData e Production (respectivamente: Desenvolvimento, Teste de Dados e Produção). Todos os exemplos que seguem funcionam no ambiente _development_. Para maiores informações sobre ambientes, veja configuração.

Por padrão, cada fonte de dados é configurada com um banco em memória chamado HSQLDB (ótimo para testes, mas provavelmente não muito útil para ambientes reais), portanto este passo é opcional:

dataSource {
  pooled = false
  driverClassName = "org.hsqldb.jdbcDriver"
  username = "sa"
  password = ""
}
// configuraçõs específicas do ambiente
environments {
  development {
    dataSource {
      dbCreate = "create-drop" // one of 'create', 'create-drop','update'
      url = "jdbc:hsqldb:mem:devDB"
    }
  }
  test {
    dataSource {
      dbCreate = "update"
      url = "jdbc:hsqldb:mem:testDb"
    }
  }
  production {
    dataSource {
      dbCreate = "update"
      url = "jdbc:hsqldb:file:prodDb;shutdown=true"
    }
  }
}

Criando uma Classe de Domínio

Tenha certeza que você está no diretório raiz do seu projeto (por exemplo "meu-projeto") digitando

cd meu-projeto
grails create-domain-class

A função irá solicitar que você informe o nome da classe de domínio. Uma classe de domínio é um artefato persistente, e por padrão, todas as suas propriedades são persistidas no banco de dados (Vá para a seção GORM (Grails Object Relational Mapping) para mais informações):

class Livro {
    String titulo
    String autor
}

Neste ponto você pode querer criar alguns dados de teste. Uma forma fácil de fazer isso é criando e salvando os objetos de domínio na closure "init" da classe bootstrap da aplicação Grails, localizada em "<..>/grails-app/conf/BootStrap.groovy" (Obs.: na versão 0.5.6, e talves em outras, parece que este arquivo foi alterado para ApplicationBootStrap.groovy, com a declaração da classe também alterada para "class ApplicationBootStrap"):

class BootStrap {
    def init = { servletContext ->
        // Cria alguns dados de teste
        new Livro(autor:"Stephen King",titulo:"The Shining").save()
        new Livro(autor:"James Patterson",titulo:"Along Came a Spider")
            .save()
    }
    def destroy = {
    }
}

Crie um controlador

Os controladores são centrais para as aplicações em Grails, eles tratam as requisições web e URLs do mapa de requisição para uma classe de controlador em uma closure junto à classe.

Execute o comando "grails create-controller" e digite o nome do controlador. Em nosso exemplo digitamos "Livro", o que gerou um controlador chamado {grails-app/controllers/LivroController.groovy}. Abra este controlador e altere-o como mostrado a seguir para que seja utilizado o Scaffolding dinâmico, o qual irá gerar dinamicamento sua aplicação em tempo de execução:

class LivroController {
     def scaffold = Livro
}

Nota: Você deverá remover ou comentar o trecho "def index = { } " do arquivo gerado para que o scaffolding funcione.

Alternativamente, você pode utilizar o comando "grails generate-all", o qual irá criar todo o scaffolding ("modelo") para você, e deixará o controlador gerado em paz, ao invés de sobreescrevê-lo com o scaffolding padrão. Isto pode ser valioso no aprendizado.

Iniciando o Grails

Para iniciar sua aplicação com Grails, execute o seguinte comando:

grails run-app

http://localhost:8080/meu-projeto/livro/list

http://localhost:8080/meu-projeto/livro

O que vem depois

• Veja Armazenando Projetos no SVN para saber como armazenar sua nova aplicação Grails dentro do controle de fontes.
• Configure sua aplicação Grails em sua IDE
• Navegue nos variados plugins Grails e instale algum como o webtest para criar testes funcionais através do canoo webtest.