Ruby On Rails-2.0.2源代码分析(2)-Routing的…

2008-04-02 02:31:02来源: 阅读 ()

新老客户大回馈,云服务器低至5折

前言

  在前一篇文章中,我大致的讲解了一下Rails的启动过程,并罗列了个人觉得比较核心的源代码进行分析,算是管中窥豹吧~在分析initializer.rb代码的时候,我说过“initializer.rb的介绍暂时结束”,因为我特意略过了初始化过程中一个十分相当非常重要的过程--Routing的载入。这里,我专门用这篇文章来讲解一下。
  Routing之于Rails就如同waiter(waitress)之于饭店。当你怀揣着这个月辛辛苦苦写软件得来的工资,来到一个上档次的饭店,如果没有门口的门生引领你到空闲的饭桌,上菜谱,点菜。。。恐怕哥们你只能一进门就甩着手中的票子大吼:给老子上两斤牛肉,一斤烧酒:)是的。当你通过浏览器指定到某一个Rails程序的URL时,Routing就跳了出来,通过分析,按照Rails内部的机制,指定相应的Controller,并执行上面相应的Action,于是,你得到服务了(小费就免了)~
  (关于Routing系统的具体机制,请参见《Agile Web Development with Rails 2nd》或者《The Rails Way》,里面有大把好的资料)

  •   Routing的载入

  好了,言归正传,在平日的开发中,我们很会很熟练的在/config/routes.rb中写类似如下的一些Routing信息(当然一些可以自动生成):
Ruby代码 复制代码
  1. ActionController::Routing::Routes.draw do |map|   
  2.   map.resources :comments  
  3.   
  4.   map.root :controller=>'posts'  
  5.   map.resources :posts  
  6.   map.resources :posts:has_many => :comments  
  7.   map.namespace :admin do |admin|    
  8.     admin.resources :posts    
  9.   end    
  10.   map.connect ':controller/:action/:id'  
  11.   map.connect ':controller/:action/:id.:format'  
  12.   ...   
  13. end  

下面,我将讲讲Routing这个如此重要的东东是如何被载入的。按照自己学习的方法,我仍然还是喜欢先整理一张关于Routing载入所执行源代码的执行顺序图。如下所示:
  请注意,由于Routing的载入仍然属于Rails启动阶段的工作,所以,我直接在上篇文章所用的代码执行顺序图的基础上进行了扩充(也删减了一些无关痛痒的部分),图中红色剪头表示Routing载入的相关执行代码。好了,下面,让我们稍微深入一点,详细看看每个代码文件到底都做了一些什么事情,来完成Routing的载入工作。

  environment.rb

  源代码路径:RAILS_ROOT/config/environment.rb
  此代码文件内容比较少,且十分容易理解,我先把代码整理贴出来:


Ruby代码 复制代码
  1. RAILS_GEM_VERSION = '2.0.2' unless defined? RAILS_GEM_VERSION   
  2.   
  3. # Bootstrap the Rails environment, frameworks, and default configuration   
  4. require File.join(File.dirname(__FILE__), 'boot')   
  5.   
  6. Rails::Initializer.run do |config|   
  7.   ...   
  8. end  


  第一行设置Rails Gem的版本,用于加载相应版本的Rails,第二行执行的代码通过载入boot文件达到启动rails的目的(此时Rails还未初始化)。好了,到了Rails::Initializer.run方法了,还记得我前篇文章提到的此方法吗?:)让我们再深入的看一看吧。

  initializer.rb

  源代码路径:gems/rails-2.0.2/lib/initializer.rb
  这次我们直接点,再来看看Initializer类的类方法run长什么样子:

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  


  在environment.rb中对run方法的调用,没有带任何参数,所以command是默认的:process(重要),configuration当然是重新生成一个新的配置类。当然,顺便提一下,这次的调用带了一个block,因此,第一行代码将Configuration实例yield出去,用户可以在environment.rb中对Rails的任何配置进行修改(尽管如此,我们需要修改的配置不会太多)。接下来,很直观的事,向initializer实例发送:process消息(调用process实例方法)。
  在initializer的process实例方法中,会做很多事情,我先用下表罗列出来,并附上简单描述。

方法名 描述
check_ruby_version 检测ruby的版本(最低版本为1.8.2。注意:不支持1.8.3)
set_load_path 设置装载路径
require_frameworks 载入Rails的其他组件(AR,AV...)
set_autoload_paths 设置Rails自动加载源代码文件的路径(包括load_once)
add_plugin_load_paths 设置插件的load_path
load_environment 载入环境(根据目前运行环境development/test/production,载入正确的*.rb)
initialize_encoding 初始化编码(默认UTF-8)
initialize_database 初始化数据库(给AR传递数据库配置)
initialize_logger 初始化日志记录程序
initialize_framework_logging 初始化各个组件(AR,AC,AM...)的日志记录程序
initialize_framework_views 分别初始化AM和AC的template根目录和view路径
initialize_dependency_mechanism 初始化依赖载入机制(这个以后将会详细谈到)
initialize_whiny_nils 初始化警告系统(在nil上调用某一个方法)
initialize_temporary_directories 初始化临时目录(为session,cache准备的目录)
initialize_framework_settings 初始化各个组件(通过send调用各个组件的setting方法)
add_support_load_paths 暂时未使用
load_plugins 载入插件
load_observers (以后有深入了解再记录)
initialize_routing 初始化Routing
after_initialize 调用用户提供的block(完成初始化后执行的block)
load_application_initializers 载入/config/initializers/目录下的所有.rb文件

