Como criar um CRUD completo com Rails

O Rails � um framework completo que possui diversos componentes que permitem que qualquer desenvolvedor Ruby crie qualquer tipo de aplica��o voltada para a web. Entre os componentes que o Rails oferece est� o ActionPack que ajuda o desenvolvedor a gerar p�ginas interativas, um servidor de aplica��o (web server) para exibir essas p�ginas, uma base de dados SQLite3, uma biblioteca para mapeamento objeto-relacional, ferramentas de script que ajudam a gerenciar a aplica��o, al�m de diversas outras features para webservices, frameworks de teste, entre outros.

Uma diferencia��o interessante de ser enfatizada � que enquanto o Ruby � uma linguagem de programa��o, o Rails � uma cole��o de scripts codificados em Ruby. Assim, o servidor de aplica��o, o framework ActionPack e diversas outras ferramentas escritas com Ruby s�o todos scripts Ruby e assim parte do Rails.

Para trabalhar com Rails deve-se baixar primeiramente o Ruby atrav�s do seu site (vide se��o Links).

Ap�s baixar o Ruby � poss�vel instalar o Rails e as suas depend�ncias utilizando o RubyGems na linha de comando do promt conforme o comando a seguir:

gem install rails

Se for necess�rio � preciso navegar at� a basta bin do Ruby (cd c:\Ruby22\bin) e depois executar o comando apesentado. Ap�s executar o comando gem tem-se como resultado no prompt a sa�da a seguir:


  C:\Users\higorzm>cd c:\Ruby22\bin
  c:\Ruby22\bin>gem install rails
  Fetching: thread_safe-0.3.5.gem (100%)
  Successfully installed thread_safe-0.3.5
  Fetching: tzinfo-1.2.2.gem (100%)
  Successfully installed tzinfo-1.2.2
  Fetching: i18n-0.7.0.gem (100%)
  Successfully installed i18n-0.7.0
  Fetching: activesupport-4.2.5.gem (100%)
  Successfully installed activesupport-4.2.5
  Fetching: rails-deprecated_sanitizer-1.0.3.gem (100%)
  Successfully installed rails-deprecated_sanitizer-1.0.3
  Fetching: mini_portile2-2.0.0.gem (100%)
  Successfully installed mini_portile2-2.0.0

Diversos componentes assim como documenta��es completas ser�o instalados. Esse processo pode demorar um bom tempo e o prompt exibir� diversos componentes e documenta��es sendo instalados.

Outra possibilidade � acessar o site do Rails Installer (vide se��o Links) e baixar o pacote completo que traz o Ruby e o Rails no mesmo produto. Assim, a vers�o correta do Ruby j� vem acompanhada da vers�o correta do Rails. Entre os produtos que o pacote do Rails traz tem-se o Ruby 2.1.5, Rails 3.2, Bundler, Git, Sqlite, TinyTDS, Suporte do SQL Server e o DevKit.

Alguns desenvolvedores mais experientes ainda recomendam a instala��o do pacote que traz o Ruby 1.9, por ser mais est�vel. Para baixar o Ruby 1.9 que traz o Rails 3.x basta visitar o endere�o da se��o Links.

Criando uma aplica��o web

Para criar uma aplica��o web com Rails � muito simples: basta abrir o prompt de comando e navegar at� a pasta bin do Ruby e digitar o comando rails seguido pelo nome da aplica��o, conforme mostra o exemplo a seguir:

c:\Ruby22\bin>rails new testewebapp

Caso o rails esteja no classpath n�o � necess�rio navegar at� a pasta bin do Ruby, basta digitar diretamente o comando no prompt. Por�m, se for necess�rio � preciso navegar at� a basta bin do Ruby utilizando o comando cd c:\Ruby22\bin e depois executar o comando apresentado. Ap�s executar o comando do rails tem-se como resultado no prompt a sa�da a seguir:


  c:\Ruby22\bin>rails new C:\appwebexemplo
        create
        create  README.rdoc
        create  Rakefile
        create  config.ru
        create  .gitignore
        create  Gemfile
        create  app
        create  app/assets/javascripts/application.js
        create  app/assets/stylesheets/application.css
        create  app/controllers/application_controller.rb
        create  app/helpers/application_helper.rb
        create  app/views/layouts/application.html.erb
        create  app/assets/images/.keep
        create  app/mailers/.keep
        create  app/models/.keep
        ...

