Skip to content
Browse files

Update documentation on lazy loading

  • Loading branch information...
1 parent 8122d29 commit 07b62983390b51f99dfbdf354e7ef2182eaf070e @lsegal committed
Showing with 7 additions and 0 deletions.
  1. +7 −0 README.rdoc
View
7 README.rdoc
@@ -152,6 +152,13 @@ read. Consider this example:
# => "hello"
p db[:hello].comments
# => ["This is comment #0", "This is comment #1", ...]
+
+One of the benefits of shallow reads (a.k.a. lazy loading) is that you're not
+immediately deserializing associations. If you had a complex object structure
+that held cyclic associations or associations to a root object in your tree,
+you could end up de-serializing the entire database in one read, which would
+obviously not be a good thing. ODB's lazy attributes allow reads on an object
+to be very fast while maintaining associations transparently.
== The Supported Data Stores

0 comments on commit 07b6298

Please sign in to comment.
Something went wrong with that request. Please try again.