Rails3.1 使用mongodb学习笔记之mongo_maper

zhuyumu

根据官网的提示按照下面步骤依次进行,官网上的介绍文章用的是mongo_mapper但是我在网上查资料的时候发现很多人都是推荐mongoid的，本着学习，多学一点没坏处的想法，就硬着头皮弄了一遭，过几天再试一试mongoid：
安装rails
gem install rails
配置应用程序
很重要的一步就是要跳过这个active-record
rails new project_name --skip-active-record
如果是没有进行上一步而直接创建了rails项目，可以通过修改 config/application.rb 文件

#  require "rails/all" # 删除掉
# 添加下面
require "action_controller/railtie"
require "action_mailer/railtie"
require "active_resource/railtie"
require "rails/test_unit/railtie"

同时要确保generate命令，不要去对对象关联active_record的orm
# Configure generators values. Many other options are available, be sure to check the documentation.
# config.generators do |g|
#   g.orm             :active_record
#   g.template_engine :erb
#   g.test_framework  :test_unit, :fixture => true
# end

安装gem初始化数据库
Gemfile中添加
source 'http://gemcutter.org'
require 'rubygems'
require 'mongo'
gem "rails", "3.1.0"
gem "mongo_mapper"

接下来运行指令安装gem
bundle install
如果提示没有bundle那么请先安装
gem install bundle

数据库：
创建文件config/initializers/mongo.rb添加内容:

MongoMapper.connection = Mongo::Connection.new('localhost', 27017)
MongoMapper.database = "project_name_#{Rails.env}"
if defined?(PhusionPassenger)
PhusionPassenger.on_event(:starting_worker_process) do |forked|
MongoMapper.connection.connect if forked
end
end


测试配置
创建文件 lib/tasks/mongo.rake 添加内容:
namespace :db do
namespace :test do
task :prepare do
# Stub out for MongoDB
end
end
end

--------------------------------------------------------------------
中间遇到的问题以及解决过程
问题一、运行rails s ,出现错误提示：
**Notice: C extension not loaded. This is required for optimum MongoDB Ruby driver performance.
You can install the extension as follows:
gem install bson_ext
If you continue to receive this message after installing, make sure that the
bson_ext gem is in your load path and that the bson_ext and mongo gems are of the same version.
gems/ruby-1.9.2-p180/gems/execjs-1.3.0/lib/execjs/runtimes.rb:50:in `autodetect': Could not find a JavaScript runtime. See https://github.com/sstephenson/execjs for a list of available runtimes. (ExecJS::RuntimeUnavailable)
from /home/chinacheng/.rvm/gems/ruby-1.9.2-p180/gems/execjs-1.3.0/lib/execjs.rb:5:in `<module:ExecJS>'
from /home/chinacheng/.rvm/gems/ruby-1.9.2-p180/gems/execjs-1.3.0/lib/execjs.rb:4:in `<top (required)>'

提示缺少gem包 gem install bson_ext
安装之后，再运行，仍然出现上面这个错误
在Gemfile中添加
gem "bson_ext"
执行rails s
**Notice: C extension not loaded 这个问题就不存在了
还剩下JavaScript runtime这个错误，查了一下原因是:
Windows下默认有Javascript引擎，所以window下不会有这个错误。Linux下才有这个错误，一般只要第一个项目安装即可，以后的项目不用重复安装。
而且这个错误是由development环境中的assets包引起的，注释掉

# Gems used only for assets and not required
# in production environments by default.
#group :assets do
#  gem 'sass-rails', "  ~> 3.1.0"
#  gem 'coffee-rails', "~> 3.1.0"
#  gem 'uglifier'
#end
就不用安装’execjs’和’therubyracer’了。
当然这不是一个好办法
如果不注释，需要在Gemfile中添加

gem 'therubyracer'
gem 'execjs'

或者是安装一个Node.js
问题二：配置文件中hash的问题
ps:关于hash,因为工作原因，我本地既有ruby1.8又有ruby1.9
这个config/initializers/wrap_parameters.rb文件，如果是在ruby1.8.7中会出现如下错误：
syntax error, unexpected ':', expecting kEND (SyntaxError)
wrap_parameters format: [:json]
这个在ruby1.9.2环境中是没问题的
1.8环境下需要改成
wrap_parameters :format=>[:json]

另外session_store.rb这个文件中也会出现这个类似的问题：

syntax error, unexpected ':', expecting $end (SyntaxError)
...ion_store :cookie_store, key: '_project_name_session'

同理在1.9中没问题，1.8中要改成:key=>'_project_name_session'
上面这个问题突出的问题是：ruby1.8于ruby1.9在hash定义上出现的变化
#新的语法
h = { a: 1, b: 2 }#
#旧的语法
h = { :a=> 1, :b=>2 }# 返回{:a=>1, :b=>2}
1.9.2同时兼容以前1.8.7的写法
----------------------------------------------------------------------------
接下来继续做那个demo
首先做一下首页的显示
运行指令
rails g controller index
创建index的控制器以及其他代码
先写测试
在控制器的测试文件中添加
require 'test_helper'
class IndexControllerTest < ActionController::TestCase
test "access the index page" do
get :index
assert_response 200
end
end

运行，肯定跑不通，写代码来实现功能
删除public下面的index.html文件
配置以下路由，指定新的主页路径
root :to=>'index#index'

在IndexController中添加主页action
  class IndexController < ApplicationController
def index
end
end
在app/view/index/下面添加index.erb文件
运行rake test,显示错误
test_helper.rb:3:in `<class:TestCase>': undefined method `fixtures' for ActiveSupport::TestCase:Class (NoMethodError)
这是测试用例的问题
把test_helper.rb中调用测试用例的代码注释掉
# fixtures :all
再次运行测试rake test
IndexControllerTest
PASS test_access_the_index_page (0:00:00.334)
Finished in 0.335200 seconds.
1 tests, 1 passed, 0 failures, 0 errors, 0 skips, 1 assertions
访问主页成功
ps:上面的controller基本上跟mongo没啥关系，但是考到功能测试出现的这fixtures还是把这个放上来了
模型
创建一个名为user的model：执行命令
rails g model topic --skip-migration  --orm=mongo_mapper
orm这个参数如果不写，会出现这个错误
No value provided for required options '--orm'
执行完成之后显示生成的文件：
      invoke  mongo_mapper
