PetaPoco 使用总结(一)
前段时间,公司的一个项目希望用一个ORM 的框架,通过对比 Dapper 和 PetaPoco ,虽然Dapper 功能很强大,速度更快。
但是最终还是选择了比较简单的PetaPoco。
因为PetaPoco更加的简单,所有的代码只有1500多行。通过一个项目的试验,PetaPoco使用简单,无任何需配置,无需冗长的映射文件,性能也不错。
PetaPoco是一款适用于.NET应用程序的轻型对象关系映射器(ORM, Object Relational
Mapper)。与那些功能完备的ORM(如NHibernate或Entity
Framework)不同的是,PetaPoco更注重易用性和性能,而非丰富的功能。使用PetaPoco只需要引入一个C#文件,可以使用强类型的
POCO(Plain Old CLR Object),并支持使用T4模板生成的类,和支持.net 4.0 的 Dynamic对象等等。
最近,随着许多开源项目的发布,微型ORM已开始成为一种流行趋势。其他一些众所周知的适用于.NET的项目有Dapper和Massive。那些微型ORM相对于功能完备的ORM而言,会更简单、更高效,微型ORM通常要求开发人员手动编写SQL语句,而非完全动态生成。它们同样不需要冗长的映射文件,因为对于维护和调试而言,那些映射文件只会让过程变得单调乏味。
PetaPoco最让人感兴趣的功能包括:
- 可与SQL Server、SQL Server CE、MySQL、PostgreSQL以及Oracle数据库协同工作。
- 包含针对Insert/Delete/Update/Save以及IsNew的多个辅助方法。
- 支持简单事务
- 对于翻页请求会自动计算总记录数,并获取特定分页。
- 支持参数替换,能够从对象属性中抓取命名参数(named parameters)
- 包括一个消耗资源很少的SQL Builder类
- 部分记录更新
- 包括T4 Templates,可以用于基于数据库结构生成POCO类。
- 很好的性能,剔除了Linq,并通过Dynamic方法快速的为属性赋值
在性能方面,PetaPoco仅次于Dapper,速度只稍逊于手工编码的数据访问层(DAL, Data Access
Layer)。
PetaPoco下载地址:
GitHub - https://github.com/toptensoftware/petapoco
例子:来自PetaPoco官网
查询
- 定义Poco 类
// Represents a record in the "articles" table
public class article
{
public long article_id { get; set; }
public string title { get; set; }
public DateTime date_created { get; set; }
public bool draft { get; set; }
public string content { get; set; }
}
- 创建PetaPoco数据库连接 ,并执行查询
var db=new PetaPoco.Database("connectionStringName");
// 查询所有articles
foreach (var a in db.Query<article>("SELECT * FROM articles"))
{
Console.WriteLine("{0} - {1}", a.article_id, a.title);
}
查询返回参数
long count=db.ExecuteScalar<long>("SELECT Count(*) FROM articles");
查询得到一行记录:
var a = db.SingleOrDefault<article>("SELECT * FROM articles WHERE
[email protected]", 123));
分页查询
PetaPoco
自带了分页功能,可以自动执行分页请求。
var
result=db.Page<article>(1, 20, // <-- page number and items per
page
"SELECT * FROM articles WHERE
[email protected] ORDER BY date_posted DESC", "coolstuff");
Query vs Fetch
Database 对象有两个获取数据的方法:Query
和Fetch。这两个方法非常相似,不同的是Fetch方法返回一个POCO类的List<>,而Query使用 yield return
迭代所有数据,这些数据并没有加载到内存中。
需要注意的是:应该小心再开始一个新的查询之前完成和处理掉上一个查询,否则会曝异常。所以这种情况下, 应该优先使用
Fetch。
出现这个问题的时候,一直找不到原因,看了源码注释之后,才知道的。
执行非查询的sql 语句
使用Execute 方法执行一个不带查询的命令:
db.Execute("DELETE FROM articles WHERE draft<>0");