[ http://issues.apache.org/jira/browse/IBATISNET-136?page=comments#action_12361258 ]
Norman Katz commented on IBATISNET-136: --------------------------------------- This issue also exists in the latest DataMapper 1.3 Docs. > Documentation bug: Data Mapper Guide 1.2.1.pdf nullValue in <result> > -------------------------------------------------------------------- > > Key: IBATISNET-136 > URL: http://issues.apache.org/jira/browse/IBATISNET-136 > Project: iBatis for .NET > Type: Bug > Components: Documentation > Versions: DataMapper 1.2.1 > Environment: .Net > Reporter: Norman Katz > > 3.5.3.7. nullValue > The nullValue attribute can be set to any valid value (based on property > type). The nullValue attribute is used > to specify an outgoing null value replacement. What this means is that when > the value is detected in the object > property, a NULL will be written to the database (the opposite behavior of an > inbound null value replacement). > This allows you to use a "magic" null number in your application for types > that do not support null values (such > as int, double, float). When these types of properties contain a matching > null value (say, -9999), a NULL > will be written to the database instead of the value. > If your database has a NULLABLE column, but you want your application to > represent NULL with a constant > value, you can specify it in the Result Map as shown in Example 3.25. > This seems close to a verbatim copy of the nullValue section of <parameter> > (3.4.2.6.). I believe it should actually state one of the following: > a) ... when a null value is detected in a result returned from the query, the > replacement value will be stored in the corresponding result property. > or > b) ... when the value is detected in the result returned from the query, a > null will be stored in the corresponding result property. > Nothing is being "written to the database" when you're in the context of a > <result> so I believe your current text is inaccurate and this paragraph > should be revised. -- 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