Rails源码笔记-ActiveSupport-core_ext-array

简介:

ActiviSupport中包含一些工具类,以及一些对标准类库的扩展。

ActiveSupport的内容都是是独立于rails的,因此也可以在非rails的ruby项目中使用。

 

获取代码

rails的源码位于https://github.com/rails/rails

使用git clone命令可以将代码获取到本地。

 
 
  1. git clone git://github.com/rails/rails.git 

 

我们先从对标准类库的扩展入手,看看ActiveSupport对ruby的标准类库都进行了哪些扩展。

扩展都放在activesupport/lib/active_support/core_ext目录。

进入目录,机会发现rails对ruby的一些基础数据类型都进行了扩展。

进入array文件夹,这里放的是对array的一些扩展。

打开第一个文件,access.rb,看看都做了什么扩展。

 

 
 
  1. class Array 
  2.   # Returns the tail of the array from +position+.  
  3.   #  
  4.   #   %w( a b c d ).from(0)  # => ["a", "b", "c", "d"]  
  5.   #   %w( a b c d ).from(2)  # => ["c", "d"]  
  6.   #   %w( a b c d ).from(10) # => []  
  7.   #   %w().from(0)           # => []  
  8.   def from(position)  
  9.     self[position, length] || []  
  10.   end 
  11.  
  12.   # Returns the beginning of the array up to +position+.  
  13.   #  
  14.   #   %w( a b c d ).to(0)  # => ["a"]  
  15.   #   %w( a b c d ).to(2)  # => ["a", "b", "c"]  
  16.   #   %w( a b c d ).to(10) # => ["a", "b", "c", "d"]  
  17.   #   %w().to(0)           # => []  
  18.   def to(position)  
  19.     first position + 1  
  20.   end 
  21.  
  22.   # Equal to <tt>self[1]</tt>.  
  23.   #  
  24.   #   %w( a b c d e).second # => "b"  
  25.   def second  
  26.     self[1]  
  27.   end 
  28.  
  29.   # Equal to <tt>self[2]</tt>.  
  30.   #  
  31.   #   %w( a b c d e).third # => "c"  
  32.   def third  
  33.     self[2]  
  34.   end 
  35.  
  36.   # Equal to <tt>self[3]</tt>.  
  37.   #  
  38.   #   %w( a b c d e).fourth # => "d"  
  39.   def fourth  
  40.     self[3]  
  41.   end 
  42.  
  43.   # Equal to <tt>self[4]</tt>.  
  44.   #  
  45.   #   %w( a b c d e).fifth # => "e"  
  46.   def fifth  
  47.     self[4]  
  48.   end 
  49.  
  50.   # Equal to <tt>self[41]</tt>. Also known as accessing "the reddit".  
  51.   def forty_two  
  52.     self[41]  
  53.   end 
  54. end 

你会发现rails的代码很清晰,而且代码中的注释详细而不罗嗦,除去解释方法的用途,一般都会有几个简单的例子,很实用。

这里我将这个文件的全部内容都贴了出来,以后可能会酌情调整,如果有裁剪,大家可以去clone源码,自己对照查看。

关于ruby的api,给大家推荐两个地方。

http://ruby-doc.org/core-1.9.3/

一个是官方的网站,很完整,很全面。

http://apidock.com/

一个是api笔记网站,任何注册的用户都可以在任何一个api下面添加笔记,挺有意思的。而且不仅包含ruby,还有rails和rspec。

 

扩展了7个方法

from(position)

返回从给出的位置到末尾的子数组。英文的解释其实更贴切,return  the tail of the array from +position+。从position的位置返回数据的尾巴。

 

to(position)

和from相反,是从头到position的子数组。

 

还扩展了second, third, fourth, fifth, forty_two,分别用来返回数据的第二个,第三个,第四个,第五个,第41个元素。

 

我们再来看看array文件夹中的第二个文件conversions.rb。

这个文件中定义的扩展,主要功能是类型转换。

 

to_sentence(options = {})

将数组元素用逗号连接成一个句子,最后两个元素使用连接词连接。

可以将数组变成一个句子,默认使用逗号和and连接,包含可选的hash参数options,在参数中可以指定连接数组元素的符号,两个元素的情况下如何连接,多个单词的情况下最后两个如何连接,等等。

 

to_formatted_s(format => :default)

将元素的to_s方法返回的结果连接成字符串。指定了:db参数之后,结果就变成了用逗号连接对象的id。

 

定义别名,to_default_s是to_s的别名。

alias_method :to_default_s, :to_s

alias_method :to_s, :to_formatted_s

 

关于上面这种用法,我来解释一下,在rails的源码中会多次的遇到。

