FeaturesPluginsDocs & SupportCommunityPartners

安装和配置 Ruby 支持

创建
2008
年 4 月[修订版:V6.1-1]

本文将介绍如何在NetBeans IDE中下载、安装和配置 Ruby 支持。

目录

此页面上的内容适用于 NetBeans IDE 6.1



下载 Ruby 支持

如果您尚未安装 NetBeans 6.1 IDE,请打开 NetBeans IDE 6.1 下载页面,,然后下载一个含有 Ruby 支持的 IDE 版本。如果已经安装了 NetBeans IDE 6.1,但是 NetBeans IDE 6.1中没有 Ruby 支持,则按照以下步骤将 Ruby 支持添加到该 IDE 中。

  1. 如果您使用代理上网,可在主菜单中选择“工具”>“选项”,并选择“手动代理设置”,输入您的 HTTP 代理服务器的名称和端口号,然后单击“确定”按钮。

  2. 在主菜单中选择“工具”>“插件”。

  3. 在“插件”对话框中,单击“可用插件”选项卡,然后使用滚动栏查看 Ruby 类别(如下图所示)。

    选择 Ruby 插件

  4. 选中“Ruby 和 Rails”复选框,这样就在 NetBeans IDE 中添加了 Ruby 支持。

  5. (可选)选中“JRuby 和 Rails 分发版”复选框,下载并安装 JRuby 软件和 Ruby on Rails 框架。

    注意:您必须在系统上安装 Ruby 或 JRuby 软件才可使用 Ruby 和 Rails 分发版。如果您未安装此软件,则必须安装此插件,或者下载并安装 JRuby 或 Ruby 软件,然后才能在 IDE 中开发 Ruby 项目。

  6. (可选)选中以下一个或多个插件:

    • 其他的 Ruby 颜色主题。Ruby 文件类型提供额外的编辑器颜色主题

    • 其他的 Ruby 提示。为最新版本开发的 Ruby 提供代码提示

    • GlassFish V3 JRuby 集成。支持将 Glassfish V3 实例安装到 IDE 中,并将实例配置为 Ruby on Rails 项目的当前服务器

  7. 单击“安装”按钮。

    此时会出现一个 NetBeans IDE 安装程序。

  8. 在 NetBeans IDE 安装程序中单击“下一步”按钮。

  9. 阅读许可证协议,然后选中“I Accept the Terms in All License Agreements”单选按钮,并单击“下一步”按钮。

  10. 安装完成后,可以选择“立即重启”立即重启 IDE,也可以选择“稍后重启”再单击“完成”按钮。

配置 IDE 使用您自己的 Ruby 安装(可选)

初次安装时,Ruby 和 Rails 模块将注册在系统上检测到的任何 Ruby 安装。要添加额外的 Ruby 或 JRuby 安装,请完成以下步骤。

  1. 在 IDE 中,从主菜单中选择“工具”>“Ruby 平台”。

    此时将出现 Ruby 平台管理器,如下图所示。

    平台管理器

  2. 执行以下操作之一添加额外的 Ruby 或 JRuby 平台。

    • 单击“自动检测平台”按钮,使 IDE 自动检测并添加已安装在系统上的平台。

    • 单击“添加平台”按钮添加特定平台,然后找到并选择“Ruby Binary”,单击“打开”按钮。

  3. 单击“确定”按钮关闭“选项”对话框。

有关如何获取Ruby软件的更多信息,请访问 www.ruby-lang.orginstantrails.rubyforge.orglocomotive.raaum.org

管理 Gem

