Fluent Data 入门

由 Primates 根据互联网资源整理FluentData 是微型 ORM(micro-ORM)家族的一名新成员,旨在比大型 ORM(full ORM)更加易用。FluentData 于本月推出,它使用 fluent API 并支持 SQL Server、SQL Azure、Oracle和 MYSQL。

FluentData 的设计者 Lars-Erik Kindblad 谈到:

当前市面上的 ORM 框架,如 Entity Framework NHibernate,都过于复杂而且难于学习。此外,由于这些框架自身抽象的查询语言以及从数据库到.NET 对象的映射太过麻烦,导致它们生成的 SQL 都很低效。FluentData 另辟蹊径,它是一个轻量级框架,拥有简单的 fluent API 并且很容易学会。与其他微型 ORM(如 Dapper 和 Massive)类似,FluentData 关注性能和易用性。它允许开发人员拥有对 SQL 较多的控制,而不是依赖 ORM 进行自动生成。它不仅可以使用 SQL 来执行查询、增添和更新操作,还可以支持使用存储过程和事务。根据文档描述,FluentData 可以在不改动已有结构的情况下,与任何业务对象一同工作。

以下是 FluentData 的一些其他特性:

  • 多结果集(Multiple Result Set):在一次数据库操作下返回多个数据集;
  • 开发人员可使用强类型对象或动态对象;
  • 可为创建时需要特殊处理的复杂对象自定义实体工厂(Custom Entity Factory);
  • 具有添加其他数据库支持的能力。

FluentData 需要 .NET 4.0,并支持 SQL Server、SQL Azure、SQL Server Compact 以及使用 .NET 驱动的 Oracle 和 MySQL。 想要了解进一步信息,如代码示例和免费下载,请访问CodePlex 站点上的 FluentData

二 创建 DbContext

初始化一个 DbContext

可以在*.config 文件中配置 connection string,将 connection string name 或者将整个 connection string作为参数传递给 DbContext 来创建 DbContext。

重要配置

IgnoreIfAutoMapFails – IDbContext.IgnoreIfAutoMapFails 返回一个 IDbContext,该实例中,如果自动映射失败时是否抛出异常

  通过*.config 中配置的 ConnectionStringName 创建一个 DbContext

1: public IDbContext Context()

2: {

3:  return new DbContext().ConnectionStringName("MyDatabase",

4:    new SqlServerProvider());

5: }

  调用 DbContext 的 ConnectionString 方法显示设置 connection string 来创建

1: public IDbContext Context()

2: {

3:  return new DbContext().ConnectionString(

4:    "Server=MyServerAddress;Database=MyDatabase;Trusted_Connection=True;", new SqlServerProvider());

5: }

  其他可以使用的 Provider

  只有通过使用不同的 Provider,就可以切换到不同类型的数据库服务器上,比如

  AccessProvider, DB2Provider, OracleProvider, MySqlProvider, PostgreSqlProvider, SqliteProvider,SqlServerCompact, SqlAzureProvider, SqlServerProvider。

三 查询(Query)

返回单个对象

  返回一个 dynamic 对象

1: dynamic product = Context.Sql(@"select * from Product where ProductId = 1").QuerySingle<dynamic>();

  返回一个强类型对象:

1: Product product = Context.Sql(@"select * from Product where ProductId = 1").QuerySingle<Product>();

  返回一个 DataTable:

1: DataTable products = Context.Sql("select * from Product").QuerySingle<DataTable>();

其 实 QueryMany<DataTable> 和 QuerySingle<DataTable> 都 可 以 用 来 返 回 DataTable , 但 考 虑 到QueryMany<DataTable>返回的是List<DataTable>,所以使用 QuerySingle<DataTable>来返回 DataTable 更方便。

  查询一个标量值

1: int numberOfProducts = Context.Sql(@"select count(*) from Product").QuerySingle<int>();

返回一组数据

  返回一组 dynamic 对象(new in .NET 4.0)