Esses s�o apenas alguns dos diversos outros arquivos e pasta que tamb�m ser�o criados. Basicamente, entre os diret�rios criados tem-se:

O diret�rio app cont�m os controller, models, views e outros artefatos da aplica��o;
O diret�rio config possui as configura��es da aplica��o como regras, roteamentos, base de dados, etc;
O diret�rio db cont�m o esquema da base de dados utilizada pela aplica��o;
O diret�rio doc possui toda a documenta��o da aplica��o;
O diret�rio lib possui os m�dulos utilizados pela aplica��o;
O diret�rio log possui os logs gerados pelo servidor de aplica��o, que s�o excelentes para encontrar erros;
O diret�rio public cont�m os arquivos est�ticos e compilados;
O diret�rio script possui os scripts do rails que inicializam a aplica��o e outros para deploy e execu��o;
O diret�rio test possui os testes de unidade da aplica��o;
O diret�rio tmp possui os arquivos tempor�rios.
O diret�rio vendor possui c�digo de terceiros.

Entre os arquivos temos:

o config.ru, que � utilizado para o servidores baseados em Rack;
os arquivos Gemfile e Gemfile.lock s�o utilizados para especificar as depend�ncias do gem necess�rias pela aplica��o rails;
o arquivo Rakefile localiza e carrega tarefas que podem ser executadas no prompt de comando;
o README.rdoc possui uma instru��o manual para a aplica��o e deve ser editado para comportar as novas tarefas realizadas pela aplica��o.

Com isso a aplica��o web ser� gerada em uma nova pasta chamada "testewebapp". Dessa forma, com apenas um �nico comando j� foi poss�vel gerar todo esqueleto necess�rio para a aplica��o web.

� poss�vel indicar o caminho onde a aplica��o ser� criada: isso � realizado quando se define o nome da aplica��o. Se for especificado o caminho da aplica��o ela ser� criada no diret�rio corrente do prompt.

Tamb�m ser� necess�rio rodar o comando bundle conforme o c�digo a seguir:

C:\> c:\Ruby22\bin\bundle install

A sa�da ser� a mesma presentada na Listagem 1.

Listagem 1. Sa�da do Comando bundle

Fetching gem metadata from https://rubygems.org/............
Fetching version metadata from https://rubygems.org/...
Fetching dependency metadata from https://rubygems.org/..
Resolving dependencies............................................
Using rake 10.4.2
Using i18n 0.7.0
Installing json 1.8.3 with native extensions

Pode-se verificar que � preciso entrar no diret�rio da aplica��o e executar o bundle.

Vale ressaltar que o comando anterior que foi utilizado para criar a aplica��o web pode j� incluir o comando Bundle e assim n�o � necess�rio rod�-lo em separado. Ele ser� automaticamente invocado na cria��o da aplica��o web. No final, uma mensagem ser� recebida, como vemos a seguir:


  Your bundle is complete!
  Use bundle show [gemname] to see where a bundled gem is installed.

Agora que a aplica��o web foi criada j� � poss�vel iniciar o servidor web que vem no pacote do rails. Para isso devemos navegar at� a pasta da aplica��o e executar o comando a seguir:

cd c:\appwebexemplo
  c:\appwebexemplo>rails server

Ap�s isso o servidor come�ar� a carregar a aplica��o conforme o log exibido no prompt de comando:


  c:\appwebexemplo>rails server
  => Booting WEBrick
  => Rails 3.2.21 application starting in development on http://0.0.0.0:3000
  => Call with -d to detach
  => Ctrl-C to shutdown server
  [2015-12-15 20:45:20] INFO  WEBrick 1.3.1
  [2015-12-15 20:45:20] INFO  ruby 1.9.3 (2014-11-13) [i386-mingw32]
  [2015-12-15 20:45:20] INFO  WEBrick::HTTPServer#start: pid=7860 port=3000

Agora j� � poss�vel acessar a aplica��o colocando a URL http://localhost:3000/ no browser. Ap�s isso ser� exibida a p�gina da Figura 1.

Figura 1. Acessando a aplica��o principal atrav�s do browser.

Para editar o HTML da p�gina inicial basta editar o arquivo public/index.html. O diret�rio public cont�m todos os conte�dos est�ticos da aplica��o.

Utilizando o Ruby n�o � necess�rio compilar c�digo como � realizado com Java, pois ele � uma linguagem interpretada, bastando codificar e executar o c�digo.

