iBatisNet配置

结合上面示例中的IbatisNet配置文件，下面对配置文件中各节点的说明：

 

<? 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="../../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和编译在程序中的资源文件）属性引用进来

properties 节点参数

参数	描述
resource	指定the properties文件从application的根目录进行加载 resource="properties.config"
url	指定the properties文件从文件的绝对路径进行加载 url="c:/Web/MyApp/Resources/properties.config" -or- url="file://c:/Web/MyApp/Resources/properties.config"
embedded	指定文件可以作为程序集的资源文件进行加载' embedded=" database.config, IBatisNetDemo ”

上面例子中Properties文件的配置如下：

<? xml version = "1.0" encoding="utf-8" ?>

< settings >

     <!--    User application and configured property settings go here. -->

     <!-- To run tests, create a file named DataBase.config

          with your own value for datasource.

          (don't included it in the solution and don't commit it in SVN)

     -->

     < add key = "userid" value="sa" />

     < add key = "password" value="" />

     < add key = "database" value="Northwind" />

     < add key = "datasource" value="localhost" />

     < add key = "selectKey" value="select @@IDENTITY as value" />

     < add key = "directory" value="Maps" />

     < add key = "useStatementNamespaces" value="false" />

</ settings >

下面解释一下这个文件的节点参数

Property 节点参数

参数	描述
key	定义 key (variable) 名字 key="username"
value	定义 DataMapper 中使用的 key 的值 value="mydbuser"

 

2.       s etting 节点

Setting 节点参数

参数	描述
cacheModelsEnabled	是否启用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项。1.3版本的Provider.config文件中定义了已经实现的16个provider,通过设置这个文件中的几个参数来决定使用哪个数据库提供程序。

• sqlServer1.0 - Microsoft SQL Server 7.0/2000 provider available with .NET Framework 1.0
• sqlServer1.1 -Microsoft SQL Server 7.0/2000 provider available with .NET Framework 1.1
• sqlServer2.0 - Microsoft SQL server 7.0/2000/2005 provider available with .NET Framework 2.0
• OleDb1.1 - OleDb provider available with .NET Framework 1.1
• Odbc1.1 - Odbc provider available with .NET Framework 1.1
• oracle9.2 - Oracle provider V9.2.0.401
• oracle10.1 - Oracle provider V10.1.0.301
• oracleClient1.0 - MS Oracle provider V1.0.5 available with .NET Framework 1.1
• ByteFx - ByteFx MySQL provider V0.7.6.15073
• MySql - MySQL provider V1.0.4.20163
• SQLite3 - SQLite.NET provider V0.21.1869.3794
• Firebird1.7 - Firebird SQL .NET provider V1.7.0.33200
• PostgreSql0.7 - Npgsql provider V0.7.0.0
• PostgreSql0.7.1 - Npgsql provider V0.7.1.0
• iDb2.10 - IBM DB2 iSeries provider V10.0.0.0
• Informix -- informix NET Provider, 2.81.0.0

提供程序要求安装相关类库，每一个

4.       database节点

数据库的信息，包括使用哪些数据库驱动和数据连接字符串的配置。

Database节点参数

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

5.       typeHandler节点

定义数据库类型到dotnet数据类型的处理，不同的数据库都有一些特殊的数据库字段类型需要特殊处理，就可以通过这个功能实现。比如说Blob字段在不同的数据库中处理不一样。大家可以去看看Ibatisnet源代码就清楚这个功能的实现原理，对于我们的设计会有很大的启发

6.       sqlMaps节点

sqlMap节点指定了映射文件的位置，配置中可以出现多个sqlMap节点，以指定项目内所包含的所有映射文件

 

provider 元素都有 "enabled" 属性来控制是否启用这个 providers. 一个 provider 可以通过 “ default “属性标识为默认的提供程序。