结合使用 Oracle 和 Ruby on Rails

在终端窗口中，通过执行以下命令来执行 connect.rb 脚本：

export NLS_LANG=American_America.UTF8
ruby connect.rb

如果连接成功，您会看到上面的消息；如果连接失败，您将看到一条错误消息。

connect.rb 文件的内容如下：

# connect.rb: Create connections to Oracle
require 'config.rb'

begin
	# login as normal user
	conn1 = OCI8.new(DB_USER, DB_PASSWORD, DB_SERVER)
	puts "login as normal user succeeded."
	conn1.logoff
	puts "logoff succeeded."	
	puts

	# login as DBA
	conn2 = OCI8.new('sys', 'oracle', DB_SERVER, :SYSDBA)
	puts "login with DBA privilege succeeded."
	conn2.logoff
	puts "logoff succeeded."

rescue OCIError
	# display the error message
	puts "OCIError occured!"
	puts "Code: " + $!.code.to_s
	puts "Desc: " + $!.message

end

puts '-'*80

本教程的其余脚本中将包括以下命令：

require 'config.rb'
 
 #create connection
 conn = OCI8.new(DB_USER, DB_PASSWORD, DB_SERVER)

# operations on conn goes here


 #log out
 conn.logoff

创建一个游标，准备执行 SQL 语句并返回 OCI8::Cursor 的实例。

执行 SQL 语句。返回值的类型取决于 SQL 语句的类型。指定 bindvars 后，它们在执行前作为绑定变量进行绑定。

在终端窗口中，通过执行以下命令来执行 fetch.rb 脚本：

ruby fetch.rb

其输出显示在屏幕截图中。

fetch.rb 文件的内容如下：

#fetch.rb: Fetch data from database
require 'config.rb'

# Create a connection to Oracle
conn = OCI8.new(DB_USER, DB_PASSWORD, DB_SERVER)

# parse and exec the statement
cursor = conn.parse("select * from regions")
cursor.exec

# output column names
puts cursor.getColNames.join(",")

# output rows
while r = cursor.fetch 
	puts r.join(",")
end

# close the cursor and logoff
cursor.close
conn.logoff
puts '-'*80

还可以通过另一种方式编写更针对于 ruby 的相同的代码。在终端窗口中，通过执行以下命令来执行 fetch_r.rb 脚本：

ruby fetch_r.rb

The output is shown in the screenshot. 

fetch_r.rb 文件的内容如下：

# fetch_r.rb: Fetch in a more ruby-like way
require 'config.rb'

# Create a connection to Oracle
conn = OCI8.new(DB_USER, DB_PASSWORD, DB_SERVER)

# Fetch and display the rows in a block
nrow = conn.exec("select * from regions") do |r|
	puts r.join(",")
end

# Display count of rows
puts ' '*30 + nrow.to_s + " rows were fetched."

conn.logoff
puts '-'*80

在获取许多行时，预先获取有助于改善性能。在终端窗口中，通过执行以下命令来执行 prefetch.rb 脚本：

ruby prefetch.rb

The output is shown in the screenshot. 

prefetch.rb 文件的内容如下：

# prefetch.rb: Prefetch data
require 'config.rb'

SELECT_STATEMENT = "select a.first_name, a.last_name, b.first_name, b.last_name,
   a.salary - b.salary salarydiff 
from employees a, employees b 
where b.id > a.id"

# Create a connection to Oracle
conn = OCI8.new(DB_USER, DB_PASSWORD, DB_SERVER)

# Execute statement with different prefetch sizes
[nil,100].each do |prefetchrows|

  cursor = conn.parse(SELECT_STATEMENT)

  if prefetchrows
    cursor.prefetch_rows = prefetchrows
  else
    prefetchrows = "default"
  end

  puts "Executing with prefetch rows = #{prefetchrows}"

  time1 = Time.now

  cursor.exec

  while r = cursor.fetch()
    # puts r.join(",")
  end

  # Display count of rows
  puts ' '*30 + cursor.row_count.to_s + " rows were fetched."

  time2 = Time.now
  puts "Time cost: " + (time2-time1).to_s
  puts

end

conn.logoff
puts '-'*80

