1、配置文件：
- 框架默认情况下支持"connectionStrings"的配置方式，如《轮子来袭 vJine.Core Orm 之 01_快速入门》所述；
-
框架的进阶设定将支持更为详尽、灵活的配置，而您需要做的只是按照给定的格式增加相应的配置节即可(样例及解释如下)。
<?xml version="1.0"?> <configuration> <configSections> <sectionGroup name="vJine.Net"><!-- 必须制定：格式及内容固定 --> <section name="OrmConfig" type="vJine.Core.AppConfig`1[[vJine.Core.ORM.OrmConfig, vJine.Core]], vJine.Core"/> </sectionGroup> </configSections>
<connectionStrings> <add name="Default" providerName="System.Data.SqlClient" connectionString="Data Source=.;Initial Catalog=Test;Integrated Security=True"/> </connectionStrings> <vJine.Net> <OrmConfig> <Adapters Active="false"> <!-- 由用户指定扩展的Adapter（继承自vJine.Core.ORM.IDbAdapter）, --> <Adapter Active="true" name="My_Orm_Adapter" pattern="O_My"> <type>vJineCore_QuickStart.My_Orm_Adapter, vJineCore_QuickStart</type> </Adapter> </Adapters> <Connections> <!-- 后续内容会覆盖此前db.name相同的内容, connectionStrings中的内会在初始配置时会添加到此段， 字段对应关系如下(name->name,providerName->providerName,connectionString->connectionString) db各属性的意义： .name: new DataManager(string name)中对应的name,默认(new DataManager())为Default, .providerName:DbProviderFactories用以创建DbProviderFactory; .connectionString:DbProviderFactory用以连接数据库的连接字符串 .adapter:Adapter配置节对应的name .host,.port,.user,.password;作为connectionString的配置项目可单独设置、修改，并在新建DataManager实例时替换相应索引值， 即：connectionString = string.format(connectionString,.host,.port,.user,.password);如果不需要，可不必指定。 .adapter:如果指定则按da.adapter查找对应的adapter.name；否则按db.providerName,db.name的顺序匹配adapter.pattern --> <db name="O_My_Test" providerName="System.Data.SQLite" adapter="SQLite" host="{0}" port="{1}"> <connectionString>Data Source=default_data.db;Version=3;Pooling=True;Max Pool Size=100;</connectionString> <user>{2}</user> <password>{3}</password> </db> <db name="SQLite" providerName="System.Data.SQLite" adapter="SQLite"> <connectionString>Data Source=default_data.db;Version=3;Pooling=True;Max Pool Size=100;</connectionString> </db> <db name="MySQL" providerName="MySql.Data.MySqlClient" host="127.0.0.1" port="3306"> <user>root</user> <password>******</password> <connectionString>server={0};charset=utf8;User Id={2};Password={3};database=test;Persist Security Info=True</connectionString> </db> <db name="Oracle" providerName="Oracle.DataAccess.Client" host="XE"> <user>SYSTEM</user> <password>******</password> <connectionString>DATA SOURCE={0};PERSIST SECURITY INFO=True;USER ID={2};Password={3}</connectionString> </db> </Connections> <Converters Active="true"> <!-- 类型转换定义,用于引用(用以提供系统默认类型转vJine.Core.ORM.OrmTypeConverter以外的类型转换支持) --> <Converter name="sbyte_" type="vJine.Core.ORM.TypeConverter+sbyte_, vJine.Core"/> </Converters> <TypeMaps adapter="SQLite"> <!--全局数据类型映射--> <TypeMap adapter="MSSQL" type="string" SQL_TYPE="varchar(70)" Conv="_对应Converter.name(此处不需要，留空即可)"></TypeMap> <!--请依据需求指定,系统默认类型映射参见《vJine.Core ORM 数据类型映射》--> </TypeMaps> <SchemaMaps Active="true"><!--如果Active="false",则或略此项定义--> <!--针对表的数据类型映射--> <Schema Active="true" adapter="SQLite" type="vJineCore_QuickStart.BML.My_Model, vJineCore_QuickStart"><!--如果Active="false",则或略此项定义--> <Map Active="true" Name="Comments" Alias="Comments" IsNullable="true" TrimString="true" Conv="_对应Converter.name(此处不需要，留空即可)"/><!--如果Active="false",则或略此项定义--> </Schema> </SchemaMaps> </OrmConfig> </vJine.Net> </configuration>
2、增删改查：
除《轮子来袭 vJine.Core Orm 之 01_快速入门》一文中所述的基本增、删、改、查外，您也可以使用如下方式操作：
Class<My_Model>.I insert = new Class<My_Model>.I();
insert .Into("table_A", "table_B") //不写则默认为类名(My_Model) .Keys(My_Model._.ID, My_Model._.MyStatus, My_Model._.Qty) //不写则默认为所有公共属性 .Values(new_data); dm.E<My_Model>(insert);
Class<My_Model>.D delete = new Class<My_Model>.D();
delete
.From("table_A", "table_B") .Where(My_Model._.ID.Like("A%") & (My_Model._.MyStatus == My_Model.Status.Ready | My_Model._.MyStatus == My_Model.Status.Running));
dm.E<My_Model>(delete);
Class<My_Model>.U update = new Class<My_Model>.U(); update .Update("table_A", "table_B") .Set(My_Model._.Qty.EQ(My_Model._.Qty + 7)) .Where(My_Model._.ID.Like("A%") & (My_Model._.MyStatus == My_Model.Status.Ready | My_Model._.MyStatus == My_Model.Status.Running)); dm.E<My_Model>(update);
Class<My_Model>.Q querier = new Class<My_Model>.Q(); querier .Select(My_Model._.ID, My_Model._.MyStatus, My_Model._.Qty) //只需选择必要的字段即可 .From("table_A", "table_B", "table_C") .Where(My_Model._.ID.Like("A%") & (My_Model._.MyStatus == My_Model.Status.Ready | My_Model._.MyStatus == My_Model.Status.Running));
dm.E<My_Model>(querier, container);
3、连接、事务及级联调用：
void transaction(DataManager dm) { /* * 此处将DataManager作为传入参数有其特殊的意义 * 在常规的业务逻辑中，经常会碰到多个数据库操作方法之间的调用, * vJjine.Core ORM考虑的了这种应用，确保了多个方法调用时能共享同一个链接、同一个事物 * 而同时又降低了代码的复杂度 */ dm.Open(); //打开连接 try { dm.Begin(); //开始事物 //transaction 的一系列数据库操作 transaction_b(dm); //此处调用transaction_b dm.Commit(); //此处提交事物 } catch (Exception ex) { dm.Rollback(); //处理错误 } finally { dm.Close(); //此处关闭连接 } } void transaction_b(DataManager dm) { dm.Open(); //此处共用transaction方法打开的连接 try { dm.Begin(); //此处共用transaction方法开启的事物 //transaction_b 的一系列数据库操作 dm.Commit(); //此处并未提交事物 } catch (Exception ex) { dm.Rollback(); //处理错误 } finally { dm.Close(); //此处并未关闭连接 } }
4、关于辅助类:
public partial class _ /*起这个名字是为了方便操作，框架中并没有对此做限制，之所以起这个名字也是借鉴了其他的ORM框架*/ /*不必一定声明在业务模型类内部，可依据团队习惯单独定义，同时也不必每个属性都定义，之定义必要的属性即可（参见Class<>.IDUQ)*/ { public static readonly Property<My_Model/*包含属性的类*/, string/*需与属性类型完全一致*/> ID = new Property<My_Model/*包含属性的类*/, string>("ID"/*需与属性名完全一致*/); }
5、关于充血与贫血：
vJine.Core ORM 采用贫血模型，最大程度的保证了框架的非侵入特性，当然您也可以依据你的意愿进行封装。
至此，您已经对vJine.Core ORM框架有了充分的了解，如果有闲暇时间，可以试试亲手操作一下了。
QQ讨论群:115051701,欢迎加入。