Dicas rápidas de RADRails III - Aba Generators

Continuando a série de dicas sobre o RADRails, a abordagem agora é sobre a aba Generators. Esta opção serve para gerar um “esqueleto” selecionando o modo create ou apagar os arquivos criados selecionando o modo destroy pelo Rails.

No campo Generator, as possibilidades de seleção são:

controller - Cria o controle passado como parâmetro.

integration_test - Cria um teste de integração. O arquivo deve começar com maiúsculas ou underscore (_) e não pode começar com a palavra Test.

mailer - Cria um modelo para formulário de envio de e-mail.

migration - Cria um arquivo para migração de banco de dados.

model - Cria uma classe de modelo que será utilizada para comunicação com o BD.

observer - Cria um modelo e um arquivo para testes. Um observer serve para monitorar a vida de um evento de um modelo sem ter que - para isso - criar a lógica dentro do próprio modelo. Confuso não?

plugin - Serve para criar um plugin que acrescenta funcionalidades a outros projetos.

scaffold - Um dos recursos mais poderosos (porém não completo) do Rails. Cria automaticamente um modelo, controle e visão sobre uma tabela do BD, deixando pronto ao uso. Útil para ganhar produtividade, porém não muito flexível para personalização.

Opções: (entre parênteses a opção em linha de comando)

Pretend (-p ou –pretend) - Executa o script, mas não faz nenhuma mudança. Bom para verificar erros de sintaxe.

Force (-f ou –force) - Sobrepõe arquivos que já tenham sido anteriormente criados.

Skip (-s ou –skip) - Preserva arquivos que já tenham sido anteriormente criados.

Quiet (-q ou –quiet) - Omite a saída dos comandos no console

Backtrace (-t ou –backtrace) - Utilizado para depuração

Use SVN (-c ou –svn) - Modifica os arquivos com o Subversion

Dicas rápidas de RADRails II - Aba Servers

Continuando as dicas sobre RadRails 1.0, vamos discorrer a respeito da guia servers.

A guia exibe uma lista dos servidores que estão em serviço. A alternativa via menu para esta aba é:
Window > Show View > Other…, após abrir a janela Show View, selecione Aptana Standard Views e finalmente Servers.

Normalmente para cada projeto criado, um servidor estará listado. A grade contém os campos:

• Name - Nome do servidor

• Status - Indica se o servidor está parado (stopping) ou rodando (running)

• Description - Descrição do servidor.

• Type - Tipo do servidor

• Host - Endereço IP sob a qual o servidor estará rodando.

• Port - Porta de serviço

Para editar os parâmetros de um servidor, dê um duplo clique sobre a opção. O servidor deverá ser parado (stopping) antes de ser alterado. E o que pode ser alterado? Esta opção varia de acordo com o servidor. No caso de um servidor Rails, são apresentados os seguintes parâmetros:

• O nome do servidor;

• O seu tipo quando o servidor instalado assim permitir, exemplo Rails permite: WEBRick, Mongrel ou LighTPD;

• O endereço IP do host;

• A porta;

• E o ambiente (Desenvolvimento, Produção ou testes).

A barra de ferramentas possui as demais opções (que também pode ser acessada via botão direito do mouse):

Add Server - Permite adicionar e configurar um novo servidor através da lista de opções exibidas:

• Apache Server - Configura um servidor web Apache.

• Internal Jetty Server - Configura um servidor web baseado em Java.

• Jaxer Server / Package Server - Configura um servidor web capaz de reconhecer instruções AJAX tanto do lado cliente como do lado servidor.

• MySQL Server - Adiciona um servidor de Banco de Dados MySQL

• Rails Server - Um dos servidores do RoR.

• XAMPP Server - Distribuição que contempla um servidor Apache, MySQL, PHP e Pearl em um único pacote.

Start Server - Põe o servidor para rodar (running mode)

Start Server in Debug Mode - Põe o servidor para rodar em modo de depuração de erros.

Restart Server - Aplicado apenas para servidores já iniciados, encerra o serviço e ativa-o novamente.

Pause Server - Interrompe temporariamente o servidor.

Stop Server - Encerra o servidor de modo definitivo.

Open Console Shell - Abre a aba de console contendo informações sobre o atual serviço.

