You are viewing a plain text version of this content. The canonical link for it is here.
Posted to torque-dev@db.apache.org by gk...@apache.org on 2023/09/20 07:49:04 UTC

svn commit: r1912421 - /db/torque/trunk/torque-runtime/src/main/java/org/apache/torque/criteria/Criteria.java

Author: gk
Date: Wed Sep 20 07:49:04 2023
New Revision: 1912421

URL: http://svn.apache.org/viewvc?rev=1912421&view=rev
Log:
- Update criteria javadoc to be more explicit about the required type if it is a value from database (e.g. a column) as in criterion class.

Modified:
    db/torque/trunk/torque-runtime/src/main/java/org/apache/torque/criteria/Criteria.java

Modified: db/torque/trunk/torque-runtime/src/main/java/org/apache/torque/criteria/Criteria.java
URL: http://svn.apache.org/viewvc/db/torque/trunk/torque-runtime/src/main/java/org/apache/torque/criteria/Criteria.java?rev=1912421&r1=1912420&r2=1912421&view=diff
==============================================================================
--- db/torque/trunk/torque-runtime/src/main/java/org/apache/torque/criteria/Criteria.java (original)
+++ db/torque/trunk/torque-runtime/src/main/java/org/apache/torque/criteria/Criteria.java Wed Sep 20 07:49:04 2023
@@ -1955,7 +1955,9 @@ public class Criteria implements Seriali
      *
      * @param lValue The left hand side of the comparison, not null.
      *        If this object implements the Column interface, it is interpreted
-     *        as a (pseudo)column.
+     *        as a (pseudo)column. If this value should be a value from the database,
+     *        the object must implement the
+     *        <code>org.apache.torque.Column</code> interface.
      *        If this object is a Criteria, it is interpreted as a subselect.
      *        In all other cases, (e.g. string object), it is interpreted as
      *        literal value.
@@ -1963,7 +1965,9 @@ public class Criteria implements Seriali
      *        If this object is a unary comparison operator, it is taken as
      *        comparison operator of the condition to add.
      *        If this object implements the Column interface, it is interpreted
-     *        as a (pseudo)column.
+     *        as a (pseudo)column. If this value should be a value from the database,
+     *        the object must implement the
+     *        <code>org.apache.torque.Column</code> interface.
      *        If this object is a Criteria, it is interpreted as a subselect.
      *        In all other cases, (e.g. string object), it is interpreted as
      *        literal value.
@@ -1985,13 +1989,17 @@ public class Criteria implements Seriali
      *
      * @param lValue The left hand side of the comparison, not null.
      *        If this object implements the Column interface, it is interpreted
-     *        as a (pseudo)column.
+     *        as a (pseudo)column. If this value should be a value from the database,
+     *        the object must implement the
+     *        <code>org.apache.torque.Column</code> interface.
      *        If this object is a Criteria, it is interpreted as a subselect.
      *        In all other cases, (e.G. string object), it is interpreted as
      *        literal value.
      * @param rValue The right hand side of the comparison, may be null.
      *        If this object implements the Column interface, it is interpreted
-     *        as a (pseudo)column.
+     *        as a (pseudo)column. If this value should be a value from the database,
+     *        the object must implement the
+     *        <code>org.apache.torque.Column</code> interface.
      *        If this object is a Criteria, it is interpreted as a subselect.
      *        In all other cases, (e.G. string object), it is interpreted as
      *        literal value.
@@ -2019,7 +2027,9 @@ public class Criteria implements Seriali
      *
      * @param lValue The left hand side of the comparison, not null.
      *        If this object implements the Column interface, it is interpreted
-     *        as a (pseudo)column.
+     *        as a (pseudo)column. If this value should be a value from the database,
+     *        the object must implement the
+     *        <code>org.apache.torque.Column</code> interface.
      *        If this object is a Criteria, it is interpreted as a subselect.
      *        In all other cases, (e.G. string object), it is interpreted as
      *        literal value.
@@ -2049,7 +2059,9 @@ public class Criteria implements Seriali
      *
      * @param lValue The left hand side of the comparison, not null.
      *        If this object implements the Column interface, it is interpreted
-     *        as a (pseudo)column.
+     *        as a (pseudo)column. If this value should be a value from the database,
+     *        the object must implement the
+     *        <code>org.apache.torque.Column</code> interface.
      *        If this object is a Criteria, it is interpreted as a subselect.
      *        In all other cases, (e.G. string object), it is interpreted as
      *        literal value.
@@ -2081,7 +2093,9 @@ public class Criteria implements Seriali
      *
      * @param lValue The left hand side of the comparison, not null.
      *        If this object implements the Column interface, it is interpreted
-     *        as a (pseudo)column.
+     *        as a (pseudo)column. If this value should be a value from the database,
+     *        the object must implement the
+     *        <code>org.apache.torque.Column</code> interface.
      *        If this object is a Criteria, it is interpreted as a subselect.
      *        In all other cases, (e.G. string object), it is interpreted as
      *        literal value.
@@ -2129,7 +2143,9 @@ public class Criteria implements Seriali
      *
      * @param lValue The left hand side of the comparison, not null.
      *        If this object implements the Column interface, it is interpreted
-     *        as a (pseudo)column.
+     *        as a (pseudo)column. If this value should be a value from the database,
+     *        the object must implement the
+     *        <code>org.apache.torque.Column</code> interface.
      *        If this object is a Criteria, it is interpreted as a subselect.
      *        In all other cases, (e.G. string object), it is interpreted as
      *        literal value.
@@ -2153,7 +2169,9 @@ public class Criteria implements Seriali
      *
      * @param lValue The left hand side of the comparison, not null.
      *        If this object implements the Column interface, it is interpreted
-     *        as a (pseudo)column.
+     *        as a (pseudo)column. If this value should be a value from the database,
+     *        the object must implement the
+     *        <code>org.apache.torque.Column</code> interface.
      *        If this object is a Criteria, it is interpreted as a subselect.
      *        In all other cases, (e.G. string object), it is interpreted as
      *        literal value.



---------------------------------------------------------------------
To unsubscribe, e-mail: torque-dev-unsubscribe@db.apache.org
For additional commands, e-mail: torque-dev-help@db.apache.org