Ruby on Rails研究之三：Mysql数据库开发

  web开发的主要目标还是要和数据库结合，下面来研究一下数据库的应用。为了节省时间，继续使用上一篇文章建立的test应用

一、建立mysql数据库
  mysql数据库的安装和使用这里就不详细介绍了，在mysql里面建立一个testdb数据库，新建一个user表
create table users
(
id  smallint(5) unsigned not null auto_increment,
created_on  timestamp(14)  not null,
updated_on  timestamp(14)  not null,
user_name varchar(20) not null,
age  int  not null,
constraint pk_users primary key (id)
);

 

二、几个重要的说明：
因为rails使用约定来代替复杂的配置，这是它开发效率高的一个重要原因，这些约定包括：
1、数据表的名称是英文复数形式的，例如users
2、必须包含一个名称为id的自增字段
建议严格按照这两个约定来建立数据表，不然会带来一些问题。（虽然通过一些配置也可以避开这两个约定，但是那样就失去了rails的简洁特色了）
另外created_on和updated_on这两个字段rails也会自己处理，但这两个字段不是必须的

三、配置数据库联接
rails安装的时候自带了mysql驱动，所以不用另外安装了。
打开D:/ROR/test/config/database.yml文件，把development一段修改为你的数据库地址、数据库名，用户名、密码
development:
  adapter: mysql
  database: testdb
  username: root
  password:
  host: localhost
修改好了以后，就可以启动test应用了

四、产生model和controler
分别用ruby script/generate model user和ruby script/generate controller user来产生model和controller，屏幕显示如下：
D:/ROR/test>ruby script/generate model user
      exists  app/models/
      exists  test/unit/
      exists  test/fixtures/
      create  app/models/user.rb
      create  test/unit/user_test.rb
      create  test/fixtures/users.yml
      create  db/migrate
      create  db/migrate/001_create_users.rb

D:/ROR/test>ruby script/generate controller user
      exists  app/controllers/
      exists  app/helpers/
      create  app/views/user
      exists  test/functional/
      create  app/controllers/user_controller.rb
      create  test/functional/user_controller_test.rb
      create  app/helpers/user_helper.rb
注意这里的user用的是单数，这也是rails的约定之一
然后修改D:/ROR/test/app/controllers/user_controller.rb为
class UserController < ApplicationController
  model :user
  scaffold :user
end
然后在IE地址栏输入http://127.0.0.1:3000/user就可以看到画面了，画面上有一个New user链接，点击可以进入新增user的画面，新建一笔资料之后，back到list画面，可以看到刚才新建的记录被显示在那里，而且还多了view,edit,destroy三个链接。
到目前为止，我们没有写一行程序，rails已经帮我们建立了一个简单的应用，rails的神奇之处就在于此吧。
我们去修改一下users表的结构，可以发现rails不用做任何修改，依然是可以正常运行的。

五、rails的程序开发
  上面的例子所有的工作都是rails做了，但是只是一些简单的页面，距离真正的应用还有一段距离，所以我们需要对rails的工作进行进一步的开发，这个时候我们就需要让rails生成显式的代码，以便我们进一步研究和开发。使用的命令是ruby script/generate scaffold user，屏幕显示如下：
D:/ROR/test>ruby script/generate scaffold user
      exists  app/controllers/
      exists  app/helpers/
      create  app/views/users
      exists  app/views/layouts/
      exists  test/functional/
  dependency  model
      exists    app/models/
      exists    test/unit/
      exists    test/fixtures/
   identical    app/models/user.rb
   identical    test/unit/user_test.rb
   identical    test/fixtures/users.yml
      create  app/views/users/_form.rhtml
      create  app/views/users/list.rhtml
      create  app/views/users/show.rhtml
      create  app/views/users/new.rhtml
      create  app/views/users/edit.rhtml
      create  app/controllers/users_controller.rb
      create  test/functional/users_controller_test.rb
      create  app/helpers/users_helper.rb
      create  app/views/layouts/users.rhtml
      create  public/stylesheets/scaffold.css
注意这个命令使用的仍然是user的单数形式，但是rails生成的目录却是users复数形式了。
然后在IE地址栏输入http://127.0.0.1:3000/users就可以看到画面了，注意这次我们使用的也是users复数形式。

有兴趣的话可以打开users_controller.rb和上面产生的user_controller.rb进行比较，发现他们有了比较大的差别。
另外在app/view/users目录里面有一些rhtml文件，例如edit,list,view,show，这些就是我们需要的显式程序了，你可以根据需要修改他们了。

六、关于约定的问题
  我一开始尝试的时候没有注意rails对数据库建立的约定，走了一些弯路，所以我把它们写在这篇文章的开头了，以免大家重蹈我的覆辙，这里再补充说明一下不遵守这些约定带来的问题。
1、数据表名不是复数，例如
create table first
(
id  smallint(5) unsigned not null auto_increment,
created_on  timestamp(14)  not null,
updated_on  timestamp(14)  not null,
user_name varchar(20) not null,
age  int  not null,
constraint pk_first primary key (id)
);
在generate model first和generate controller first的时候没有问题，一样要修改first_controller.rb文件，
但是IE地址栏输入http://127.0.0.1:3000/first会看到
ActiveRecord::StatementInvalid in FirstController#index
Mysql::Error: #42S02Table 'testdb.firsts' doesn't exist: SHOW FIELDS FROM firsts
解决的方法是通过改变rails的配置来取消默认的单复数转换约定
在environment.rb中使用ActiveRecord::Base.pluralize_table_names = false参数
重新启动server就可以了。

2.数据表名和model的名称不一致
例如我们建立一个employee的model和controller，但是它对应的数据表是users
先建立model和controller，画面显示如下：
D:/ROR/test>ruby script/generate model employee
      exists  app/models/
      exists  test/unit/
      exists  test/fixtures/
      create  app/models/employee.rb
      create  test/unit/employee_test.rb
      create  test/fixtures/employees.yml
      exists  db/migrate
      create  db/migrate/005_create_employees.rb

D:/ROR/test>ruby script/generate controller employee
      exists  app/controllers/
      exists  app/helpers/
      create  app/views/employee
      exists  test/functional/
      create  app/controllers/employee_controller.rb
      create  test/functional/employee_controller_test.rb
      create  app/helpers/employee_helper.rb
然后修改app/models/employee.rb为：
class Employee < ActiveRecord::Base
  set_table_name "users"
end
记得还是要修改app/controllers/employee_controller.rb为
class EmployeeController < ApplicationController
  model :employee
  scaffold :employee
end
这样在IE地址栏输入http://127.0.0.1:3000/employee就会看到页面了。

3.没有id字段
如果没有id字段，那么list和new页面没有问题，但是view,edit,destroy会找不到记录，显示错误
ActiveRecord::RecordNotFound in UserController#show
Couldn't find User without an ID

4.id字段不是自增字段
list, view, edit destroy没有问题，但是新增第二条记录的时候会显示主键重复
ActiveRecord::StatementInvalid in UserController#create
Mysql::Error: #23000Duplicate entry '0' for key 'PRIMARY':

 七、数据库中文乱码问题

  上面的例子如果输入中文会出现乱码，解决方法是修改database.yml文件，增加一行  encoding: utf8，例如：

development:
  adapter: mysql
  database: testdb
  encoding: utf8
  username: root
  password:
  host: localhost

这样就OK了。

补充说明一下，我的mysql服务器的字符集是gbk，如何设置mysql的字符集就不在这里讨论了。