Open Log - Abre os arquivos de registro sobre o andamento do servidor.

View Statistics - Exibe dados relativos a estatística do servidor. As estatísticas não estão disponíveis para todos os tipos de servidor.

Embedded Codes (Códigos Embutidos) em views

Embedded Codes ou Códigos embutidos são instruções, objetos ou qualquer outra coisa que é inserido dentro de um documento. Por exemplo um gráfico Excel inserido dentro de um arquivo do Word.

Os arquivos de visão do RoR, basicamente são compostos por instruções HTML e pedaços de código em Ruby. O que define a parte que contém a expressão Ruby são tags para blocos especiais, conforme a tabela abaixo:

<%= %> É um dos códigos mais comum. Contém expressões em Ruby que serão substituídas pelo resultado na construção do HTML acrescido por uma quebra de linha.

<%= -%> Idêntico ao anterior, porém não acrescenta uma quebra de linha.

<% %> Contém uma expressão em Ruby cujo resultado não gera uma saída em HTML. Acrescenta uma quebra de linha.

<% -%> Idêntico ao anterior, porém sem acrescentar uma quebra de linha.

<%# %> Insere um comentário. O comando será ignorado e não exibido.

Plugin Brazilian Rails

Neste post eu comentei que era mais fácil trabalhar com Rails utilizando a convenção em inglês. Nas andanças da net, achei este plugin que - entre outras coisas - traduz a pluralização do Rails para o português.

Tentei instalá-lo no RADRails, mas obtive falha. Creio que se meu ambiente de desenvolvimento não fosse Windows seria mais fácil. Como necessito trabalhar com este ambiente, minha solução foi ir para o Console e tentar instalar o plugin via prompt. Ocorre que não está muito claro como se faz isso.

No site existe dois exemplos:
O primeiro é para instalação em Rails 2.1 (ainda não lançado - enquanto escrevo este post).
ruby script/plugin install git://github.com/tapajos/brazilian-rails.git

O segundo é para instalação em versões anteriores:
ruby script/plugin install svn://rubyforge.org/var/svn/brazilian-rails

Ambos comandos acima não funcionaram em Windows. Mas consegui a dica correta. No console, vá até o diretório do projeto criado e digite:
ruby script/plugin install http://brazilian-rails.rubyforge.org/svn/

Outra dica importante que não está clara: Para utilizar o plugin, abra o arquivo enviroment.rb que está no subdiretório config da aplicação, e acrescente o comando require ‘inflector_portuguese’ após o bloco Rails::initializer.run END. O código ficará parecido com este:

# Be sure to restart your server when you modify this file
(…)
# Specifies gem version of Rails to use when vendor/rails is not present
RAILS_GEM_VERSION = ‘2.0.2′ unless defined? RAILS_GEM_VERSION
# Bootstrap the Rails environment, frameworks, and default configuration
require File.join(File.dirname(__FILE__), ‘boot’)

Rails::Initializer.run do |config|
# Settings in config/environments/* take precedence over those specified here.
# Application configuration should go into files in config/initializers
(…)
config.action_controller.session = {
:session_key => ‘_App_session’,
:secret => ‘88bc…c62e’
}
# Use the database for sessions instead of the cookie-based default,
(…)
# config.active_record.default_timezone = :utc
end
require ‘inflector_portuguese’

Salve o arquivo. Agora, você já pode criar classes com pluralização em português.

Em futuros artigos, tentarei explorar as outras funcionalidades do Brazilian-Rails.

Dicas rápidas de RADRails I - Novo Projeto

Como dito aqui RADRails é uma excelente IDE de desenvolvimento para RoR (Ruby on Rails). Nesta pequena série de artigos eu vou explicar rapidamente alguns dos comandos básicos desta ferramenta.

Vamos começar a série com os comandos para criar um novo projeto.

Utilize o menu: File > New > Project e abra a pasta Rails. Selecione a opção RailsProject e clique no botão Next.
Atalho: Pressione simultaneamente as teclas ALT+SHIFT+N, depois tecle R.

Na nova tela que abriu, digite o nome do seu projeto no campo Project Name. Você pode definir a localização para armazenamento do projeto ou optar pela localização padrão. Para tanto selecione o campo Use default location. O campo só é editável quando a localização padrão não está selecionada.