Gem 是第三方 Ruby 库。IDE 提供了 Ruby Gems 管理器,可以用来添加和维护 gem。要打开该管理器,可在主菜单中选择“工具”>“Ruby Gems”。管理器包含以下选项卡:

  • 已更新。列出安装在平台中的 gems 的可用的新版本。

  • 已安装。显示已安装在选定 Ruby 平台中的 gems 列表。阅读前一部分,了解如何在 IDE 中注册 Ruby 平台。如果您使用绑定的 Jruby 平台,并且 IDE 随带 JRuby 和 Rails 分发版插件,则该列表中应含有 ActiveRecord JDBC Adapter gem 和 Rails 框架,如下图所示。

  • Gems列出可添加到选定 Ruby 平台的 gems。

  • 设置。使用此选项卡配置代理。

 Ruby Gems 管理器中的已安装选项卡

注意:RubyGems wiki page 提供了如何启用 Ruby Gems 管理器管理本地 Ruby gem 存储库的信息 。

有关 Ruby Gems 的更多信息,请访问 www.ruby-lang.org/en/libraries/。有关 Rails 的更多信息,请访问 rubyonrails.org。有关 ActiveRecord JDBC Adapter gem 的更多信息,请访问 jruby-extras.rubyforge.org/activerecord-jdbc-adapter/

通过 JRuby 使用数据库服务器

可以使用以下两种方法通过 JRuby on Rails 应用程序访问数据库。

  • MySQL AdapterMySQL adapter 包含在 Jruby 中。该 MySQL adapter 的使用就像本地 Ruby on Rails 应用程序一样简单。

  • JDBC Adapter。如前所述,JRuby 和 Rails Distribution 插件包括 ActiveRecord-JDBC gem,Rails 应用上的 Ruby 通过 ActiveRecord-JDBC gem 可以访问提供 JDBC 3.0 兼容驱动程序的数据库服务器,如 MySQL、PostgresSQL、Oracle、HSQLDB 和 Java DB(也称为 Derby)。该 JDBC 驱动程序必须是纯 Java 驱动程序。在笔者撰写本文的时候,ActiveRecord-JDBC 是不能使用 Sqlite JDBC 驱动程序工作的。

    要在 Ruby on Rails 项目中使用 JDBC adapter,可在创建该项目时选择 “使用 JDBC 访问数据库”复选框,如下图所示。

    如果您使用 MySQL 或 PostgreSQL 数据库服务器,并且已经在 IDE 中注册了数据库服务器,则 IDE 会自动将驱动程序添加到 JRuby 的类路径中。否则,您必须获取数据库服务器的 JDBC 3.0 驱动程序,并将它添加到 JRuby 类路径中。要将驱动程序添加到类路径,右键单击项目节点,从弹出菜单中选择“属性”,选择“Java”类型,然后单击“添加 JAR/文件夹”。

    注意:如果已经注册了 GlassFish 服务器,或者已经配置 IDE 使用 Sun Microsystems, Inc. Java SE Development Kit (JDK) 6.0,则 IDE 会自动注册 Java DB 数据库服务器。

    选择 JDBC 数据库访问

在 Rails 项目上创建 Ruby 时,IDE 会将该配置添加到数据库服务器的 database.yml 文件中,该数据库服务器是在向导的数据库配置步骤中选择的。如果您正在使用的数据库服务器没有在下拉列表中显示,在创建完该项目后可以在database.yml文件中编辑数据库配置。

注意:如果您操作系统的 host 文件中没有 localhost ,可使用 127.0.0.1 代替。如果通过 Rake 命令或数据库迁移命令访问数据库时出错,请尝试更改 host 配置以修复问题。您必须重启服务器,使更改生效。也应注意在某些系统中,应使用小写字母进行数据库设置。

注意“运行 Rake 任务”>“db”>“创建”菜单选项只适用于 MySQL、PostgreSQL、SQLite 和 SQLite3 适配器。对于其他数据库服务器适配器,包括 JDBC 适配器,可使用以下步骤之一创建数据库:

  • 在命令窗口中使用适当的命令手动创建数据库。举例来说,您可以使用类似于以下的命令创建一个 MySQL 数据库。

    mysqladmin -u fred -p create mydb_development
  • 在“新建项目”向导的“数据库配置”面板中,单击“创建 DB”按钮。

  • 在“服务”窗口中,展开“数据库”节点,然后单击数据库服务器节点并从主菜单中选择“创建数据库”。

