Caso não tenha o NetBeans 6.1 IDE, instalado, vá para a página de download do NetBeans IDE 6.1 e baixe uma versão do IDE que contenha o suporte a Ruby.
Caso você tenha uma instalação do NetBeans IDE 6.1 que não inclua o suporte a Ruby, complete as etapas a seguir para adicionar o suporte a Ruby ao IDE.
Se sua rede usa um proxy, selecione Ferramentas > Opções no menu principal, selecione Configurações manuais do proxy, digite o Proxy HTTP e a porta do proxy e clique em OK.
Selecione Ferramentas > Plug-ins no menu principal.
Na caixa de diálogo Plug-ins, clique na aba Plug-ins disponíveis e role até a categoria Ruby, como mostrado a seguir.
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
Dicas extras do Ruby. Fornece dicas de código para Ruby que foram desenvolvidas após a última versão do IDE
Integração do GlassFish V3 e do JRuby. Permite que você instale instâncias do Glassfish V3 no IDE, e configure uma instância como o servidor atual em um projeto Ruby on Rails Project
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)
Quando instalado pela primeira vez, o módulo do Ruby and Rails registra quaisquer instalações do Ruby que ele detecte em seu sistema. Para adicionar instalações extras do Ruby ou JRuby, conclua as etapas seguintes.
No IDE, escolha Ferramentas > Plataformas Ruby menu principal.
O gerenciador da Plataforma Ruby aparece, como mostrado na figura seguinte.
Realize uma das etapas seguintes para adicionar plataformas Ruby ou JRuby extras.
Clique em Autodetectar plataformas para fazer o IDE detectar e adicionar automaticamente as plataformas que você instalou no sistema.
Clique em Adicionar plataforma para adicionar uma plataforma específica, em seguida, navegue para e selecione o binário do Ruby, e clique em Abrir.
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 instaladas possuem uma versão mais recente disponível.
Instaladas. Exibe uma lista das gems que foram instaladas na plataforma Ruby selecionada. Consulte a seção anterior para obter informações sobre o registro das plataformas Ruby com o IDE. Se você estiver usando a plataforma JRuby incluída e o IDE tiver o plug-in Distribuição JRuby e Rails, a lista conterá a gem ActiveRecord-JDBC Adapter e o framework 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.
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 Adapter, que permite que o aplicativo 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. Enquanto este artigo está sendo escrito, o ActiveRecord-JDBC Adapter não funciona com o driver Sqlite JDBC.
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.
Se você estiver usando o servidor de banco de dados MySQL ou PostgreSQL, o IDE adicionará automaticamente o driver incluído ao classpath do JRuby. Para os outros servidores de banco de dados, o IDE adiciona automaticamente o driver ao classpath do JRuby, se você tiver registrado o servidor do banco de dados no IDE. Caso contrário, você deve obter um driver JDBC 3.0 para seu servidor de banco de dados e adicionar o driver ao classpath do JRuby. Para adicionar o driver ao classpath, clique com o botão direito do mouse no nó do projeto, escolha Propriedades no menu pop-up, selecione a categoria Java e clique em Adicionar JAR/pasta.
Observação: Se o servidor GlassFish estiver registrado, ou se o IDE estiver configurado para usar Sun Microsystems, Inc. Java SE Development Kit (JDK) 6.0, o IDE registra automaticamente o servidor de banco de dados Java DB no IDE.
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 Configuração do banco de dados do assistente. 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 de host do seu sistema operacional não contiver localhost, altere a definição do host na configuração para 127.0.0.1. Se ocorrerem erros quando você acessar o banco de dados por meio de comandos Rake ou comandos de migração de banco de dados, tente alterar a configuração do host para corrigir o problema. Você deve reiniciar o servidor para que a alteração tenha efeito. Observe também que com alguns sistemas, a configuração do banco de dados deve ser em letras minúsculas.
Observação: O menu de opção Executar tarefa do Rake > db > criar funciona somente para adaptadores MySQL, PostgreSQL, SQLite e SQLite3. Para outros adaptadores do servidor de banco de dados, incluindo o adaptador JDBC, use uma das etapas seguintes para criar o banco de dados:
Crie manualmente o banco de dados a partir de uma janela de comando usando comandos que sejam apropriados para o servidor de banco de dados. Por exemplo, você usaria um comando semelhante ao seguinte para criar um banco de dados MySQL .
mysqladmin -u fred -p create mydb_development
Clique no botão Criar DB da configuração apropriada no painel Configuração do banco de dados do assistente para Novo projeto.
Na janela Serviços, expanda Bancos de dados, em seguida, clique com o botão direito do mouse no nó dos servidores de banco de dados e escolha Criar banco de dados no menu pop-up.
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.
O aplicativo implantado 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 o aplicativo 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.
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ó do projeto e escolha Plug-ins do Rails no menu pop-up, como mostrado na figura a seguir.
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, como mostrado a seguir.
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 de goldspike, como mostrado na figura a seguir e clique em Instalar.
Clique em OK para iniciar a instalação.
Quando a instalação for bem sucedida, feche as caixas de diálogo Instalação e Plug-ins do Rails.
Clique com o botão direito do mouse no nó do projeto rubyweblog e escolha Executar tarefa do Rake > Atualizar lista no menu pop-up, como mostrado a seguir. Essa opção força o IDE a reconhecer os novos destinos do rake war que o plug-in Goldspike adicionou ao projeto.
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.
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.
Observação: Se você instalar o plug-in Integração do GlassFish V3 e do JRuby, será possível registrar uma instância do Glassfish V3 com o IDE, e configurar a instância como o servidor atual em um projeto do Rails. Em seguida, você pode usar o botão Executar projeto principal para executar o aplicativo na instância do GlassFish V3. Observe que todas as aplicações são implantadas no nível root ("/"), o que pode causar problemas se você estiver implantando mais de um aplicativo do Rails. Esse plug-in está nos estágios experimentais de desenvolvimento.
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 .
