手工搭建基于ABP的框架(2) - 访问数据库
为了防止不提供原网址的转载,特在这里加上原文链接:
http://www.cnblogs.com/skabyy/p/7517397.html
本篇我们实现数据库的访问。我们将实现两种数据库访问方法来访问一个SQLite数据库——使用NHibernate实现的ORM映射访问和使用Dapper实现的SQL语句访问。然后完成前一篇未完成的CreateTweet
和GetTweets
接口。
在开始之前,先做一些准备工作,新建Domain层的Module:
public class MyTweetDomainModule : AbpModule
{
public override void Initialize()
{
IocManager.RegisterAssemblyByConvention(Assembly.GetExecutingAssembly());
}
}
同时MyTweetApplicationModule
添加对MyTweetDomainModule
的依赖:
[DependsOn(typeof(MyTweetDomainModule))]
public class MyTweetApplicationModule : AbpModule
安装NuGet包Abp.NHibernate
到MyTweet.Domain
和MyTweet.Infrastructure
。
下面我们将完成这些步骤来实现数据库的访问:
- 配置数据库连接
- 新建
tweet
表以及相应的Model类型 - 实现访问数据的Repository
- 用Dapper实现通过SQL访问数据库
使用Fluent NHibernate配置数据库连接
我们这里使用的数据库是SQLite数据库,其他数据库的配置也是类似的。我们将连接到App_Data
文件夹下的一个SQLite数据库。新建LocalDbSessionProvider
类并在构造函数处配置数据库连接。由于LocalDbSessionProvider
实现了接口ISingletonDependency
,模块初始化时LocalDbSessionProvider
会以单例的形式注册到IoC容器。
public class LocalDbSessionProvider : ISessionProvider, ISingletonDependency, IDisposable
{
protected FluentConfiguration FluentConfiguration { get; private set; }
private ISessionFactory _sessionFactory;
public LocalDbSessionProvider()
{
FluentConfiguration = Fluently.Configure();
// 数据库连接串
var connString = "data source=|DataDirectory|MySQLite.db;";
FluentConfiguration
// 配置连接串
.Database(SQLiteConfiguration.Standard.ConnectionString(connString))
// 配置ORM
.Mappings(m => m.FluentMappings.AddFromAssembly(Assembly.GetExecutingAssembly()));
// 生成session factory
_sessionFactory = FluentConfiguration.BuildSessionFactory();
}
private ISession _session;
public ISession Session
{
get
{
if (_session != null)
{
// 每次访问都flush上一个session。这里有效率和多线程问题,暂且这样用,后面会改。
_session.Flush();
_session.Dispose();
}
_session = _sessionFactory.OpenSession();
return _session;
}
}
public void Dispose()
{
_sessionFactory.Dispose();
}
}
这里每次用到session都只是简单地把上一次的session flush
了,然后打开新的session。这会有效率和多线程冲突的问题。这里只是单纯为了展示实现数据库链接的方法而先用的简单实现。后面做工作单元(UoW)时会解决这个问题。
为了NHibernate能创建SQLite的连接,还需要安装System.Data.SQLite.Core
到MyTweet.Web
(其他数据库的话要安装其他相应的包)。
新建tweet
表以及相应的Model类型
我们用tweet
表保存tweet数据。tweet数据表接口以及对应Model属性如下:
数据库字段 | Model属性 | 类型 | 描述 |
---|---|---|---|
pk_id |
PkId |
string |
主键 |
content |
Content |
string |
内容 |
create_time |
CreateTime |
string |
创建时间 |
使用SQLite工具新建MySQLite.db文件,并新建表tweet
。
然后将MySQLite.db文件拷贝到App_Data
文件夹下。
CREATE TABLE `tweet` (
`pk_id` TEXT,
`content` TEXT,
`create_time` TEXT NOT NULL,
PRIMARY KEY(`pk_id`)
);
接下来新建Model类Tweet
以及映射TweetMapper
。Tweet
继承Entity<string>
,其中的string
表示Tweet
的主键Id
是string
类型的。TweetMapper
继承ClassMap<Tweet>
,上面LocalDbSessionProvider
构造函数执行到.Mappings(m => m.FluentMappings.AddFromAssembly(Assembly.GetExecutingAssembly()))
这个方法时,会用反射的方式搜索程序集中ClassMap<T>
的子类,建立Model和数据库表的映射(Tweet
和tweet
表的映射)。
public class Tweet : Entity<string> // 主键为string类型
{
public string Content { get; set; }
public DateTime CreateTime { get; set; }
}
public class TweetMapper : ClassMap<Tweet>
{
public TweetMapper()
{
// 禁用惰性加载
Not.LazyLoad();
// 映射到表tweet
Table("tweet");
// 主键映射
Id(x => x.Id).Column("pk_id");
// 字段映射
Map(x => x.Content).Column("content");
Map(x => x.CreateTime).Column("create_time");
}
}
实现Repository与增查接口
Repository即是DDD中的仓储,它封装了数据对象的增删改查操作。ABP的NhRepositoryBase
已经实现了常用的增删改查功能,因此这里只需要继承一下就行了。
public interface ITweetRepository : IRepository<Tweet, string> { }
public class TweetRepository : NhRepositoryBase<Tweet, string>, ITweetRepository
{
public TweetRepository()
: base(IocManager.Instance.Resolve<LocalDbSessionProvider>())
{ }
}
最后,修改MyTweetAppService
,实现CreateTweet
接口和GetTweets
接口。
public class CreateTweetInput
{
public string Content { get; set; }
}
public class MyTweetAppService : ApplicationService, IMyTweetAppService
{
public ITweetRepository TweetRepository { get; set; }
public object GetTweets(string msg)
{
return TweetRepository.GetAll().OrderByDescending(x => x.CreateTime).ToList();
}
public object CreateTweet(CreateTweetInput input)
{
var tweet = new Tweet
{
Id = Guid.NewGuid().ToString("N"),
Content = input.Content,
CreateTime = DateTime.Now
};
var o = TweetRepository.Insert(tweet);
return o;
}
}
大功告成!测试一下。用Postman调用CreateTweet
接口插入一条tweet:
然后调用GetTweets
查询:
ABP的依赖注入
可能有同学会疑惑,在MyTweetAppService
中只声明了ITweetRepository
类型的属性TweetRepository
,但是并没有进行赋值,那么这个属性的对象实例是哪里来的呢?这就涉及到ABP框架的依赖注入策略了。
ABP基于Castle Windsor框架实现自己的依赖注入功能。依赖注入最基本的功能无非是注册(Register
)和解析(Resolve
)两个,注册功能将对象注册到IoC容器,解析功能根据类名或接口名获从IoC容器获取已注册的对象。我们可以直接通过IocManager
获得Castle Windsor的IoC容器,直接进行注册和解析操作。
// 以单例模式注册类型T
IocManager.Register<T>(Abp.Dependency.DependencyLifeStyle.Singleton);
// 以临时对象模式注册类型T,解析的时候会生成T的一个新对象
IocManager.Register<T>(Abp.Dependency.DependencyLifeStyle.Transient);
// 从IoC容器解析已注册的类型T的对象
var obj = IocManager.Resolve<T>();
还有一些其他方法可以做注册和解析,具体可以参照ABP的文档。不过一般都不需要使用这些方法。ABP框架有一套依赖注入的规则,通过编写应用程序时遵循最佳实践和一些约定,使得依赖注入对于开发者几乎是透明的。
ABP的注册
基本上每个模块的初始化方法都会有这么一行代码:
IocManager.RegisterAssemblyByConvention(Assembly.GetExecutingAssembly());
模块初始化时,ABP会搜索这个模块所在的程序集,自动注册满足常规注册条件与实现帮助接口的类。
常规注册
ABP自动注册所有Repositories, Domain Services, Application Services, MVC 控制器和Web API控制器。ABP通过判断是否实现了相应接口来判断是不是上述几类。例如下面的MyAppService
:
public interface IMyAppService : IApplicationService { }
public class MyAppService : IMyAppService { }
由于它实现了接口IApplicationService
,ABP会自动注册,我们就可以通过IMyAppService
解析出一个MyAppService
对象。
通过常规注册的类的生命期都是transient(临时的),每次解析时都会生成一个新的临时对象。
帮助接口
ABP另外提供了ITransientDependency
和ISingletonDependency
两个接口。这两个接口前面也有用到过了。实现了ITransientDependency
的类会被注册为transient。而实现了ISingletonDependency
的类则被注册为单例。
ABP的解析
除了手工解析外,还可以通过构造函数和公共属性注入来获取类的依赖。这也是最常用的方法。例如:
public class MyAppService : IMyAppService
{
public ILogger Logger { get; set; }
private IMyRepository _repo;
public MyAppService(IMyRepository repo)
{
_repo = repo;
}
}
ILogger
从公共属性注入,IMyRepository
从构造函数注入。注入过程对开发者是透明的,开发者不需要去写注入的代码。
QueryService - 使用SQL语句查询数据
实际开发中,经常需要直接使用SQL进行数据访问。查询逻辑比较复杂时直接使用SQL可以避免复杂的Mapper。通常复杂的Mapper会导致低效率的查询甚至会触发NHibernate一些奇怪的bug。实际上,在开发中,对于单纯的读取数据的功能(即使查询逻辑不复杂),我们建议直接使用SQL查询实现。直接使用SQL查询在调试时更为方便——直接拷贝SQL语句到SQL客户端执行即可检验该语句是否正确。
下面简要介绍一下使用Dapper来实现数据库查询功能。封装了sql查询操作的类我们称为QueryService。
首先,安装dapper
包到MyTweet.Infrastructure
。在MyTweet.Infrastructure
实现QueryService的基类BaseQueryService
:
public class BaseQueryService : ITransientDependency
{
private ISessionProvider _sessionProvider;
protected BaseQueryService(ISessionProvider sessionProvider)
{
_sessionProvider = sessionProvider;
}
public IEnumerable<T> Query<T>(string sql, object param = null)
{
var conn = _sessionProvider.Session.Connection;
return conn.Query<T>(sql, param);
}
}
Dapper给System.Data.IDbConnection
接口扩展了Query<T>
方法,该方法执行SQL查询并将查询结构映射为IEnumerable<T>
类型的对象。为了使用这个扩展方法,还需在文件开头加个using
语句。
using Dapper;
QueryService并不在ABP依赖注入的常规注册规则里,所以让BaseQueryService
实现了ITransientDependency
,这样它的子类都会自动被注册到IoC容器。
接下来在MyTweet.Domain
新建类TweetQueryService
,它负责实现具体的SQL查询。方法SearchTweets
实现了查询包含关键词keyword
的所有tweet。
public interface ITweetQueryService
{
IList<Tweet> SearchTweets(string keyword);
}
public class TweetQueryService : BaseQueryService, ITweetQueryService
{
public TweetQueryService() : base(IocManager.Instance.Resolve<LocalDbSessionProvider>())
{ }
public IList<Tweet> SearchTweets(string keyword)
{
var sql = @"select
pk_id Id,
content Content,
create_time CreateTime
from tweet
where content like '%' || @Keyword || '%'";
return Query<Tweet>(sql, new { Keyword = keyword ?? "" }).ToList();
}
}
最后在MyTweetAppService
实现查询tweet数据的接口GetTweetsFromQS
:
public ITweetQueryService TweetQueryService { get; set; }
public object GetTweetsFromQS(string keyword)
{
return TweetQueryService.SearchTweets(keyword);
}
测试一下:
结束
本文介绍了通过NHibernate以及Dapper进行数据库访问的方法,简单说明了ABP依赖注入策略。现在数据库连接部分的代码只是单纯为了演示的简单实现,没有做合理的数据库Session管理,会有效率和多线程冲突的问题。后面会加上工作单元(Unit of Work)来解决这些问题。
最后,放上代码链接:https://github.com/sKabYY/MyTweet-AbpDemo
手工搭建基于ABP的框架(2) - 访问数据库的更多相关文章
- 手工搭建基于ABP的框架 - 工作单元以及事务管理
一个业务功能往往不只由一次数据库请求(或者服务调用)实现.为了功能的完整性,我们希望如果该功能执行一半时出错,则撤销前面已执行的改动.在数据库层面上,事务管理实现了这种完整性需求.在ABP中,一个完整 ...
- 手工搭建基于ABP的框架(3) - 登录,权限控制与日志
为了防止不提供原网址的转载,特在这里加上原文链接: http://www.cnblogs.com/skabyy/p/7695258.html 本篇将实现登录.权限控制.日志配置与审计日志的功能.首先我 ...
- phoenix 使用activerecord模式框架ecto 访问数据库
备注: 需要先安装mysql 以及phoenix 框架,测试使用的是docker 进行安装,具可以参考代码 1. 创建项目 mix phx.new first --database mys ...
- ABP框架用Dapper实现通过SQL访问数据库
ABP的框架(2) - 访问数据库 为了防止不提供原网址的转载,特在这里加上原文链接:http://www.cnblogs.com/skabyy/p/7517397.html 本篇我们实现数据库的 ...
- 手工搭建ABP框架(1) - Web项目
为了防止不提供原网址的转载,特在这里加上原文链接: http://www.cnblogs.com/skabyy/p/7295533.html ABP是 ASP.NET Boilerplate Proj ...
- ABP架构学习系列三:手工搭建ABP框架
由于公司的项目才接触到ABP这个框架,当时就觉得高大上,什么IOC.AOP.ddd各种专业词汇让人激情 澎湃,但在使用过程中碰到了许多坑,可能也许是没有去看源码导致的,但工作确实没有那么多时间让人去慢 ...
- 第二篇 基于.net搭建热插拔式web框架(沙箱的构建)
上周五写了一个实现原理篇,在评论中看到有朋友也遇到了我的问题,真的是有种他乡遇知己的感觉,整个系列我一定会坚持写完,并在最后把代码开源到git中.上一篇文章很多人看了以后,都表示不解,觉得不知道我到底 ...
- 基于.net搭建热插拔式web框架(实现原理)
第一节:我们为什么需要一个热插拔式的web框架? 模块之间独立开发 假设我们要做一个后台管理系统,其中包括“用户活跃度”.“产品管理”."账单管理"等模块.每个模块中有自己的业务特 ...
- ABP从入门到精通(5):使用基于JWT标准的Token访问WebApi
项目:asp.net zero 4.2.0 .net core(1.1) 版本 我们做项目的时候可能会遇到需要提供api给app调用,ABP动态生成的WebApi提供了方便的基于JWT标准的Token ...
随机推荐
- 【转】Python装饰器与面向切面编程
原文请参考: http://www.cnblogs.com/huxi/archive/2011/03/01/1967600.html 今天来讨论一下装饰器.装饰器是一个很著名的设计模式,经常被用于有切 ...
- Jquery实现按钮点击遮罩加载,处理完后恢复
<%@ Page Language="C#" AutoEventWireup="true" CodeFile="EasyUiLoad.aspx. ...
- IsKeyboardFocused -- 键盘焦点
<Trigger Property="IsKeyboardFocused" Value="true"> <!--<Setter Prop ...
- java 静态代码块 代码块 构造函数 静态成员变量 成员变量的初始化顺序
没有父类的情况 1,静态代码块-->静态成员变量-->成员变量(实例属性)-->代码块-->构造函数 2, 静态代码块 和 静态成员变量 只会初始化一次 有父类的情况 1,父类 ...
- java连接sqlserver2008r2 心得
现在是该轻松一笑的时候了,困扰已久的问题有了解释了. 之前的各种连不上,说到底还是权限问题,sqlserver2008r2的权限分得太细了. 两个实例间数据库互相都看不到,更不用谈访问了. 端口号也是 ...
- Appium-desktop安装与使用
Appium-desktop是什么? 项目描述: Appium Server and Inspector in Desktop GUIs for Mac, Windows, and Linux. Ap ...
- Scrapy架构及其组件之间的交互
最近在学Python,同时也在学如何使用python抓取数据,于是就被我发现了这个非常受欢迎的Python抓取框架Scrapy,下面一起学习下Scrapy的架构,便于更好的使用这个工具. 一.概述 下 ...
- 阿里巴巴Java开发规约插件p3c详细教程及使用感受
阿里巴巴Java开发手册 在进入正题介绍这款插件之前,首先来谈一下<阿里巴巴Java开发手册>,2017年年初,首次公开的阿里官方Java代码规范标准手册可以说是引起了全民(IT界)代码规 ...
- Akka(30): Http:High-Level-Api,Routing DSL
在上篇我们介绍了Akka-http Low-Level-Api.实际上这个Api提供了Server对进来的Http-requests进行处理及反应的自定义Flow或者转换函数的接入界面.我们看看下面官 ...
- canvas画布标签
最近良师益友整理一些canvas的资料,加强学习了解! 当你创建一个<canvas>元素后,就拥有了它的绘图上下文. 一.简单图形 1.getContext()方法 为了在canvas上绘 ...