意思就是先给to_s起了一个别名to_default_s,然后给to_s起了一个别名to_formatted_s。

怎么理解呢,我们先看个例子吧。

 

 
     
  1. class Person 
  2.  
  3.   def getName 
  4.     puts "andyshi" 
  5.   end 
  6. end 
  7.  
  8. class Person 
  9.  
  10.   def getName_new 
  11.     puts "before" 
  12.     getName_old 
  13.     puts "after" 
  14.   end 
  15.  
  16.   alias_method :getName_old:getName 
  17.   alias_method :getName:getName_new 
  18. end 

 

 
 
  1. p=Person.new 
  2.  
  3. p.getName 

 

我们发现输出的结果是

 

 
 
  1. before 
  2.  
  3. andyshi 
  4.  
  5. after 

经过两行的alias_method,对于调用的客户端来说,不需要修改,还是继续调用getName,但是结果发生了变化,前后都加入了新结果。有点aop的效果。

详细解释一下。

首先给原来的getName重命名getName_old,然后定义一个getName_new方法,里面加入其他内容,然后调用getName_old,相当于调用原来的getName,然后将getName指向getName_new。

以前调用getName的地方不用修改,以后也可以继续使用getName,但是调用产生的效果发生了变化。

 

 

to_xml(options = {})

返回数组的xml格式字符串。

 

再来看看另外一个文件extract_options.r。

这里面有两个扩展。

一个是针对hash的。

extractable_options?

返回对象是否可以抽取。是给array的扩展使用的,下面就会介绍到。

 

一个是针对array的

extract_options!

如果数组的最后一个元素是可抽取的,也就是最后一个元素是否hash,如果是就返回这儿元素,否则就返回一个空的hash,也就是{}。这里面判断是否可抽取,就用到了上面介绍的针对hash的扩展。

 

再来看grouping.rb文件。

这里面有三个扩展,都是对array的扩展。

in_groups_of(number, fill_with = nil)

就是将数组分组,每组的个数是number,空位使用fill_with来填充。比如说数组长度是10,指定每组3个元素,这样第四组只有一个元素,剩下两个空位,使用fill_with来填充。

 

in_groups(number, fill_with = nil)

也是将数组分组,number是分组的个数,就是组的个数,空位使用fill_with填充。

 

splite(value = nil, &block)

将数组分割成子数组,分割的标志是元素的值等于value的值,或者是block指定的条件。

 

文件prepend_and_append.rb

起了两个别名。

alias_method :append, :<<

alias_method :prepend, :unshift

 

文件uniq_by.rb

uniq_by(&block)

根据block中的定义返回一个新的唯一的数组。

 

uniq_by!(&block)

和uniq_by功能一样,但是返回的是修改之后的自己。

 

文件wrap.rb

self.warp(object)

将object包装成一个数组,如果是数组就直接直接返回object。

 

上面就是array文件夹中的全部内容。

 

 




本文转自 virusswb 51CTO博客,原文链接:http://blog.51cto.com/virusswb/1082531,如需转载请自行联系原作者

目录
相关文章
|
JavaScript 前端开发
【笔记】HTMLCollection拿不到元素?无法转Array?
HTMLCollection拿不到元素?无法转Array?
360 0
【笔记】HTMLCollection拿不到元素?无法转Array?
|
存储 PHP 索引
PHP 零基础入门笔记(12):数组 array
PHP 零基础入门笔记(12):数组 array
|
2月前
|
JavaScript 前端开发
总结TypeScript 的一些知识点:TypeScript Array(数组)(下)
一个数组的元素可以是另外一个数组,这样就构成了多维数组(Multi-dimensional Array)。
|
2月前
|
存储 JavaScript 前端开发
总结TypeScript 的一些知识点:TypeScript Array(数组)(上)
数组对象是使用单独的变量名来存储一系列的值。
|
3月前
|
存储 安全 Swift
在Swift中,数组(Array)
在Swift中,数组(Array)
29 3
|
4月前
|
Ruby
|
6月前
|
存储 Java 索引
【面试题精讲】ArrayList 和 Array(数组)的区别?
【面试题精讲】ArrayList 和 Array(数组)的区别?
|
5月前
|
算法 Python
数组倍增(Array Doubling
数组倍增(Array Doubling)是一种常见的算法技术,用于解决数组相关的查找、插入、删除等问题。该技术的核心思想是将数组的大小乘以 2,新数组的长度是原数组长度的两倍,然后将原数组中的元素复制到新数组中。在某些情况下,这种技术可以提高算法的效率,尤其是对于动态数据结构的问题。
134 1
|
2月前
Google Earth Engine(GEE)——reducer中进行array数组的获取和分析
Google Earth Engine(GEE)——reducer中进行array数组的获取和分析
34 0