You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@cayenne.apache.org by aa...@apache.org on 2008/12/28 01:11:00 UTC
svn commit: r729697 - in
/cayenne/main/trunk/framework/cayenne-jdk1.5-unpublished/src/main/java/org/apache/cayenne/access/select:
EntitySegmentBuilder.java EntityTreeSegmentBuilder.java
Author: aadamchik
Date: Sat Dec 27 16:10:59 2008
New Revision: 729697
URL: http://svn.apache.org/viewvc?rev=729697&view=rev
Log:
javadocs
Modified:
cayenne/main/trunk/framework/cayenne-jdk1.5-unpublished/src/main/java/org/apache/cayenne/access/select/EntitySegmentBuilder.java
cayenne/main/trunk/framework/cayenne-jdk1.5-unpublished/src/main/java/org/apache/cayenne/access/select/EntityTreeSegmentBuilder.java
Modified: cayenne/main/trunk/framework/cayenne-jdk1.5-unpublished/src/main/java/org/apache/cayenne/access/select/EntitySegmentBuilder.java
URL: http://svn.apache.org/viewvc/cayenne/main/trunk/framework/cayenne-jdk1.5-unpublished/src/main/java/org/apache/cayenne/access/select/EntitySegmentBuilder.java?rev=729697&r1=729696&r2=729697&view=diff
==============================================================================
--- cayenne/main/trunk/framework/cayenne-jdk1.5-unpublished/src/main/java/org/apache/cayenne/access/select/EntitySegmentBuilder.java (original)
+++ cayenne/main/trunk/framework/cayenne-jdk1.5-unpublished/src/main/java/org/apache/cayenne/access/select/EntitySegmentBuilder.java Sat Dec 27 16:10:59 2008
@@ -30,7 +30,7 @@
import org.apache.cayenne.query.QueryMetadata;
/**
- * Builder of the leaf entity segment that has no persistent subclasses or superclasses.
+ * Builder of an entity segment that has no persistent subclasses or superclasses.
*
* @since 3.0
*/
Modified: cayenne/main/trunk/framework/cayenne-jdk1.5-unpublished/src/main/java/org/apache/cayenne/access/select/EntityTreeSegmentBuilder.java
URL: http://svn.apache.org/viewvc/cayenne/main/trunk/framework/cayenne-jdk1.5-unpublished/src/main/java/org/apache/cayenne/access/select/EntityTreeSegmentBuilder.java?rev=729697&r1=729696&r2=729697&view=diff
==============================================================================
--- cayenne/main/trunk/framework/cayenne-jdk1.5-unpublished/src/main/java/org/apache/cayenne/access/select/EntityTreeSegmentBuilder.java (original)
+++ cayenne/main/trunk/framework/cayenne-jdk1.5-unpublished/src/main/java/org/apache/cayenne/access/select/EntityTreeSegmentBuilder.java Sat Dec 27 16:10:59 2008
@@ -32,8 +32,8 @@
import org.apache.cayenne.reflect.ClassDescriptor;
/**
- * Builder of the non-leaf entity segment that has at least one subclass or superclass or
- * any combination of them.
+ * Builder of an entity segment that has at least one subclass or superclass or any
+ * combination of them.
*
* @since 3.0
*/
Re: svn commit: r729697 - in /cayenne/main/trunk/framework/cayenne-jdk1.5-unpublished/src/main/java/org/apache/cayenne/access/select: EntitySegmentBuilder.java EntityTreeSegmentBuilder.java
Posted by Andrus Adamchik <an...@objectstyle.org>.
Consider that in the most general case a select result in Cayenne 3.0
is List<Object[]>, with each element in the Object[] being either a
persistent object or a scalar value, with a special (most common) case
of List<Object>, where Object is again either a persistent or a scalar.
With this in mind, a "segment" is a descriptor of all elements in the
Object[] at a given index, as seen by the user. Internally a segment
may be quite complex, containing pieces (subsegments?) related to the
main table, joined tables, discriminator columns, etc.
Hope this makes sense.
BTW, I have a local branch where SelectQuery processing is completely
switched to the new "org.apache.cayenne.access.select" package. Not
ready to commit it yet, as there are still many important cases that
don't work (such as prefetching).
Andrus
On Dec 28, 2008, at 4:47 AM, Aristedes Maniatis wrote:
>
> On 28/12/2008, at 11:11 AM, aadamchik@apache.org wrote:
>
>> +++ cayenne/main/trunk/framework/cayenne-jdk1.5-unpublished/src/
>> main/java/org/apache/cayenne/access/select/
>> EntitySegmentBuilder.java Sat Dec 27 16:10:59 2008
>> @@ -30,7 +30,7 @@
>> import org.apache.cayenne.query.QueryMetadata;
>>
>> /**
>> - * Builder of the leaf entity segment that has no persistent
>> subclasses or superclasses.
>> + * Builder of an entity segment that has no persistent subclasses
>> or superclasses.
>> *
>> * @since 3.0
>> */
>>
>
> What does an EntitySegment represent? Is it one database table, such
> when inheritance is not used, there is only one EntitySegment per
> query, and when it is used there is one EntitySegment per table
> which is JOINed in the query?
>
> Ari
>
>
>
> -------------------------->
> Aristedes Maniatis
> phone +61 2 9660 9700
> PGP fingerprint 08 57 20 4B 80 69 59 E2 A9 BF 2D 48 C2 20 0C C8
>
>
>
Re: svn commit: r729697 - in /cayenne/main/trunk/framework/cayenne-jdk1.5-unpublished/src/main/java/org/apache/cayenne/access/select: EntitySegmentBuilder.java EntityTreeSegmentBuilder.java
Posted by Aristedes Maniatis <ar...@maniatis.org>.
On 28/12/2008, at 11:11 AM, aadamchik@apache.org wrote:
> +++ cayenne/main/trunk/framework/cayenne-jdk1.5-unpublished/src/main/
> java/org/apache/cayenne/access/select/EntitySegmentBuilder.java Sat
> Dec 27 16:10:59 2008
> @@ -30,7 +30,7 @@
> import org.apache.cayenne.query.QueryMetadata;
>
> /**
> - * Builder of the leaf entity segment that has no persistent
> subclasses or superclasses.
> + * Builder of an entity segment that has no persistent subclasses
> or superclasses.
> *
> * @since 3.0
> */
>
What does an EntitySegment represent? Is it one database table, such
when inheritance is not used, there is only one EntitySegment per
query, and when it is used there is one EntitySegment per table which
is JOINed in the query?
Ari
-------------------------->
Aristedes Maniatis
phone +61 2 9660 9700
PGP fingerprint 08 57 20 4B 80 69 59 E2 A9 BF 2D 48 C2 20 0C C8