PetaPoco是一个简单轻巧的orm开源类库,全部功能只有一个文件,可以很方便集成到项目中。代替SqlHelper辅助类的不二选择。。。
主要功能包括: - 映射实体类,支持enum,Nullable等类型,可同时映射多个实例。 - 支持分页 - 以@0等占位符代替SqlParameter,传参更方便 - 带有sql字符串构造器,构造条件查询sql非常方便 - update支持指定字段更新 - 支持T4模板
使用示例: 使用前需要先new一个数据库实例:
var db = new PetaPoco.Database("ConnectionName");
可以放心地把db实例设为static,因为实例中没有SqlConnection的引用,连接每次执行完后,会自动关闭。 发现有人反映在web上使用static的db实例还是会有问题,具体可看链接(Link1),StackOverflow中推荐web中每个请求使用一个单独的db实例(Link2). 1、取一条记录
var a = db.SingleOrDefault("SELECT * FROM articles WHERE article_id=@0", 123));
2、分页
// 分页实质在内部是用Row_Number()重写了sql,支持join
var result=db.Page(1, 20, "SELECT * FROM articles WHERE category=@0 ORDER BY date_created DESC", "coolstuff");
上面的分页sql,会被改写为sql:
SELECT * FROM (
SELECT ROW_NUMBER() OVER (ORDER BY date_created DESC) peta_rn, * FROM articles WHERE category=@0 ) peta_paged
WHERE peta_rn>@1 AND peta_rn
3、部分更新
db.Update("articles", "article_id", new { title="New title" }, 123);
4、sql条件构造
var sql = PetaPoco.Sql.Builder
.Append("SELECT * FROM articles")
.Append("WHERE article_id=@0", id)
.Append("WHERE date_created>=@0", start_date)
.Append("WHERE date_created<=@0", end_date);
5、直接执行sql
db.Execute("DELETE FROM articles WHERE draft<>0");
6、调用存储过程
//调用存储过程
db.Execute("exec procSomeHandler @0, @1", 3, "2011-10-01");
//调用带输出(OUTPUT)参数的存储过程, 写的sql语句,@0参数后的“output”是关键
var param = new SqlParameter() { Direction = ParameterDirection.Output, SqlDbType = SqlDbType.Int };
db.Execute("exec procSomeHandler @0 OUTPUT", param);
7、代替返回值DataTable 有时,我们并不想每条执行的sql都需要创建对应的实体类,这样会导致项目中存在过多的实体类,有方法能做到DataTable这样灵活就最好了。在.net4.0中,PetaPoco可以返回dynamic类型,可以很好地解决这个问题,而在.net3.5中就没办法,不过可以通过修改PetaPoco代码,实现使用Dictionary类型来代替dynamic动态类型的功能。改动代码如下:https://github.com/cxfksword/PetaPoco/commit/e07746c06977f09ef8e7a0f81b718e520b4513ed
var list = db.Fetch>("select article_id,date_created from articles");
使用petapoco时有点需要注意,就是当数据库字段数据类型是varchar等非unicode字符类型时,petapoco传参需要把string转换为AnsiString类型,否则会有性能问题。
Ansi String Support
DBA guru Rob Sullivan yesterday pointed out that SQL Server has pretty severe performance overhead if you try to query an index with varchar column using a unicode string parameter. To fix this the parameter needs to be bound as DbType.AnsiString. To facilitate this you can now wrap such string parameters in a new AnsiString class:
var a = db.SingleOrDefault("WHERE title=@0", new PetaPoco.AnsiString("blah"));
参考资料: http://code.google.com/p/dapper-dot-net/ http://www.toptensoftware.com/petapoco/