Ruby on rails 实战圣经:Rails起步走

作者: raosheng1993
发布时间:2015-07-13 11:17:09


Rails起步走
There are two ways of constructing a software design: One way is to make it so simple that there are obviously no deficiencies and the other way is to make it so complicated that there are no obvious deficiencies. - C.A.R. Hoare,
在这一章中,我们将开始介绍如何建立一个最简单的Hello, World!程序,以及用最快速的方式制作CRUD应用。
CRUD指的是Create(新增)、Read(读取)、Update(更新)、Delete(删除)四种操作数据的基本方式。
在上一章安装Rails后,你会在命令行中得到一个rails的指令,这个指令可以初始一个Rails项目目录。
开始建立第一个Rails应用程序
首先请打开一个命令行窗口(Terminal),然后找个目录适合放你的Rails项目,就说是projects好了:
$ mkdir projects
$ cd projects
接着,输入以下指令就会建立一个叫做demo的Rails项目:
$ rails new demo
如果出现建立出来的目录不是demo而是new,表示你的Rails版本是旧版的,请输入rails -v检查Rails的版本必须是3.0以上。不是的话,请回上一章末执行gem install rails安装Rails 3。
你会看到以下讯息显示出总共新增了哪些文件:
  create 
  create  README
  create  Rakefile
  create  config.ru
  create  .gitignore
  create  Gemfile
  create  app
  ...(略)...
  create  vendor/plugins
  create  vendor/plugins/.gitkeep
这样就建立出demo目录,让我们继续:
$ cd demo
这个目录下包含了一个Rails项目基本会用到的目录结构和文件,让我们简单走访一下,输入ls(Windows读者请输入dir)显示出此目录下的文件:
文件/目录 用途
Gemfile 设定Rails应用程序会使用哪些Gems套件
README 项目说明:你可以用来告诉其他人你的应用程序是做什么用的,如何使用等等。
Rakefile 用来加载可以被命令行执行的一些Rake任务
app/ 放Controllers、Models和Views文件,接下来的内容主要都在这个目录。
config/ 应用程序配置文件、路由规则、数据库设定等等
config.ru 用来启动应用程序的Rack服务器配置文件
db/ 数据库的结构纲要
doc/ 用来放你的文件
lib/ 放一些自定的Module和类别文件
log/ 应用程序的Log记录档
public/ 唯一可以在网络上看到的目录,这是你的图档、JavaScript、CSS和其他静态文件摆放的地方
script/ 放rails这个指令和放其他的script指令
test/ 单元测试、fixtures及整合测试等程序
tmp/ 暂时性的文件
vendor/ 用来放第三方程序代码外挂的目录
启动服务器
Rails使用了一套叫做Bundler的工具可以帮助我们检查及安装这个Rails应用程序所有依存的套件,请输入:
$ bundle install
可以只输入bundle就是bundle install了。 每次有修改Gemfile这个文件,都需要重新执行bundle
会出现
Fetching source index for http://rubygems.org/
...
Your bundle is complete! Use `bundle show [gemname]` to see where a bundled gem is installed.
在开发用的计算机上,我们不需要安装如Apache、IIS的网站服务器。Ruby本身就有提供了HTTP服务器可以执行Rails,要启动它,我们另开启一个指令窗口,cd进到刚刚建立的Rails项目目录然后输入rails server:
$ cd projects/demo
$ rails server
就会出现以下讯息:
=> Booting WEBrick
=> Rails 3.2.8 application starting in development on http://0.0.0.0:3000
=> Call with -d to detach
=> Ctrl-C to shutdown server
[2012-09-30 04:23:28] INFO  WEBrick 1.3.1
[2012-09-30 04:23:28] INFO  ruby 1.9.3 (2012-04-20) [x86_64-darwin12.1.0]
[2012-09-30 04:23:28] INFO  WEBrick::HTTPServer#start: pid=18615 port=3000
rails server 可以简写为 rails s
使用Ubuntu操作系统的朋友,如果启动服务器时出现Could not find a JavaScript runtime的错误,请编辑Gemfile这个文件加上一行gem 'therubyracer',输入bundle install安装这个套件,然后再启动一次rails server即可。这是因为在Ubuntu操作系统上默认没有任何JavaScript直译器可以给Rails使用。你可以装Node.js或是安装therubyracer这个Ruby套件来获得JavaScript直译器。
接着打开你的浏览器前往http://localhost:3000,我们可以看到Rails的默认首页。这个Welcome Aboard的画面可以确认设定无误,点选About your application’s environment超链接可以看到更多环境信息。
 
