第一个Rails应用
Rails是一个“模型-视图-控制器”框架(MVC)。是用Ruby写的,所以要对Ruby要有一定的了解才能对rails框架深入学习。其实Ruby与Rails就像是python与flask框架,而且ruby和python都是脚本语言,相似处很多。
Rails接受来自浏览器的请求,通过解析请求确定对应的控制器,然后调用控制器中的对应方法,方法可能会到模型中请求数据,然后控制器调用对应视图把结果显示给用户。
跑通第一个rails的demo程序很简单,安装好rails后,执行rails new demo
: 查看一下生成的相应文件:
由于在开发环境和生产环境用得数据库可能不一样,开发环境的数据库一般默认为sqlite3.我们可以通过执行rails new demo -skip-active-record
,使得不会默认创建database.yml和sqlite3了。我们随后可以通过引入新的gem包去指定我们需要的数据库类型,不过这都是后面才要讲的。
我们先启动rails应用:rails server
或者简写为rails s
:
在浏览器中访问:localhost:3000
,出来的界面如果是下面的,就说明rails应用成功启动了:
如果想让同一网络中的其他设备也能访问Web服务器,则可以把绑定的主机指定为0.0.0.0:
rails s -b 0.0.0.0
Rails应用的目录结构
先不对默认的rails应用进行修改,之前通过rails new
生成了一堆文件,我们可以从这部分分析,即rails的应用目录结构。
app/
app 目录是你主要工作的地方,不同子目录存放了 Models、Controllers、Views、Helpers 和 Assets 等档案。
app/controllers
Controller 存放在这里
app/models
Model 存放在这里
app/views
View 的样本(template)文件,依照不同 Controllers 分子目录存放。
app/helpers
Helper 一些在 Views 中可以使用的小方法,用来产生较复杂的 HTML。默认的 Helper 档案命名是对应 Controller 的,不过并不强制,定义在任一个 Helper 档案中的方法,都可以在任何 Views 中使用。
app/assets
Assets 静态档案存放在这里,包括有JavaScript、Stylesheets样式表和Images图档。详细的用法会在Assets一章中介绍。
config/
虽然 Rails 的原则是惯例优于设定,不过还是有一些需要设定的地方。这个目录下存放了例如数据库设定档 database.yml、路由设定 routes.rb、应用程式设定档 application.rb 和不同执行环境的设定档在 config/environments 目录下。
db/
数据库 Schema(纲要) 和定义档 migrations
lib/
lib目录可以用于存放模型、视图和控制器之外的应用代码,如果你有一些共享的类别或模版文件,可以放在这里,然后用require加载。例如一个放在lib/foobar.rb的类别或模组档案,可以在要使用的.rb档案中这样加载:
require "foobar"
如果放在子目录lib/foo/bar.rb的话:
require "foo/bar"
当然文件不能散乱的放在lib目录中,可以创建子目录来把相关功能整合在一起。在Rails5中需要通过在config/application.rb文件中添加下列代码来加载一下:
config.autoload_path += %W(#{Rails.root}/lib)
一旦加载过后,如果文件中定义了类或模块的小写形式,rails会自动加载文件。比如lib/hello_world墓冢有一个hello.rb文件,只要类的名称是 HelloWorld::Hello
,Rails就能自动找到并加载它。
lib/tasks
Rake 任务文件存放在这里,Rake一般是小脚本文件,后面我们会介绍。
log/
不同执行环境的 log 档案会分别记录在这里。日志不仅包含跟踪信息,还包含时序统计、缓存信息和数据库语句的执行时长。也可以通过引入新的log gem包来输出你想要的格式。
public/
这个目录对 Web 服务器来说,就是文件根目录(document root),也就是唯一可以在网络上读取到的目录。
bin/
Rails 的脚本文件,例如执行bin/rake。
test/
单元测试、功能测试及整合测试的文件。如果是不加自己的测试框架,则就将所有的test写在这里;如果用了框架诸如rspec,则会另外生成一个spec
的文件夹。
tmp/
. 用来存放暂时用途的文件
vendor/assets
可将第三方的CSS/JavaScript函式库(没有提供Gem安装版本的)复制一份放在这里。
其他根目录下的档案:
config.ru 是用于配置Rack Web服务器接口,在Rails应用中负责创建Rails Metal应用或使用Rake中间件。
Gemfile 设定你的 Rails 会使用哪些 Gems
Gemfile.lock用于记录Rails应用中用到的gem包的具体版本号,由Bundler维护。
README.md 使用手册,用过github的一定很熟悉。
Rakefile 用来加载可以被命令列执行的 Rake 任务
Rails的Hello World
从一个Hello World来写吧。
由于只是输出到浏览器界面上,所以这部分并不需要"模型"的加入,暂时不涉及CRUD部分,所以我们先写控制器和相应的视图就行了。
我们想通过请求http://localhost:3000/say/hello
来输出hello world。为什么是这个链接?当然可以不是这个链接,但是这是rails中控制器的最基本路由和请求url之间的关系,放到以后的"路由部分"说。我们现在可以这样理解,不管链接形式是怎样的,如果我们想访问hello world的页面,最后一定会重定向到http://localhost:3000/say/hello
这个链接。
这个链接的特殊地方http://localhost:3000/say/hello
,事实上在于通过请求先访问say这个控制器,然后访问say控制器中的hello方法。我们通过rails generate controller Say hello
生成控制器和相应的hello方法。
rails generate自动帮我们生成了和Say这个控制器相关的视图文件和测试文件和帮助文件,在app/controllers中也生成了相应的say_controller.rb文件:
class SayController < ApplicationController def hello endend
如果我们想增加一个方法直接写也可以,比如我们可以增加一个访问链接http://localhost:3000/say/goodbye
,可以直接增加一个goodbye方法:
class SayController < ApplicationController def hello end def goodbye endend
但是一些视图文件和测试文件需要手动添加了,在config/routes.rb中也需要增加相应的路由选项。这个可以看成是优点也可以看成是缺点。
我们在视图文件app/views/say/hello.html.erb中,其实就是rails中的html文件,写hello,world:
Hello World!
然后跑一下程序:rails s
,然后访问http://localhost:3000/say/hello
:
相应的创建一个goodbye.html.erb然后写入想显示的内容就可以直接通过访问:../say/goodbye看到了。
以上只是静态界面,让我们写一个从控制器传入的字符串的动态界面:
hello.html.erb:Hello World!
<%= @name %>
It is <%= @time %> .
<%= "It is #{@time} " %>
在控制器say_controller.rb中加入:
class SayController < ApplicationController def hello @name = "yun" @time = Time.now endend
生成的结果如下:
在hello.html.erb中用了两种写法来显示时间,其中<%= .. %>
是erb系统处理模版文件中可以嵌入ruby代码,即视图和控制器进行联系的一个语法。
由于web应用通常是一个多页面应用,所以只展示一个页面是不够的。一般来说,应用中的每个页面都对应单独的视图,但是我们可以通过新动作(方法)来处理新页面,同时继续使用原有动作的控制器。正如我们之前增加goodbye方法一样,呢么现在的问题就是如何将两个页面联系起来,我们只需要在hello页面上增加一个指向goodbye页面的链接就行了。Rails按照预定会把url地址解析为目标控制器及动作。通过link_to()
方法创建指向goodbye()的链接。调用link_to()
方法时,第一个参数是超链接的文本,第二个参数是rails生成的执行goodbye()动作的超链接。
所以可以通过link_to "Goodbye", say_goodbye_path
增加跳转到goodbye页面的超链接。这里的say_goodbye_path
是指say/goodbye的路径,在路由部分进行详细介绍。所以hello.html.erb文件可以改写为:
Hello World!
<%= @name %>
It is <%= @time %> .
<%= "It is #{@time} " %><%= link_to "Goodbye", say_goodbye_path %>
最后的效果如下:
Rails的信条
Rails信条是一套编程与程序员本身的思想集合,具体的可以参见