显式绑定变量。当 key 为数字时，它通过位置绑定（从 1 开始）。当 key 为字符串时，它通过占位符名称绑定。

也可以通过 bindvars 绑定变量。

在终端窗口中，通过执行以下命令来执行 bind.rb 脚本：

ruby bind.rb

其输出显示在屏幕截图中。

bind.rb 文件的内容如下：

# bind.rb: How to bind variables
require 'config.rb'

# Create a connection to Oracle
conn = OCI8.new(DB_USER, DB_PASSWORD, DB_SERVER)

# Prepare the data, also display what's hard-coded statement
conn.exec("DELETE FROM test_bind")
conn.exec("INSERT INTO test_bind VALUES(1, 'Unknown')")
conn.exec("INSERT INTO test_bind VALUES(2, 'Unknown')")
conn.exec("INSERT INTO test_bind VALUES(3, 'Unknown')")

# Now update the data using bind variables.
cursor = conn.parse("UPDATE test_bind SET name = :name WHERE id = :id")
cursor.bind_param(1,nil,String,100) #  Or: cursor.bind_param(1, ' '*100)
cursor.bind_param(2,Fixnum)					#  Or: cursor.bind_param(2, id) 

id = 1
['China', 'Korea', 'Japan'].each { |country|
	cursor[1] = country
	cursor[2] = id
	cursor.exec
	id = id + 1
}

# Fetch back the updated data
conn.exec("SELECT * FROM test_bind").fetch do |row|
	puts row.join(',')
end

conn.logoff

puts '-'*80

要使用绑定变量测试性能改善，通过执行以下命令来执行 bind_perf_test.rb 脚本：

ruby bind_perf_test.rb

The output is shown in the screenshot. 

bind_perf_test.rb 文件的内容如下：

# bind_perf_test.rb: Performance test for binding variables
require 'config.rb'

# Create a connection to Oracle
conn = OCI8.new(DB_USER, DB_PASSWORD, DB_SERVER)

# Not using bind varables.
puts "Fetching result, not using bind variables:"
time1 = Time.now
(100..200).each { |id|
	cursor = conn.parse("SELECT first_name FROM employees WHERE id = #{id}")
  cursor.exec
	#puts id.to_s + " --> " + cursor.fetch[0]
}
time2 = Time.now
puts "Time cost: " + (time2-time1).to_s
puts

# Using bind varables.
puts "Fetching result, using bind variables:"

time1 = Time.now
cursor = conn.parse("SELECT first_name FROM employees WHERE id = :id")
cursor.bind_param(1, Fixnum)

(100..200).each { |id|    
	cursor[1] = id
	cursor.exec
	#puts id.to_s + " --> " + cursor.fetch[0]
}
time2 = Time.now
puts "Time cost: " + (time2-time1).to_s

# End of the test
conn.logoff

puts '-'*80

在分析和执行过程中使用该方法。pos 从 1 开始。当 type 为 String 时使用 length。

在终端窗口中，通过执行以下命令来执行 define.rb 脚本：

ruby define.rb

其输出显示在屏幕截图中。

您会看到两个输出块之间的差别。

define.rb 文件的内容如下：

# define.rb: Define output columns
require 'config.rb'


# Create a connection to Oracle
conn = OCI8.new(DB_USER, DB_PASSWORD, DB_SERVER)


# Prepare the data
conn.exec("DELETE FROM test_define");
conn.exec("INSERT INTO test_define VALUES(1,'Scott Tiger', SYSDATE, SYSTIMESTAMP)")

# Define to fetch Date and Time
cursor = conn.parse("SELECT name,birthdate,lastvisit FROM test_define WHERE id = :id")
cursor.bind_param(1, 1)
cursor.define(1, String, 100)
cursor.define(2, Date)
cursor.define(3, Time)
cursor.exec

while r = cursor.fetch
	puts r.join("\n")
end

puts 

# Define to fetch Date and Time as String
#conn.exec("ALTER SESSION SET nls_territory='TAIWAN' nls_language='TRADITIONAL CHINESE'")
cursor = conn.parse("SELECT name,birthdate,lastvisit FROM test_define WHERE id = :id")
cursor.bind_param(1, 1)
cursor.define(1, String, 100)
cursor.define(2, String, 100)
cursor.define(3, String, 100)
cursor.exec