要中断服务器的话,请按Ctrl+C(若不灵光请改试Ctrl+Z)。在development开发模式的话,除了修改config或vender目录下的文件需要重新启动之外,其他修改通常不需要重新启动,修改的文件会自动重载。如果是production正式上线模式的话,修改任何文件都必须重新启动服务器才会有效果。
第一个Hello World!!
让程序说Hello World!可是我们学写程序的一大传统。我们提过Rails是MVC框架,显示Hello World!不需要用到数据库,所以我们只要先写Controller和View,以及让路由指派到这个Controller即可,输入以下指令就会产生出一个叫做welcome的空Controller文件:
$ rails generate controller welcome
可以简写为rails g controller welcome
接下来在路由文件config/routes.rb新增一行设定:
Demo::Application.routes.draw do
    get "welcome/say_hello" => "welcome#say"
    # ...
end
get这一行的意思是将http://localhost:3000/welcome/say_hello这样的网址对应到welcome Controller的say Action。
编辑app/controllers/welcome_controller.rb,加入一个say方法:
class WelcomeController < ApplicationController
    def say
    end
end
如果您使用Ruby 1.9系列,如果程序中有UTF-8字符,例如中文字,那么在文件开头第一行必须加上# encoding: utf-8。不然会有invalid multibyte char (US-ASCII)的例外错误。
在Controller中,一个公开函式(public method)就代表一个Action,一个Action对应一个HTTP的请求和响应。接着我们打开浏览器浏览http://localhost:3000/welcome/say_hello,你会看到一个错误如下:
Template is missing

Missing template welcome/say, application/say with {:handlers=>[:erb, :builder], :formats=>[:html], :locale=>[:en, :en]}. Searched in: * "/Users/ihower/rails/rails31/app/views"
这是因为我们还没有准备好View文件。请新增app/views/welcome/say.html.erb这个文件,依照惯例目录名就是Controller名称、文件名是Action名称,第一个附档名说明了这是HTML格式的文件,第二个附档名说明这是ERb样板(我们会在View一章仔细介绍样板)。编辑该文件内容如下:
<h1>Hello, World!</h1>
这时再重新整理一次浏览器,你就会看到Hello, World!了。
让我们再新增一个页面并加入超链接吧,再次编辑路由文件config/routes.rb加入一个路由:
get "welcome" => "welcome#index"
这一行的意思是将http://localhost:3000/welcome这样的网址对应到welcome Controller的index Action。
编辑app/controllers/welcome_controller.rb加入
def index
end
新增app/views/welcome/index.html.erb内容是
<p>Hola! It's <%= Time.now %></p>
<p><%= link_to 'Hello!', welcome_say_hello_path %></p>
Time是Ruby内建的时间类别,Time.now会输出目前时间。link_to是Rails内建的方法可以输出超链接,而welcome_say_hello_path会输出/welcome/say_hello这个网址。这种出现在View中的辅助方法统称作Helper。浏览http://localhost:3000/welcome,将看到Hola!及Hello!超链接。
 
设定首页
如何将网站首页变更为welcome#index呢? 首先,我们将public/index.html这个文件移除,这是因为Rails会优先回传任何public目录下的静态文件。接着编辑config/routes.rb打开以下的程序代码:
root :to => "welcome#index"
Ruby的单行批注是用#井号
这一行的意思是,将网站根目录导引至welcome Controller的index Action。那在View中要怎么建立回首页的链接呢?编辑app/views/welcome/say.html.erb加入:
<p><%= link_to "Home", root_path %></p>
设定及建立数据库
操作数据库是动态网站非常基本的功能,在撰写CRUD应用程序之前,我们必须先设定好数据库。Rails的数据库配置文件是config/database.yml,如果你打开这个文件,默认的设定是SQLite3。这个文件里包含三段不同环境的设定,对应到三个Rails执行环境:
• development开发模式,用在你的开发的时候
• test测试模式,用在执行自动测试时
• production正式上线模式,用在实际的上线运作环境
设定SQLite3数据库
Rails内建支持SQLite3这是一套非常轻量的非服务器型数据库程序,它的数据库就只是一个文件而已。流量大的正式上线环境虽然不适合SQLite,不过拿来开发和测试却非常好用。Rails默认也使用SQLite3数据库来建立新的项目,以下是默认的设定数据config/database.yml:
# SQLite version 3.x
#   gem install sqlite3
development:
  adapter: sqlite3
  database: db/development.sqlite3
  pool: 5
  timeout: 5000

# Warning: The database defined as "test" will be erased and
# re-generated from your development database when you run "rake".
# Do not set this db to the same as development or production.
test:
  adapter: sqlite3
  database: db/test.sqlite3
  pool: 5
  timeout: 5000

production:
  adapter: sqlite3
  database: db/production.sqlite3
  pool: 5
  timeout: 5000