Tamb�m � poss�vel utilizar outros servidores de aplica��o. O Rails n�o � amarrado em nenhum tipo de servidor, banco de dados ou outros recursos que ele traz por padr�o.

Criando um CRUD utilizando o Rails

Para criar as opera��es CRUD o Rails oferece uma forma simples que � o scaffolding. Este � uma ferramenta do Rails que gera rapidamente todo o c�digo e as p�ginas necess�rias para uma aplica��o CRUD. Por exemplo, quando criamos um CRUD para uma aplica��o de locadora de filmes devemos criar um CRUD para os filmes onde pode-se cadastrar, atualizar, ler e deletar os filmes da locadora. Tamb�m pode-se criar outros CRUDs como para alugar filmes, cadastrar fornecedores, clientes, etc. Dessa forma, o CRUD � essencial para qualquer aplica��o web e exige um certo tempo dos desenvolvedores para criar todas as funcionalidades exigidas. Entre elas necessitamos de uma p�gina para consulta, outra para cadastramento, outra para edi��o e uma �ltima para dele��o. Al�m disso, � preciso criar a tabela do banco de dados que ir� armazenar essas informa��es.

Para utilizar a ferramenta scaffold tem-se o comando scaffold, que permite a sua r�pida utiliza��o. Para utiliz�-lo pode-se utilizar o comando a seguir no prompt de comando:

c:\appwebexemplo>rails generate scaffold appwebexemp nome:string id_seq:string endereco:text preco:decimal email:string

N�o podemos esquecer de estar no diret�rio da aplica��o e a janela anterior que est� executando o servidor de aplica��o n�o deve ser fechada, por isso � preciso abrir um novo prompt para executar o comando apresentado.

Ap�s executar o comando, diversos arquivos ser�o criados conforme mostra o prompt de comando:


invoke  active_record
create    db/migrate/20151215234254_create_appwebexemps.rb
create    app/models/appwebexemp.rb
invoke    test_unit
create      test/unit/appwebexemp_test.rb
create      test/fixtures/appwebexemps.yml
invoke  resource_route
route    resources :appwebexemps
invoke  scaffold_controller
create    app/controllers/appwebexemps_controller.rb
invoke    erb
create      app/views/appwebexemps
create      app/views/appwebexemps/index.html.erb
create      app/views/appwebexemps/edit.html.erb
create      app/views/appwebexemps/show.html.erb
create      app/views/appwebexemps/new.html.erb
create      app/views/appwebexemps/_form.html.erb
invoke    test_unit
create      test/functional/appwebexemps_controller_test.rb
invoke    helper
create      app/helpers/appwebexemps_helper.rb
invoke      test_unit
create        test/unit/helpers/appwebexemps_helper_test.rb
invoke  assets
invoke    coffee
create      app/assets/javascripts/appwebexemps.js.coffee
invoke    scss
create      app/assets/stylesheets/appwebexemps.css.scss
invoke  scss
create    app/assets/stylesheets/scaffolds.css.scss

O c�digo criado pelo scaffold permite que o usu�rio crie, atualize, leia e delete os dados da aplica��o numa base de dados. Pode-se notar que as p�ginas foram todas criadas no diret�rio view. Al�m dessas p�ginas, a ferramenta tamb�m cria em db/migrate um script para criar a base de dados, testes de unidade, p�ginas para realizar o teste de armazenamento de dados, informa��es sobre o roteamento das p�ginas, controller para receber os dados dos formul�rios e arquivos CSS para os estilos da p�gina.

No entanto, ao tentar acessar a aplica��o web atrav�s do endere�o http://localhost:3000/appwebexemps teremos como resultado um erro de conex�o com a base de dados. � importante observar que a URL tem um "s" no final. Para verificar a URL criada basta ir em config e no arquivo routes.

Esse erro ocorreu porque o banco de dados ainda n�o foi criado, assim, ao tentar buscar os dados para exibir ao usu�rio, o Rails n�o achou e exibiu assim uma exce��o na tela.

Outra tarefa bastante facilitadora do Ruby � que quando ele gerou o scaffolding tamb�m gerou um pequeno script chamado migration, que � utilizado justamente para criar a tabela na base de dados que ir� armazenar todos os dados da aplica��o. O migration � um script que criar a estrutura da base de dados.

Para visualizar esse script basta acessar db/migrat e nesse diret�rio est� o arquivo <timestamp>_create_tickets.rb, onde <timestamp> � quando o arquivo foi criado.

Abrindo-o pode-se visualizar o c�digo da Listagem 2.