while r = cursor.fetch
	puts r.join("\n")
end

conn.logoff
puts '-'*80

获取/设置自动提交模式的状态。默认值是 false（记住：注销时不回滚未提交的事务）。如果为 true，每次执行 insert/update/delete 语句时都自动提交事务。

在终端窗口中，通过执行以下命令来执行 transaction.rb 脚本：

ruby transaction.rb

该脚本使用 conn1 连接更新一行。在 Oracle 中，新数据在提交前仅在原始数据库会话中可见。其输出显示在屏幕截图中。

在这种情况下，conn2 连接不知道 conn1 的未提交事务发生了什么。

transaction.rb 文件的内容如下：

# transaction.rb: How to use transactions
require 'config.rb'

# Create connections to Oracle
conn1 = OCI8.new(DB_USER, DB_PASSWORD, DB_SERVER)
conn2 = OCI8.new(DB_USER, DB_PASSWORD, DB_SERVER)

conn1.exec("DELETE FROM test_transaction")
conn1.exec("INSERT INTO test_transaction VALUES(1, 'old value')")
conn1.commit

#conn1.autocommit = true
puts "OCI8.autocommit = " + conn1.autocommit.to_s
puts "conn1 updated the name to 'something new'";
conn1.exec("UPDATE test_transaction SET name = 'something new' WHERE id = 1");
#conn1.commit

puts "conn2 got the name as '" + 
		conn2.exec('SELECT name FROM test_transaction WHERE id = 1').fetch[0] + "'"

conn1.logoff
conn2.logoff

puts '-'*80

更新 transaction.rb 脚本，取消对 conn1.autocommit = true 的注释，然后保存文件。

使用以下命令再次执行脚本：

ruby transaction.rb

现在，conn2 知道哪些内容是新增的。其输出显示在屏幕截图中。

单独提交每一行会额外增加服务器的负载。您可以比较单独提交每行与在事务结束后提交之间的性能差异。要测试差别，使用以下命令执行 trans_perf_test.rb 脚本：

ruby trans_perf_test.rb

注意，第二个数字比第一个数字小。其输出显示在屏幕截图中。

trans_perf_test.rb 文件的内容如下：

# trans_perf_test.rb: Performance test for transactions
require 'config.rb'

# Create a connection to Oracle
conn = OCI8.new(DB_USER, DB_PASSWORD, DB_SERVER)
conn.exec("DELETE FROM test_transaction")
conn.commit

# Commit on each time
conn.autocommit = true
time1 = Time.now
300.times{
	conn.exec("INSERT INTO test_transaction VALUES(1, 'something')")
}
time2 = Time.now

# Commit on the last step
conn.autocommit = false	# It's the default
time3 = Time.now
300.times{
	conn.exec("INSERT INTO test_transaction VALUES(1, 'something')")
}
conn.commit
time4 = Time.now

# Output the comparation
puts "Time cost of each-time commit(sec): " + (time2-time1).to_s
puts "Time cost of one-time commit(sec) : " + (time4-time3).to_s

conn.logoff

puts '-'*80

Oracle 存储程序包。TO_CHAR 是一个内置函数。

在终端窗口中，通过执行以下命令来执行 plsql.rb 脚本：

ruby plsql.rb

其输出显示在屏幕截图中。

plsql.rb 文件的内容如下：

# plsql.rb: Call PL/SQL procedures and functions
require 'config.rb'

# Create a connection to Oracle
conn = OCI8.new(DB_USER, DB_PASSWORD, DB_SERVER)

puts 'Get version information from Oracle:'
cursor = conn.parse("BEGIN DBMS_UTILITY.db_version(:ver, :comp); END;")
cursor.exec(' '*50,' '*50)
puts "Oracle DB Version: " + cursor[1]
puts "Oracle DB Compatibility: " + cursor[2]
puts

puts 'Call TO_CHAR function:'
cursor = conn.parse("BEGIN :str := TO_CHAR(:num, 'FM0999'); END;")
cursor.exec('ABCD', 123)
puts "TO_CHAR input: " + cursor[2].to_s
puts "TO_CHAR output: " + cursor[1]
puts

