一、先來介紹下倉儲

倉儲（Repository）： 倉儲用來操作資料庫進行資料存取。倉儲介面在領域層定義，而倉儲的實現類應該寫在基礎設施層。

在ABP中，倉儲類要實現IRepository介面，介面定義了常用的增刪改查以及聚合方法，其中包括同步及非同步方法。主要包括以下方法：

ABP針對不同的ORM框架對該介面給予了預設的實現；
針對EntityFramework，提供了EfRepositoryBase<TDbContext, TEntity, TPrimaryKey>的泛型版本的實現方式。
針對NHibernate，提供了NhRepositoryBase<TEntity, TPrimaryKey>

泛型版本的實現就意味著，大多數的時候，這些方法已足已應付一般實體的需要。如果這些方法對於實體來說已足夠，我們便不需要再去建立這個實體所需的倉儲介面/類。

直接通過在應用服務層定義倉儲引用，然後通過建構函式注入即可。在我們的應用服務層即可按以下方式使用Task倉儲：

public class TaskAppService : ITaskAppService { 
private readonly IRepository<Task> _taskRepository; 
public TaskAppService(IRepository<Task> taskRepository) 
{ 
    _taskRepository = taskRepository; 
}
 

示例程式碼中使用的就是這種方式。

二、如何實現自定義倉儲

假設我們需要查詢某個使用者都分配哪些任務。

1. 在領域層，建立IRepositories資料夾，然後定義IBackendTaskRepository。

namespace LearningMpaAbp.IRepositories
{
    /// <summary>
    /// 自定義倉儲示例
    /// </summary>
    public interface IBackendTaskRepository : IRepository<Task>
    {
        /// <summary>
        /// 獲取某個使用者分配了哪些任務
        /// </summary>
        /// <param name="personId">使用者Id</param>
        /// <returns>任務列表</returns>
        List<Task> GetTaskByAssignedPersonId(long personId);
    }
}
 

1. 在基礎架構層，實現該倉儲。

namespace LearningMpaAbp.EntityFramework.Repositories
{
    public class BackendTaskRepository:LearningMpaAbpRepositoryBase<Task>,IBackendTaskRepository
    {
        public BackendTaskRepository(IDbContextProvider<LearningMpaAbpDbContext> dbContextProvider) : base(dbContextProvider)
        {
        }

        /// <summary>
        /// 獲取某個使用者分配了哪些任務
        /// </summary>
        /// <param name="personId">使用者Id</param>
        /// <returns>任務列表</returns>
        public List<Task> GetTaskByAssignedPersonId(long personId)
        {
            var query = GetAll();

            if (personId>0)
            {
                query = query.Where(t => t.AssignedPersonId == personId);
            }

            return query.ToList();
        }
    }
}

該倉儲實現，繼承自模板生成的LearningMpaAbpRepositoryBase泛型抽象類，然後再實現IBackendTaskRepository介面。這裡要顯示宣告實現類的有參建構函式，使用泛型的IDbContextProvider將資料庫上下文的子類ChargeStationContext傳給父類的建構函式。

三、倉儲的注意事項

1. 倉儲方法中，ABP自動進行資料庫連線的開啟和關閉。
2. 倉儲方法被呼叫時，資料庫連線自動開啟且啟動事務。
3. 當倉儲方法呼叫另外一個倉儲的方法，它們實際上共享的是同一個資料庫連線和事務。
4. 倉儲物件都是暫時性的，因為IRepository介面預設繼承自ITransientDependency介面。所以，倉儲物件只有在需要注入的時候，才會由Ioc容器自動建立新例項。
5. 預設的泛型倉儲能滿足我們大部分的需求。只有在不滿足的情況下，才建立定製化的倉儲。