Doctrine

Timestamp:

04/30/08 03:26:33 (14 months ago)

Author:

jwage

Message:

fixes #634

Files:

• branches/0.11/manual/docs/en/component-overview.txt (modified) (3 diffs)

branches/0.11/manual/docs/en/component-overview.txt

@@ -194 +194 @@
 +++ Refreshing records
 
-Sometimes you may want to refresh your record with data from the database, use {{Doctrine_Record::refresh()}}.
+Sometimes you may want to refresh your record with data from the database, use
+ {{Doctrine_Record::refresh()}}.
 
 <code type="php">
@@ -205 +206 @@
 ++++ Refreshing relationships
 
-The {{Doctrine_Record::refresh()}} method can also refresh record relationships, but you need to specify them on the query.
+The {{Doctrine_Record::refresh($deep = false)}} method can also refresh the 
+already loaded record relationships, but you need to specify them on the
+original query.
 
 <code type="php">
@@ -229 +232 @@
 // get new user on group
 $group->refresh(true);
+</code>
+
+You can also lazily refresh individual relationships or all defined relationships 
+of a model using  {{Doctrine_Record::refreshRelated($name = null)}}.
+
+<code type="php">
+$user = Doctrine::getTable('User')->findOneByName('jon');
+$user->refreshRelated(); // Will lazily load all defined relationships
+
+$user->refreshRelated('Phonenumber'); // Will lazily load the Phonenumber relationship
 </code>