ABP架构学习系列三:手工搭建ABP框架

  1. 云栖社区>
  2. 博客>
  3. 正文

ABP架构学习系列三:手工搭建ABP框架

芝麻软件 2017-12-04 17:44:00 浏览2204

  由于公司的项目才接触到ABP这个框架,当时就觉得高大上,什么IOC、AOP、ddd各种专业词汇让人激情 澎湃,但在使用过程中碰到了许多坑,可能也许是没有去看源码导致的,但工作确实没有那么多时间让人去慢慢研究。很久之前想手动搭建这个框架了,但是各种理由,你懂的。但是要在技术上得到大的提升就得静的下心去研究,学到大神的思想和精髓,运用到实际中去,才能去体验更开阔的天地。

  本文以创建博客为思路,一步步构建整个项目,在摸索中进步,也希望能够帮助到有需要的人。

一、基础架构

  第一部分主要是搭建好整个项目的骨架,连通各个项目

  创建MVC5项目(ZmBlog.Web),手动引入Abp、Abp.Web、Abp.Web.Mvc、Abp.Web.Api
  
  详情请看上一篇第一部分:http://www.cnblogs.com/xcsn/p/7941541.html
  接下来,继续创建其他类库ZmBlog.Core、ZmBlog.Infrastructure、ZmBlog.Application。
  引入相关nuget包,所有项目引用abp,ZmBlog.Infrastructure引用Abp.EntityFramework,web项目引用后两个
Install-Package Abp -Version 0.8.4
Install-Package Abp.EntityFramework -Version 0.8.4
Install-Package Abp.Web.Mvc -Version 0.8.4
Install-Package Abp.Web.Api -Version 0.8.4
  

二、ZmBlog.Core

  ZmBlog.Core是DDD的核心,实体、领域服务、事件等一般都写在这里,同时也定义了仓储的接口,但实现放在基础设施层。
 首先,添加类ZmBlogCoreModule,如下
namespace ZmBlog.Core
{
    public class ZmBlogCoreModule:AbpModule
    { 
        public override void Initialize()
        { 
            IocManager.RegisterAssemblyByConvention(Assembly.GetExecutingAssembly()); 
        }
    }
}

 ZmBlogCoreModule必须依赖于AbpModule,ZmBlogCoreModule是自定义模块第一个启动的,另外,ZmBlogCoreModule启动之前,abp会先启用内部的AbpKernelModule。

AbpKernelModule类是Abp框架自己的Module,它也跟所有其他的Module一样继承自AbpModule,重写PreInitialize,Initialize,PostInitialize三个主要成员。

更详细的请参考:https://www.cnblogs.com/Azula/archive/2015/11/23/4989157.html

 

现在,定义一个实体文章分类Category,继承自Entity<TPrimaryKey>

    public class Category: Entity<string>
    {
        public Category()
        {
            Id = Guid.NewGuid().ToString();
        }
        /// <summary>
        /// 类别名称
        /// </summary>
        public string Name { get; set; }
        /// <summary>
        /// 状态(0隐藏1显示)
        /// </summary>
        public int Status { get; set; }
    }

以下是Entity<TPrimaryKey>的成员,其中定义了主键Id(可重写)

 接着,添加一个仓储接口ICategoryRepository

public interface ICategoryRepository : IRepository<Category,string>{}

另外,还可以添加领域服务ICategoryDomainService、CategoryDomainService,对于业务简单的模块,可以去掉领域服务,直接在应用层处理。

public interface ICategoryDomainService:IDomainService{}

public class CategoryDomainService : DomainService, ICategoryDomainService{}

 三、ZmBlog.Infrastructure

1.定义模块

创建一个模块ZmBlogDataModule,依赖模块AbpEntityFrameworkModule会自动注册了所有仓储接口

[DependsOn(typeof(ZmBlogCoreModule),typeof(AbpEntityFrameworkModule))]
    public class ZmBlogDataModule : AbpModule
    { 
        public override void Initialize()
        {
             IocManager.RegisterAssemblyByConvention(Assembly.GetExecutingAssembly());
        }
    }

2.使用EF作为orm

 使用以下命令引入包

Install-Package EntityFramework -Version 6.1.3

Install-Package Castle.Windsor -Version 3.3.0

(1)创建ZmBlogDbContext

 public class ZmBlogDbContext: AbpDbContext
    {
        public ZmBlogDbContext()
            : base("DefaultConnection")
        {
        }

        public ZmBlogDbContext(string nameOrConnectionString)
            : base(nameOrConnectionString)
        {
        }

        //This constructor is used in tests
        public ZmBlogDbContext(DbConnection connection)
            : base(connection, true)
        {
        }

        public DbSet<Category> Categorys { get; set; }
        
        protected override void OnModelCreating(DbModelBuilder modelBuilder)
        {
            base.OnModelCreating(modelBuilder); 
            modelBuilder.Conventions.Remove<OneToManyCascadeDeleteConvention>();


            modelBuilder.Configurations.Add(new CategoryCfg());//使用独立配置 

        }
    } 