puts 'Get DBMS_OUTPUT:'
conn.exec("BEGIN DBMS_OUTPUT.ENABLE(NULL); END;")
conn.exec("BEGIN DBMS_OUTPUT.put_line('Hello world!'); END;")
conn.exec("BEGIN DBMS_OUTPUT.put_line('Can you see me?'); END;")

cursor = conn.parse("BEGIN DBMS_OUTPUT.get_line(:line, :status); END;")
cursor.bind_param(':line', nil, String, 255)
cursor.bind_param(':status',Fixnum)

while true
	cursor.exec
	break if cursor[':status'] == 1
	puts cursor[':line']
end

puts '-'*80

检查 BLOB 是否可用。要使用 BLOB，您首先需要插入 EMPTY_BLOB()。

脚本文件所在的文件夹中有一个 PNG 文件。创建一个名为 download 的文件夹。在终端窗口中，通过执行以下命令来执行 blob.rb 脚本：

mkdir download
ruby blob.rb

其输出显示在屏幕截图中。

blob.rb 文件的内容如下：

#blob.rb: Save and Load BLOB
require 'config.rb'

# Create a connection to Oracle
conn = OCI8.new(DB_USER, DB_PASSWORD, DB_SERVER)

conn.exec("DELETE FROM test_blob")

# Must insert a EMPTY_BLOB before save real data
cursor = conn.parse("INSERT INTO test_blob VALUES(:name, EMPTY_BLOB())")
Dir["*.png"].each do |fname|
	cursor.exec(fname)
end

# Save BLOB into Oracle
conn.exec("SELECT name,image FROM test_blob") do |name, image|
	puts "uploading file: " + name
	File.open(name, 'r') do |f|
		image.write(f.read)
		image.size = f.pos
	end
end

# Load BLOB from Oracle
conn.exec("SELECT name,image FROM test_blob") do |name, image|
	puts "downloading file: " + name
	File.open("download/"+name, 'w') do |f|
		f.write(image.read)
	end
end

# End
conn.logoff
puts '-'*80

查看 ruby.png 文件的权限。执行以下命令：

ls -l ruby.png download/ruby.png

根据 SELECT 语句从关系数据生成 XML。它返回 CLOB。

在终端窗口中，通过执行以下命令来执行 xml.rb 脚本：

ruby xml.rb

其输出显示在屏幕截图中。

xml.rb 文件的内容如下：

# xml.rb: Generate a xml document based on relational data
require 'config.rb'

# Create a connection to Oracle
conn = OCI8.new(DB_USER, DB_PASSWORD, DB_SERVER)

sql = "SELECT DBMS_XMLGEN.getxml('
		SELECT dept.name,dept.id,
		CURSOR(
			SELECT emp.first_name,emp.last_name,emp.phone_number
			FROM employees emp
			WHERE emp.department_id=dept.id
		) AS employees
		FROM departments dept
		WHERE dept.id in (20,110)'
	) AS xml
	FROM dual"

# Fetch as CLOB
puts conn.exec(sql).fetch[0].read

conn.logoff
puts '-'*80

在终端窗口中，通过执行以下命令来执行 activerecord.rb 脚本：

ruby activerecord.rb

其输出显示在屏幕截图中。

activerecord.rb 文件的内容如下：

# activerecord.rb: Using ActiveRecord, the ORM module
require 'config.rb'
require 'rubygems'
require 'active_record'

# Establish a connection to Oracle
ActiveRecord::Base.establish_connection(
	:adapter => "oracle_enhanced",
	:database => DB_SERVER,
	:username => DB_USER,
	:password => DB_PASSWORD )

# Define the Classes, they are mapped to table countries and regions
class Country < ActiveRecord::Base
	belongs_to :region
end
class Region < ActiveRecord::Base
	has_many :countries
end

# Enjoy the automatic Object-Relation Mapping
cty = Country.find('CN')
puts 'CN refers to [' + cty.name + ']'
puts '[' + cty.name + '] is in [' + cty.region.name + ']'
puts

rgn = Region.find(cty.region.id)
puts 'Countries in the same region with [' + cty.name + ']'
rgn.countries.each { |country| puts ' - ' + country.name }

puts '-'*80

您将创建一个名为 holapp 的非常基本的 Rails 应用程序。在终端窗口中执行以下命令：