create    app/models/user.rb
invoke    test_unit
create      test/unit/user_test.rb
create      test/fixtures/users.yml

如果不想每一次都写这个--orm
在config/application.rb中添加:
config.generators do |g|
g.orm :mongo_mapper
end

user.rb代码

class User
include MongoMapper::Document
key :name, String
key :age, Integer
end

user_test.rb代码
# encoding: utf-8
require 'test_helper'

class UserTest < ActiveSupport::TestCase
test "new user test" do
assert_equal User.count,0
assert_difference "User.count",1 do
User.create(:name=>"王华",:age=>18)
end
user = User.last
assert_equal user.name, "王华"
assert_equal user.age, 18
end


运行单元测试
rake test:units 发现错误
Errors running test:units!
查看堆栈得到信息

** Invoke test:units (first_time)
** Invoke test:prepare (first_time)
** Invoke db:test:prepare (first_time)
** Invoke environment (first_time)
** Execute environment
** Execute db:test:prepare
rake aborted!
Set config before connecting. MongoMapper.config = {...}


提示在链接之前先配置：
project_name$ script/rails generate mongo_mapper:config
create  config/mongo.yml

此配置文件的内容是：


development:
host: 127.0.0.1
port: 27017
database: project_name_development
test:
host: 127.0.0.1
port: 27017
database: project_name_test
# set these environment variables on your prod server
production:
host: 127.0.0.1
port: 27017
database: project_name
username: <%= ENV['MONGO_USERNAME'] %>
password: <%= ENV['MONGO_PASSWORD'] %>


rake test;units是没有问题了
UserTest
PASS test_new_user_test (0:00:00.333)
Finished in 0.469750 seconds.
1 tests, 1 passed, 0 failures, 0 errors, 0 skips, 4 assertions

另外还写了一个users_controller的增删该查以及它的测试，跟mysql关联的写法没有任何区别，完全一样。
测试项目源码地址
https://github.com/chinacheng/mongodb_project