PetaPoco靳怎么读读

拒绝访问 |
| 百度云加速
请打开cookies.
此网站 () 的管理员禁止了您的访问。原因是您的访问包含了非浏览器特征(387c-ua98).
重新安装浏览器,或使用别的浏览器一、基本介绍
  一个产品诞生以后,宣传必不可少,初识Petapoco,我居然耐心把官网上的英文介绍通读一遍,因为我发现,作者是一个十足的文艺青年,他没有把他的产品宣传得无比高大上,而是很多地方透露着有点低调的、谦卑的气息,清新,可爱。很多地方都能看出,比如在Background那一段:So, what's with the name? Well if Massive is massive, this is "Peta" massive (it's now over 1,500 lines after all) and since it works with "Poco"s ... "PetaPoco" seemed like a fun name!!还有在小标题上,摒弃了古板,写着Features at a Glance,轻鸿一瞥,但又不是了然无声。
  Peta我们已经知道其意思,就是千兆。那么什么是poco?看到它的网站副标题&A tiny ORM-ish thing for your POCOs&。我们下次有空还得简单介绍一下ORM的概念。
二、配置过程
(1)在Petapoco官网中下载一个NuGet.Tools.vsix文件,进行安装。
(2)打开Visual Studio2012,新建项目,新建控制台程序和窗体程序都可以,在解决方案中启动NugGet程序包。
【补充】Nuget是一个.NET平台下的开源的项目,它是Visual Studio的扩展。在使用Visual Studio开发基于.NET Framework的应用时,Nuget能把在项目中添加、移除和更新引用的工作变得更加快捷方便。Nuget是 ASP .NET Gallery 的一员。NuGet 是免费、开源的包管理开发工具,专注于在 .NET 应用开发过程中,简单地合并第三方的组件库。当需要分享开发的工具或是库,需要建立一个Nuget package,然后把这个package放到Nuget的站点。如果想要使用别人已经开发好的工具或是库,只需要从站点获得这个package,并且安装到自己的Visual Studio项目或是解决方案里。NuGet能更方便地把一些dll和文件(如jquery)添加到项目中,而不需要从文件中复制拷贝。
(3)在搜索框中搜索Petapoco,进行安装。
(4)在Models中新建app.config文件,进行配置。添加connectionStrings标签。添加属性。源代码如下:
1 &connectionStrings&2
3 &add name="DefaultConnection" connectionString="Data Source=PC***********\MSSQLSERVER2008R;Initial Catalog=ZJSTGYL; Persist Security Info=T          User ID=*********; Password=*********;"providerName="System.Data.SqlClient" /&
5 &/connectionStrings&
(5)该段代码的作用是程序跟数据库连接,connectionStrings是关键字,Data Source=计算机名、数据库名(计算机名出也可使用IP地址),填写数据库的账号和密码,providerName获取或设置 .NET Framework 数据提供程序的名称,Persist Security Info属性的意思是表示是否保存安全信息,其实可以简单的理解为"ADO在数据库连接成功后是否保存密码信息", True表示保存,False表示不保存&控件使用该提供程序来连接基础数据源。简而言之就是数据库驱动。
【补充】这里每一种数据库连接方式各有不同,可以参考所提供的连接方法,该网站提供了全球所有的数据库的连接方式。
(6)打开Models文件夹中打开Database.tt,填写相关的属性。ConnectionStringName = "DefaultConnection"; Namespace = "这里可以自定义,自定义以后的名称就是实例化数据库的命名空间名称"; ClassPrefix = "该属性填写与否不影响程序的运行,只是在以后的实例化数据库中变成前缀"。
【补充】这里的.tt文件是指T4模板,T4(Text Template Transformation Toolkit)是微软官方在VisualStudio 2008中开始使用的代码生成引擎。在 Visual Studio 中,&T4 文本模板&是由一些文本块和控制逻辑组成的混合模板,它可以生成文本文件。 在 Visual C# 或 Visual Basic 中,控制逻辑编写为程序代码的片段。生成的文件可以是任何类型的文本,例如网页、资源文件或任何语言的程序源代码。说白了:T4文本模板,即一种自定义规则的代码生成器。根据业务模型可生成任何形式的文本文件或供程序调用的字符串。
(7)全部保存,打开类视图,如果出现了刚才你自定义的命名空间的类,说明该数据库连接基本成功。如果之前改变了前缀,打开命名空间,前缀自然会标注上去。
(8)就可以通过SQL语言进行数据库的操作。
阅读(...) 评论()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:
代码展示:
首先,定义一个Poco类:
// Represents a record in the "articles" table
public class article
public long article_id { }
public string title { }
public DateTime date_created { }
public bool draft { }
public string content { }
接下来,创建一个PetaPoco.Database,来执行查询:
// 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", 123));
获取分页数据:
PetaPoco能够自动完成分页请求
var result=db.Page&article&(1, 20, // &-- page number and items per page
"SELECT * FROM articles WHERE category=@0 ORDER BY date_posted DESC", "coolstuff");
你将会得到一个PagedFetch对象:
public class Page&T& where T:new()
public long CurrentPage { }
public long ItemsPerPage { }
public long TotalPages { }
public long TotalItems { }
public List&T& Items { }
PetaPoco在背后为我们做了一下处理:
生成并执行一个查询,得到匹配的数据行数
修改原始的查询语句,使其只得到所有匹配数据的一个子集
你现在已经拥有了一个展示单页数据的一切东西和一个分页控制器,他们被封装在一个现成的小对象中。(You now have everything to display a page of data and a pager control all wrapped up in one handy little object!)
Query vs Fetch
Database 对象有两个获取数据的方法:Query 和Fetch。这两个方法非常相似,不同的是Fetch方法返回一个POCO类的List&&,而Query使用&yield return&迭代所有数据,这些数据并没有加载到内存中。
不带查询的命令
使用Execute 方法执行一个不带查询的命令:
db.Execute("DELETE FROM articles WHERE draft&&0");
Inserts、Updates 和 Deletes
PetaPoco提供了insert、update和delete操作的帮助。
在插入一条记录时,你需要指定插入的表名和主键:
// Create the article
var a=new article();
a.title="My new article";
a.content="PetaPoco was here";
a.date_created=DateTime.UtcN
// 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", 123);
// Change it
a.content="PetaPoco was here again";
// Save it
db.Update("articles", "article_id", a);
或者你可以传一个匿名类来更新一部分字段。下面的代码只更新article的title字段:
db.Update("articles", "article_id", new { title="New title" }, 123);
// 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, 123);
修饰POCO类
在上面的例子中,必须指明表名和主键是很烦人的,你可以在你的Poco类中附加这些信息:
// Represents a record in the "articles" table
[PetaPoco.TableName("articles")]
[PetaPoco.PrimaryKey("article_id")]
public class article
public long article_id { }
public string title { }
public DateTime date_created { }
public bool draft { }
public string content { }
简化后的insert、update、delete:
// Insert a record
var a=new article();
a.title="My new article";
a.content="PetaPoco was here";
a.date_created=DateTime.UtcN
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", 123);
// Update an article
db.Update&article&("SET title=@0 WHERE article_id=@1", "New Title", 123);
你还可以告诉POCO忽略某列
public class article
[PetaPoco.Ignore]
public long SomeCalculatedFieldPerhaps
或许你喜欢一点更详细的描述。和自动映射所有列相比,你可以通过使用类和列的属性来指明哪些列需要映射。
// Represents a record in the "articles" table
[PetaPoco.TableName("articles")]
[PetaPoco.PrimaryKey("article_id")]
[PetaPoco.ExplicitColumns]
public class article
[PetaPoco.Column]publiclong article_id {}
[PetaPoco.Column]publicstring title {}
[PetaPoco.Column]publicDateTime date_created {}
[PetaPoco.Column]public bool draft {}
[PetaPoco.Column]publicstring content {}
它可以结合partial class 很好的工作,把需要绑定的字段放在一个.cs文件中,把计算得到的和别的有用的属性添加到分开的文件中,而不用去考虑DAL。
好吧,PetaPoco仅支持少数几个,因为我不想引起混乱。
Hey!稍等&&它们不是POCO对象了!
当然,它们打破了严格的POCO概念,但使用它们可以让POCO更容易工作。
Writing all those POCO objects can soon get tedious and error prone... so PetaPoco includes a&&that can automatically write classes for all the tables in your your SQL Server, SQL Server CE, MySQL, PostgreSQL or Oracle database.
Using the T4 template is pretty simple. The git repository includes three files (The NuGet package adds these to your project automatically in the folder&\Models\Generated).
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.
A typical Database.tt file looks like this:
&#@ include file="PetaPoco.Core.ttinclude" #&&#& & // Settings& & ConnectionStringName="jab";& & Namespace=ConnectionStringName;& & DatabaseName=ConnectionStringName;& & stringRepoName=DatabaseName+"DB";& & bool GenerateOperations=true;& & // Load tables& & var tables =LoadTables();#&&#@ include file="PetaPoco.Generator.ttinclude" #&
To 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.
All going well Database.cs should be generated with POCO objects representing all the tables in your database. To get the project to build you'll also need to add PetaPoco.cs to your project and ensure it is set to compile (NuGet does this for you) .
The template is based on the&&template. If you're familiar with its ActiveRecord templates you'll find PetaPoco's template very similar.
自动的Select语句
当使用PetaPoco时,大多数查询都以"SELECT * FROM table"开头。鉴于我们现在可以从POCO对象的attribute中得到表名,我们没有理由不自动生成Select语句。
如果你运行一个不以select开头的查询, PetaPoco会自动的将它加上:
// Get a record
var a=db.SingleOrDefault&article&("SELECT * FROM articles WHERE article_id=@0",123);
可以简写:
// Get a recordvar a=db.SingleOrDefault&article&("WHERE article_id=@0",123);
PetaPoco实际上并不生成"SELECT *",它更准确的得到要查询的列名。
IsNew 和Save 方法
有时你有一个POCO,你想要知道数据库中是否已经存在。因为我们有主键,我们所要做的检查是该属性被设置为别的值还是默认值。
检测是否为新增:
// Is this a new record if(db.IsNew(a)){& & // Yes it is...}
和它相关联还有一个Save方法,它将根据判断的结果执行Insert或Update。
// Save a new or existing recorddb.Save(a);
事务相当的简单:
using (var scope=db.Transaction){& & // Do transacted updates here& & // Commit& & scope.Complete();}
事务可以是嵌套的,因此你可以调用其它包含事务的方法,或者被包含在单个的事务中。当所有事务都执行完成了,事务将会提交,否则所有操作都将回滚。
注意:为了使用事务,所有操作都需要相同的PetaPoco Database对象实例。你很可能想到IOC容器中为在每一个http请求或每一个线程共享同一个实体,我喜欢用。
Linq从哪儿实现?
没有任何支持。我在Subsonic中使用Linq很长时间,我发现自己下降到使用&来做这些事情,因为:
&不能用简单的Linq实现
&在.NET 下工作,但不支持Mono(尤其是Mono 2.6)
低效。例如:Subsonic 中activerecord.SingleOrDefault(x=x.id==123)的效率比CodingHorror 低20倍。
Now that I've got CodingHorror all over the place it bugs me that half the code is Linq and half is SQL.
Also, I've realized that for me the most annoying thing about SQL directly in the code is not the fact that it's SQL but that it's nasty to format nicely and to build up those SQL strings.
PetaPoco's SQL Builder
目前已经有很多构建SQL的API,以下是我的版本,它确实很基础!
我的目标是格式化SQL更简单,并且通过适当的参数替换达到防止SQL注入的作用。这不能保证SQL语法的正确,也不支持使用intellisense。
以下是非常基础的写法:
var id=123;var a=db.Query&article&(PetaPoco.Sql.Builder& & .Append("SELECT * FROM articles")& & .Append("WHERE article_id=@0", id))
很管用吧,参数索引器来通过调用.Append是多么酷啊!【Big deal right? Well what's cool about this is that the parameter indicies are specific to each&.Append&call:】
var id=123;var a=db.Query&article&(PetaPoco.Sql.Builder& & .Append("SELECT * FROM articles")& & .Append("WHERE article_id=@0", id)& & .Append("AND date_created&@0",DateTime.UtcNow))
你也可以根据条件构建SQL:
var id=123;var sql=PetaPoco.Sql.Builder& & .Append("SELECT * FROM articles")& & .Append("WHERE article_id=@0", id);if(start_date.HasValue)& & sql.Append("AND date_created&=@0", start_date.Value);if(end_date.HasValue)& & sql.Append("AND date_created&=@0", end_date.Value);var a=db.Query&article&(sql)
注意到每个append调用都用到餐厨@0了吗?PetaPoco构建整个列表的参数,将这些参数索引更新到内部。
你也可以使用命名参数,然后他会在传递的参数中找到合适的属性名。
sql.Append("AND date_created&=@start AND date_created&=@end", & & & & & & & & new & & & & & & & & { & & & & & & & & & & start=DateTime.UtcNow.AddDays(-2), & & & & & & & & & & end=DateTime.UtcNow & & & & & & & & }& & & & & & );
不管是数字的还是命名的参数,如果任何一个参数不能被推断出来,都会抛出一个异常。
这里还有几个创建SQL的公用方法:
var sql=PetaPoco.Sql.Builder()& & & & & & .Select("*")& & & & & & .From("articles")& & & & & & .Where("date_created & @0",DateTime.UtcNow)& & & & & & .OrderBy("date_created DESC");
跟踪Sql命令
有些时候能够看到执行的Sql语句会非常有用,PetaPoco为此提供了三个属性:
LastSQL - 非常明显,不解释
LastArgs - 传递的参数数组
LastCommand - SQL语句和参数字符串
在调试器中查看LastCommand属性能够简单的看到执行了那些操作!
OnException Handler Routine
PetaPoco所执行的Sql命令都封装在try/catch语句块中,所有的异常信息都会传递给OnException虚方法。通过记录这些异常(或在这个方法中设置断点),你可以轻松的跟踪那些地方出现了问题。
上面的内容展示了最基本的PetaPoco使用方法,想了解更多,请。
原文地址:
转自:/youring2/archive//2532130.html
阅读(...) 评论()拒绝访问 |
| 百度云加速
请打开cookies.
此网站 () 的管理员禁止了您的访问。原因是您的访问包含了非浏览器特征(387cbf-ua98).
重新安装浏览器,或使用别的浏览器

我要回帖

更多关于 读书笔记怎么写 的文章

 

随机推荐