DefaultConnection是连接字符串名称,在web项目添加或修改如下

<connectionStrings>
    <add name="DefaultConnection" connectionString="Data Source=.;Initial Catalog=ZmBlogDb;Integrated Security=True" providerName="System.Data.SqlClient" />
  </connectionStrings>

CategoryCfg是对实体类型的配置,如设置Id为主键

public class CategoryCfg: EntityTypeConfiguration<Category>
    {
        public CategoryCfg()
        {
            HasKey(s => s.Id);
        }
    }

 

(2)使用codefirst模式

1.启用迁移

启用:Enable-Migrations
自动生成配置文件:Configuration.cs
2.创建迁移
add-migration AddCategory
自动生成迁移文件:201712040256502_AddCategory
3.执行迁移
update-database -vebose
自动生成数据库ZmBlogDb、迁移记录表__MigrationHistory、表Categories

 (3)实现仓储

基础类BaseRepository,继承实现增删改查

public  abstract  class BaseRepository<TEntity, TPrimaryKey> :EfRepositoryBase<ZmBlogDbContext,TEntity,TPrimaryKey> where TEntity : class, IEntity<TPrimaryKey>
    {
        protected BaseRepository(IDbContextProvider<ZmBlogDbContext> dbContextProvider)
            : base(dbContextProvider)
        {

        }

        //add common methods for all repositories
    }
    public abstract class BaseRepository<TEntity> : BaseRepository<TEntity, string>
        where TEntity : class, IEntity<string>
    {
        protected BaseRepository(IDbContextProvider<ZmBlogDbContext> dbContextProvider)
            : base(dbContextProvider)
        {

        }

        //do not add any method here, add to the class above (since this inherits it)
    }

自定义的实现类,如下

 public class CategoryRepository : BaseRepository<Category, string>, ICategoryRepository
    {
        public CategoryRepository(IDbContextProvider<ZmBlogDbContext> dbContextProvider) : base(dbContextProvider)
        {
        }
    }

四、ZmBlog.Application

1.添加模块

添加模块 ZmBlogApplicationModule

namespace ZmBlog.Application
{
    [DependsOn(typeof(ZmBlogCoreModule), typeof(ZmBlogDataModule))]
    public class ZmBlogApplicationModule:AbpModule
    {
        public override void Initialize()
        { 
            IocManager.RegisterAssemblyByConvention(Assembly.GetExecutingAssembly());
        }
    }
}

2.创建服务

在项目下添加文件夹Categories,然后添加服务接口和实现类,如

ICategoryApp

public interface ICategoryApp:IApplicationService
    {
        string GetCategoryName(string id);
    } 

CategoryApp

namespace ZmBlog.Application.Categories
{
    public class CategoryApp : ApplicationService, ICategoryApp
    {
        private readonly IRepository<Category, string> _categoryRepository;

        public CategoryApp(IRepository<Category, string> categoryRepository)
        {
            _categoryRepository = categoryRepository;
        }

        //private readonly ICategoryRepository _categoryRepository;

        //public CategoryApp(ICategoryRepository categoryRepository)
        //{
        //    _categoryRepository = categoryRepository;
        //}


        public string GetCategoryName(string id)
        {
            //var categoryData = _categoryRepository.GetAll().FirstOrDefault(s=>s.Name == "硬件");

            var category = new Category()
            {
                Name = "硬件" + DateTime.Now.ToString("yy-MM-dd HH:mm:ss"),
                Status = 1
            };
            _categoryRepository.Insert(category);

            CurrentUnitOfWork.SaveChanges();
            return category.Name;
        }
    }
}

五、ZmBlog.Web修改

1.增加依赖

ZmBlogWebModule是web的模块,上一篇文章创建的,增加依赖ZmBlogApplicationModule

[DependsOn(typeof(AbpWebMvcModule),typeof(ZmBlogApplicationModule))]
    public class ZmBlogWebModule:AbpModule
{
    //...
}

2.修改控制器

public class HomeController : AbpController
    {
        private ICategoryApp _categoryApp;
        public HomeController(ICategoryApp categoryApp)
        {
            _categoryApp = categoryApp;
        }
        public ActionResult Index()
        {
            try
            {  
                ViewBag.Name = _categoryApp.GetCategoryName("");
            }
            catch (Exception e)
            {
                ViewBag.Name = "默认分类"; 
                throw;
            }

            return View();
        }
//.....省略

3.页面修改

@{
    ViewBag.Title = "Home Page";
}

<div class="jumbotron">
    <h1>I Like @ViewBag.Name</h1> 
</div> 

去掉没用的,直接展示效果

 六、展示

运行起来的效果

数据库

由于时间原因,一些细节没有详细讲,如有不清楚请留言

 

 源码下载:https://github.com/jackchn/cnblogs-xcsn-source下的ZmBlogStudy.rar