当然,现在我主要关心表中黑体标出的initialize_routing方法,至于其他方法,感兴趣的同学们可以自己查看源代码,都十分简单易懂。下面,先来看看initialize_routing的内容

Ruby代码 复制代码
  1. def initialize_routing   
  2.   return unless configuration.frameworks.include?(:action_controller)   
  3.   ActionController::Routing.controller_paths = configuration.controller_paths   
  4.   ActionController::Routing::Routes.reload   
  5. end  


  第一,没有哪位同学用Rails不使用action_controller组件吧?呵呵。这里,我们暂时只用记住第三行执行代码Routes.reload,并且暂时先记住Routes是routing.rb中定义的一个RouteSet实例。那么。。。还等什么,到routing.rb里面去转转吧。

  routing.rb

  源代码路径:/actionpack-2.0.2/lib/action_controller/routing.rb (actionpack?Agile Web Development with Rails 2nd!嘿嘿)
  主角总算登场了,Routing可以算得上Rails当中最复杂的功能系统之一。此代码文件内容相当的多,首先,我先按照如何将大象放进冰箱的方法学,从一个很高的角度看一看,Rails是如何将Routing载入的(明显会比装大象的步骤多)。下面是一张很高层次的流程图:
 
  从这个层次来看,Routing的载入流程比较清晰,所做的工作无非就是首先判断是否需要载入,如需载入,则清空原来保存的所有信息,然后重新从config/routes.rb中载入所有Routing信息。现在,先将这幅大流程图保留在我们的脑海中,接下来,深入细节看看。routing.rb中内容较多,包含的类也较多,先来看一看此代码文件中包含类的类图:

  (为了直观起见,我只将个人认为核心的类描绘出来,并且只将与载入Routing相关的方法列了出来;从简洁的角度出发,我还省略了方法参数)
  Route类
  此类代表一个普通的Routing信息,例如“'test/:controller/show/:id/*spec',:action=>"show", :requirements => { :id =>/\d+/}, :conditions => { :method => :get }”。
  segments----代表一个routing信息中path('test/:controller/show/:id/*spec')的“片段”数组。前面那个示意routing信息的“片段”数组有类似如下信息:["/","test","/",":controller","/","show","/",":id","spec"]
  requirements----代表一个routing信息中的:requirements {:id => /\d+/}
  conditions----代表一个routing信息中的:conditions {:method=>:get}。注意,目前版本的conditions只支持:method。
  (此类还包括很多非常重要的实例方法,比如:识别一个请求应该调用哪个Controller和Action;如何通过link_to,redirect_to等生成一个URL,但是这里我主要讲Routing的加载,所以这部分内容留到以后再讲。)

  NamedRouteCollection类
  次类代表一个named routes集合。有些类似一个Hash,一个name对应着一组普通的route。

  RouteSet类
  还记得initializer.rb中的ActionController::Routing::Routes么?前面说了,他是一个RouteSet的实例。从类名就可以看出来,此类是一个Route的集合,他包括一个普通route的数组,还有一个named route的集合。就Rails框架而言,此类是Routing系统的对外接口,Rails框架的其他部分会通过他来载入route信息,识别请求路径,生成URL等等。此类有两个内部类Mapper和NamedRouteCollection。

  Mapper类
  就用户而言,此类是Routing系统的对外接口,我们会在config/routes.rb用如下代码增加routes信息:

Ruby代码 复制代码
  1. ActionController::Routing::Routes.draw do |map|   
  2.   map.connect ':controller/:action/:id'  
  3.   map.connect ':controller/:action/:id.:format'  
  4. end  


  block中的参数map就是一个Mapper类的实例,我们就是通过调用他的connect等实例方法增加route信息。Mapper类包含一个RouteSet类实例,其实Mapper类只是一个Wrapper而已,讲所有的调用操作都转发到了RouteSet类实例。

  RouteBuilder类
  此类是Rails内部使用的类,确切的说,是给RouteSet实例使用的类。此类用于将用户提供的所有route信息Build成一个个普通的Route对象(然后当然是存放在RouteSet的普通route数组中或者named routes集合中)。

  Segment类
  在讲Route类的时候,我提到了“片段”,这就是Segment类所抽象的东西。他是所有“片段”对象的父类。
  DynamicSegment类
  代表一个动态Segment,有两个子类,PathSegment和ControllerSegment。PathSegment表示Route globbing,ControllerSegment表示代表controller的片段。
  StaticSegment类
  代表一个静态Segment,有一个子类,DividerSegment,表示分隔符片段。
  相当抽象是吗?好了,那我们来看一个实际例子,你就会完全理解Segment了。例如,现在我们在config/routes.rb中定义了一个如下的route信息:
map.connect 'test/:controller/show/:id/*spec',:action=>"show", :requirements => { :id =>/\d+/}, :conditions => { :method => :get }
  当Rails框架通过map对象的connect方法调用后,会在内部将这个route分解为如下的Segment:

Segment类型
DividerSegment /
StaticSegment test
DividerSegment /
ControllerSegment :controller
DividerSegment /
StaticSegment show
DividerSegment /
DynamicSegment :id
DividerSegment /
PathSegment :spec
DividerSegment /
(注意,第一个和最后一个"/",尽管我们提供path的时候是没有的,但是Rails的Routing系统内部会自动加上的。)

标签:

版权申明:本站文章部分自网络,如有侵权,请联系:west999com@outlook.com
特别注意:本站所有转载文章言论不代表本站观点,本站所提供的摄影照片,插画,设计作品,如需使用,请与原作者联系,版权归原作者所有

上一篇:插件rquerypad, 简化查询参数 增强关联查询能力

下一篇:Ruby On Rails-2.0.2源代码分析(1)-Rails的启动