Wrong description of how inline parameters are handled
-------------------------------------------------------
Key: IBATIS-358
URL: http://issues.apache.org/jira/browse/IBATIS-358
Project: iBatis for Java
Issue Type: Bug
Components: Documentation
Environment: iBatis Data Mapper Development Guide Version 2.0, August
9, 2006
Reporter: Robert Jäschke
The description of how inline parameters are handled (compare pages 23 and 28)
is wrong.
On page 23 it is written that they are used "to populate the statement
parameter in-place" and
on page that they are "coded directly into the SQL". But this is not true:
using something like "#id#"
actually creates a PreparedStatement with "?" which is filled with "id" later.
This should be made clear on these sections!
Furthermore I could not find a description of the difference between using
"#id#" and "$id$" in
the manual. It first occurs (?) on page 50, where dynamic elements are
described. The difference
is, that "$id$" does, what is said on pages 23/28, that the value is directly
coded into the SQL
(in which way? Is it quoted, if neccessary, or not?) and that "#id#" makes it a
parameter of a
prepared statement. In this occasion I must say I could not find out from the
manual, if iBatis
uses PreparedStatements or not or when it uses them (a look into SqlExecutor
revealed, that
it always uses PreparedStatements?!).
As a sidenode: On page 49 it is said, that the "iterate" attribute "property"
does also allow
java.util.Iterator, but tests and a look into the source revealed, that this is
not the case (it
always checks, if it is a collection or an array?!).
Just my 2 cents, hoping that I haven't overlooked something.
--
This message is automatically generated by JIRA.
-
If you think it was sent incorrectly contact one of the administrators:
http://issues.apache.org/jira/secure/Administrators.jspa
-
For more information on JIRA, see: http://www.atlassian.com/software/jira
