O que é Andaime em Ruby on Rails?

Você pode estar aprendendo Rails & você leu que você tem que criar um “andaime” para começar sua aplicação Rails…

Easy!

Você pode fazer isso usando o comando rails g scaffold.

Mas o que é andaime?

“Andaime é uma estrutura temporária usada para apoiar uma equipe de trabalho na construção, manutenção e reparo de edifícios, pontes e todas as outras estruturas feitas pelo homem”. – Wikipedia

Translated into Rails:

Um andaime é um conjunto de arquivos gerados automaticamente que forma a estrutura básica de um projeto Rails.

Estes arquivos incluem:

• Um controlador
• Um modelo
• Visualizações para cada ação padrão do controlador (index, edit, show, new)

Uma nova rota.

E uma migração para preparar seu banco de dados.

Vejamos um exemplo!

Como usar o Comando Andaime Rails

Um exemplo de andaime para um site sobre livros ficaria assim.

rails g scaffold books

Você deve ver muito texto rolando por, que detalha os arquivos que estão sendo criados.

Este exemplo cria:

• A BooksController
• A Book modelo
• Um novo resources :books rota adicionada ao seu config/routes.rb ficheiro
• Um conjunto de ficheiros relacionados com os testes
• Ver ficheiros em app/views/books (cinco no total)

Sim.

Isso é muita coisa.

Se você quiser desfazer este andaime, logo após criá-lo, você pode usar o seguinte comando.

rails d scaffold books

Onde “d” significa “destruir”.

Cuidado que isto irá APAGAR os ficheiros criados pelo processo de andaime.

Agora:

Antes de poder usar o seu código de andaime você tem que executar as suas migrações para actualizar o esquema da sua base de dados.

Utilize o comando rails db:migrate.

Se nenhuma mensagem de erro aparecer, você está pronto! Você tem uma estrutura básica para sua nova aplicação Rails, ou para uma nova funcionalidade que precisa de um novo modelo, visualizações & controlador correspondente.

>

Next:

Executar rails server.

Abra o navegador para localhost:3000/books & você deve ser capaz de ver os resultados!

Rails Scaffolding With Extra Fields

Por defeito…

O seu modelo só recebe campos de timestamp, o que significa que a única informação que pode gravar sobre os seus livros (ou qualquer modelo com que esteja a trabalhar) é o momento em que foram criados, ou actualizados.

Aí está como criar um andaime com campos extra:

rails g scaffold books title:string author:string publication_year:integer

Se você gerar seu andaime assim, você terá 3 campos para trabalhar.

Um título, um autor, e um ano de publicação.

Isso é um pouco mais interessante do que ter apenas os timestamps do banco de dados.

Btw.

Esta mesma sintaxe que usamos para criar migrações com rails g migration.

Gerar Componentes Específicos

Scaffolding cria coisas que você pode não precisar ou querer agora.

But Rails é legal.

Você pode criar componentes individuais, como controladores, usando o comando rails g (g para gerar).

Exemplos:

• rails g controller Fruit
• rails g model Fruit name:string color:string (cria modelo + migração)
• rails g migration CreateBook title:string year:integer (cria apenas migração)

Um dos grandes benefícios de usar um comando scaffolding é que todos os arquivos são criados usando as convenções de nomes corretas, o que evita mensagens de erro estranhas. Também lhe poupa o trabalho de ter de criar manualmente estes ficheiros.

Btw…

É considerada uma boa prática apagar ficheiros gerados automaticamente que não planeia utilizar. Então depois de usar um gerador como “g controller”, revise a lista de arquivos criados & remove aqueles que você não precisa.

Sumário

Você aprendeu sobre andaimes em Ruby para que você possa rapidamente iniciar uma nova aplicação Rails para praticar.

Como você aprender mais você pode querer largar andaimes.

Mas você ainda pode gerar controladores individuais, modelos, ou visualizar arquivos quando você precisar deles.

Obrigado pela leitura! 🙂