rails holapp
cd holapp
gedit config/database.yml

用以下内容替换 config/database.yml 文件中的 development 部分，然后保存并关闭该文件。

development:
    adapter: oracle_enhanced
    username: rubyhol
    password: welcome
    database: localhost/orcl

现在可以生成 comic 模型。在终端窗口中执行以下命令：

ruby script/generate model comic

您想编辑生成的脚本。在终端窗口中输入以下命令：

gedit db/migrate/*_create_comics.rb

用以下内容替换 self.up 部分，然后保存并关闭该文件。

  def self.up
    create_table :comics do |t|
          t.column :name,:string
    t.column :description, :string
    t.column :price, :float
    end
  end

现在可以对数据库迁移进行 rake 操作，以生成目标表。在终端窗口中输入以下命令：

rake db:migrate

可以通过以下命令生成 comic 模型的结构

ruby script/generate scaffold --skip-migration comic name:string description:string price:float

Webrick 是用 Ruby 编写的 HTTP 服务器库，它使用 servlet 扩展其功能。使用以下命令启动 Webrick 服务器：

ruby script/server

您可以查看该应用程序。打开一个浏览器窗口，输入以下 URL。单击 New Comic 创建一条记录，以确保该应用程序正常运行。

http://localhost:3000/comics

输入 comic 信息，然后单击 Create。

comic 创建成功。单击 Back。

创建另一个 comic。选择 New comic。

输入 comic 信息，然后单击 Create。

另一个 comic 创建成功。单击 Back。

列出了这两个 comic。您还可以对第一个 comic 选择 Edit 进行编辑。

更改任何信息后单击 Update。

更新了该 comic。单击 Back。

还可删除一个 comic。对其中一个 comic 选择 Destroy。

单击 OK 确认。

更新了该 comic。单击 Back。

停止脚本服务器。在运行该服务器的窗口中按 Control+c。

另外打开一个终端窗口，执行以下命令：

cd /home/rubyhol/holapp
source /etc/bashrc

生成 author 模型的结构。在终端窗口中执行以下命令：

ruby script/generate scaffold author name:string vocation:string

生成 article 模型的结构。在终端窗口中执行以下命令：

ruby script/generate scaffold article title:string author_id:integer abstract:text

现在，您需要让 Rails 知道 Article 模型和 Author 模型之间的关系。为此，需要对生成的模型脚本进行编辑。在终端窗口中输入以下命令：

gedit app/models/author.rb

用以下内容替换文件的内容，然后保存并关闭该文件。

class Author < ActiveRecord::Base
   has_one :article
end

您想编辑生成的脚本。在终端窗口中输入以下命令：

gedit app/models/article.rb

用以下内容替换文件的内容，然后保存并关闭该文件。

class Article < ActiveRecord::Base
   belongs_to :author
end

现在可以对数据库迁移进行 rake 操作，以生成目标表。在终端窗口中输入以下命令：

rake db:migrate

在终端窗口中，通过执行以下命令再次启动脚本服务器：

script/server &

您可以查看该应用程序。打开浏览器窗口，输入以下 URL，然后选择 New author。

http://localhost:3000/authors

输入一位新作者，然后单击 Create。

该作者创建成功。单击 Back。

您想再创建一位作者。选择 New author。

输入一位新作者，然后单击 Create。

该作者创建成功。单击 Back。

随即显示您添加的作者列表。

现在您想创建一些文章。输入以下 URL，然后选择 New articles。

http://localhost:3000/articles

在 Title 处输入一个标题，对 Author 指定 Julia Child，输入任何摘要信息。然后单击 Create。

该文章创建成功。

请注意，这里的 Author 为 0。这是因为 author_id 的值无效，结果是“Julia Child”变成了 0。在下一节中，您将改进 new 和 edit 表单，以便能够通过一个弹出列表按姓名选择作者（该弹出列表显示姓名但在代码中返回 author_id）。

在新的终端窗口中输入以下命令（因为您之前的窗口正在运行脚本/服务器）。

cd holapp
gedit app/views/articles/new.html.erb

将下面这行：

<%= f.text_field :author_id %>

替换为

<%= f.collection_select(:author_id, Author.all, :id, :name) %>

该文件现在应如下所示。

对 articles 目录中的 edit.html.erb 文件执行相同的操作。在终端窗口中输入以下命令：

gedit app/views/articles/edit.html.erb

将下面这行：

<%= f.text_field :author_id %>

替换为

<%= f.collection_select(:author_id, Author.all, :id, :name) %>

该文件现在应如下所示。

再次输入以下 URL。您会看到您在前面创建的文章出现在该列表中。选择 Edit。

http://localhost:3000/articles

注意，现在您可从一个选择列表中选择作者了。选择 Julia Child。然后单击 Update。

该文章创建成功。

注意这里的 Author: 1。此为 author_id 的值。您可将此值改为姓名。

下面将更改 articles 目录中的 index.html.erb 文件。在终端窗口中输入以下命令：

gedit app/views/articles/index.html.erb

将下面这行：

<td><%=h article.author_id %></td>

替换为

<td><%=h article.author.name %></td>

该文件现在应如下所示。

对 articles 目录中的 edit.html.erb 文件执行相同的操作。在终端窗口中输入以下命令：

gedit app/views/articles/show.html.erb

将下面这行：

<%=h article.author_id %>

替换为

<%=h article.author.name %>

该文件现在应如下所示。

再次输入以下 URL。您会看到此时该作者出现在列表中。选择 Show。

http://localhost:3000/articles

您现在可在 Show 模式下看到所有信息。

为了指明这种关系，需要更改 author.rb 文件。在终端窗口中输入以下命令：

gedit app/models/author.rb

将下面这行：

 has_one : article 

替换为

 has_many : articles 

再次输入以下 URL，然后选择 New article。

http://localhost:3000/articles

新建一个文章。对 Author 选择 Julia Child，然后单击 Create。

该文章创建成功。单击 Back。

两个文章同时显示出来。

您需要在 authors.rb 文件中再次更改该关系。在终端窗口中输入以下命令：

gedit app/models/author.rb

将下面这行：

 has_many :articles 

替换为

 has_and_belongs_to_many :articles 

另外还需要更改 article.rb 文件。在终端窗口中输入以下命令：

gedit app/models/article.rb

将下面这行：

 belongs_to :author 

替换为

 has_and_belongs_to_many :authors 

现在需要创建 Authors 和 Articles 之间的一个联接表。在终端窗口中输入以下命令：

script/generate migration CreateArticlesAuthors

现在需要对刚创建的文件进行更改以创建一个表来存储作者和文章。在终端窗口中输入以下命令：

gedit db/migrate/*_create_articles_authors.rb

将下面的内容：

def self.up
end

def self.down
end

替换为

def self.up
  create_table :articles_authors, :id => false do |t|
    t.integer :author_id
    t.integer :article_id
    t.timestamps
  end
end
 
def self.down
  drop_table :articles_authors
end

现在可以对数据库迁移进行 rake 操作，以生成目标表。在终端窗口中输入以下命令：

rake db:migrate

再次输入以下 URL。注意此时出现了一个错误。

http://localhost:3000/articles

既然现在是多对多的关系，Article 模型就具有名为 authors 和 author_ids 的方法而不是名为 author 和 author_id 的方法。要纠正这个错误，需要在 new.html.erb 文件中创建和编辑弹出列表并显示您前面创建的用于处理多位作者的域。在终端窗口中输入以下命令：

gedit app/views/articles/new.html.erb

将下面这行：

<%= f.collection_select(:author_id, Author.all, :id, :name) %>

替换为

<%= f.collection_select(:author_ids, Author.all, :id, :name, {},
                        {:multiple => :multiple} ) %>

该文件现在应如下所示。

另外还需要更改 articles 目录中的 edit.html.erb 文件。在终端窗口中输入以下命令：

gedit app/views/articles/edit.html.erb

将下面这行：

<%= f.collection_select(:author_id, Author.all, :id, :name) %>

替换为

<%= f.collection_select(:author_ids, Author.all, :id, :name, {},
                        {:multiple => :multiple} ) %>

该文件现在应如下所示。

还需要更改 articles 目录中的 index.html.erb 文件。在终端窗口中输入以下命令：

gedit app/views/articles/index.html.erb

将下面这行：

<th>Author</th>

替换为

<th>Authors</th>

需要获取所有作者的姓名并执行 join 操作将它们连接在一起。将下面这行：

<td><%=h article.author.name %></td>

替换为

<td><%=h article.authors.map {|auth| auth.name}.join(", ") %></td>

该文件现在应如下所示。

最后，更改 articles 目录中的 show.html.erb 文件。在终端窗口中输入以下命令：

gedit app/views/articles/show.html.erb

将以下代码行：

<b>Author: </b>
<%=h article.author.name %>

替换为

<b>Authors: </b>
<%=h article.authors.map {|auth| auth.name}.join(", ") %>

该文件现在应如下所示。

再次输入以下 URL。注意列表中没有显示任何作者。这是因为您切换了表达式。您可能已纠正了这个问题，即已使用一个迁移将 articles 表中的数据引入到了 articles_authors 表中。但这里我们使用应用程序将作者添加回来。选择 Boning a Duck 标题的 Edit 链接。

http://localhost:3000/articles

对 Author 选择 Julia Child，然后单击 Update。注意这里的选择列表允许您选择多位作者而不是只选一位。

该文章更新成功。单击 Back。

选择 The Importance of Butter 标题的 Edit 链接。

按下 Control 键的同时选择这两位作者，单击 Update。

该文章更新成功。单击 Back。

现在该文章显示不止一位作者。

添加一个 boolean 类型的列 is_finished。在终端窗口中执行以下命令：

script/generate migration AddIsFinishedToArticle is_finished:boolean

接着，需要将现有文章标记为未完成。在终端窗口中执行以下命令：

gedit db/migrate/*_add_is_finished_to_article.rb

将以下行：

  add_column :articles, :is_finished, :boolean

更改为

  add_column :articles, :is_finished, :boolean, :default => false
  Article.reset_column_information
  Article.find(:all).each do |a|
    a.is_finished = false
  end

现在您将更新数据库。在终端窗口中输入以下命令：

rake db:migrate

接着，您想添加一个“Mark Finished”按钮，使其调用新的 mark_finished 操作。在终端窗口中输入以下命令：

gedit app/views/articles/show.html.erb

在 <%= link_to 'Back', articles_path %> 行的后面添加下面一行。

<%= button_to "Mark Finished", :action => :mark_finished, :id  => @article.id %>

您需要更新页面布局以显示到未完成文章的链接。应使此代码与主布局分离开来。您将生成一个新的“局部模板”，其文件名以字符“_”（下划线）开头以表明它不是一个完整的模板。该模板将查找 is_finished 为 false 的文章并链接到这些文章。在终端窗口中执行以下命令：

gedit app/views/articles/_unfinished.html.erb

在该文件中添加以下代码：

  <div class="unfinished-title">Unfinished Articles</div>
  <table>
    <% for article in Article.all(:conditions => {:is_finished  => false}) %>
     <tr> <%= link_to article.title, :action => :show, :id  => article.id %> </tr>
    <% end %>
  </table>

接着，需要在页面布局中引用这个新的“局部模板”以便所有页面显示它。在终端窗口中执行以下命令：

gedit app/views/layouts/articles.html.erb

紧随 <p style="color:green"><%= flash[:notice] %></p> 之后添加以下代码：

 <div id="unfinished">
  <%= render(:partial => "unfinished") %>
 </div>

接着，需要编写新按钮将执行的 mark_finished 操作的代码。在终端窗口中执行以下命令：

gedit app/controllers/articles_controller.rb

向下滚动至文件底部。在最后一个“end”的前面添加以下代码：

    # POST /articles/mark_finished/1
    # POST /articles/mark_finished/1.xml
    def mark_finished
      @article = Article.find(params[:id])
      @article.update_attribute(:is_finished, true)
  
      respond_to do |format|
        format.html { redirect_to(:action => :show) }
        format.xml  { head :ok }
      end
    end
  
          

您已更新了数据库，向页面布局添加了按钮和操作以及列表。现在可对该功能进行测试了。在浏览器中输入以下 URL：

    http://localhost:3000/articles

注意页面顶部列出了未完成的文章。选择 Boning a Duck 链接。

单击 Mark Finished 按钮。

您会看到 Boning a Duck 已从 Unfinished Articles 列表中删除。选择 Back。

此时您可以尝试 AJAX 了！您希望将应用程序更改成这样：当您按下该按钮时，窗口会自动更新而不会刷新整个屏幕。为此，您想让“Mark Finished”按钮发送一个 AJAX 命令来执行 mark_finished 操作，然后再发回一个命令更新“Unfinished Articles”标题下的内容。首先将该按钮更改为一个远程 (AJAX) 表单。在终端窗口中执行以下命令：

  gedit app/views/articles/show.html.erb

将以下语句：

  <%= button_to "Mark Finished", :action => :mark_finished, :id  => @article.id %>

更改为

  <% form_remote_tag :url => { :action => :mark_finished, :id  => @article } do %>
   <%= submit_tag "Mark Finished" %>
  <% end %>

当您按下该按钮时，应用程序将像以前一样进行更新，但不发送整个页面，您需要发送回某个 JavaScript 以便只更新未完成文章列表。通过使用一个远程 javascript 模板，Rails 可为您生成这个 JavaScript。在终端窗口中执行以下命令新建一个文件：

  gedit app/views/articles/mark_finished.js.rjs

输入以下代码行：

  page.replace_html("unfinished" , :partial => "unfinished")

为使其生效，在所有页面中需有一些默认的 JavaScript 子例程。您需要编辑布局。在终端窗口中执行以下命令新建一个文件：

gedit app/views/layouts/articles.html.erb

在 <%= stylesheet_link_tag 'scaffold' %> 之后添加下行：

<%= javascript_include_tag :defaults %>

接着，需要更新 mark_finished 操作以使用新的远程模板，该模板与该操作同名。在终端窗口中执行以下命令新建一个文件：

gedit app/controllers/articles_controller.rb

将以下代码：

    # POST /articles/mark_finished/1
    # POST /articles/mark_finished/1.xml
    def mark_finished
      @article = Article.find(params[:id])
      @article.update_attribute(:is_finished, true)
  
      respond_to do |format|
        format.html { redirect_to(:action => :show) }
        format.xml  { head :ok }
      end
    end

          

更改为

    # *AJAX* /articles/mark_finished/1
    def mark_finished
      @article = Article.find(params[:id])
      @article.update_attribute(:is_finished, true)
  
      respond_to do |format|
        format.js
      end
    end

您已转为使用一个 AJAX 请求表单并发回 Javascript 以更新列表。在浏览器中输入以下 URL：

    http://localhost:3000/articles

新建一个文章。选择 New article。

对 Title 输入 Gravity，对 Author 选择 Julia Child，对 Abstract 输入 Gravity makes cakes fall，然后单击 Create。

您会看到 Unfinished Articles 列表中列出了 Gravity。选择 Gravity 链接。

单击 Mark Finished。

Gravity 立即从列表中消失。该页面未完全刷新。这是 AJAX 的功劳。在像这样一个简单的屏幕上，使用和不使用 AJAX 之间的差别可能不太明显，因为您的 Web 服务器发送的页面较小。但在含有图像、flash 和/或大量数据的更为复杂的屏幕上，其差别可以是巨大的。如果使用 AJAX，则服务器可以只发送有变化的部分。因此，您确实会欣赏 Rails 对 AJAX 支持！

现在可以生成 comic 模型。在终端窗口中执行以下命令：

ruby script/generate migration add_columns

您想编辑生成的脚本。在终端窗口中输入以下命令：

gedit db/migrate/008_add_columns.rb

用以下内容替换 self.up 部分，然后保存并关闭该文件。

  def self.up
 add_column :comics, :author, :string
  end

现在可以对数据库迁移进行 rake 操作，以生成目标表。在终端窗口中输入以下命令：

rake db:migrate

注：要删除某列，我们可以在 self.up 方法中添加一行（如“remove_column :comics, :price”）；要重命名某列，我们可以在 self.up 方法中添加一行（如“rename_column :comics, :price, :new_price”）；要更改某列，我们可以在 self.up 方法中添加一行（如“change_column :comics, :price, :integer”）。
而且，我们可以通过执行“rake db:migrate VERSION=xx”命令来回滚迁移操作，其中 xx 是您希望回滚到的版本。