Ruby On Rails-2.0.2源代码分析（1）-Rails的启动

• 前言

  本文主要是针对Ruby On Rails 2.0.2的源代码进行分析，学习与研究。所使用的工具是NetBean 6.1 Beta，WEBRick，SciTE，ruby-debug-base（0.10.0），ruby-debug-ide（0.1.10）。Ruby版本为1.8.6。
  应该怎么分析总结，是开始最令人头痛的事，Ruby是面向对象的语言，从对象的层次记录吧，似乎一切都不那么直观，一个庞大的系统摆在眼前，整理一个类图，继承关系图。。。有点牛啃南瓜，无从下口的感觉。最后，决定打算从Ruby的本质-解释语言下手，从解释器的角度出发，跟着解释器的步伐，从细微入手，一步一步深入Rails，以达到从局部到整体，了解学习的目的。所以，最终，我决定从源代码执行顺序的角度去分析Rails。
  为方便起见，我直接使用NetBean的调试环境，使用Ruby自带的WEBRick，从接触Rails最基本的ruby script/server开始，首先来看Rails是怎么启动起来的。

• Rails的启动

  ruby script/server，应该是搞rails的同学们耳熟能详的命令了。server脚本主要执行两个的过程：1.启动Rails；2.启动web服务器（当然，我这里是启动WEBRick了）。我们就从这里入手，看看Rails是怎么样被启动起来的。
  前面我说过，我将从源代码执行顺序的角度去分析，所以，让我们先来看一看Rails启动时，核心源代码的执行顺序，具体见下图（为了使得分析简单明了，抓住关键本质所在，我只把个人认为与启动有关的源代码列出来，执行过程中，其他类似关于ActiveSupport中关于core的extension之类的代码就不列出）：

  boot.rb

  源代码路径：RAILS_ROOT/config/boot.rb
  这个代码文件是Rails的启动入口，完成的功能是：首先判断Rails是否启动，如果未启动则先执行一个“预初始化”（preinitialize）过程，然后选择一种启动方式（Vendor/Gem），执行相应类上的run方法。主方法boot!代码如下：

Ruby代码  

1. def boot!  
2.   unless booted?  
3.     preinitialize  
4.     pick_boot.run  
5.   end  
6. end  

  其中，与初始化过程是执行RAILS_ROOT/config目录下面的preinitializer.rb（如果存在的话）。这个过程的目的是在加载environment.rb文件执行执行一些初始化工作。参见：http://yudionrails.com/2008/1/7/what-s-new-in-edge-rails-pre-environment-load-hook。此源代码中包含一个module Rails，此模块下面包括三个类：VendorBoot，GemBoot，他们都继承自Boot类，分别代表是通过Vendor还是Gem的方式启动Rails（如果RAILS_ROOT/vender/下面存在名为rails的目录，则以Vendor方式启动Rails，否则，从Gem启动Rails）。当使用Gem方式启动Rails的话，还有一个重要的功能就是判断加载哪个版本的Rails，当然，正如我们所知，environment.rb中的RAILS_GEM_VERSION起了作用。总得来说，boot代码逻辑较简单，没有什么费解的东西，下面给出这个文件的整个执行逻辑流程图：

