O RestfulX é um framework que se propõe, basicamente, a trazer para o Flex a abstração que o Rails faz da camada de dados. Ele possui um conjunto de geradores de código que facilitam o trabalho de programação ao automatizar tarefas repetitivas, como criar Value Objects (VOs) e tratar a comunicação com o backend para realizar operações de manipulação do banco de dados – criar, recuperar, atualizar e apagar registros, operações conhecidas sob o acrônimo CRUD (Create, Retrieve, Update e Delete).

Toda a geração de código é baseada no Rails, mas você não é obrigado a utilizar o Rails como backend. Você também pode armazenar seus dados no Google App Engine (GAE), ou até gerar uma aplicação em AIR que acesse dados em uma base SQLite, dispensando conexão com a internet ou a instalação de um webserver / SGBD na máquina local.

A versão mais recente, enquanto escrevo este artigo, é a 1.2.2. Para instalá-la, certifique-se que você já tem o Ruby e o Rails instalados corretamente e execute o seguinte comando (os exemplos foram criados para a plataforma Windows, mas são válidos para qualquer plataforma):

gem install restfulx

Com o RestfulX instalado, crie sua aplicação Rails:

rails -d mysql minha_app

Neste exemplo, estou criando uma aplicação chamada minha_app, configurada para usar o mysql como SGBD (sem a opção -d mysql, o rails configura a aplicação para usar o sqlite, o que pode ser facilmente modificado através do arquivo config/database.yml).

Agora, edite o arquivo config/environment.rb e adicione a seguinte linha de código:

config.gem "restfulx"

Com isso, sua aplicação está pronta para usar o framework.

Agora é necessário criar os arquivos de configuração e fazer o download da biblioteca do RestfulX que será usada no Flex (atualmente, restfulx-1.2.2.swc). O comando a seguir é responsável por essa tarefa:

ruby script\generate rx_config

Crie, dentro do diretório db, o arquivo model.yml. Este arquivo está para o RestfulX assim como as migrations estão para o Rails. É baseado neste arquivo (model.yml) que o RestfulX vai criar as migrations para que nossa aplicação funcione. Dentro deste arquivo, coloque o seguinte conteúdo (exemplo obtido do site do framework):

project:
- name: string
- notes: text
- start_date: date
- end_date: date
- completed: boolean
- belongs_to: [user]
- has_many: [tasks]

location:
- name: string
- notes: text
- belongs_to: [user]
- has_many: [tasks]

task:
- name: string
- notes: text
- start_time: datetime
- end_time: datetime
- completed: boolean
- next_action: boolean
- belongs_to: [project, location, user]

note:
- content: text
- belongs_to: [user]

user:
- login: string
- first_name: string
- last_name: string
- email: string
- has_many: [tasks, projects, locations]
- has_one: [note]

Com o arquivo salvo, execute os seguintes comandos:

ruby script\generate rx_yaml_scaffold
rake db:refresh
rake db:flex:build

O primeiro comando cria as migrations, baseando-se no arquivo model.yml, e cria os VOs e as telas para executar as operações de CRUD em cada modelo. O segundo comando atualiza o banco de dados, executando as migrations criadas no comando anterior. O terceiro comando compila a nossa aplicação Flex, e deixa ela pronta para uso através do servidor da nossa aplicação. Para ver toda essa “mágica” funcionando inicie o servidor (com ruby script\server) e acesse http://localhost:3000/ no seu browser. Você verá o scaffold da sua aplicação funcionando, manipulando dados no banco. Agora você pode utilizar as facilidades do framework para manipular seus dados como se estivesse no Rails, mas isso é assunto para o próximo artigo.