README.md in mongoid-eager-loading-0.2.0 vs README.md in mongoid-eager-loading-0.3.0
- old
+ new
@@ -3,11 +3,11 @@
mongoid-eager-loading adds the eager loading feature for mongoid.
Originally it is my [pull request][0] for mongoid, but it is not accepted yet, so I created this gem to get the eager loading benefits easily for my projects.
-I only test it in mongoid-2.0.0.beta.19, maybe you can try it on other mongoid version, and let me know if it works fine.
+I only test it in mongoid 2.0.0.beta.19 and 2.0.0.beta.20, maybe you can try it on other mongoid version, and let me know if it works fine.
Usage
-----
define it in your Gemfile
@@ -16,34 +16,36 @@
suppose you have a mongoid model Post
class Post
include Mongoid::Document
-
+
referenced_in :user
references_many :comments
end
then you can use the eager loading like
Post.includes(:user)
Post.includes(:user, :comments)
-
+
eager loading can be only used on referenced_in, references_one and references_many associations.
-
+
Benchmark
---------
I also run a [benchmark][1] on my local computer, the result is as follows
Starting benchmark...
user system total real
- Finding 10 posts with person, without eager loading 0.010000 0.000000 0.010000 ( 0.006538)
- Finding 10 posts with person, with eager loading 0.000000 0.000000 0.000000 ( 0.005235)
- Finding 50 posts with person, without eager loading 0.020000 0.000000 0.020000 ( 0.027912)
- Finding 50 posts with person, with eager loading 0.020000 0.000000 0.020000 ( 0.020103)
- Finding 100 posts with person, without eager loading 0.040000 0.000000 0.040000 ( 0.055197)
- Finding 100 posts with person, with eager loading 0.030000 0.010000 0.040000 ( 0.040644)
+ Finding 10 posts with person, without eager loading 0.000000 0.000000 0.000000 ( 0.005373)
+ Finding 10 posts with person, with eager loading 0.010000 0.000000 0.010000 ( 0.002984)
+ Finding 50 posts with person, without eager loading 0.010000 0.000000 0.010000 ( 0.022207)
+ Finding 50 posts with person, with eager loading 0.010000 0.000000 0.010000 ( 0.006831)
+ Finding 100 posts with person, without eager loading 0.040000 0.000000 0.040000 ( 0.050991)
+ Finding 100 posts with person, with eager loading 0.010000 0.000000 0.010000 ( 0.012867)
+ Finding 1000 posts with person, without eager loading 0.390000 0.050000 0.440000 ( 0.477983)
+ Finding 1000 posts with person, with eager loading 0.120000 0.010000 0.130000 ( 0.128879)
Author
------
Richard Huang :: flyerhzm@gmail.com :: @flyerhzm