Caso não tenha o NetBeans 6.0 IDE, vá para a página de download do NetBeans IDE 6.0 e baixe uma versão do IDE que contenha o suporte a Ruby.
Caso você tenha uma instalação do NetBeans IDE 6.0 que não inclua o suporte a Ruby, complete as etapas a seguir para adicionar o suporte a Ruby ao IDE.
Se a sua rede usar um proxy, escolha Ferramentas > Opções do menu principal, selecione o botão de opção Configurações manuais do proxy na caixa de diálogo Opções, digite a porta e o proxy HTTP do seu proxy e clique em OK.
No menu principal, escolha Ferramentas > Plug-ins.
Na caixa de diálogo Plug-ins, clique na aba Plug-ins disponíveis e role até a categoria Ruby, conforme mostrado abaixo.
Figura 1: Gerenciador de plug-ins
Selecione a caixa de verificação Ruby e Rails para obter suporte a Ruby no NetBeans IDE.
(Opcional) Selecione a caixa de verificação Distribuição JRuby e Rails para baixar e instalar o software JRuby e a estrutura Ruby on Rails.
Observação: você deve ter o software Ruby ou JRuby instalado no sistema para usar a distribuição Ruby e Rails. Caso você não tenha este software, deverá instalar este plug-in ou baixar e instalar o software JRuby ou Ruby antes de trabalhar com projetos Ruby no IDE.
(Opcional) Selecione um ou mais dos seguintes plug-ins:
Temas de cores adicionais para Ruby. Fornece temas de cores do editor adicionais para os tipos de arquivo Ruby.
Depot de amostra. Uma aplicação JRuby on Rails de amostra.
Dicas adicionais Ruby. Fornece dicas de código adicionais para Ruby, como a detecção de conflitos de nome de variável local e a detecção de nomes de variáveis que não seguem as convenções de codificação Ruby.
Suporte a Ruby RSpec. Fornece suporte IDE para a estrutura RSpec.
Clique em Instalar.
O instalador do NetBeans IDE é exibido.
No instalador do IDE NetBeans, clique em Avançar.
Leia o contrato de licença, selecione o botão de opção Aceito os termos de todos os contratos de licença e clique em Instalar.
Depois que a instalação estiver concluída, selecione Reiniciar o IDE agora ou Reiniciar o IDE mais tarde e clique em Terminar.
Configurando o IDE para usar sua própria instalação do Ruby (Opcional)
Na primeira vez que um projeto Ruby é aberto ou criado no IDE, o IDE verifica se há outras instalações do Ruby além do software JRuby fornecido. Caso haja, o IDE exibe uma caixa de diálogo solicitando que você selecione qual software deseja usar.
Se você decidir instalar o software Ruby posteriormente, poderá concluir as seguintes etapas para configurar o IDE para usar a instalação do Ruby.
No IDE, escolha Ferramentas > Opções do menu principal.
Clique em Ruby e, se necessário, clique na aba Plataforma.
Se você ainda não tiver aberto ou criado um projeto Ruby, na primeira vez que você acessar a aba Plataforma, o IDE exibirá a caixa de diálogo Escolher intérprete Ruby. A caixa de diálogo mostra uma lista das instalações Ruby disponíveis, conforme mostrado na figura a seguir. Se a caixa de diálogo não for exibida, passe para a Etapa 5.
Figura 2: Caixa de diálogo Escolher intérprete Ruby
Selecione o intérprete Ruby que deseja usar. Caso não veja o seu intérprete Ruby na lista, clique em Outro.
Clique em Fechar.
Se você escolheu Outro na Etapa 3, ou se a caixa de diálogo Escolher intérprete Ruby não foi exibida, clique no botão Procurar conforme mostrado na figura a seguir.
Navegue para a localização do binário Ruby e clique em Abrir.
Figura 3: Janela Opções de Ruby
Observação: você também pode acessar a janela Opções de Ruby clicando no botão Alterar na etapa 2 do assistente para Novo projeto.
Clique em OK para fechar a caixa de diálogo Opções.
Gems são bibliotecas Ruby de terceiros. O IDE fornece um gerenciador de gems Ruby para adicionar e manter gems. Abra o gerenciador de gems Ruby escolhendo Ferramentas > Gems Ruby no menu principal. O gerenciador contém as duas abas seguintes:
Atualizadas. Lista quais gems intaladas possuem uma nova versão disponível.
Instaladas. Exibe uma lista das gems que foram instaladas na plataforma Ruby registrada. Consulte a seção anterior para obter informações sobre como registrar a plataforma Ruby. Se você estiver usando a plataforma JRuby e o IDE incluir o plug-in Distribuição JRuby e Rails, a lista conterá a gem ActiveRecord-JDBC e a estrutura Rails, conforme mostrado na figura a seguir.
Novas Gems. Lista as gems que podem ser adicionadas à plataforma Ruby.
Configurações. Utilize esta aba para configurar o proxy.
Instalar Aba Gerenciador
Observação. A página wiki do RubyGems fornece informações sobre como habilitar o gerenciador de Gems Ruby para gerenciar um repositório nativo de gems Ruby.
Você pode acessar bancos de dados de uma aplicação JRuby on Rails de uma das seguintes maneiras.
Adaptador MySQL. O adaptador MySQL está incluído no JRuby. Use este adaptador como faria com uma aplicação Ruby on Rails nativa.
Adaptador JDBC. Conforme mencionado anteriormente, o plug-in Distribuição JRuby e Rails inclui a gem ActiveRecord-JDBC, que permite que a aplicação JRuby on Rails acesse servidores de bancos de dados que fornecem drivers compatíveis com JDBC 3.0, como MySQL, PostgreSQL, Oracle, HSQLDB, e Java DB (também conhecido como Derby).
O driver JDBC deve ser um driver Java puro. No momento desta escrita, o ActiveRecord-JDBC não funciona com o driver Sqlite JDBC.
Observação: para usar uma conexão JDB, você deve obter um
driver de cliente JDBC 3.0 para seu servidor de banco de dados, e colocar
uma cópia do driver JDBC na pasta JRuby/lib. Dependendo da sua instalação, esta pasta pode ficar em um destes locais:
netbeans-install-dir/ruby1/jruby-1.0.2/lib
netbeans-user-dir/jruby-1.0.2/JRuby/lib
Observação: os drivers MySQL e PostgreSQL JDBC estão incluídos no IDE. Se a instalação incluir o servidor da aplicação GlassFish, o driver Java DB também estará disponível. Para localizar os drivers, expanda Bancos de dados > Drivers na janela Serviços.
Clique com o botão direito do mouse no nó do driver e escolha Personalizar. Uma caixa de diálogo é aberta, mostrando a localização do arquivo do driver.
Para usar o adaptador JDBC em um projeto Ruby on Rails, selecione a caixa de verificação Acessar banco de dados usando JDBC quando criar o projeto, conforme mostrado na figura a seguir.
Figura 5: Selecionando o acesso a banco de dados com JDBC
Quando esta caixa de verificação é selecionada, o IDE coloca as seguintes instruções no arquivo environment.rb.
Exemplo de código 1: Configuração do ambiente JDBC
if RUBY_PLATFORM =~ /java/
require 'rubygems'
gem 'ActiveRecord-JDBC'
require 'jdbc_adapter'
end
Quando o adaptador JDBC for usado para acessar um banco de dados, defina as configurações do banco de dados no database.yml assim como você faria se estivesse usando o adaptador Rails desse banco de dados, conforme mostrado no exemplo de código a seguir.
Exemplo de código 2: Exemplo de configuração do banco de dados JDBC
adaptador: mysql
banco de dados: my_development_database
nome de usuário: fred
senha: secret
host: localhost
Quando você cria um projeto Ruby on Rails, o IDE adiciona as configurações ao database.yml para o servidor de banco de dados selecionado na Etapa 2 do assistente, conforme mostrado na Figura 5. Se estiver usando um servidor de banco de dados que não esteja na lista suspensa, você poderá editar a configuração do banco de dados no arquivo database.yml depois de criar o projeto.
Observação: se o arquivo do host do sistema operacional não tiver localhost, use 127.0.0.1. Observe também que com alguns sistemas, a configuração do banco de dados deve ser em letras minúsculas.
Adicionando bancos de dados
Vários tutoriais do NetBeans requerem que você crie um banco de dados para as tabelas de dados usadas pelo tutorial. As etapas para a adição de um banco de dados são diferentes para cada servidor de banco de dados. As instruções a seguir são para bancos de dados MySQL e Java DB.
Adicionando bancos de dados MySQL
Caso ainda não tenha sido iniciado, inicie o servidor de banco de dados MySQL.
(Opcional) Use as seguintes etapas para criar um usuário.
No prompt de comando, digite o seguinte comando.
mysql -uusuário-p
Omita o -p se o usuário não tiver uma senha.
Do contrário, quando solicitado, digite a senha. O usuário deve ter privilégios criar usuário globais ou o privilégio inserir para o banco de dados mysql, como o usuário raiz.
Use uma sintaxe similar ao exemplo a seguir para criar um usuário.
CREATE USER 'fred'@'localhost'
identified by 'secret';
(Opcional) Use uma sintaxe similar à seguinte para especificar privilégios de acesso. Neste exemplo, o usuário possui todos os privilégios em todos os bancos de dados do servidor de banco de dados localhost.
GRANT ALL PRIVILEGES ON *.* TO 'fred'@'localhost';
Digite quit e pressione Enter para sair.
Para criar um banco de dados, use uma sintaxe similar à seguinte em um prompt de comando.
mysqladmin -u fred -p create mydb_development
Omita o -p se o usuário não tiver uma senha.
Do contrário, quando solicitado, digite a senha. Se você não tiver criado usuários, poderá usar raiz como nome de usuário.
Para obter mais informações sobre como criar usuários e bancos de dados MySQL, consulte o Guia de referência do MySQL.
Adicionando bancos de dados Java DB (Derby)
Se você tiver instalado uma versão do IDE que inclua o servidor de aplicação GlassFish, o IDE está configurado para acessar o banco de dados Java DB fornecido com GlassFish.
É possível usar as etapas a seguir para adicionar um banco de dados Java DB do IDE.
Do menu principal do IDE, escolha Ferramentas > Banco de dados Java DB > Criar banco de dados.
Na caixa de diálogo Criar banco de dados Java DB, digite o nome do banco de dados, o nome do usuário e uma senha opcional, conforme mostrado no exemplo a seguir.
Figura 6: Caixa de diálogo Criar Banco de dados Java DB
(Opcional) Para especificar uma localização diferente para o banco de dados, clique em Configurações e, em seguida, clique no botão Procurar para a localização do banco de dados, navegue para a pasta na qual deseja que o banco de dados fique e clique em Abrir. Clique em OK para fechar a caixa de diálogo Configurações de Java DB.
Clique em OK.
O IDE cria o banco de dados e adiciona um nó na seção Banco de dados na janela Serviços, conforme mostrado na figura a seguir.
Figura 7: Nó Banco de dados na janela Serviços
Registrando bancos de dados com o IDE
Não é necessário registrar seu servidor de banco de dados com o IDE para usá-lo a partir do seu projeto Ruby. No entanto, se for registrado, é possível criar e visualizar tabelas e comandos SQL de exercício a partir do IDE.
Registrando servidores de banco de dados com o IDE
Primeiro, você deve registrar o servidor do banco de dados com o IDE. O IDE foi testado com os seguintes drivers:
Java DB 10.3.1.4
MySQL Connector/J 5.0.7
PostgreSQL 8.2 compilação 506
Oracle 10.2.0.3
MySQL, PostgreSQL e, opcionalmente, Java DB já são registrados com o IDE.
As etapas a seguir mostram como registrar outros servidores de banco de dados com o IDE.
Caso ainda não tenha, obtenha um driver compatível com JDBC 3.0 para o servidor de banco de dados.
Na próxima etapa, especifique o caminho para este driver.
O IDE usa o driver JDBC para acessar o esquema do banco de dados e para consultar os bancos de dados. Se o driver do banco de dados não for totalmente compatível com o JDBC 3.0, você pode ter problemas ao usar as ferramentas de banco de dados do IDE.
Na janela Serviços, clique com o botão direito do mouse no nó Servidores e escolha Adicionar servidor no menu pop-up.
A caixa de diálogo Novo driver JDBC será exibida.
Clique em Adicionar e navegue para o arquivo jar do driver, selecione-o e clique em Abrir.
A caixa de diálogo Novo driver JDBC exibe as configurações do driver selecionado.
Clique em OK para fechar a caixa de diálogo Novo driver JDBC.
O IDE adiciona um nó para o servidor do banco de dados no nó Drivers.
Estabelecendo uma conexão com uma instância de banco de dados
As etapas a seguir mostram como criar uma conexão do IDE com uma instância de banco de dados, como o banco de dados de exemplo mydb_development descrito na seção anterior.
Na janela Serviços, clique com o botão direito do mouse no nó Bancos de dados e escolha Nova conexão.
A caixa de diálogo Nova conexão de banco de dados se abre.
Selecione o driver da lista suspensa Nome, como MySQL (Conector/driver J).
Usando o padrão mostrado na caixa de texto URL do banco de dados como guia, digite a URL do banco de dados na caixa de texto.
Por exemplo, digite jdbc:mysql://localhost:3306/mydb_development.
Forneça o nome do usuário e forneça a senha, se necessário, conforme mostrado na figura a seguir.
Figura 8: Nova conexão de banco de dados
Clique em OK.
Quando a conexão estiver estabelecida, clique em OK para descartar a caixa de diálogo.
O IDE adiciona um nó para o novo grupo no nó Grupos. O emblema do nó mostra que a conexão está aberta. Quando você iniciar o IDE na próxima vez, o emblema estará rompido para indicar que a conexão está encerrada.
Para reconectar, clique com o botão direito do mouse no nó e escolha Conectar, forneça a senha se necessário e clique em OK.
Implantando uma aplicação JRuby no Glassfish
Por padrão, as aplicações JRuby são executadas no navegador WEBrick. Se você quiser implantar uma aplicação JRuby no servidor da aplicação GlassFish, poderá empacotar a aplicação e suas dependências em um arquivo WAR (web archive). Em seguida, você pode tornar o arquivo WAR disponível para o servidor da aplicação, conforme mostrado nas etapas a seguir.
A aplicação implantada usará o banco de dados de produção. Abra o arquivo database.yml para garantir que a configuração de produção esteja definida corretamente.
Ao criar a aplicação JRuby, você recebe a opção de adicionar destinos Rake para oferecer suporte ao deployment do servidor da aplicação, conforme mostrado na figura a seguir. Se você pretende implantar no GlassFish,
deve marcar esta caixa de verificação.
Figura 9: Opção para fornecer destinos Rake WAR
Se você tiver um projeto JRuby existente que não ofereça este destino Rake, conclua as etapas a seguir para adicionar o plug-in Goldspike ao projeto. Este plug-in adiciona tarefas de Rake que permitem que você crie arquivos WAR.
Na janela Projetos, clique com o botão direito do mouse no nó e escolha Gerar código no menu pop-up.
Na caixa de diálogo Plug-ins Rails, clique na aba Novos plug-ins.
Caso você não veja uma entrada para Goldspike, conclua as etapas a seguir para registrar o repositório que fornece o plug-in Goldspike.
Clique na aba Cabeçalhos.
Clique em Adicionar URL.
Na caixa de diálogo Adicionar URL do repositório, digite http://jruby-extras.rubyforge.org/svn/trunk/rails-integration/plugins e clique em OK.
Depois que o repositório for adicionado, clique em Fechar.
Clique na aba Novos plug-ins. Agora você deve ver uma entrada para o Goldspike.
Selecione a entrada para Goldspike e clique em Instalar.
Clique em OK para iniciar a instalação.
Feche as caixas de diálogo Instalação e Plug-ins Rails.
Clique com o botão direito do mouse no nó do projeto e escolha Executar tarefa Rake > Atualizar lista do menu pop-up.
Para empacotar a sua aplicação em um arquivo WAR, clique com o botão direito do mouse no nó do projeto e escolha Executar tarefa Rake > War > Independente > Criar.
O IDE cria o arquivo WAR e o coloca na pasta superior do projeto.
Se você estiver usando o adaptador JDBC, coloque uma cópia do driver JDBC do servidor do banco de dados em glassfish-install-dir/lib
e inicie (ou reinicie) o servidor GlassFish.
No momento desta escrita, você deve usar o adaptador JDBC a menos que esteja se conectando a um banco de dados MySQL.
Coloque uma cópia do arquivo WAR recém-criado na pasta autodeploy do GlassFish. Por exemplo, copie pasta de projetos/MyRubyApp/MyRubyApp.war
para glassfish-install-dir/domains/domain1/autodeploy.
Em um navegador, vá para a URL da aplicação, por exemplo,
http://localhost:8080/MyRubyApp.
Para obter suporte e se manter informado sobre as alterações mais recentes nos recursos de desenvolvimento do NetBeans Ruby, participe das listas de usuários e .
