iBATIS In Action：使用映射语句(二).docVIP

4.3 映射参数（Mapping Parameters） 对于大多数SQL语句来说，它们有用是因为我们可以在运行时向其传入参数。 有两种方式可以将参数（parameter）映射到语句中：内联（inline）参数和外部（external）参数。使用内联参数，配置一般较为简单，iBATIS会根据您的配置进行“揣测”，以获取其它细节信息。而使用外部参数时，配置一般更为显式的（具体）——因为您告诉iBATIS它该如何去做。 4.3.1 外部参数映射 参数映射（Parameter Map）定义了一个参数的有序列表，它与查询语句的占位符相匹配。注意，参数对象的属性定义可以按任意顺序，参数映射会确保每个值得以正确地传入。 使用外部参数映射时，我们可以指定多达10个的特性。如果没有完全指定，iBATIS会藉由反射来确定出一些合理的默认值，这个过程会花费一定的时间，也有可能不够准确。表4.4列出了适用于映射参数的特性，并对其做了简要的介绍。 映射参数的特性（attribute） 特性 描述 property 表示参数对应的对象的属性名称。如果输入参数对象为IDictionary，则property是相应key的名称。同一property值可以出现多次，这取决于它在语句中出现的次数。 column 用于定义存储过程的参数名称。 direction 可用于指定存储过程参数的方向。其值可以是Input，Output或InputOutput。 dbType 用于显式地指定参数对应的列类型。对于某些操作，一些ADO.NET provider不能判断列的类型，此时dbType必须指定。 此特性仅在列为nullable时是必需的。此外，在显式指定日期类型时也需要此特性。尽管.NET仅有一种日期值类型（System.DateTime），大多数数据库却不止一个。通常情况下，数据库至少有三种不同的日期类型（Date，DateTime，TimeStamp）。为使映射过程能够正确，我们可能需要指定列的dbType。 type 用于指定前面的property的CLR类型。在向存储过程传入InputOput和Output类型的参数时，该特性很有用。 正常情况下，property的类型可通过反射获得，但对于IDictionary类型的参数就无能为力了，此时类型被假定为Object。 nullValue nullValue可以设置为任何的有效值（这取决于property的类型）。 注意：对于值类型（int，double，datetime等）的属性，它们是不能为null的，那如何向数据库中插入null值呢？可以采用nullValue，比如对于Age列（int类型），我们可以指定nullValue为0，这意味着如果该属性未设置（C#中，int属性的默认值为0），那么会向数据库插入NULL。在.NET2.0中也可以使用nullable类型，此时更为方便。请参考我的小文。 size 设置列的最大尺寸。 precision 设置数字值的精度。 scale 设置小数的位数。 typeHandler 用于自定义类型处理器（Custom Type Handler）。 内联参数在多数情况下效果不错。如果您希望改善性能，或者遇到了意外的情况，外部参数可能就用得上了。在第5章中，我们会更全面地讨论外部参数，在这里，暂不需要。 4.3.2 重温内联参数 如果您更喜欢使用内联参数，同样可以为参数指定更多的信息，如属性的类型，类的类型以及null值替换（即nullValue特性）。看下面四个例子： statement id=insertProduct parameterClass=Product insert into PRODUCT (PRD_ID, PRD_DESCRIPTION) values (#id#, #description#) /statement 这是最简单的情况，下面这个例子指定了dbType： statement id=insertProduct parameterClass=Product insert into PRODUCT (PRD_ID, PRD_DESCRIPTION) values (#id:int#, #description:VarChar#) /statement 下面这个例子指定了nullValue： statement id=insertProduct parameterClass=Product insert into PRODUCT (PRD_ID, PRD_