PetaPoco是一款适用于.Net 和Mono的微小、快速、单文件的微型ORM。
PetaPoco有以下特色：
- 微小，没有依赖项……单个的C#文件可以方便的添加到任何项目中。
- 工作于严格的没有装饰的Poco类，和几乎全部加了特性的Poco类
- Insert/Delete/Update/Save and IsNew 等帮助方法。
- 分页支持：自动得到总行数和数据
- 支持简单的事务
- 更好的支持参数替换，包括从对象属性中抓取命名的参数。
- 很好的性能，剔除了Linq，并通过Dynamic方法快速的为属性赋值
- T4模板自动生成Poco类
- 查询语言是Sql……不支持别扭的fluent或Linq语法（仁者见仁，智者见智）
- 包含一个低耦合的Sql Builder类，让内联的Sql更容易书写
- 为异常信息记录、值转换器安装和数据映射提供钩子。（Hooks for logging exceptions, installing value converters and mapping columns to properties without attributes.）
- 兼容SQL Server, SQL Server CE, MySQL, PostgreSQL and Oracle。
- 可以在.NET 3.5 或Mono 2.6或更高版本上运行
- 在.NET 4.0 和Mono 2.8下支持dynamic
- NUnit单元测试
- 开源（Apache License）
- 所有功能大约用了1500行代码
可以从这里获得PetaPoco：
创建PetaPoco对象，并执行查询：
// Create a PetaPoco database object
var db=new PetaPoco.Database("connectionStringName"); // Show all articles
foreach (var a in db.Query<article>("SELECT * FROM articles"))
{
Console.WriteLine("{0} - {1}", a.article_id, a.title);
}
得到一个scalar：
long count=db.ExecuteScalar<long>("SELECT Count(*) FROM articles");
得到一行记录：
var a = db.SingleOrDefault<article>("SELECT * FROM articles WHERE article_id=@0", ));
获取分页数据（将获取一个PageFetch对象）：
PetaPoco分页执行过程：
var result=db.Page<article>(, , // <-- page number and items per page
"SELECT * FROM articles WHERE category=@0 ORDER BY date_posted DESC", "coolstuff");
1.生成并执行一个查询，获取匹配的数据行数。
2.修改原始的查询语句，只能得到所有匹配的一个子集。
pageFetch对象：一个展示单页数据和分页控制的类。
public class Page<T> where T:new()
{
public long CurrentPage { get; set; }
public long ItemsPerPage { get; set; }
public long TotalPages { get; set; }
public long TotalItems { get; set; }
public List<T> Items { get; set; }
}
获取数据的方式Query 和 Fetch：
Fetch返回一个一个POCO类的List<>，而Query使用迭代所有数据，但是这些数据没有被加载到内存中。
不带查询的命令：
db.Execute("DELETE FROM articles WHERE draft<>0");
Inserts、Updates 和 Deletes：
// Create the article
var a=new article();
a.title="My new article";
a.content="PetaPoco was here";
a.date_created=DateTime.UtcNow; // Insert it
db.Insert("articles", "article_id", a); // by now a.article_id will have the id of the new article
// Get a record
var a=db.SingleOrDefault<article>("SELECT * FROM articles WHERE article_id=@0", ); // Change it
a.content="PetaPoco was here again"; // Save it
db.Update("articles", "article_id", a);
db.Update("articles", "article_id", new { title="New title" }, );
// Delete an article extracting the primary key from a record
db.Delete("articles", "article_id", a); // Or if you already have the ID elsewhere
db.Delete("articles", "article_id", null, );
修饰POCO类：
// Represents a record in the "articles" table
[PetaPoco.TableName("articles")]
[PetaPoco.PrimaryKey("article_id")]
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; }
}
简化后的insert、update、delete：
// Insert a record
var a=new article();
a.title="My new article";
a.content="PetaPoco was here";
a.date_created=DateTime.UtcNow;
db.Insert(a); // Update it
a.content="Blah blah";
db.Update(a); // Delete it
db.Delete(a);
delete和update的其它方式：
// Delete an article
db.Delete<article>("WHERE article_id=@0", ); // Update an article
db.Update<article>("SET title=@0 WHERE article_id=@1", "New Title", );
忽略某列：
public class article
{
[PetaPoco.Ignore]
public long SomeCalculatedFieldPerhaps
{
get; set;
}
}
使用类和列的属性来指明哪些列需要映射：
// Represents a record in the "articles" table
[PetaPoco.TableName("articles")]
[PetaPoco.PrimaryKey("article_id")]
[PetaPoco.ExplicitColumns]
public class article
{
[PetaPoco.Column]publiclong article_id { get; set;}
[PetaPoco.Column]publicstring title { get; set;}
[PetaPoco.Column]publicDateTime date_created { get; set;}
[PetaPoco.Column]public bool draft { get; set;}
[PetaPoco.Column]publicstring content { get; set;}
}
T4 模板：
- PetaPoco.Core.ttinclude - includes all the helper routines for reading the DB schema（数据库模式）
- PetaPoco.Generator.ttinclude - the actual template that defines what's generated（实体模板）
- Database.tt - the template itself that includes various settings and includes the two other ttinclude files.（模板本身）
use the template：
- Add the three files to you C# project
- Make sure you have a connection string and provider name set in your app.config or web.config file
- Edit ConnectionStringName property in Records.tt (ie: change it from "jab" to the name of your connection string)
- Save Database.tt.
自动的Select语句：
运行一个不以select开头的查询， PetaPoco会自动的将它加上。
IsNew 和Save 方法：
IsNew：检测是否为新增。
Save：根据判断的结果执行Insert或Update。
事务：
using (var scope=db.Transaction)
{
// Do transacted updates here // Commit
scope.Complete();
}
注意：为了使用事务，所有操作都需要相同的PetaPoco Database对象实例。