No grupo options (opções), mantenha a opção Generate Rails application skeleton habilitada. Habilitado toda a estrutura de pastas e arquivos serão automaticamente criados.

Selecione o tipo database (banco de dados) que você está trabalhando e o Rails version (versão do Rails) para desenvolvimento. Salvo rara exceção, a opção latest é a escolha.

Create a WEBrick server e/ou Mongrel server estas opções servem para ativar a criação do servidor host da aplicação. WEBrick é o servidor padrão que vem junto com o Ruby. É uma boa opção quando em fase de testes e desenvolvimento da aplicação. Já o Mongrel possui maior performance sendo escrito em Ruby e desenvolvido para o Rails. É a melhor opção para produção.
Selecione a opção Automatic start server after project is created para ativar o servidor assim que o projeto for criado. Caso contrário, você terá que iniciar manualmente.
Disable table pluralization desativa a convenção de pluralização dos métodos. Para saber como a pluralização trabalha veja o post sobre este assunto. Clique no botão next para completar a criação do projeto.

Para abrir a perspectiva de desenvolvimento em Rails, selecione no menu:

Window, Open Pespective, Other… selecionando RadRails na janela que foi exibida.

Por hoje é só. No próximo artigo vamos conhecer as guias Servers, Generators, Rake Tasks e Console.

Guias de referência rápida

Fuçando na web me deparei com estas preciosidades:Rails Migrations Cheatsheet 1.2.0 e Form Helpers Cheatsheet 1.2.0. Ambos devidamente impressos e colados estrategicamente ao lado da mesa.

Programar em inglês ou desativar a pluralização?

Em um outro post eu comentei sobre como conhecer bem as convenções do Rails. Bem, este post irá aprofundar um pouco mais no assunto ao abordar as pluralizações.

Pluralização é uma das convenções do Rails para quando você cria por exemplo, um modelo. Por “padrão”, o Rails se encarregará de criar toda a estrutura necessária ao modelo, então o modelo deve ser um nome no singular, a tabela criada estará no plural, o modelo estará no singular, mas com a primeira letra capitalizada (maiúscula), etc.

Esta convenção é de fato uma mão na roda, porém ela só é efetiva quando desenvolvemos usando o inglês. Quando aplicado a gramática portuguesa, ela se torna um problema já que Rails não tem suporte a outras línguas.

A tabela abaixo demonstra a pluralização do modelo carro para todos os métodos gerados pelo Rails:

Método  	Resultado
camelize 	Carro
classify 	Carro
demodulize 	carro
foreign_key 	carro_id
humanize 	Carro
pluralize 	carros
singularize 	carro
tableize 	carros
titleize 	Carro
underscore 	carro

Tudo lindo correto? Errado. Vamos pluralizar agora o modelo injeção:

A primeira coisa é eliminar o cedilha e acentuações o que resulta em injecao:

Método  	Resultado
camelize 	Injecao
classify 	Injecao
demodulize 	injecao
foreign_key 	injecao_id
humanize 	Injecao
pluralize 	injecaos
singularize 	injecao
tableize 	injecaos
titleize 	Injecao
underscore 	injecao

Em vermelho o problema, Rails não reconhece a gramática portuguesa, logo a pluralização não resulta na forma correta injecoes (injeções).

Para verificar como o Rails trabalha com a pluralização visite o: nubyonrails.

Existem maneiras de desativar a pluralização e fazer a programação “na marra”, mas isso gera um custo adicional desnecessário ao desenvolvedor além de quebrar o conceito do framework que é o de focar o desenvolvimento apenas naquilo que é fundamental.

E, traduzindo o modelo, não irá garantir que os campos que são controlados pelo Rails como “id”, “created_at”, “updated_at” entre outros, também serão traduzidos, ou seja, você terá que mantê-los ou novamente, dedicar tempo a esta tarefa.

Por fim, qual dos códigos abaixo é o de mais fácil compreensão?

1: @liner = Liner.find_by_code "001"
2: @liner = Liner.find_by_codigo "001"
3: @armador = Armador.find_by_code "001"
4: @armador = Armador.find_by_codigo "001"

