iBATIS.net配置说明篇

从本篇开始，会对“iBATIS.net开发的第一个web实例”进行一个全方面的细节说明。
IBatisNetDemo工程(业务逻辑层)
sqlmap.config

<?xml version="1.0" encoding="utf-8"?>
<sqlMapConfig xmlns="http://ibatis.apache.org/dataMapper" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" >

  <!-- Rem : If used via a DataAccess context, properties tag will be ignored 
  <properties resource="http://www.cnblogs.com/database.config"/> -->
  <properties embedded="database.config, IBatisNetDemo"/>
  <settings>
    <setting useStatementNamespaces="${useStatementNamespaces}"/>
    <setting cacheModelsEnabled="true"/>
    <setting validateSqlMap="false"/>
  </settings>
 
  <!-- Optional if resource -->
  <providers embedded="providers.config,IBatisNetDemo"/>
  <!-- ==== SqlClient configuration =========    -->
  <!-- Rem : If used via a DataAccess context, database tag will be ignored -->
  <database>
    <!-- Optional ( default ) -->
    <provider name="sqlServer1.1"/>
    <dataSource name="iBatisNet" connectionString="data source=${datasource};database=${database};user id=${userid};password=${password};connection reset=false;connection lifetime=5; min pool size=1; max pool size=50"/>
  </database>

  <sqlMaps>
    <!-- user via embedded-->
    <sqlMap embedded="Map.SqlClient.Person.xml,IBatisNetDemo"/>
  </sqlMaps>
</sqlMapConfig>

 （1）、 properties节点
可以根据需要配置一些常量属性。如果这些属性有很多的话可以单独写一个文件里面，再通过resource（或url, embedded分别是引用url和编译在程序中的资源文件）属性引用进来。

    参数                            描述
   resource       指定the properties文件从application的根目录进行加载
                      resource="http://www.cnblogs.com/database.config"

   url               指定the properties文件从文件的绝对路径进行加载
                     url="c:\web\IBatisNetTest\database.config"
                                    或者
                     url="file://c:\web\IBatisNetTest\database.config"

  embedded       指定文件可以作为程序集的资源文件进行加载
                       embedded="database.config, IBatisNetDemo"

 （2）、setting节点

      参数                                                 描述
 
cacheModelsEnable              是否启用sqlMap上的缓存机制
                                        Example: cacheModelsEnabled=”true”
                                        Default: true (enabled) 

useStatementNamespaces     是否使用Satement命名空间，这里的命名空间指的是映射文件中
                                        sqlMap节点的namespace属性，如例中针对Person表的映射文件
                                        sqlMap节点<sqlMap namespace="Person" 
                                        xmlns="http://ibatis.apache.org/mapping" 
                                        xmlns:xsi=http://www.w3.org/2001/XMLSchema-instance> 
                                        这里,指定了此sqlMap节点下定义的操作均丛属于“Person”命名空间
                                        在useStatementNamespaces=”true”的情况下，Statement调用
                                        需追加命名空间，
                                        如：sqlMap.Update(“Person.UpdatePerson”,person);
                                       否则直接通过Statement名称调用即可，
                                       如sqlMap.Update(“UpdatePerson”,person);
                                       但请注意此时需要保证所有映射文件中，statement定义无重名
                                       Example: useStatementNamespaces=”false”
                                       Default: false (disabled) 

validateSqlMap                   配置要不要启示SqlMapConfig.xsd schema验证映射文件.
                                       Example: validateSqlMap=”false”
                                       Default: false (disabled) 

（3）、provider节点
配置数据驱动提供类配置文件的路径和文件名，通过resource（或url, embedded分别是引用url和编译在程序中的资源文件）属性引用进来，参数的含义同properties.
ADO.NET是通过数据访问提供程序（Provider）访问数据库。IBatisNet使用的是插件式结构来使用这些数据库提供程序，每一个Provider对应于providers.config文件中定义的一个provider项。
（4）database节点
数据库的信息，包括使用哪些数据库驱动和数据连接字符串的配置。
Database节点参数：

         参数                         描述
      provider        数据库访问所使用的provider.config文件定义的provider
       
     dataSource     特定的数据库连接字符串
 

 （5）、typeHandler节点
定义数据库类型到dotnet数据类型的处理，不同的数据库都有一些特殊的数据库字段类型需要特殊处理，就可以通过这个功能实现。比如说Blob字段在不同的数据库中处理不一样。
（6）、 sqlMaps节点
sqlMap节点指定了映射文件的位置，配置中可以出现多个sqlMap节点，以指定项目内所包含的所有映射文件