horas vagas. Ou não. by T!

No primeiro post (aqui) de Ruby on Rails, instalamos o Ruby e o Rails. Agora, vamos à diversão.

Para criar o projeto, é só digitar o comando

rails <nome_do_projeto>

Vamos utilizar um exemplo, pra ficar mais claro. Vou fazer um relatório de uso dos PCs aqui no Laboratório da UFPE. Neste post, vou fazer o cadastro de alunos. Instalei o LAMP (Apache+PHP+MySQL no Linux. Aqui tem um tutorial) para usar o MySQL e o phpMyAdmin.

Criando o Banco de Dados

CREATE DATABASE `relatorio`;

Por enquanto, só vamos utilizar a tabela ‘aluno’, então vou criar só ela agora:

CREATE TABLE `alunos` (
    `id` smallint NOT NULL AUTO_INCREMENT,
    `CPF` BIGINT NOT NULL ,
    `Nome` VARCHAR( 50 ) NOT NULL ,
    `Curso` ENUM( 'adm', 'des', 'eco', 'eng', 'ped', 'upe' ) NOT NULL ,
    PRIMARY KEY ( `id` ),
    UNIQUE KEY `CPF_key` ( `CPF` )
) ENGINE = MYISAM ;

OBS: toda tabela deve ter uma chave primária de nome ‘id’, no MySQL o mais fácil é criar isto como ‘numeric auto_increment’.

Criando o projeto:

Vamos chamar o projeto de ‘relatório’. Assim, o código de criação ficaria:

rails relatorio

O rails vai criar uma pasta chamada relatório. Entre na pasta e digite:

script/server

que vai iniciar o servidor WEBrick, embutido no rails. Agora, já podemos digitar no navegador preferido (Firefox) o endereço http://localhost:3000. (sem o ponto =p). Se tudo deu certo, vai aparecer uma página com a mensagem “Welcome Aboard”, dando boas vindas. Note que tem um “link” que informa sobre o ambiente da aplicação. Aqui, estou usando ruby 1.8.6 (linux-i486), Gems 0.9.4 e rails 1.2.4.

Logo abaixo dessas informações, tem uma seção “Getting Started”, que vamos seguir agora.

1. Criar o banco de dados e editar o arquivo config/database.yml:
Já criamos o BD, então é só editar o arquivo. Com o editor de texto de sua preferência (vim), editar a seção development. Fica mais ou menos assim:

development:
   adapter: mysql
   database: relatorio
   username: root
   password:
   socket: /var/run/mysqld/mysqld.sock

2. Gerar os modelos e controladores:
É só utilizar o script generate, na pasta script. São duas linhas de comandos:

script/generate model aluno
script/generate controller aluno

Agora já estão gerados o modelo e o controlador de aluno. Vamos, então, adicionar uma linha no arquivo app/controllers/category_controller.rb, para gerar o scaffold (é esse negócio que vai gerar um CRUD (Create, Refresh, Update, Delete) padronizado – Documentação). O arquivo vai ficar assim:

class AlunoController < ApplicationController
        scaffold :aluno
end

A partir daqui, já é possível acessar o cadastro de alunos a partir do navegador, no endereço http://localhost:3000/aluno (eu precisei reiniciar o servidor WEBrick antes).

Por enquanto é só. Num post futuro, vamos customizar um pouco o cadastro de aluno.

Referências:
urubatan.com.br
API do Ruby on Rails

O que é Ruby?

De acordo com o site oficial, Ruby é “uma linguagem de programação dinâmica, open-source com foco em simplicidade e produtividade. Tem uma sintaxe elegante que é natural de ler e fácil de escrever” (tradução livre). Resumindo: é fácil, rápida para desenvolver, poderosa, flexível e que está em pleno crescimento no mundo do desenvolvimento web. Foi criada por Yukihiro Matsumoto e divulgada em 1995. O início do boom se deu com a criação do Rails, um framework para desenvolvimento web em Ruby.

No site http://tryruby.hobix.com tem um tutorial básico e um interpretador online, para quem quiser conhecer a linguagem antes de instalar no PC.

Instalando o Ruby

O processo de instalação é bem simples:

• No Linux (fiz no Ubuntu 7.10 aqui do Lab): Depois de habilitar o repositório Universe, é só rodar o seguinte comando:

  sudo apt-get install ruby irb rdoc

• No rWindows:
  1. Baixar o OneClick Installer aqui.
  2. Instalar normalmente.

Agora, as gemas

O Gems é o sistema de pacotes do Ruby. É mais ou menos como o apt-get do Debian. Através dele, pode-se instalar as bibliotecas restantes no Ruby. O processo é “muito complicado” =P

1. Baixar o arquivo compactado da versão mais recente neste site.
2. Descompactar.
3. Na linha de comando, entrar na pasta e digitar, como root:

   ruby setup.rb

4. Pronto. Agora podemos utilizar o gems para instalar o rails.

Instalando o Rails

O Rails é um framework OpenSource para o desenvolvimento de aplicações web, com bancos de dados, em Ruby. Para instalá-lo, devemos executar a complicada sequência de passos (Um, pra ser mais preciso):

1. Digite o comando:

   gem install rails --include-dependencies

Nota: Existe um pacote chamado InstantRails, para Windows (clique aqui para baixar), que contém o Ruby, Rails, Apache e MySQL pré-configurados. É baseado no EasyPHP e funciona mais ou menos da mesma forma.

Referências:
urubatan.com.br
ruby-br.org (Ruby Brasil)
ruby-lang.org (Site oficial)
instantrails.rubyforge.org (InstantRails)
rubyforge.org
docs.rubygems.org (Documentação do Ruby Gems)
rubyonrails.org (Ruby on Rails)