You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@ibatis.apache.org by "Norman Katz (JIRA)" <ib...@incubator.apache.org> on 2005/12/27 09:18:30 UTC

[jira] Created: (IBATISNET-136) Documentation bug: Data Mapper Guide 1.2.1.pdf nullValue in

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


[jira] Closed: (IBATISNET-136) Documentation bug: Data Mapper Guide 1.2.1.pdf nullValue in

Posted by "Roberto Rabe (JIRA)" <ib...@incubator.apache.org>.
     [ http://issues.apache.org/jira/browse/IBATISNET-136?page=all ]
     
Roberto Rabe closed IBATISNET-136:
----------------------------------

    Resolution: Fixed

Thanks for the catch!  

In SVN...

> 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


[jira] Commented: (IBATISNET-136) Documentation bug: Data Mapper Guide 1.2.1.pdf nullValue in

Posted by "Norman Katz (JIRA)" <ib...@incubator.apache.org>.
    [ 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