Ruby On Rails-2.0.2源代码分析(2)-Routing的…
2008-04-02 02:31:02来源: 阅读 ()
在前一篇文章中,我大致的讲解了一下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的载入
- ActionController::Routing::Routes.draw do |map|
- map.resources :comments
- map.root :controller=>'posts'
- map.resources :posts
- map.resources :posts, :has_many => :comments
- map.namespace :admin do |admin|
- admin.resources :posts
- end
- map.connect ':controller/:action/:id'
- map.connect ':controller/:action/:id.:format'
- ...
- end
ActionController::Routing::Routes.draw do |map| map.resources :comments map.root :controller=>'posts' map.resources :posts map.resources :posts, :has_many => :comments map.namespace :admin do |admin| admin.resources :posts end map.connect ':controller/:action/:id' map.connect ':controller/:action/:id.:format' ... end
下面,我将讲讲Routing这个如此重要的东东是如何被载入的。按照自己学习的方法,我仍然还是喜欢先整理一张关于Routing载入所执行源代码的执行顺序图。如下所示:
请注意,由于Routing的载入仍然属于Rails启动阶段的工作,所以,我直接在上篇文章所用的代码执行顺序图的基础上进行了扩充(也删减了一些无关痛痒的部分),图中红色剪头表示Routing载入的相关执行代码。好了,下面,让我们稍微深入一点,详细看看每个代码文件到底都做了一些什么事情,来完成Routing的载入工作。
environment.rb
源代码路径:RAILS_ROOT/config/environment.rb
此代码文件内容比较少,且十分容易理解,我先把代码整理贴出来:
- RAILS_GEM_VERSION = '2.0.2' unless defined? RAILS_GEM_VERSION
- # Bootstrap the Rails environment, frameworks, and default configuration
- require File.join(File.dirname(__FILE__), 'boot')
- Rails::Initializer.run do |config|
- ...
- end
RAILS_GEM_VERSION = '2.0.2' unless defined? RAILS_GEM_VERSION # Bootstrap the Rails environment, frameworks, and default configuration require File.join(File.dirname(__FILE__), 'boot') Rails::Initializer.run do |config| ... end
第一行设置Rails Gem的版本,用于加载相应版本的Rails,第二行执行的代码通过载入boot文件达到启动rails的目的(此时Rails还未初始化)。好了,到了Rails::Initializer.run方法了,还记得我前篇文章提到的此方法吗?:)让我们再深入的看一看吧。
initializer.rb
源代码路径:gems/rails-2.0.2/lib/initializer.rb
这次我们直接点,再来看看Initializer类的类方法run长什么样子:
- def self.run(command = :process, configuration = Configuration.new)
- yield configuration if block_given?
- initializer = new configuration
- initializer.send(command)
- initializer
- end
def self.run(command = :process, configuration = Configuration.new) yield configuration if block_given? initializer = new configuration initializer.send(command) initializer 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的内容
- def initialize_routing
- return unless configuration.frameworks.include?(:action_controller)
- ActionController::Routing.controller_paths = configuration.controller_paths
- ActionController::Routing::Routes.reload
- end
def initialize_routing return unless configuration.frameworks.include?(:action_controller) ActionController::Routing.controller_paths = configuration.controller_paths ActionController::Routing::Routes.reload 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信息:
- ActionController::Routing::Routes.draw do |map|
- map.connect ':controller/:action/:id'
- map.connect ':controller/:action/:id.:format'
- end
ActionController::Routing::Routes.draw do |map| map.connect ':controller/:action/:id' map.connect ':controller/:action/:id.:format' 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 | / |
标签:
版权申明:本站文章部分自网络,如有侵权,请联系:west999com@outlook.com
特别注意:本站所有转载文章言论不代表本站观点,本站所提供的摄影照片,插画,设计作品,如需使用,请与原作者联系,版权归原作者所有
IDC资讯: 主机资讯 注册资讯 托管资讯 vps资讯 网站建设
网站运营: 建站经验 策划盈利 搜索优化 网站推广 免费资源
网络编程: Asp.Net编程 Asp编程 Php编程 Xml编程 Access Mssql Mysql 其它
服务器技术: Web服务器 Ftp服务器 Mail服务器 Dns服务器 安全防护
软件技巧: 其它软件 Word Excel Powerpoint Ghost Vista QQ空间 QQ FlashGet 迅雷
网页制作: FrontPages Dreamweaver Javascript css photoshop fireworks Flash