Listagem 2. C�digo do arquivo _create_tickets

class CreateApliwebs < ActiveRecord::Migration
    
           def change
      
                     create_table : appwebexemps do |t|
        
                              t.string :nome
                              t.string :string    
                              t.string :id_seq
                              t.string :string  
                              t.string :endereco
                              t.string :text     
                              t.string :preco
                              t.string :decimal    
                              t.string :email
                              t.string :string
                              t.timestamps
      
                     end
    
           end
   
  end

Este arquivo migration � um pequeno script em Ruby. Ao inv�s de execut�-lo diretamente, deve-se execut�-lo utilizando outra ferramenta do Rails chamada rake. Assim, basta executar o comando a seguir no prompt:

rake db:migrate

Este comando executa o script e cria a tabela. Se tudo for criado corretamente o prompt exibir� o log a seguir:


  c:\appwebexemplo>rake db:migrate
  ==  CreateAppwebexemps: migrating =============================================
  -- create_table(:appwebexemps)
     -> 0.0060s
  ==  CreateAppwebexemps: migrated (0.0070s) ====================================

O Rails vem com suporte nativo ao SQLite3 (vide se��o Links), que � uma aplica��o de banco de dados bastante leve e muito utilizada para aplica��es que est�o executando em ambiente de desenvolvimento e teste. O rails tamb�m oferece o SQLite quando se cria um novo projeto. O arquivo config/database.yml possui maiores informa��es sobre a configura��o do banco de dados, conforme mostra a Listagem 3.

Listagem 3. Arquivo database


  development:
    adapter: sqlite3
    database: db/development.sqlite3
    pool: 5
    timeout: 5000

No entanto, o rails tamb�m suporta MySQL e PostgreSQL, e possui adaptadores nativos para esses dois bancos de dados. Para utilizar o MySQL em desenvolvimento basta configurar o arquivo config/database.yml conforme mostra a Listagem 4.

Listagem 4. Usando MySQL


  development:
    adapter: mysql2
    encoding: utf8
    database: appwebexemps
    pool: 5
    username: root
    password:
    socket: /tmp/mysql.sock

O username e o password devem ser configurados conforme a instala��o do banco de dados.

Para utilizar o PostgreSQL basta configurar conforme a Listagem 5.

Listagem 5. Usando PostgreSQL


  development:
    adapter: postgresql
    encoding: unicode
    database: appwebexemps
    pool: 5
    username: blog
    password:

Agora basta acessarmos a aplica��o atrav�s do endere�o http://localhost:3000/appwebexemps/, conforme mostra a Figura 2.

Figura 2. Aplica��o web criada realizando a conex�o com a base de dados criada e exibindo os resultados na tela.

Caso ocorra algum erro como "ExecJS::ProgramError in #index ruby", basta ir at� o diret�rio C:\appwebexemplo\app\views\layouts e abrir o arquivo application.html. Pesquise por application e troque por default, pois normalmente tem duas entradas: uma na linha 5 e outra na linha 6.

Agora j� � poss�vel navegar pela aplica��o armazenando, lendo e listando dados, assim como alter�-los e delet�-los.

Para armazenar um dado basta clicar no bot�o �New Appwebexemp� e inserir os dados, conforme mostra a Figura 3.

Figura 3. Inserindo dados na aplica��o web criada.

A tela seguinte mostra os dados cadastrados e permite que o usu�rio realize uma edi��o destes, conforme mostra a Figura 4.

Figura 4. Exibindo os dados e o bot�o Edit para realizar a altera��o.

Clicando em Edit � poss�vel visualizar os dados e alter�-los conforme necess�rio, como mostra a Figura 5.

Figura 5. Editando os dados cadastrados anteriormente pelo usu�rio.

Visitando a p�gina principal pode-se visualizar o dado cadastrado conforme mostra a tabela da p�gina principal (vide Figura 6).

Figura 6. Acessando a tela principal da aplica��o com os dados sendo listados.

Dessa forma, utilizando poucas ferramentas e scripts � poss�vel montar uma aplica��o completa utilizando Ruby e Rails em poucos minutos e com muito pouco c�digo. Neste exemplo n�o foi inserido uma �nica linha de c�digo. Al�m disso, todas essas p�ginas geradas podem ser customizadas inserindo imagens, alterando completamente o layout, modificando JavaScript, inserindo mais c�digo, entre outras funcionalidades, mas isso � assunto para um outro artigo.