Se você domina o inglês, obviamente irá optar pela primeira opção. Se você é adepto do português irá escolher a opção 4 (depois de desabilitar a pluralização), só que isso implica em ter o seu código funções pseudo-traduzidas pois o “find_by” não é traduzido. Ah! Mas então, para evitar isso, você pode partir para a solução 3, ter todos os campos escritos em inglês, o que não parece lógico já que não existe nenhum grande esforço adicional em também ter o modelo traduzido.

Portanto, a melhor solução é continuar usando a pluralização e traduzir seus campos para o inglês. Quem sabe, com o tempo que você vai ganhar no desenvolvimento, você consegue finalmente se inscrever naquele curso de inglês?

Recomendação de leitura

Nem só de Internet vive o desenvolvedor. Livros são essenciais para complementar os estudos em uma linguagem. Meu atual livro de cabeceira é o Rails Solutions - Ruby on Rails Made Easy de Justin Williams ainda sem tradução para o português. De leitura fácil e com exemplos práticos ele aborda os princípios básicos do RoR, passando pela introdução a linguagem, princípios e fundamentos, instalação em diversas plataformas, recomendação de ferramentas de edição, síntaxe básica, classes e objetos, modelos, migrações, controllers, visões, AJAX, autenticações, plug-ins, processo de controle de transferência para a produção com o Capistrano e finalmente como bônus, a criação e controle testes.

O livro não aborda a última versão do Rails (2). Poucos comandos precisam ser adaptados, mas nada muito complexo. Uma rápida visita ao Google resolve as incompatibilidades.

Conteúdo
Introduction to Ruby on Rails
Installing Rails
Ruby for Rails Developers
Getting Started with Rails
More Advanced Rails
Formatting Data
Introduction to Ajax
Bringing Forms to Life with Ajax
Uploading Files and Sending Attachments
User Authentication and Session Management
Customizing Rails Views
Using Rails Plug-ins and Engines
Deploying with Capistrano

Uma prévia do livro pode ser visto no Google Books.

Maiores infomações, visite o site do Amazon.

Muita atenção nas convenções

Um dos motivos do Rails ser tão produtivo é o fato dele trabalhar com convenções. Com isso, abstrai-se do desenvolvedor a necessidade desta tarefa, ganhando - muito - tempo. Dentre as convenções, uma refere-se a criação dos atributos de um modelo, gerando na migração, os campos nas tabelas. Note esta migração criada por mim:


create_table :liners do |t|
t.column :Codigo, :string, :limit => 3
t.column :Descricao, :string, :limit => 30
t.timestamps
end

add_index(:liners, :Codigo, :unique => true)

Se você já é um veterano de Rails, já deve ter percebido o que está errado. Ok. pare por aqui e pule para o próximo post. Agora, se você é como eu, um novato de pouco mais de 48h na linguagem, continue lendo.

A migração funcionou bem, a tabela foi criada, assim como os campos. O sistema também correspondeu as expectativas até que eu acrescentei a seguinte validação na classe:

validates_uniqueness_of :Codigo

Esta validação evita a criação de registros que contenham o mesmo “código” como valor. Porém, sempre que eu tentava testar o formulário com esta validação habilitada, lá vinha uma mensagem de exceção StatementError de meu Banco de Dados, informando que a coluna codigo não existe.

Como não? Ela (a coluna) está lá! Certo? Outras validações como validates_presence_of :Codigo também está lá na classe e funciona! O que está errado?
A resposta é que não observei a convenção. Os campos no Rails devem estar em totalmente em minúsculas.

Uma rápida alteração no Banco de Dados e em todas as partes da aplicação para codigo e tudo voltou ao normal.

Ainda existe um outro problema nesta minha codificação. O fato dos atributos estarem escritos em português ao invés de inglês, mas isso é um problema para ser discutido em outro momento.

Ou seja, as convenções são uma mão na roda no ganho da produtividade, porém exige do desenvolvedor (principalmente o iniciante) o seu preço: Conhecê-las intimamente.

RadRails

RadRails é uma ferramenta IDE (Integrated Development Enviroment) com base em Eclipse que pode ser customizada para o desenvolvimento de aplicações em Rails. É uma ferramenta complexa, mas que pode facilitar muito o aprendizado, principalmente se você já está familiarizado com o desenvolvimento por IDE.

A ferramenta pode ser baixada em www.radrails.org.