中间那段批注告诉你不要把test数据库设成跟production或development同一个
本书接下来也都使用SQLite3数据库,因为它完全不需要什么设定就可以使用。
YAML格式严格要求缩排(建议为两个空白),且冒号后面必须有一个空隔。一般我们会预期YAML的值解析出来是字符串,因此碰上值是数字或多行内容时,建议加上引号避免字符串解析错误。例如password: "123456"。如果没有加上引号,这串数字会被解析成Fixnum对象而不是字符串String。
建立数据库
数据库设定好了,输入以下的指令可以让Rails建立出空的数据库:
$ bundle exec rake db:create
这将在db/目录下建立出development和test的SQLite3文件。
Rake是一种Ruby的命令行工具,你可以输入rake -T列出所有可用的指令。我们会在稍后的章节中详细介绍Rake。
你的第一个CRUD程序
Rails的scaffold鹰架功能会自动产生一组Model、Views跟Controller程序代码,完成一个简易的CRUD程序以供展示及学习之用。请输入:
$ rails g scaffold person name:string bio:text birthday:date
产生的文件简单说明如下,注意到Model的名称是用单数person,而Controller照RESTful惯例是用复数people:
db/migrate/20110517161435_create_people.rb 用来建立people数据库数据表的Migration(你的文件开头名称会有不同的时间)
app/models/person.rb person model文件
test/fixtures/people.yml 用来测试的假文章数据
app/controllers/people_controller.rb people controller文件
app/views/people/index.html.erb 用来显示所有文章的index页面
app/views/people/edit.html.erb 用来编辑文章的页面
app/views/people/show.html.erb 用来显示特定一篇文章的页面
app/views/people/new.html.erb 用来新增文章的页面
app/views/people/_form.html.erb 用来显示编辑和新增文章的窗体局部(Partial)样板
app/helpers/people_helper.rb 可在文章Views中使用的Helper方法
test/unit/person_test.rb people model的单元测试
test/functional/people_controller_test.rb people controller的功能测试
test/unit/helpers/people_helper_test.rb people helper的单元测试
config/routes.rb 设定URL路由规则的文件,scaffold再此新增了一行resources :people
app/assets/stylesheets/scaffold.css.scss Scaffold鹰架提供的样式文件
app/assets/stylesheets/people.css.scss people的CSS样式文件
app/assets/javascripts/people.js.coffee people的JavaScript文件
虽然鹰架(scaffolding)可以帮助你快速上手,但是可没办法产生出完美符合需求的程序代码。因此有经验的Rails程序设计师甚少使用默认的鹰架产生程序代码,而是偏好使用Rails的generator来分别产生Model和Controller文件,甚至客制出自己专属的scaffold程序。
scaffold产生出来的程序中,有一项是数据库迁移档(database migration)。Migration的用途是建立和修改数据库数据表。Rails使用rake指令来执行Migrations。Migration的档名中包含了Timestamp(时间戳章),用来确保它们可以依照建立时间依序执行。
请输入以下指令执行Migration:
$ bundle exec rake db:migrate
Rails这时会建立people数据表:
==  Createpeople: migrating ====================================================
-- create_table(:people)
   -> 0.0019s
==  Createpeople: migrated (0.0020s) ===========================================
因为默认是跑在development模式,这个指令会用config/database.yml设定里的development那段所指定的数据库。
浏览http://localhost:3000/people就可以操作了,十分神奇吧。不过,这里就不详细说明其产生出来的程序代码了,读者读毕稍后章节后,自会明白。
 
常见错误
NoMethodError
NoMethodError非常明显,就是你打错方法了,例如此例中把link_to打成link_too。根据错误讯息你应该可以很容易找到是哪个文件在哪一行。
 
NameError
NameError也很明显,读取一个不存在的局部变量会出现以下错误:
 
SyntaxError: unexpected $end
SyntaxError加上unexpected $end, expecting keyword_end的话,那一定是你少了(或多了)end关键词,def跟do都必须要有对应的end。不过很可惜Rails没办法提示你是那一行少了(或多了)end,发生错误的行数都会告诉你是最后一行。如果真的不太好找,你可以单独用ruby -w去执行发生错误的程序,例如ruby -w app/controller/welcome_controller,这会打开Ruby的警告模式来获得更准确的语法错误讯息。
 
invalid multibyte char (US-ASCII)
最后这个是Ruby 1.9才会有的情况:invalid multibyte char (US-ASCII),表示你在原始码里面有UTF-8字符(例如中文),你必须宣告以下批注在档首就可以解决这个问题,当然你的文件单元格式必须是正确的UTF-8(无BOM记号):
# encoding: utf-8
 

版权声明:本文为博主原创文章,未经博主允许不得转载。

来源:http://blog.csdn.net/raosheng1993/article/details/45437797

推荐: