结合上面示例中的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节点,以指定项目内所包含的所有映射文件
原文在cnblogs http://www.cnblogs.com/shanyou/articles/388598.html
provider 元素都有 "enabled" 属性来控制是否启用这个 providers. 一个 provider 可以通过 “ default “属性标识为默认的提供程序。