initialize.rb

  源代码路径：gems/rails-2.0.2/lib/initializer.rb (Gem方式启动）
                    RAILS_ROOT/vendor/rails/railties/lib/initializer.rb（Vendor方式启动）
  虽然两种不同启动方式执行的源代码不同，但是他们完成的功能都大同小异，都对Rails执行必要的配置以及初始化。我们先来看看上一步--执行boot.rb代码的最后一步（还记得pick_boot.run么？），具体代码如下：

 

Ruby代码  

1. class Boot  
2.   def run  
3.     load_initializer  
4.     Rails::Initializer.run(:set_load_path)  
5.   end  
6. end  

当完成了选择一个boot方式后，会执行相应Boot对象的run方法，那么run方法首先载入初始化器，VendorRoot通过如下方式载入：

Ruby代码  

1. class VendorBoot < Boot  
2.   def load_initializer  
3.     require "#{RAILS_ROOT}/vendor/rails/railties/lib/initializer"  
4.   end  
5. end  

GemRoot通过如下方式载入：

Ruby代码  

1. class GemBoot < Boot  
2.   def load_initializer  
3.     self.class.load_rubygems  
4.     load_rails_gem  
5.     require 'initializer'  
6.   end  
7.   ...  
8. end  

OK。初始化器载入完成，Boot的run方法立即执行初始化器对象的类方法run，注意这里的run方法参数是:set_load_path符号。好了，下面，我们可以深入到initialize.rb里面去看个究竟了。  initialize.rb中定义了一个module Rails，其中包括了此代码文件中最重要的两个类：Configuration和Initializer。从类名我们就可以很清晰的了解到，Initializer类完成Rails的初始化工作，当然这个过程需要各种各样的配置，参数，这些则由Configuration提供。那么首先来看看Configuration提供了Rails所需的哪些配置参数，详见下表：

配置名（accessor名）具体描述frameworks会被载入的Rails框架组件列表，会包括action_controller，action_view等load_paths附加的load路径列表，app/controller;app/models等Rails项目下的目录load_once_pathsRails只会load一次的目录，似乎目前版本的Rails未用到这个参数log_path日志文件的路径，根据目前的环境（development，test，production）决定log_levelRails日志器的日志级别（info，debug）view_pathview的目录路径，默认路径是app/view了controller_pathscontroller的目录路径，默认路径是app/controllercache_classes是否对类进行缓存。目前未使用（一直是false）whiny_nilstrue/false，当设置为true的话，当你在Rails中调用一个nil方法的时候，将会得到警告plugins载入的插件列表，默认为空plugin_paths插件路径，默认是RAILS_ROOT/vendor/plugins目录plugin_locators插件的定位器，默认是Plugin::FileSystemLocatorplugin_loader插件的载入器，默认是Plugin::Loaderdatabase_configuration_file数据库配置文件，默认位于RAILS_ROOT/config/database.yml

  绕了一圈，现在让我们回到Initializer类的run方法（由boot.rb调用：Rails::Initializer.run(:set_load_path)），十分简单：

Ruby代码  

1. def self.run(command = :process, configuration = Configuration.new)  
2.   yield configuration if block_given?  
3.   initializer = new configuration  
4.   initializer.send(command)  
5.   initializer  
6. end  

现在我们姑且不管block（boot.rb调用他的时候确实也没有关联一个block），接下来的工作是生成一个新的Configuration对象，并赋给Initializer的构造函数(然后由Initializer对象保存该配置对象)，然后执行initializer上的command方法，默认情况是执行process方法，这里通过boot.rb的调用，将执行set_load_path方法。在这里值得注意的是，新生成的Configuration对象的所有配置参数都是默认值，例如：frameworks参数通过如下方法得到默认值：

Ruby代码  

1. def default_frameworks  
2.   [ :active_record, :action_controller, :action_view, :action_mailer, :active_resource ]  
3. end  

controller_path参数通过如下方法得到默认值：

 

Ruby代码  

1. def default_controller_paths  
2.   paths = [File.join(root_path, 'app', 'controllers')]  
3.   paths.concat builtin_directories  
4.   paths  
5. end  

其实，所有的这些配置都不是定死的，我们可以在enviroment.rb中重新定义他们，象下面这样：

Ruby代码  

1. Rails::Initializer.run do |config|  
2.   config.frameworks -= [ :active_record, :active_resource, :action_mailer ]  
3.   config.plugins = [ :exception_notification, :ssl_requirement, :all ]  
4.   ...  
5. end  

到这里，initializer.rb的介绍暂时结束，只是简单的执行了set_load_path方法设置load路径。接下来，执行流程回到了script/server:

Ruby代码  

1. require File.dirname(__FILE__) + '/../config/boot'  
2. require 'commands/server'  

该执行第二句了，下面轮到server.rb出场了。

  server.rb

源代码路径：gems/rails-2.0.2/lib/commands/server.rb
  server.rb主要完成两个功能：1.加载active_support；2.加载web服务器。
  加载active_support十分简单，只是通过源代码开始的第一句：

Ruby代码  

1. require 'active_support'  

加载web服务器相比复杂一些。首先，Rails会试图加载FastCGI，然后会试图加载mongrel，如下代码所示：

Ruby代码  

1. begin  
2.   require_library_or_gem 'fcgi'  
3. rescue Exception  
4.   # FCGI not available  
5. end  
6.   
7. begin  
8.   require_library_or_gem 'mongrel'  
9. rescue Exception  
10.   # Mongrel not available  
11. end  

最终，会通过defined?(Mongrel)和defined?(FCGI)来决定使用哪种服务器。当然，本文前面提到了将使用WEBRick作为web服务器，这里最终加载的服务器当然是webrick。server.rb的最后一句代码： 

Ruby代码  

1. require "commands/servers/#{server}"   

在这里#{server}当然是webrick了，所以，接下来执行的将是webrick.rb

  webrick.rb

源代码路径：gems/rails-2.0.2/lib/commands/servers/webrick.rb
  webrick.rb完成如下几个主要功能：1.加载Ruby自带的webrick库；2.加载environment.rb；3.加载webrick_server.rb；4.执行DispatchServlet（在webrick_server.rb中定义）的类方法dispatch。整个过程都是顺序完成的，所以，示意的源代码可以如下所示：

Ruby代码  

1. require 'webrick'  
2. require RAILS_ROOT + "/config/environment"  
3. require 'webrick_server'  
4. DispatchServlet.dispatch(OPTIONS)  

  environment.rb

  源代码路径：RAILS_ROOT/config/environment.rb
  回到了我们熟悉的environment.rb中，在这里我们可以对Rails运行的环境进行配置，这里不做过多阐述，可以参与相关Rails文档。

  webrick_server.rb

源代码路径：gems/rails-2.0.2/lib/webrick_server.rb
  这是Rails启动所执行的最后一个源代码文件。我前面提到了一点，此源代码文件中定义了DispatchServlet，这是一个自定义的dispatch servlet，用于将浏览器的请求dispatch到相应的controller，action上。因为这里我只打算介绍Rails的启动，所以，我们只用关注如下的代码即可：

Ruby代码  

1. class DispatchServlet < WEBrick::HTTPServlet::AbstractServlet  
2.   
3.   # Start the WEBrick server with the given options, mounting the  
4.   # DispatchServlet at <tt>/</tt>.  
5.   def self.dispatch(options = {})  
6.     Socket.do_not_reverse_lookup = true # patch for OS X  
7.   
8.     params = { :Port        => options[:port].to_i,  
9.                :ServerType  => options[:server_type],  
10.                :BindAddress => options[:ip] }  
11.     params[:MimeTypes] = options[:mime_types] if options[:mime_types]  
12.   
13.     server = WEBrick::HTTPServer.new(params)  
14.     server.mount('/', DispatchServlet, options)  
15.   
16.    trap("INT") { server.shutdown }  
17.     server.start  
18.   end  
19. end  

这是一个经典的启动WEBRick服务器的方式，不用过多阐述，可以参考webrick的相关文档。当然，webrick_server.rb文件中还有一个相当重要的类CGI，并且，DispatchServlet类中还有一些重要的方法，我们暂时可以将他们搁在一旁。以后进一步分析Rails的时候再讲解。  OK。至此，Rails就正式上马了，web服务器也启动起来了，接下来的事情，当然是等着web服务器将request转发给Rails进行处理了，按照国际惯例，这当然是下文分解的事了~

转载至：http://www.iteye.com/topic/170683