ibatis-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Robert Jäschke (JIRA) <ibatis-...@incubator.apache.org>
Subject [jira] Created: (IBATIS-358) Wrong description of how inline parameters are handled
Date Thu, 19 Oct 2006 11:30:35 GMT
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"
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$"
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
(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
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


View raw message