Author: ppoddar
Date: Tue Apr 30 00:18:50 2013
New Revision: 1477418
URL: http://svn.apache.org/r1477418
Log:
Add Comments
Modified:
openjpa/sandboxes/21/openjpa-persistence/src/main/java/org/apache/openjpa/persistence/ParameterImpl.java
Modified:
openjpa/sandboxes/21/openjpa-persistence/src/main/java/org/apache/openjpa/persistence/ParameterImpl.java
URL:
http://svn.apache.org/viewvc/openjpa/sandboxes/21/openjpa-persistence/src/main/java/org/apache/openjpa/persistence/ParameterImpl.java?rev=1477418&r1=1477417&r2=1477418&view=diff
==============================================================================
---
openjpa/sandboxes/21/openjpa-persistence/src/main/java/org/apache/openjpa/persistence/ParameterImpl.java
(original)
+++
openjpa/sandboxes/21/openjpa-persistence/src/main/java/org/apache/openjpa/persistence/ParameterImpl.java
Tue Apr 30 00:18:50 2013
@@ -22,15 +22,16 @@ import javax.persistence.Parameter;
/**
* A user-defined parameter of a query.
- *
+ * <br>
* A parameter is uniquely identified within the scope of a query by either
* its name or integral position. The integral position refers to the integer
* key as specified by the user. The index of this parameter during execution
* in a datastore query may be different.
* <br>
- * A value can be bound to this parameter. This behavior of a parameter
carrying
- * its own value is a change from earlier versions (where no explicit
abstraction
- * existed for a query parameter).
+ * A parameter can be bound to a value. However, this receiver does not contain
+ * the actual bound value. Instead a query knows the bound value of a
parameter.
+ * This allows the same instance of this type be used across multiple queries
+ * bound to (possibly) different values.
*
* @author Pinaki Poddar
*