将 JRuby 应用程序部署到 GlassFish 应用服务器

默认情况下,JRuby 应用程序将在 WEBrick 浏览器中运行。如是要将 JRuby 应用程序部署到 GlassFish 应用服务器,可以将应用程序和它的依赖关系打包为 Web archive (WAR) 文件,然后再将这个 WAR 文件提供给应用服务器(可按以下步骤操作)。

  1. 部署的应用将使用生产数据库。打开 database.yml 文件,确保产品数据库的配置正确无误。

  2. 在创建 JRuby 应用程序的时候,会显示一个“添加 Rake 目标以支持应用服务器部署”选项(如下图所示)。如果打算在 GlassFish 中进行部署,应该选中该复选框。

    提供 WAR Rake 目标的选项

    如果您现有的 JRuby 项目没有提供 Rake 目标。完全可以按照以下步骤将 Goldspike 插件添加到该项目中。该插件添加的 Rake 任务可以创建 WAR 文件。

    1. 在“项目”窗口中,右键单击该项目的节点,然后在弹出的菜单中选择“Rails 插件”,如下图所示。

      从菜单中选择 Rails 插件

    2. 在“Rails 插件”对话框中,单击“新建插件”选项卡。

    3. 如果未看到 goldspike 条目,完成以下步骤注册提供 goldspike 插件的存储库。

      1. 单击“存储库”选项卡。

      2. 单击“添加 URL”。

      3. 在“添加存储库 URL”对话框中,键入 http://jruby-extras.rubyforge.org/svn/trunk/rails-integration/plugins 并单击“确定”按钮,如下图所示。

        在添加存储库 URL 对话框中键入 URL

      4. 添加存储库之后,单击“关闭”按钮。

      5. 单击“新建插件”选项卡。

        您应该能看到 goldspike 条目。

    4. 选择 goldspike 条目,如下图所示,然后单击“安装”按钮。

      在新插件选项卡中选择 goldspike 条目

    5. 单击“确定”按钮,开始安装。

    6. 成功完成安装后,关闭“安装”和“Rails 插件”对话框。

    7. 右键单击 rubyWeblog 项目节点并在弹出菜单中选择“运行 Rake 任务”>“刷新列表”,如下所示。此选项将强制 IDE 识别 Goldspike 插件添加到项目中的新 War Rake 目标。

      从运行 Rake 任务菜单中选择刷新列表

  3. 要将应用打包为 WAR 文件,可右键单击该项目节点并且选择“运行 Rake 任务”>“War”>“单独”>“创建”。

    IDE 将创建 WAR 文件并将该文件放在该项目的顶级文件夹中。.

  4. 将新近创建的 WAR 文件的副本放进 GlassFish 的 autodeploy 文件夹。例如,将 projects-folder/MyRubyApp/MyRubyApp.war 复制到glassfish-install-dir/domains/domain1/autodeploy

  5. 在浏览器中输入该应用程序的URL。例如,http://localhost:8080/MyRubyApp

注意:如果您安装了 GlassFish V3 JRuby 集成插件,则可以在 IDE 中注册一个 Glassfish V3 实例,并将该实例配置为 Rails 项目的当前服务器。然后,您可以使用“运行主项目”按钮在 GlassFish V3 实例上运行应用程序。注意,所有应用程序都将被部署到 root ("/") 级,如果您部署了一个以上的 Rails 应用程序,这可能会造成一些问题。此插件正处于开发的试验阶段。

未来计划

将反馈发送给我们



>> 更多 Ruby 文档

Companion
Projects:
MySQL Database Server   Open JDK: an Open SourceJDK   GlassFish Community: an Open Source Application Server    Mobile & Embedded Community    Open Solaris   java.net - The Source for Java Technology Collaboration   Virtual Box - full virtualizer  Open ESB - The Open Enterprise Service Bus Powered by