Date: Thursday, January 5, 2006 @ 11:36:44
Author: marc
Path: /cvsroot/carob/carob/include
Modified: ParameterStatement.hpp (1.1 -> 1.2)
Javadoc fixes following recent implementation/protocol changes. Please review.
------------------------+
ParameterStatement.hpp | 17 +++++++----------
1 files changed, 7 insertions(+), 10 deletions(-)
Index: carob/include/ParameterStatement.hpp
diff -u carob/include/ParameterStatement.hpp:1.1
carob/include/ParameterStatement.hpp:1.2
--- carob/include/ParameterStatement.hpp:1.1 Thu Dec 22 17:02:51 2005
+++ carob/include/ParameterStatement.hpp Thu Jan 5 11:36:44 2006
@@ -77,9 +77,9 @@
class Connection;
/**
- * A SQL Statement is pre-compiled and stored in a
+ * A SQL Statement template is stored in a
* <code>ParameterStatement</code> object. This object can then be used to
- * efficiently execute this statement multiple times.
+ * efficiently execute this statement multiple times with different parameters.
* <p>
* <b>Note: </b> The setXXX methods for setting IN parameter values must
specify
* types that are compatible with the defined SQL type of the input parameter.
@@ -92,7 +92,7 @@
friend class Connection;
public:
- //No constructor, statements must be created by connections
+ //No public constructor, statements must be created by connections
virtual ~ParameterStatement();
/**
@@ -254,10 +254,7 @@
protected:
/**
- * Constructor. Parses/Splits the SQL statement into segments - string parts
- * separated by question mark placeholders. When we rebuild the thing with
the
- * arguments, we can substitute the args by joining segments and parameters
- * back together.
+ * Constructor.
*
* @param connection the instantiating connection
* @param sqlStatement the SQL statement with ? for IN markers
@@ -279,12 +276,12 @@
private:
/** Original, untouched request (only trimmed) */
std::wstring sql;
- /** IN parameters, ready to be inlined in the request */
+ /** IN parameters, ready to be sent with the request */
std::vector<std::wstring> inStrings;
/**
- * Helper - this compiles the SQL query, inlining the parameters in the
- * request String.
+ * Helper - this serializes the parameters into a unique wstring.
+ *
* If a parameter was not set, throws a NullValueException if throwException
is true,
* otherwise replace the missing parameter with ?
* @param throwException to throw a NullValueException if a parameter is
missing
_______________________________________________
Carob-commits mailing list
[email protected]
https://forge.continuent.org/mailman/listinfo/carob-commits
