基于 abp vnext 和 .net core 开发博客项目 -凯发k8官方网
基于 abp vnext 和 .net core 开发博客项目 - 自定义仓储之增删改查
转载于:https://github.com/meowv/blog
本篇说一下自定义仓储的实现方式,其实在abp框架中已经默认给我们实现了默认的通用(泛型)仓储,irepository
之所以实现自定义仓储,是因为abp没有给我们实现批量插入、更新的方法,这个是需要自己去扩展的。
既然是自定义仓储,那么就有了很高的自由度,我们可以任意发挥,可以接入第三方批量处理数据的库,可以接入dapper操作等等,在这里贴一下微软官方推荐的一些ef core的工具和扩展:https://docs.microsoft.com/zh-cn/ef/core/extensions/ 。
自定义仓储
在.domain领域层中创建仓储接口,ipostrepository、icategoryrepository、itagrepository、iposttagrepository、ifriendlinkrepository,这里直接全部继承 irepository
可以转到irepository
图片
看看abp对于仓储的介绍,如下:
irepository
abp提供了 ibasicrepository
你可以扩展这些接口(并可选择性地从basicrepositorybase派生)为你的实体创建自定义存储库。
依赖于 ibasicrepository 而不是依赖 irepository 有一个优点, 即使它们不支持 iqueryable 也可以使用所有的数据源, 但主要的供应商, 像 entity framework, nhibernate 或 mongodb 已经支持了 iqueryable。
因此, 使用 irepository 是典型应用程序的 建议方法。但是可重用的模块开发人员可能会考虑使用 ibasicrepository 来支持广泛的数据源。
对于想要使用只读仓储提供了ireadonlyrepository
仓储接口类如下:
//ipostrepository.cs
using volo.abp.domain.repositories;
namespace meowv.blog.domain.blog.repositories
{
///
/// ipostrepository
///
public interface ipostrepository : irepository
{
}
}
//icategoryrepository.cs
using volo.abp.domain.repositories;
namespace meowv.blog.domain.blog.repositories
{
///
/// icategoryrepository
///
public interface icategoryrepository : irepository
{
}
}
//itagrepository.cs
using system.collections.generic;
using system.threading.tasks;
using volo.abp.domain.repositories;
namespace meowv.blog.domain.blog.repositories
{
///
/// itagrepository
///
public interface itagrepository : irepository
{
///
/// 批量插入
///
///
///
task bulkinsertasync(ienumerable tags);
}
}
//iposttagrepository.cs
using system.collections.generic;
using system.threading.tasks;
using volo.abp.domain.repositories;
namespace meowv.blog.domain.blog.repositories
{
///
/// iposttagrepository
///
public interface iposttagrepository : irepository
{
///
/// 批量插入
///
///
///
task bulkinsertasync(ienumerable posttags);
}
}
//ifriendlinkrepository.cs
using volo.abp.domain.repositories;
namespace meowv.blog.domain.blog.repositories
{
///
/// ifriendlinkrepository
///
public interface ifriendlinkrepository : irepository
{
}
}
在itagrepository和iposttagrepository仓储接口中,我们添加了批量插入的方法。相对于的在我们的.entityframeworkcore层实现这些接口。
创建repositories/blog 文件夹,添加实现类:postrepository、categoryrepository、tagrepository、posttagrepository、friendlinkrepository。
不知道大家发现没有,我们的仓储接口以及实现,都是以repository结尾的,这和我们的.application应用服务层都以service结尾是一个道理。
在自定义仓储的实现中,我们可以使用任意你想使用的数据访问工具,我们这里还是继续用entity framework core,需要继承efcorerepository
图片
efcorerepository默认实现了许多默认的方法,然后就可以直接使用 dbcontext 来执行操作了。
仓储接口实现类如下:
//postrepository.cs
using meowv.blog.domain.blog;
using meowv.blog.domain.blog.repositories;
using volo.abp.domain.repositories.entityframeworkcore;
using volo.abp.entityframeworkcore;
namespace meowv.blog.entityframeworkcore.repositories.blog
{
///
/// postrepository
///
public class postrepository : efcorerepository
{
public postrepository(idbcontextprovider dbcontextprovider) : base(dbcontextprovider)
{
}
}
}
//categoryrepository.cs
using meowv.blog.domain.blog;
using meowv.blog.domain.blog.repositories;
using volo.abp.domain.repositories.entityframeworkcore;
using volo.abp.entityframeworkcore;
namespace meowv.blog.entityframeworkcore.repositories.blog
{
///
/// categoryrepository
///
public class categoryrepository : efcorerepository
{
public categoryrepository(idbcontextprovider dbcontextprovider) : base(dbcontextprovider)
{
}
}
}
//tagrepository.cs
using meowv.blog.domain.blog;
using meowv.blog.domain.blog.repositories;
using system.collections.generic;
using system.threading.tasks;
using volo.abp.domain.repositories.entityframeworkcore;
using volo.abp.entityframeworkcore;
namespace meowv.blog.entityframeworkcore.repositories.blog
{
///
/// tagrepository
///
public class tagrepository : efcorerepository
{
public tagrepository(idbcontextprovider dbcontextprovider) : base(dbcontextprovider)
{
}
}
//posttagrepository.cs
using meowv.blog.domain.blog;
using meowv.blog.domain.blog.repositories;
using system.collections.generic;
using system.threading.tasks;
using volo.abp.domain.repositories.entityframeworkcore;
using volo.abp.entityframeworkcore;
namespace meowv.blog.entityframeworkcore.repositories.blog
{
///
/// posttagrepository
///
public class posttagrepository : efcorerepository
{
public posttagrepository(idbcontextprovider dbcontextprovider) : base(dbcontextprovider)
{
}
}
//friendlinkrepository.cs
using meowv.blog.domain.blog;
using meowv.blog.domain.blog.repositories;
using volo.abp.domain.repositories.entityframeworkcore;
using volo.abp.entityframeworkcore;
namespace meowv.blog.entityframeworkcore.repositories.blog
{
///
/// posttagrepository
///
public class friendlinkrepository : efcorerepository
{
public friendlinkrepository(idbcontextprovider dbcontextprovider) : base(dbcontextprovider)
{
}
}
}
在tagrepository和posttagrepository仓储接口的实现中,因为数据量不大,可以直接用了ef core自带的addrangeasync批量保存数据。
到这里,关于博客的自定义仓储便完成了,此时项目层级目录图,如下:
图片
增删改查
接下来在就可以在.application服务层愉快的玩耍了,写服务之前,我们要分析我们的项目,要有哪些功能业务。由于是博客项目,无非就是一些增删改查。今天先不写博客业务,先完成对数据库文章表meowv_posts的一个简单crud。
在.application层新建blog文件夹,添加一个iblogservice.cs博客接口服务类,分别添加增删改查四个方法。
这时就要用到我们的数据传输对象(dto)了,简单理解,dto就是从我们的领域模型中抽离出来的对象,它是很纯粹的只包含我们拿到的数据,不参杂任何行为逻辑。
在.application.contracts层新建blog文件夹,同时新建一个postdto.cs类,与.domain层中的post.cs与之对应,他们很相似,但是不一样。
于是iblogservice.cs接口服务类的crud为:
//iblogservice.cs
using meowv.blog.application.contracts.blog;
using system.threading.tasks;
namespace meowv.blog.application.blog
{
public interface iblogservice
{
task insertpostasync(postdto dto);
}
接口写好了,少不了实现方式,直接在blog文件夹新建impl文件夹,用来存放我们的接口实现类blogservice.cs,注意:都是以service结尾的噢~
实现服务接口除了要继承我们的iblogservice外,不要忘了还需依赖我们的servicebase类。由于我们之前直接接入了autofac,可以直接使用构造函数依赖注入的方式。
//blogservice.cs
using meowv.blog.application.contracts.blog;
using meowv.blog.domain.blog.repositories;
using system;
using system.threading.tasks;
namespace meowv.blog.application.blog.impl
{
public class blogservice : servicebase, iblogservice
{
private readonly ipostrepository _postrepository;
}
现在就可以实现我们写的iblogservice接口了。
先写添加,这里实现方式全采用异步的方法,先构建一个post实体对象,具体内容参数都从postdto中获取,由于主键之前设置了自增,这里就不用管它了。然后调用 await _postrepository.insertasync(entity);,正好它返回了一个创建成功的post对象,那么我们就可以判断对象是否为空,从而确定文章是否添加成功。
代码如下:
…
public async task insertpostasync(postdto dto)
{
var entity = new post
{
title = dto.title,
author = dto.author,
url = dto.url,
html = dto.html,
markdown = dto.markdown,
categoryid = dto.categoryid,
creationtime = dto.creationtime
};
…
然后在.httpapi层和之前添加helloworldcontroller一样,添加blogcontroller。调用写的insertpostasync方法,如下:
//blogcontroller.cs
using meowv.blog.application.blog;
using meowv.blog.application.contracts.blog;
using microsoft.aspnetcore.mvc;
using system.threading.tasks;
using volo.abp.aspnetcore.mvc;
namespace meowv.blog.httpapi.controllers
{
[apicontroller]
[route("[controller]")]
public class blogcontroller : abpcontroller
{
private readonly iblogservice _blogservice;
}
添加博客操作,我们将其设置为[httppost]方式来提交,因为现在开发接口api,都要遵循restful方式,所以就不用给他指定路由了,[frombody]的意思是在请求正文中以json的方式来提交参数。
完成上述操作,打开我们的swagger文档看看, …/swagger/index.html ,已经出现我们的接口了。
图片
随手就试一下这个接口,能否成功创建文章。
图片
可以看到数据库已经躺着我们刚刚添加数据内容。
将剩下的三个接口一一实现,相信大家肯定都知道怎么写了。就不逐一唠叨了,代码如下:
…
public async task deletepostasync(int id)
{
await _postrepository.deleteasync(id);
…
在这里先暂时不做参数校验,咱们默认都是正常操作,如果执行操作成功,直接返回true。大家会发现,当我们使用了dto后,写了大量对象的转换,在这里暂不做优化,将在后续业务开始后使用automapper处理对象映射。如果大家感兴趣可以自己先试一下。
在controller中调用,代码如下:
…
///
/// 删除博客
///
///
///
[httpdelete]
public async task deletepostasync([required] int id)
{
return await _blogservice.deletepostasync(id);
}
…
deletepostasync:指定了请求方式[httpdelete],参数id为必填项
updatepostasync:指定了请求方式[httpput],参数id为必填项并且为url的一部分,要更新的具体内容和添加博客的方法insertpostasync的一样的
getpostasync:指定了请求方式[httpget],参数id为必填项
ok,打开swagger文档看看效果,并试试我们的接口是否好使吧,反正我试了是没有问题的。
图片
做到这一步的项目层级目录如下:
图片
本篇使用自定义仓储的方式完成了对博客(meowv_posts)的增删改查,你学会了吗?😁😁😁
开源地址:https://github.com/meowv/blog/tree/blog_tutorial
总结
以上是凯发k8官方网为你收集整理的基于 abp vnext 和 .net core 开发博客项目 - 自定义仓储之增删改查的全部内容,希望文章能够帮你解决所遇到的问题。
- 上一篇:
- 下一篇: 基于 abp vnext 和 .net