At� a pr�xima.

Bibliografia

[1] Jay McGavren. Head First Ruby (O�Reilly, 2015).

[2] Ruby Programming Language
https://www.ruby-lang.org/.

[3] David Griffiths. Head First Rails (O�Reilly, 2015).

[4] Download do Rails
http://rubyonrails.org/download/.

[5] Rails Installer
http://www.railsinstaller.org/pt-BR

[6] Rails 1.9
https://s3.amazonaws.com/railsinstaller/Windows/railsinstaller-2.2.5.exe

[7] SQLite
http://www.sqlite.org/

Confira outros conte�dos:

Programa��o x Concurso P�blico

Osvaldo aprendeu programa��o

DevMedia x Netflix: Onde investir meu...

Assista grátis a nossa aula inaugural

Perguntas frequentes

Quem somos?

Por que a programação se tornou a profissão mais promissora da atualidade?

Como faço para começar a estudar?

Em quanto tempo de estudo vou me tornar um programador?

Sim, você pode se tornar um programador e não precisa ter diploma de curso superior!

O que eu irei aprender estudando pela DevMedia?

Principais diferenciais da DevMedia

Qual o investimento financeiro que preciso fazer para me tornar um programador?

Como funciona a forma de pagamento da DevMedia?

Por Higor Em 2016

Coment�rios nesta publica��o Escrever um coment�rio sobre conte�do

Gabriel Simas

N�vel 0

Higor.

N�o sou desenvolvedor Rails, mas lendo o seu Post sobre CRUD, fiquei bem interessado em aprend�-la. Parabens pelo Post, foi �timo. Continue assim, fique tranquilo, nem Jesus agradou!

Forte Abra�o

há +1 ano

Douglas

N�vel 0

Ol� Lu�s, tudo bem?

Agradecemos o seu elogio ao autor.

Um abra�o.

há +1 ano

Nossos casos de sucesso

Leonardo Carlos

Eu sabia pouqu�ssimas coisas de programa��o antes de come�ar a estudar com voc�s, fui me especializando em v�rias �reas e ferramentas que tinham na plataforma, e com essa bagagem consegui um est�gio logo no in�cio do meu primeiro per�odo na faculdade.

Lucas Rodrigues

Estudo aqui na Dev desde o meio do ano passado! Nesse per�odo a Dev me ajudou a crescer muito aqui no trampo.
Fui o primeiro desenvolvedor contratado pela minha empresa. Hoje eu lidero um time de desenvolvimento!
Minha meta � continuar estudando e praticando para ser um Full-Stack Dev!

Her�clito J�nior

Economizei 3 meses para assinar a plataforma e sendo sincero valeu muito a pena, pois a plataforma � bem intuitiva e muuuuito did�tica a metodologia de ensino. Sinto que estou EVOLUINDO a cada dia. Muito obrigado!

Julio Cablen

Nossa! Plataforma maravilhosa. To amando o curso de desenvolvimento front-end, tinha coisas que eu ainda n�o tinha visto. A did�tica � do jeito que qualquer pessoa consegue aprender. S�rio, to apaixonado, adorando demais.

Joelberth Sena

Adquiri o curso de voc�s e logo percebi que s�o os melhores do Brasil. � um passo a passo incr�vel. S� n�o aprende quem n�o quer. Foi o melhor investimento da minha vida!

Felipe Nunes

Foi um dos melhores investimentos que j� fiz na vida e tenho aprendido bastante com a plataforma. Voc�s est�o fazendo parte da minha jornada nesse mundo da programa��o, irei assinar meu contrato como programador gra�as a plataforma.

Wanderson Oliveira

Comprei a assinatura tem uma semana, aprendi mais do que 4 meses estudando outros cursos. Exerc�cios pr�ticos que n�o tem como n�o aprender, est�o de parab�ns!

Jos� Lucas

Obrigado DevMedia, nunca presenciei uma plataforma de ensino t�o presente na vida acad�mica de seus alunos, parab�ns!

Eduardo Dorneles

Aprendi React na plataforma da DevMedia h� cerca de 1 ano e meio... Hoje estou h� 1 ano empregado trabalhando 100% com React!

Adauto Junior

J� fiz alguns cursos na �rea e nenhum � t�o bom quanto o de voc�s. Estou aprendendo muito, muito obrigado por existirem. Est�o de parab�ns... Espero um dia conseguir um emprego na �rea.

Ver todos os casos de sucesso