1: List<dynamic> products = Context.Sql("select * from Product").QueryMany<dynamic>();

  返回一组强类型对象

1: List<Product> products = Context.Sql("select * from Product").QueryMany<Product>();

  返回一个自定义的 Collection

1: ProductionCollection products = Context.Sql("select * from Product").QueryMany<Product,ProductionCollection>();

  返回一组标量值

1: List<int> productIds = Context.Sql(@"select ProductId from Product").QueryMany<int>();

参数化查询

  索引顺序形式的参数

1: dynamic products = Context.Sql(@"select * from Product where ProductId = @0 or ProductId = @1", 1,

2).QueryMany<dynamic>();

  或者

1: dynamic products = Context.Sql(@"select * from Product where ProductId = @0 or ProductId =

@1").Parameters(1, 2).QueryMany<dynamic>();

  名字形式的参数:

1: var command = Context.Sql(@"select @ProductName = Name from Product where ProductId=1")

2:    .ParameterOut("ProductName", DataTypes.String, 100);

3: command.Execute();

4: string productName = command.ParameterValue<string>("ProductName");

5: List of parameters - in operator:

6: List<int> ids = new List<int>() { 1, 2, 3, 4 };

7: dynamic products = Context.Sql(@"select * from Product

8:    where ProductId in(@0)", ids).QueryMany<dynamic>();

  Output 参数:

1: dynamic products = Context.Sql(@"select * from Product

2:  where ProductId = @ProductId1 or ProductId = @ProductId2")

3:  .Parameter("ProductId1", 1)

4:  .Parameter("ProductId2", 2)

5:  .QueryMany<dynamic>();

四 映射(Mapping)

自动映射

  在数据库对象和.Net object 自动进行1:1匹配

1: List<Product> products = Context.Sql(@"select * from Product").QueryMany<Product>();

  自动映射到一个自定义的 Collection:

1: ProductionCollection products = Context.Sql("select * from Product").QueryMany<Product,ProductionCollection>();

  如果数据库字段和 POCO 类属性名不一致,使用 SQL 别名语法 AS:

1: List<Product> products = Context.Sql(@"select p.*,

2:  c.CategoryId as Category_CategoryId,

3:  c.Name as Category_Name

4:  from Product p

5:  inner join Category c on p.CategoryId = c.CategoryId")

6:    .QueryMany<Product>();

在这里 p.*中的 ProductId 和 ProductName 会自动映射到 Prodoct.ProductId 和 Product.ProductName,而Category_CategoryId 和Category_Name 将 映 射 到Product.Category.CategoryId 和Product.Category.Name.

  使用 dynamic 自定义映射规则

1: List<Product> products = Context.Sql(@"select * from Product")

2:  .QueryMany<Product>(Custom_mapper_using_dynamic);

3:

4: public void Custom_mapper_using_dynamic(Product product, dynamic row)

5: {

6:  product.ProductId = row.ProductId;

7:  product.Name = row.Name;

8: }

  使用 datareader 进行自定义映射:

1: List<Product> products = Context.Sql(@"select * from Product")

2:.QueryMany<Product>(Custom_mapper_using_datareader);

4: public void Custom_mapper_using_datareader(Product product, IDataReader row)

5: {

6:  product.ProductId = row.GetInt32("ProductId");

7:  product.Name = row.GetString("Name");

8: }

  或者,当你需要映射到一个复合类型时,可以使用 QueryComplexMany 或者 QueryComplexSingle。

1: var products = new List<Product>();

2: Context.Sql("select * from Product").QueryComplexMany<Product>(products, MapComplexProduct);

3:

4: private void MapComplexProduct(IList<Product> products, IDataReader reader)

5: {

6:  var product = new Product();

7:  product.ProductId = reader.GetInt32("ProductId");

8:  product.Name = reader.GetString("Name");

9:  products.Add(product);

10: }

五 多结果集

FluentData 支持多结果集。也就是说,可以在一次数据库查询中返回多个查询结果。使用该特性的时候,记得使用类似下面的语句对查询语句进行包装。需要在查询结束后把连接关闭。

1: using (var command = Context.MultiResultSql)

2: {

3:  List<Category> categories = command.Sql(

4:    @"select * from Category;

5:    select * from Product;").QueryMany<Category>();

6:

7:  List<Product> products = command.QueryMany<Product>();

8: }

执行第一个查询时,会从数据库取回数据,执行第二个查询的时候,FluentData 可以判断出这是一个多结果集查询,所以会直接从第一个查询里获取需要的数据.

六 分页

1: List<Product> products = Context.Select<Product>("p.*, c.Name as Category_Name")

2:  .From(@"Product p

3:  inner join Category c on c.CategoryId = p.CategoryId")

4:  .Where("p.ProductId > 0 and p.Name is not null")

5:  .OrderBy("p.Name")

6:  .Paging(1, 10).QueryMany();

调用 Paging(1, 10),会返回最先检索到的10个 Product

七 数据库操作(Insert, Update, Delete)

插入数据

  使用 SQL 语句:

1: int productId = Context.Sql(@"insert into Product(Name, CategoryId)

2:  values(@0, @1);")

3:  .Parameters("The Warren Buffet Way", 1)

4:  .ExecuteReturnLastId<int>();

  使用 builder:

1: int productId = Context.Insert("Product")

2:  .Column("Name", "The Warren Buffet Way")

3:  .Column("CategoryId", 1)

4:  .ExecuteReturnLastId<int>();

  使用 builder,并且自动映射

1: Product product = new Product();

2: product.Name = "The Warren Buffet Way";

3: product.CategoryId = 1;

4:

5: product.ProductId = Context.Insert<Product>("Product", product)

6:  .AutoMap(x => x.ProductId)

7:  .ExecuteReturnLastId<int>();

将 ProductId 作为 AutoMap 方法的参数,是要指明 ProductId 不需要进行映射,因为它是一个数据库自增长字段。

更新数据

  使用 SQL 语句:

1: int rowsAffected = Context.Sql(@"update Product set Name = @0 where ProductId = @1")

2:  .Parameters("The Warren Buffet Way", 1)

3:  .Execute();

  使用 builder:

1: int rowsAffected = Context.Update("Product")

2:  .Column("Name", "The Warren Buffet Way")

3:  .Where("ProductId", 1)

4:  .Execute();

使用 builder,并且自动映射:

1: Product product = Context.Sql(@"select * from Product

2:  where ProductId = 1")

3:  .QuerySingle<Product>();

4: product.Name = "The Warren Buffet Way";

5:

6: int rowsAffected = Context.Update<Product>("Product", product)

7:  .AutoMap(x => x.ProductId)

8:  .Where(x => x.ProductId)

9:  .Execute();

  将 ProductId 作为 AutoMap 方法的参数,是要指明 ProductId 不需要进行映射,因为它不需要被更新。

  Insert and update - common Fill method

1: var product = new Product();

2: product.Name = "The Warren Buffet Way";

3: product.CategoryId = 1;

4:

5: var insertBuilder = Context.Insert<Product>("Product", product).Fill(FillBuilder);

6:

7: var updateBuilder = Context.Update<Product>("Product", product).Fill(FillBuilder);

8:

9: public void FillBuilder(IInsertUpdateBuilder<Product> builder)

10: {

11:  builder.Column(x => x.Name);

12:  builder.Column(x => x.CategoryId);

13: }

14:

15: Delete

删除数据

  使用 SQL 语句:

1: int rowsAffected = Context.Sql(@"delete from Product

2:  where ProductId = 1")

3:  .Execute();

  使用 builder:

1: int rowsAffected = Context.Delete("Product").Where("ProductId", 1)

2:  .Execute();

存储过程和事物

存储过程

  使用 SQL 语句:

1: var rowsAffected = Context.Sql("ProductUpdate")

2:  .CommandType(DbCommandTypes.StoredProcedure)

3:  .        Parameter("ProductId", 1)

4:  .Parameter("Name", "The Warren Buffet Way")

5:  .Execute();

  使用 builder:

1: var rowsAffected = Context.StoredProcedure("ProductUpdate")

2:  .Parameter("Name", "The Warren Buffet Way")

3:  .Parameter("ProductId", 1).Execute();

  使用 builder,并且自动映射

1: var product = Context.Sql("select * from Product where ProductId = 1")

2:    .QuerySingle<Product>();

3:

4: product.Name = "The Warren Buffet Way";

5:

6: var rowsAffected = Context.StoredProcedure<Product>("ProductUpdate", product)

7:  .AutoMap(x => x.CategoryId).Execute();

  使用 Lambda 表达式

1: var product = Context.Sql("select * from Product where ProductId = 1")

2:    .QuerySingle<Product>();

3: product.Name = "The Warren Buffet Way";

4:

5: var rowsAffected = Context.StoredProcedure<Product>("ProductUpdate", product)

6:  .Parameter(x => x.ProductId)

7:  .Parameter(x => x.Name).Execute();

事务

  FluentData 支持事务。如果使用事务,最好使用 using 语句将代码包起来,已保证连接会被关闭。默认的,如果查询过程发生异常,如事务不会被提交,会进行回滚。

1: using (var context = Context.UseTransaction(true))

2: {

3:  context.Sql("update Product set Name = @0 where ProductId = @1")

4:    .Parameters("The Warren Buffet Way", 1)

5:  .Execute();

6:

7:  context.Sql("update Product set Name = @0 where ProductId = @1")

8:    .Parameters("Bill Gates Bio", 2)

9:    .Execute();

10:

11:  context.Commit();

12: }

13:

实体工厂

实体工厂负责在自动映射的时候生成 POCO 实例。如果需要生成复杂的实例,可以自定义实体工厂:

1: List<Product> products = Context.EntityFactory(new CustomEntityFactory())

2:  .Sql("select * from Product")

3:  .QueryMany<Product>();

4:

5: public class CustomEntityFactory : IEntityFactory

6: {

7:  public virtual object Resolve(Type type)

8:  {

9:    return Activator.CreateInstance(type);

10:  }

11: }

轻量级ORM-Fluentdata入门的更多相关文章

  1. PetaPoco轻量级ORM框架 - 入门安装

    PetaPoco 是一个开源轻量级ORM,够小,够快,单文件 在GitHub上有很高的人气 1377星,几年来作者一直在更新 当前版本6.0.317 - Netstandard 2.0(同时支持.ne ...

  2. Farseer.net轻量级ORM开源框架 V1.x 入门篇:视图的数据操作

    导航 目   录:Farseer.net轻量级ORM开源框架 目录 上一篇:Farseer.net轻量级ORM开源框架 V1.x 入门篇:视图实体类映射 下一篇:Farseer.net轻量级ORM开源 ...

  3. Farseer.net轻量级ORM开源框架 V1.x 入门篇:存储过程数据操作

    导航 目   录:Farseer.net轻量级ORM开源框架 目录 上一篇:Farseer.net轻量级ORM开源框架 V1.x 入门篇:存储过程实体类映射 下一篇:Farseer.net轻量级ORM ...

  4. Farseer.net轻量级ORM开源框架 V1.x 入门篇:存储过程实体类映射

    导航 目   录:Farseer.net轻量级ORM开源框架 目录 上一篇:Farseer.net轻量级ORM开源框架 V1.x 入门篇:视图的数据操作 下一篇:Farseer.net轻量级ORM开源 ...

  5. Farseer.net轻量级ORM开源框架 V1.x 入门篇:视图实体类映射

    导航 目   录:Farseer.net轻量级ORM开源框架 目录 上一篇:Farseer.net轻量级ORM开源框架 V1.x 入门篇:表的数据操作 下一篇:Farseer.net轻量级ORM开源框 ...

  6. Farseer.net轻量级ORM开源框架 V1.x 入门篇:数据库上下文

    导航 目   录:Farseer.net轻量级ORM开源框架 目录 上一篇:Farseer.net轻量级ORM开源框架 V1.x 入门篇:数据库配置文件 下一篇:Farseer.net轻量级ORM开源 ...

  7. Farseer.net轻量级ORM开源框架 V1.x 入门篇:表的数据操作

    导航 目   录:Farseer.net轻量级ORM开源框架 目录 上一篇:Farseer.net轻量级ORM开源框架 V1.x 入门篇:表实体类映射 下一篇:Farseer.net轻量级ORM开源框 ...

  8. Farseer.net轻量级ORM开源框架 V1.x 入门篇:表实体类映射

    导航 目   录:Farseer.net轻量级ORM开源框架 目录 上一篇:Farseer.net轻量级ORM开源框架 V1.x 入门篇:数据库上下文 下一篇:Farseer.net轻量级ORM开源框 ...

  9. Farseer.net轻量级ORM开源框架 V1.x 入门篇:数据库配置文件

    导航 目   录:Farseer.net轻量级ORM开源框架 目录 上一篇:Farseer.net轻量级ORM开源框架 V1.x 入门篇:新版本说明 下一篇:Farseer.net轻量级ORM开源框架 ...

  10. Farseer.net轻量级ORM开源框架 V1.x 入门篇:新版本说明

    导航 目   录:Farseer.net轻量级ORM开源框架 目录 上一篇:没有了 下一篇:Farseer.net轻量级ORM开源框架 V1.x 入门篇:数据库配置 前言 V1.x版本终于到来了.本次 ...

随机推荐

  1. 导入excel数据到数据库

    1.上传excel到服务器 jsp页面代码 <form action="actionname" method="post" id="form1& ...

  2. Excel 回归分析

    1 分析两个变量和一个因变量的关系 降水,温度与生长的关系曲线 降水是连续的数,温度有三个温室,每个温室一个温度,生长也是连续的数. 作图的方法是将降水放在一列,然后生长根据温度放三列,同一个温度的放 ...

  3. Google赛马问题

    http://coolshell.cn/articles/1202.html 据说,这是Google的面试题.面试题目如下: 一共有25匹马,有一个赛场,赛场有5个赛道,就是说最多同时可以有5匹马一起 ...

  4. Log4j框架

    一.Log4j基本使用方法 Log4j由三个重要的组件构成:日志信息的优先级 Loggers,日志信息的输出目的地 Appenders,日志信息的输出格式 Layouts .日志信息的优先级从高到低 ...

  5. JavaScript函数表达式

    函数表达式的基本语法形式 var functionName = function(arguments){ //函数体 } 递归建议 我们通过例子来一步步说明,递归的最佳实现方式.下面是普通递归调用的例 ...

  6. Leetcode Minimum Window Substring

    Given a string S and a string T, find the minimum window in S which will contain all the characters ...

  7. Android -- 启动另外一个Activity的方式(2s自动启动)

    1.  使用Handler  并且可以设置进入和退出的动画效果 Class < ? > activityClass; Class [ ] paramTypes = { Integer.TY ...

  8. 【Telerik】<telerik:RadGridView/>控件的使用

    学习Telerik第三方控件中的WPF时,对于RadGridView控件做的一些记录. AutoGenerateColumns:启动时是否生成列 ShowGroupPanel:是否显示表格的分组名称 ...

  9. idea intellij 混淆anroid代码

    idea intellij 混淆anroid代码 在project.properties中加入 target=android-14proguard.config=proguard.cfg 点击 Bui ...

  10. MySQL中INFORMATION_SCHEMA是什么?(1)

    在获取自增ID时,我用到了以下语句: select auto_increment from information_schema.tables where table_name = "表名& ...