C# NPOCO 轻量级ORM框架(进阶)
继续翻译NPOCO wiki。
这篇将home上 下面的几个页面翻译。
wiki地址:https://github.com/schotime/NPoco/wiki
上一篇: http://www.cnblogs.com/Aaxuan/p/7366476.html
从数据库映射到现在有对象
使用 SingleInto
、SingleOrDefaultInto
、FirstInto
和 FirstOrDefaultInto
方法,可以将数据库的列映射到现有对象。只有查询中的列将被设置在现有对象上。
public class User
{
public int UserId { get;set; }
public string Email { get;set; }
} var user = new User() { UserId = };
IDatabase db = new Database("connStringName");
db.SingleOrDefaultInto(user, "select Email from users where userid = @0", );
一对多的查询
这帮助您映射一个与嵌套列表对象有一对多关系的查询。鉴于以下类:
public class UserDto
{
public int UserId { get; set; }
public string Name { get; set; }
public List<CarDto> Cars { get; set; }
} public class CarDto
{
public string Make { get; set; }
public string Color { get; set; }
}
查询:
IDatabase db = new Database("connStringName"); //v2
var users = db.FetchOneToMany<UserDto, CarDto>(x => x.UserId,
"select u.*, c.* from Users u inner join Cars c on u.UserId = c.UserId order by u.UserId"); //v3
var users = db.FetchOneToMany<UserDto>(x => x.Cars,
"select u.*, c.* from Users u inner join Cars c on u.UserId = c.UserId order by u.UserId");
这将为您提供一个UserDto对象的列表,并且对于每个对象,也将填充CarDto的列表。
注意:
- 此方法的第一个参数是 lambda 表达式,该表达式标识第一个对象的惟一属性。
- 列的顺序非常重要。它必须与定义的泛型参数的顺序一致。在这个示例中,查询指定了u。然后c * 映射到< UserDto,CarDto >。
- 如果您要映射到用于插入数据的对象,那么你需要确定你对
List<>
使用了[Ignore]
属性。 - 如果您正在使用一个外连接来执行查询,并且您预期其中的一些将不会被填充,请确保在
FetchOneToMany
调用中使用第二个lambda。这将返回许多对象的主要属性。在上面的例子中,这可能是x = > x . carid。 FetchOneToMany
不能用于获取嵌套的一对多关系,也不能用于多个一对多关系。例如,如果UserDto也有一个BoatsDto列表,那么只有CarDto列表或BoatsDto列表可以加载并映射到一个查询。
对嵌套对象映射
这将帮助您将查询映射到有嵌套对象的对象。鉴于以下类:
public class User
{
public int UserId { get; set; }
public string Name { get; set; }
public Address Address { get; set; }
} public class Address
{
public string Street { get; set; }
public string City { get; set; }
}
查询:
IDatabase db = new Database("connStringName");
var users = db.Fetch<User, Address>("select u.UserId, u.Name, u.Street, u.City from Users");
这将给您一个使用嵌套类映射的 user 对象列表。
注意:
- 列的顺序非常重要。查询中的列需要按照指定的泛型参数的顺序指定。如。首先指定用户列,然后指定地址列。
- 如果您要映射到用于插入数据的对象,那么您需要确保使用 [ResultColumn] 属性忽略地址类。从v3中,您还需要添加[ComplexMapping]s属性。
字典和对象数组查询
有时,您不知道查询返回的列。这就是能够映射到字典< string,object >,或object[]的地方。字典和对象数组查询。
var users = db.Fetch<Dictionary<string, object>>("select * from users"); or var users = db.Fetch<object[]>("select * from users");
注意:
从NPoco版本 > 1.0.3 开始,所有数组类型(值类型。string[]、int[]、double[]、DateTime[]等)将是一个有效的通用参数。
跟踪更改的更新
使用快照
快照用于跟踪实体的更改,因此只有更改的属性才会被更新。在下面的示例中,只有新 Name 将被发送到数据库,因为它的年龄值与启动快照时的值相同。
IDatabase db = new Database("connString");
var user = db.SingleById<User>(); // Name = "Ted", Age = 21 var snapshot = db.StartSnapshot(user); // 在此之后的任何更改都将被记录。 user.Name = "Bobby";
user.Age = ; db.Update(user, snapshot.UpdatedColumns()); // 只更新Name列
只有在UpdatedColumns()之前的更改将被包含在变更集中。
复合主键
复合键可以指定通过放置两个逗号之间的列名称 [PrimaryKey]
属性。
[TableName("Users")]
[PrimaryKey("UserId,UserName")]
public class User
{
public int UserId { get; set; }
public string UserName { get;set; }
}
当设置了复合键,AutoIncrement属性总是默认false
。
如果你想使用 SingleById
方法查找一个对象,就可以使用匿名类型。
IDatabase db = new Database("connStringName");
var user = db.SingleById<User>(new {UserId = , UserName = "user"});
多个结果集
该特性使您能够在只调用一次数据库的情况下映射多个查询。
FetchMultiple
方法返回一个 Tuple < T >,List < T1 > >。
IDatabase db = new Database("connStringName");
Tuple<List<User>, List<Address>> data = db.FetchMultiple<User, Address>("select * from users;select * from addresses;");
var users = data.Item1;
var addresses = data.Item2;
支持:
这仅支持可以返回多个结果集的数据库。在IDataReader上实现了NextResult()。通过Npgsql支持Sql Server和Postgresql。
流利的映射
对于一个类的映射,您可以使用 Map < T > 继承,其中 T 是要映射的类。
public class UserMapping : Map<User>
{
public UserMapping()
{
PrimaryKey(x => x.UserId);
TableName("Users");
Columns(x =>
{
x.Column(y => y.Name).Ignore();
x.Column(y => y.Age).WithName("a_ge");
});
}
}
映射也可以从映射继承,并使用For < >方法在一次类中指定所有的映射。
public class OurMappings : Mappings
{
public OurMappings()
{
For<User>().Columns( ....
}
}
数据库工厂设置:
您只需要创建映射一次,我们使用数据库工厂来完成此操作。
public void Application_Start()
{
MyFactory.Setup();
}
public static class MyFactory
{
public static DatabaseFactory DbFactory { get; set; } public static void Setup()
{
var fluentConfig = FluentMappingConfiguration.Configure(new OurMappings());
//或单个的映射
9 //var fluentConfig = FluentMappingConfiguration.Configure(new UserMapping(), ....); DbFactory = DatabaseFactory.Config(x =>
{
x.UsingDatabase(() => new Database("connString"));
x.WithFluentConfig(fluentConfig);
x.WithMapper(new Mapper());
});
}
}
然后你可以在你的代码中使用它。
var database = MyFactory.DbFactory.GetDatabase();
如果你使用的是容器,那么你可以使用类似的东西
For<IDatabase>().Use(() => MyFactory.DbFactory.GetDatabase());
简单LINQ查询
Query<T>
NPoco介绍了一种使用LINQ查询获取对象的简单方法。这里有一个简单的例子。
IDatabase db = new Database("connString");
db.Query<User>().Where(x => x.Name == "Bob")
.OrderBy(x => x.UserId)
.Limit(, )
.ToList();
可用的LINQ关键字:
- ProjectTo
- Count
- Any
- Where
- OrderBy
- OrderByDescending
- ThenBy
- ThenByDescending
- Limit
- Include
- IncludeMany
这里是你如何使用一个IN子句:
var users = db.Query<User>().Where(x => new[] {,,,}.Contains(x.UserId)).ToList();
// 或者使用 'In' 扩展方法
var users = db.Query<User>().Where(x => x.UserId.In(new[] {,,,})).ToList();
在where子句中也可以使用许多字符串方法。这里有几个例子:
var users = db.Query<User>().Where(x => x.Name.StartsWith("Bo")).ToList();
var users = db.Query<User>().Where(x => x.Name.EndsWith("ob")).ToList();
var users = db.Query<User>().Where(x => x.Name.Contains("o")).ToList();
var users = db.Query<User>().Where(x => x.Name.ToLower() == "bob").ToList();
var users = db.Query<User>().Where(x => x.Name.ToUpper() == "BOB").ToList();
注意:并不是所有的操作都已经实现了。
查询提供
Query<T>
查找用户id大于50的所有用户,按名称排序,只返回20个记录。
var users = db.Query<User>()
.Where(x => x.UserId > )
.OrderBy(x => x.Name)
.Limit(, )
.ToList();
注意:
查询将只在ToList()、ToEnumerable()或返回1值的标量方法中运行。
UpdateMany<T>
在必要的情况下,使用 Where 更新所有类型T 。
var list = new[] {, , , };
// 只更新模板传递的(1、2、3、4)中 UserId 对象的 Name字段
// 如果使用 ExecuteDefaults 方法,则不会设置默认属性 null,或为0的int
db.UpdateMany<User>()
.Where( x => x.UserId.In(list))
//.ExcludeDefaults()
.OnlyFields(x => x.Name)
.Execute(new User() {Name = "test"});
注意:
查询只在执行调用时运行。
DeleteMany<T>
在必要的情况下,使用 Where 删除所有类型T 。
var list = new[] {, , , }; db.DeleteMany<User>()
.Where(x => list.Contains(x.UserId))
.Execute();
注意:
查询只在执行调用时运行。
版本列支持
[VersionColumn]
一个数字字段可以用来检测相互冲突的更新:
[TableName("Users")]
[PrimaryKey("UserId")]
public class User
{
public int UserId { get;set; } [VersionColumn("VersionInt", VersionColumnType.Number)]
public long VersionInt { get; set; }
}
更新将自动检查和增加版本,如果它已经过时,就会抛出 DBConcurrencyException 异常。
这可以通过设置来禁用:VersionException = VersionExceptionHandling.Ignore。
在SQL Server中,rowversion timestamp 数据类型
可用于与VersionColumnType.RowVersion版本列:
[TableName("Users")]
[PrimaryKey("UserId")]
public class User
{
public int UserId { get;set; } [VersionColumn("Version", VersionColumnType.RowVersion)]
public byte[] Version { get; set; }
}
Sql模板
您可以使用SqlBuilder在有条件的地方建立查询,例如,列,orderby等。
var sqlBuilder = new SqlBuilder();
var template = sqlBuilder.AddTemplate("select * from users where age > @0 and /**where**/", );
这里你可以指定一个 Where、Select、Join、LeftJoin、OrderBy、OrderByCols、GroupBy 和 Having 相应的sql令牌在下面指定。
/// Adds a filter. The Where keyword still needs to be specified. Uses /**where**/
public SqlBuilder Where(string sql, params object[] parameters) /// Replaces the Select columns. Uses /**select**/
public SqlBuilder Select(params string[] columns) /// Adds an Inner Join. Uses /**join**/
public SqlBuilder Join(string sql, params object[] parameters) /// Adds a Left Join. Uses /**leftjoin**/
public SqlBuilder LeftJoin(string sql, params object[] parameters) /// Adds an Order By clause. Uses /**orderby**/
public SqlBuilder OrderBy(string sql, params object[] parameters) /// Adds columns in the Order By clause. Uses /**orderbycols**/
public SqlBuilder OrderByCols(params string[] columns) /// Adds a Group By clause. Uses /**groupby**/
public SqlBuilder GroupBy(string sql, params object[] parameters) /// Adds a Having clause. Uses /**having**/
public SqlBuilder Having(string sql, params object[] parameters)
语句可以被链接,并且每个新语句的参数从0开始。
sqlBuilder
.Where("height >= @0", )
.Where("weight > @0 and weight < @1", , ); var db = new Database("conn");
db.Fetch<User>(template);
可以在任何可以使用Sql类的地方使用模板。
到此为止,wiki 主页上的文章除了一篇讲调试的,还有右侧列表中有二,三篇没有翻译。
翻译过程中挺难受的,英语看的一知半解,代码也一知半解,经常看完代码才明白英文意思。。
不过还好是翻译的意思都差不多,可能会有理解,翻译错误的地方,有发现的园友还请指出,以便改正。
翻译时间 2017/8/20
C# NPOCO 轻量级ORM框架(进阶)的更多相关文章
- C# NPOCO 轻量级ORM框架(入门)
目前公司使用这个框架,搜不到很详细的中文资料. 只有英文wiki,所以翻译学习一下. 因为博主也是低水平的,可能会有一些理解不到位的地方. 可能会有错误的地方,如果有园友发现可以指出. wiki地址: ...
- 轻量级ORM框架初探-Dapper与PetaPoco的基本使用
一.EntityFramework EF是传统的ORM框架,也是一个比较重量级的ORM框架.这里仍然使用EF的原因在于为了突出轻量级ORM框架的性能,所谓有对比才有更优的选择. 1.1 准备一张数据库 ...
- c# 轻量级ORM框架 实现(一)
发布一个自己写的一个轻量级ORM框架,本框架设计期初基于三层架构.所以从命名上来看,了解三层的朋友会很好理解. 设计该框架的目的:不想重复的写增删改查,把精力放到功能实现上. 发布改框架的原因:希望给 ...
- 轻量级ORM框架 QX_Frame.Bantina(二、框架使用方式介绍)
轻量级ORM框架QX_Frame.Bantina系列讲解(开源) 一.框架简介 http://www.cnblogs.com/qixiaoyizhan/p/7417467.html 二.框架使用方式介 ...
- 轻量级ORM框架 QX_Frame.Bantina(一、框架简介)
轻量级ORM框架QX_Frame.Bantina系列讲解(开源) 一.框架简介 http://www.cnblogs.com/qixiaoyizhan/p/7417467.html 二.框架使用方式介 ...
- .NET轻量级ORM框架Dapper入门精通
一.课程介绍 本次分享课程包含两个部分<.NET轻量级ORM框架Dapper修炼手册>和<.NET轻量级ORM框架Dapper葵花宝典>,阿笨将带领大家一起领略轻量级ORM框架 ...
- 轻量级ORM框架Dapper应用一:Dapper安装
一.Dapper简介 Dapper是一款轻量级ORM框架,为解决网站访问流量极高而产生的性能问题而构造,主要通过执行TSQL表达式而实现数据库的CQRS. 如果你在项目中遇到性能访问问题,选择Dapp ...
- 分享自己写的基于Dapper的轻量级ORM框架~
1.说明 本项目是一个使用.NET Standard 2.0开发的,基于 Dapper 的轻量级 ORM 框架,包含基本的CRUD以及根据表达式进行一些操作的方法,目前只针对单表,不包含多表连接操作. ...
- C# 性能优化 之 秒表 Stopwatch。 Dapper一个和petapoco差不多的轻量级ORM框架
Sweet小马 小马同学的编程日记. C# 性能优化 之 秒表 Stopwatch. 生词解释:Diagnostics[,daɪəg'nɑstɪks] n.诊断学 using System.Diagn ...
随机推荐
- Nginx服务优化详解
Nginx服务优化详解 1.隐藏Nginx版本信息 编辑主配置文件nginx.conf,在http标签中添加代码 server_tokens off;来隐藏软件版本号. 2.更改Nginx服务启动的默 ...
- 【多视图几何】TUM 课程 第2章 刚体运动
课程的 YouTube 地址为:https://www.youtube.com/playlist?list=PLTBdjV_4f-EJn6udZ34tht9EVIW7lbeo4 .视频评论区可以找到课 ...
- jQuery遍历方式
对象遍历
- SolrJ案例实现搭建环境——(十五)
案例
- oggMonitor是什么
goldengate monitor是一套监控goldengate的软件,如果安装的ogg比较多,使用goldengate monitor可以清楚的看见全部OGG的每个进程运行状态,以及整个OGG的架 ...
- python(13)多线程:线程池,threading
python 多进程:多进程 先上代码: pool = threadpool.ThreadPool(10) #建立线程池,控制线程数量为10 reqs = threadpool.makeRequest ...
- Maven仓库国内镜像站
感谢阿里巴巴,搭建并公开了Maven仓库的国内镜像站.话外:使用Maven的官方仓库真的是太slow了! 在<Maven Root>/conf/settings.xml中的<mirr ...
- linux中core dump开启使用教程【转】
转自:http://www.111cn.net/sys/linux/67291.htm 一.什么是coredump 我们经常听到大家说到程序core掉了,需要定位解决,这里说的大部分是指对应程序由于各 ...
- Linux USB驱动框架分析 【转】
转自:http://blog.chinaunix.net/uid-11848011-id-96188.html 初次接触与OS相关的设备驱动编写,感觉还挺有意思的,为了不至于忘掉看过的东西,笔记跟总结 ...
- [android]Intent跳转新的Activity可以传递数据过去
两种方式: 一,直接通过Bundle对象来传递: 如果我们想要给“收件人”Activity说点什么的话,那么可以通过下面这封“E-mail”来将我们的消息传递出去 Intent intent=new ...