安装和配置
Ruby
支持
由
Chris Kutler
创建 2008
年 4
月[修订版:V6.1-1]
本文将介绍如何在NetBeans
IDE中下载、安装和配置 Ruby
支持。
目录
如果您尚未安装 NetBeans
6.1 IDE,请打开 NetBeans
IDE 6.1 下载页面 ,,然后下载一个含有
Ruby
支持的 IDE
版本。如果已经安装了
NetBeans
IDE 6.1,但是 NetBeans
IDE 6.1中没有 Ruby
支持,则按照以下步骤将 Ruby
支持添加到该 IDE
中。
如果您使用代理上网,可在主菜单中选择“工具”>“选项”,并选择“手动代理设置”,输入您的
HTTP
代理服务器的名称和端口号,然后单击“确定”按钮。
在主菜单中选择“工具”>“插件”。
在“插件”对话框中,单击“可用插件”选项卡,然后使用滚动栏查看
Ruby
类别(如下图所示)。
选中“Ruby
和 Rails”复选框,这样就在
NetBeans IDE
中添加了 Ruby
支持。
(可选)选中“JRuby
和 Rails
分发版”复选框,下载并安装 JRuby
软件和 Ruby
on Rails 框架。
注意: 您必须在系统上安装
Ruby
或 JRuby
软件才可使用 Ruby
和 Rails
分发版。如果您未安装此软件,则必须安装此插件,或者下载并安装
JRuby
或 Ruby
软件,然后才能在 IDE
中开发 Ruby
项目。
(可选)选中以下一个或多个插件:
其他的
Ruby
颜色主题。 为
Ruby
文件类型提供额外的编辑器颜色主题
其他的 Ruby
提示。 为最新版本开发的
Ruby
提供代码提示
GlassFish
V3 JRuby 集成。 支持将
Glassfish V3
实例安装到 IDE
中,并将实例配置为 Ruby
on Rails 项目的当前服务器
单击“安装”按钮。
此时会出现一个 NetBeans
IDE 安装程序。
在 NetBeans
IDE 安装程序中单击“下一步”按钮。
阅读许可证协议,然后选中“I
Accept the Terms in All License Agreements”单选按钮,并单击“下一步”按钮。
安装完成后,可以选择“立即重启”立即重启
IDE,也可以选择“稍后重启”再单击“完成”按钮。
初次安装时,Ruby
和 Rails
模块将注册在系统上检测到的任何
Ruby 安装。要添加额外的
Ruby 或
JRuby
安装,请完成以下步骤。
在 IDE
中,从主菜单中选择“工具”>“Ruby
平台”。
此时将出现 Ruby
平台管理器,如下图所示。
执行以下操作之一添加额外的 Ruby
或 JRuby
平台。
单击“确定”按钮关闭“选项”对话框。
有关如何获取Ruby软件的更多信息,请访问
www.ruby-lang.org 、instantrails.rubyforge.org
和
locomotive.raaum.org 。
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。
设置。 使用此选项卡配置代理。
注意: 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
on Rails 应用程序访问数据库。
MySQL
Adapter 。MySQL
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 数据库服务器。
在 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
应用程序将在 WEBrick
浏览器中运行。如是要将 JRuby
应用程序部署到 GlassFish
应用服务器,可以将应用程序和它的依赖关系打包为 Web
archive (WAR) 文件,然后再将这个 WAR
文件提供给应用服务器(可按以下步骤操作)。
部署的应用将使用生产数据库。打开
database.yml
文件,确保产品数据库的配置正确无误。
在创建 JRuby
应用程序的时候,会显示一个“添加 Rake
目标以支持应用服务器部署”选项(如下图所示)。如果打算在
GlassFish
中进行部署,应该选中该复选框。
如果您现有的 JRuby
项目没有提供 Rake
目标。完全可以按照以下步骤将 Goldspike
插件添加到该项目中。该插件添加的 Rake
任务可以创建 WAR
文件。
在“项目”窗口中,右键单击该项目的节点,然后在弹出的菜单中选择“Rails
插件”,如下图所示。
在“Rails
插件”对话框中,单击“新建插件”选项卡。
如果未看到 goldspike
条目,完成以下步骤注册提供
goldspike
插件的存储库。
单击“存储库”选项卡。
单击“添加
URL”。
在“添加存储库 URL”对话框中,键入
http://jruby-extras.rubyforge.org/svn/trunk/rails-integration/plugins
并单击“确定”按钮,如下图所示。
添加存储库之后,单击“关闭”按钮。
单击“新建插件”选项卡。
您应该能看到 goldspike
条目。
选择 goldspike
条目,如下图所示,然后单击“安装”按钮。
单击“确定”按钮,开始安装。
成功完成安装后,关闭“安装”和“Rails
插件”对话框。
右键单击 rubyWeblog
项目节点并在弹出菜单中选择“运行
Rake
任务”>“刷新列表”,如下所示。此选项将强制
IDE
识别 Goldspike
插件添加到项目中的新
War
Rake 目标。
要将应用打包为 WAR
文件,可右键单击该项目节点并且选择“运行
Rake
任务”>“War”>“单独”>“创建”。
IDE
将创建 WAR
文件并将该文件放在该项目的顶级文件夹中。.
将新近创建的 WAR
文件的副本放进 GlassFish
的 autodeploy
文件夹。例如,将
projects-folder /MyRubyApp/MyRubyApp.war
复制到glassfish-install-dir /domains/domain1/autodeploy
。
在浏览器中输入该应用程序的URL。例如,http://localhost:8080/MyRubyApp 。
注意: 如果您安装了 GlassFish
V3 JRuby 集成插件,则可以在
IDE
中注册一个 Glassfish
V3 实例,并将该实例配置为
Rails
项目的当前服务器。然后,您可以使用“运行主项目”按钮在
GlassFish
V3 实例上运行应用程序。注意,所有应用程序都将被部署到
root
("/") 级,如果您部署了一个以上的
Rails
应用程序,这可能会造成一些问题。此插件正处于开发的试验阶段。
未来计划
将反馈发送给我们
>>
更多
Ruby
文档