[Sqlalchemy-commits] [1530] sqlalchemy/trunk/doc/build/content/adv_datamapping.txt: it's police....

SourceForge Headquarters 225 Broadway Suite 1600 San Diego, CA 92101 +1 (858) 422-6466

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN"
"http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head><style type="text/css"><!--
#msg dl { border: 1px #006 solid; background: #369; padding: 6px; color: #fff; }
#msg dt { float: left; width: 6em; font-weight: bold; }
#msg dt:after { content:':';}
#msg dl, #msg dt, #msg ul, #msg li { font-family: verdana,arial,helvetica,sans-serif; font-size: 10pt;  }
#msg dl a { font-weight: bold}
#msg dl a:link    { color:#fc3; }
#msg dl a:active  { color:#ff0; }
#msg dl a:visited { color:#cc6; }
h3 { font-family: verdana,arial,helvetica,sans-serif; font-size: 10pt; font-weight: bold; }
#msg pre { overflow: auto; background: #ffc; border: 1px #fc0 solid; padding: 6px; }
#msg ul, pre { overflow: auto; }
#patch { width: 100%; }
#patch h4 {font-family: verdana,arial,helvetica,sans-serif;font-size:10pt;padding:8px;background:#369;color:#fff;margin:0;}
#patch .propset h4, #patch .binary h4 {margin:0;}
#patch pre {padding:0;line-height:1.2em;margin:0;}
#patch .diff {width:100%;background:#eee;padding: 0 0 10px 0;overflow:auto;}
#patch .propset .diff, #patch .binary .diff  {padding:10px 0;}
#patch span {display:block;padding:0 10px;}
#patch .modfile, #patch .addfile, #patch .delfile, #patch .propset, #patch .binary, #patch .copfile {border:1px solid #ccc;margin:10px 0;}
#patch ins {background:#dfd;text-decoration:none;display:block;padding:0 10px;}
#patch del {background:#fdd;text-decoration:none;display:block;padding:0 10px;}
#patch .lines, .info {color:#888;background:#fff;}
--></style>
<title>[1530] sqlalchemy/trunk/doc/build/content/adv_datamapping.txt: it's police....</title>
</head>
<body>

<div id="msg">
<dl>
<dt>Revision</dt> <dd>1530</dd>
<dt>Author</dt> <dd>zzzeek</dd>
<dt>Date</dt> <dd>2006-05-27 20:01:45 -0500 (Sat, 27 May 2006)</dd>
</dl>

<h3>Log Message</h3>
<pre>it's police....</pre>

<h3>Modified Paths</h3>
<ul>
<li><a href="#sqlalchemytrunkdocbuildcontentadv_datamappingtxt">sqlalchemy/trunk/doc/build/content/adv_datamapping.txt</a></li>
</ul>

</div>
<div id="patch">
<h3>Diff</h3>
<a id="sqlalchemytrunkdocbuildcontentadv_datamappingtxt"></a>
<div class="modfile"><h4>Modified: sqlalchemy/trunk/doc/build/content/adv_datamapping.txt (1529 => 1530)</h4>
<pre class="diff"><span>
<span class="info">--- sqlalchemy/trunk/doc/build/content/adv_datamapping.txt	2006-05-28 00:31:34 UTC (rev 1529)
+++ sqlalchemy/trunk/doc/build/content/adv_datamapping.txt	2006-05-28 01:01:45 UTC (rev 1530)
</span><span class="lines">@@ -235,7 +235,7 @@
</span><span class="cx"> * secondary - for a many-to-many relationship, specifies the intermediary table.
</span><span class="cx"> * primaryjoin - a ClauseElement that will be used as the primary join of this child object against the parent object, or in a many-to-many relationship the join of the primary object to the association table.  By default, this value is computed based on the foreign key relationships of the parent and child tables (or association table).
</span><span class="cx"> * secondaryjoin - a ClauseElement that will be used as the join of an association table to the child object.  By default, this value is computed based on the foreign key relationships of the association and child tables.
</span><del>-* foreignkey - specifies which column in this relationship is &quot;foreign&quot;, i.e. which column refers to the parent object.  This value is automatically determined in most cases based on the primary and secondary join conditions, except in the case of a self-referential mapper, where it is needed to indicate the child object's reference back to it's parent, or in the case where the join conditions do not represent any primary key columns to properly represent the direction of the relationship.
</del><ins>+* foreignkey - specifies which column in this relationship is &quot;foreign&quot;, i.e. which column refers to the parent object.  This value is automatically determined in most cases based on the primary and secondary join conditions, except in the case of a self-referential mapper, where it is needed to indicate the child object's reference back to its parent, or in the case where the join conditions do not represent any primary key columns to properly represent the direction of the relationship.
</ins><span class="cx"> * uselist - a boolean that indicates if this property should be loaded as a list or a scalar.  In most cases, this value is determined based on the type and direction of the relationship - one to many forms a list, many to one forms a scalar, many to many is a list.  If a scalar is desired where normally a list would be present, such as a bi-directional one-to-one relationship, set uselist to False.
</span><span class="cx"> * private - setting `private=True` is the equivalent of setting `cascade=&quot;all, delete-orphan&quot;`, and indicates the lifecycle of child objects should be contained within that of the parent.   See the example in [datamapping_relations_cycle](rel:datamapping_relations_lifecycle).
</span><span class="cx"> * backref - indicates the name of a property to be placed on the related mapper's class that will handle this relationship in the other direction, including synchronizing the object attributes on both sides of the relation.  Can also point to a `backref()` construct for more configurability.  See [datamapping_relations_backreferences](rel:datamapping_relations_backreferences).
</span></span></pre>
</div>
</div>

</body>
</html>