Если среда NetBeans 6.1 IDE в системе еще не установлена, перейдите на страницу NetBeans IDE 6.1 Download Page и установите версию IDE, предусматривающую поддержку Ruby. Если используемая версия среды IDE NetBeans 6.1 не содержит поддержку Ruby, выполните следующие действия для ее добавления.
Если в сети имеется прокси, выберите в главном меню "Tools > Options", установите переключатель "Manual Proxy Settings", заполните поля "HTTP Proxy" и "Port" для прокси-сервера и нажмите кнопку "OK".
Выберите "Tools > Plugins" в главном меню.
В диалоговом окне "Plugins" щелкните вкладку "Available Plugins" и перейдите к категории Ruby, как показано ниже.
Для добавления поддержки Ruby в среду IDE NetBeans установите флажок "Ruby and Rails".
(Дополнительно) Установите флажок "JRuby and Rails Distribution" для загрузки и установки программного обеспечения JRuby и архитектуры Ruby on Rails.
Примечание: Для использования дистрибутива Ruby или JRuby в системе должно быть установлено программное обеспечение Ruby или JRuby. Если оно не установлено, перед работой с проектами Ruby в IDE следует установить этот подключаемый модуль или загрузить и установить программное обеспечение JRuby или Ruby.
(Дополнительно) Выберите один или несколько следующих подключаемых модулей:
Extra Ruby Color Themes. Дополнительные цветовые схемы редактора для типов файлов Ruby.
Ruby Extra Hints. Предоставляет подсказки при написании кода Ruby, которые были разработаны после последнего выпуска среды IDE
GlassFish V3 JRuby Integration. Позволяет устанавливать в среде IDE экземпляры GlassFish V3 и настраивать экземпляр как текущий сервер в проекте Ruby on Rails.
Нажмите кнопку "Install".
Появится экран программы NetBeans IDE Installer.
В NetBeans IDE Installer нажмите кнопку "Next".
Прочтите лицензионное соглашение, затем установите переключатель "I Accept the Terms in All License Agreements" и нажмите кнопку "Install".
После завершения установки выберите "Restart IDE Now" (немедленный перезапуск) или "Restart IDE Later" (отложенный перезапуск) и нажмите кнопку "Finish".
Настройка IDE для использования собственной среды Ruby (дополнительно)
При первой установке модулем Ruby and Rails регистрируются любые установки Ruby, обнаруженные в системе. Для добавления дополнительных установок Ruby and Rails выполните следующие действия.
В среде IDE выберите "Tools > Ruby Platforms" в главном меню.
Появится диспетчер платформ Ruby, показанный на следующем рисунке.
Выполните одно из следующих действий для добавления дополнительных платформ Ruby или JRuby.
Нажмите кнопку "Autodetect Platforms" для автоматического обнаружения и добавления платформ, установленных в системе.
Для добавления определенной платформы нажмите кнопку "Add Platform", затем перейдите к двоичному файлу Ruby, выберите его и нажмите кнопку "Open".
Для закрытия диалогового окна "Options" нажмите кнопку "OK".
Библиотеки Gem (также называемые "гемами") – это библиотеки Ruby, созданные сторонними разработчиками. В среде IDE предусмотрен диспетчер "Ruby Gems" для добавления библиотек Gem и управления ими. Для вызова диспетчера "Ruby Gems" выберите "Tools > Ruby Gems" в главном меню. Появится экран со следующими вкладками:
Updated. Список установленных на платформе библиотек Gem, для которых доступны более новые версии.
Installed. Список библиотек Gem, установленных для выбранной платформы Ruby. Для получения дополнительных сведений о регистрации платформ Ruby в среде IDE см. предыдущий раздел. При использовании поставляемой платформы JRuby в случае, если в среде IDE имеется JRuby и подключаемый модуль Rails Distribution, этот список содержит библиотеку ActiveRecord-JDBC Adapter и архитектуру Rails (см. рисунок ниже).
New Gems. Список библиотек Gem, которые могут быть добавлены к выбранной платформе Ruby.
Settings. Эта вкладка предназначена для настройки прокси.
Примечание: Указания по настройке диспетчера "Ruby Gems" для управления собственным хранилищем библиотек Gem Ruby приведены на вики-странице RubyGems.
Приложение на JRuby on Rails может обращаться к базам данных одним из двух способов.
Адаптер MySQL. В JRuby имеется адаптер MySQL. Этот адаптер используется так же, как и в стандартном приложении на Ruby on Rails.
Адаптер JDBC. Как было указано выше, JRuby и подключаемый модуль Rails Distribution содержат библиотеку Gem ActiveRecord-JDBC Adapter, которая позволяет приложению на JRuby on Rails обращаться к серверам базы данных посредством драйверов, совместимых с JDBC 3.0, например, MySQL, PostgreSQL, Oracle, HSQLDB и Java DB (Derby). Драйвер JDBC должен быть "чистым" драйвером Java. На момент написания этой статьи библиотека ActiveRecord-JDBC Adapter не поддерживала драйвер SQLite JDBC.
Для использования адаптера JDBC в проекте Ruby on Rails установите флажок "Access Database Using JDBC" в действии "Database Configuration" при создании проекта, как показано на следующем рисунке.
При использовании серверов базы данных MySQL или PostgreSQL поставляемый драйвер автоматически добавляется в путь к классам JRuby. При использовании других серверов базы данных драйвер автоматически добавляется в путь к классам JRuby при условии регистрации сервера базы данных в среде IDE. В противном случае следует получить драйвер JDBC 3.0 для сервера базы данных и добавить драйвер в путь к классам JRuby. Для добавления драйвера в путь к классам щелкните правой кнопкой мыши узел проекта, выберите "Properties" в контекстном меню, затем выберите категорию "Java" и нажмите кнопку "Add JAR/Folder".
Примечание: Сервер базы данных Java DB автоматически регистрируется в среде IDE в случаях, если сервер GlassFish зарегистрирован или если среда IDE настроена для использования Java SE Development Kit (JDK) 6.0 от Sun Microsystems, Inc.
При создании проекта Ruby on Rails к файлу database.yml автоматически добавляются параметры настройки для сервера базы данных, выбранного на экране мастера "Database Configuration". В случае использования сервера базы данных, который отсутствует в раскрывающемся списке, можно изменить настройки БД в файле database.yml после создания проекта.
Примечание: Если файл узла операционной системы не содержит запись localhost, измените в настройке параметр узла на 127.0.0.1. Если при обращении к базе данных из команд Rake или команд переноса базы данных возникают ошибки, попробуйте изменить настройку узла для их исправления. Для вступления изменения в силу следует перезапустить сервер. Также необходимо отметить, что некоторые системы требуют указания параметра базы данных в нижнем регистре.
Примечание: Пункт меню "Run Rake Task > db > create" может быть использован только при работе с адаптерами MySQL, PostgreSQL, SQLite и SQLite3. Для создания базы данных при использовании других адаптеров сервера базы данных, включая адаптер JDBC, следует выполнить одно из следующих действий:
В окне ввода команд создайте базу данных вручную с помощью команд, соответствующих серверу базы данных. Например, используйте для создания базы данных MySQL команду, аналогичную следующей:
mysqladmin -u fred -p create mydb_development
Для соответствующей настройки нажмите кнопку "Create DB" на панели "Database Configuration" мастера создания проекта.
В окне "Services" разверните узел "Databases", щелкните правой кнопкой мыши узел серверов баз данных и выберите "Create Database" в контекстном меню.
Развертывание приложения на JRuby в GlassFish
Приложения на JRuby по умолчанию выполняются в обозревателе WEBrick. При необходимости развертывания приложения на JRuby на сервере приложений GlassFish это приложение и связанные с ним файлы можно упаковать в веб-архив WAR. После этого следует обеспечить доступность этого файла для сервера приложений (см. указания ниже).
Развертываемое приложение использует продуктивную базу данных. Откройте файл database.yml и убедитесь, что установлены правильные настройки продуктивной базы данных.
При создании приложения на JRuby можно выбрать вариант добавления функций Rake для поддержки развертывания сервера приложений (см. рисунок ниже). Этот флажок необходимо установить для развертывания на сервере GlassFish.
Если функции Rake в существующем проекте JRuby отсутствуют, выполните следующие действия для добавления к проекту подключаемого модуля "goldspike". Этот модуль добавляет задачи Rake, позволяющие создать файлы WAR.
В окне "Projects" щелкните правой кнопкой мыши узел проекта и выберите "Rails Plugins" в появившемся меню, как показано на следующем рисунке.
В диалоговом окне "Rails Plugins" щелкните вкладку "New Plugins".
Если элемент "goldspike" отсутствует, выполните следующие действия для регистрации хранилища, предоставляющего модуль "goldspike".
Щелкните вкладку "Repositories".
Нажмите кнопку "Add URL".
В диалоговом окне "Add Repository URL" введите http://jruby-extras.rubyforge.org/svn/trunk/rails-integration/plugins и нажмите кнопку "OK".
После добавления хранилища нажмите кнопку "Close".
Щелкните вкладку "New Plugins".
Теперь в списке должна появиться запись "goldspike".
Выберите запись "goldspike", как показано на следующем рисунке, и нажмите кнопку "Install".
Для запуска процесса установки нажмите кнопку "OK".
После успешного завершения установки закройте диалоговые окна "Installation" и "Rails Plugins".
Щелкните правой кнопкой мыши узел проекта "rubyweblog" и выберите "Run Rake Task > Refresh List" в контекстном меню, как показано ниже. Этот вариант выбора вызывает автоматическое распознавание новых функций Rake war, добавленных к проекту посредством подключаемого модуля Goldspike.
Для сохранения приложения в файле WAR щелкните правой кнопкой мыши узел проекта и выберите "Run Rake Task > War > Standalone > Create".
Среда IDE создает файл WAR и помещает его в папку верхнего уровня проекта.
Поместите копию созданного файла WAR в папку автоматической установки GlassFish. Например, скопируйте projects-folder/MyRubyApp/MyRubyApp.war в glassfish-install-dir/domains/domain1/autodeploy.
В обозревателе перейдите к URL-адресу приложения, например, http://localhost:8080/MyRubyApp.
Примечание: При установке подключаемого модуля GlassFish V3 JRuby Integration можно выполнить регистрацию экземпляра GlassFish V3 в среде IDE и настройку экземпляра как текущего сервера в проекте Rails. Затем для запуска приложения в GlassFish V3 следует нажать кнопку "Run Main Project". Обратите внимание, что все приложения развертываются на уровне root ("/"), что может вызвать проблемы при развертывании более одного приложения "Rails". Этот подключаемый модуль находится на экспериментальной стадии разработки.
Что дальше?
Для получения информации о быстром создании приложения на Ruby on Rails в среде IDE ознакомьтесь с руководством Создание блога Ruby за 10 минут.
Для получения поддержки и информации о последних изменениях в функциях разработки Ruby в среде NetBeans см. рассылки и .
