[ASP.NET MVC 小牛之路]05 - 使用 Ninject實現依賴註入
在[ASP.NET MVC 小牛之路]系列上一篇文章(依賴註入(DI)和Ninject)的末尾提到了在ASP.NET MVC中使用Ninject要做的兩件事情,續這篇文章之後,本文將用一個實際的示例來演示Ninject在ASP.NET MVC中的應用。
為了更好的理解和撐握本文內容,強烈建議初學者閱讀本文前先閱讀依賴註入(DI)和Ninject。
本文目錄:
準備工作
新建一個名為BookShop的空白解決方案。在該解決方案中分別添加一個名為BookShop.WebUI的MVC空應用程序,和一個名為BookShop.Domain的類庫工程。目錄結構如下:
兩個工程添加完後,在BookShop.WebUI工程下添加BookShop.Domain工程的引用。
使用NuGet分別為BookShop.WebUI工程和BookShop.Domain工程安裝Ninject包(NuGet的介紹請閱讀依賴註入(DI)和Ninject)。可以通過可視化窗口安裝,也可以打開Package Manager Console(視圖->其他窗口->Package Manager Console)執行下面命令安裝:
Install-Package Ninject -Project BookShop.WebUI
Install-Package Ninject -Project BookShop.Domain
下圖說明安裝成功:
創建Controller Factory
我們知道,在ASP.NET MVC中,一個客戶端請求是在特定Controller的Action中進行處理的。 默認情況下,ASP.NET MVC使用內置的Controller工廠類 DefaultControllerFactory來創建某個請求對應的Controller實例。有時候默認的Controller工廠不能滿足我們實際的需求,我們就需要對這種默認行為進行擴展,即創建一個繼承自DefaultControllerFactory類的自定義Controller工廠類並重寫其中的一些方法。為此,我們在BookShop.WebUI工程下創建一個名為Infrastructure的文件夾,在該文件夾中添加一個名為NinjectControllerFactory的工廠類,代碼如下:
public class NinjectControllerFactory : DefaultControllerFactory { private IKernel ninjectKernel; public NinjectControllerFactory() { ninjectKernel = new StandardKernel(); AddBindings(); } protected override IController GetControllerInstance(RequestContext requestContext, Type controllerType) { return controllerType == null ? null : (IController)ninjectKernel.Get(controllerType); } private void AddBindings() { // todo:後面再來添加綁定 } }
上面代碼中的 ninjectKernel.Get(controllerType) 可獲取到一個Controller實例。在這裏如果手動實例化Controller類是一個非常復雜的過程,我們不知道Controller類有沒有帶參數的構造函數,也不知道構造函數的參數是什麽類型。而使用Ninject只需要使用上面的一個Get方法就可以,Ninject內部會自動處理所有的依賴關系,智能地創建我們需要的對象。
Controller工廠類創建好後,我們就需要告訴MVC用我們的NinjectControllerFactory類來創建Controller對象,為此,需在Global.asax文件的Application_Start方法中添加下面代碼:
protected void Application_Start() { ...... //設置Controller工廠 ControllerBuilder.Current.SetControllerFactory(new NinjectControllerFactory()); }
這裏我們暫且不去關心上面這段代碼是什麽原理,知道設置自定義的Controller工廠必須要在這註冊就行了,有空的話我會在後續博文對這部分內容進行更深入的講解。
添加Domain Model
在MVC應用程序中,一切都是圍繞Domain Model(領域模型)來的。 所以我們在BookShop.Domain工程中專門建一個名為Entities的文件夾,用來存放領域實體模型。作為一個電子商務類的網上書店,當然最重要的一個領域實體就是Book了。由於只是為了演示,我們簡單定義一個Book類,並在Entities文件夾中添加該類,代碼如下:
public class Book { public int ID { get; set; } public string Title { get; set; } public string Isbn { get; set; } public string Summary { get; set; } public string Author { get; set; } public byte[] Thumbnail { get; set; } public decimal Price { get; set; } public DateTime Published { get; set; } }
添加Repository
我們知道,我們肯定需要一種方式來從數據庫中讀取Book數據。在這我們不防為數據的使用者(這裏指Controller)提供一個IBookRepository接口,在這個接口中聲明一個IQueryable<Book>類型的屬性Books。這樣,通過該接口使用依賴註入,使用者就可以拿到Books數據集合,而不用關心數據是如何得到的。為此,我們在BookShop.Domain工程中添加一個名為 Abstract的文件夾,在該文件夾中添加我們的IBookRepository接口文件,代碼如下:
public interface IBookRepository { IQueryable<Book> Books { get; } }
在MVC中我們一般會用倉儲模式(Repository Pattern)把數據相關的邏輯和領域實體模型分離,這樣對於使用者來說,通過調用倉儲對象,使用者可以直接拿到自己想要的數據,而完全不必關心數據具體是如何來的。我們可以把倉儲比喻成一個超市,超市已經為消費者供備好了商品,消費者只管去超市選購自己需要的商品,而完全不必關心這些商品是從哪些供應商怎麽樣運輸到超市的。但對於倉儲本身,必須要實現讀取數據的“渠道”。
在BookShop.Domain工程中添加一個名為Concrete文件夾用於存放具體的類。我們在Concrete文件夾中添加一個實現了IBookRepository接口的BookRepository類來作為我們的Book數據倉儲。BookRepository類代碼如下:
public class BookRepository : IBookRepository { public IQueryable<Book> Books { get { return GetBooks().AsQueryable(); } } private static List<Book> GetBooks() { //為了演示,這裏手工造一些數據,後面會介紹使用EF從數據庫中讀取。 List<Book> books = new List<Book>{ new Book { ID = 1, Title = "ASP.NET MVC 4 編程", Price = 52}, new Book { ID = 2, Title = "CLR Via C#", Price = 46}, new Book { ID = 3, Title = "平凡的世界", Price = 37} }; return books; } }
為了演示,上面是手工造的一些數據,後面的文章我將介紹使用Entity Framwork從數據庫中讀取數據。對於剛接觸ORM框架的朋友可能對這裏IQueryable感到奇怪,為什麽用IQueryable作為返回類型,而不用IEnumerable呢?後面有機會講Entity Framwork的時候再講。
添加綁定
打開之前我們在BookShop.WebUI工程創建的NinjectControllerFactory類,在AddBindings方法中添加如下代碼:
private void AddBindings() { ninjectKernel.Bind<IBookRepository>().To<BookRepository>(); }
這句代碼,通過Ninject把IBookRepository接口綁定到BookRepository,當IBookRepository接口的實現被請求時,Ninject將自動創建BookRepository類的實例。
到這裏,Ninject的使用步驟就結束了,接下來我們把本示例剩余的步驟完成。
顯示列表
右擊BookShop.WebUI工程的Controllers文件夾,添加一個名為Book的Controller,按下面代碼對其進行編輯:
public class BookController : Controller { private IBookRepository repository; public BookController(IBookRepository bookRepository) { repository = bookRepository; } }
在這,BookController的構造函數接受了一個IBookRepository參數,當BookController被實例化的時候,Ninject就為其註入了BookRepository的依賴。接下來我們為這個Controller添加一個名為List的Action,用來呈現Book列表。代碼如下:
public class BookController : Controller { ... public ViewResult List() { return View(repository.Books); } }
當然我們需要添加一個View。右擊上面的List方法,選擇添加視圖,在彈出的窗口進行如下配置:
然後我們在List.cshtml中用foreach循環來列舉書本信息,代碼如下:
@model IEnumerable<BookShop.Domain.Entities.Book> @{ ViewBag.Title = "Books"; } @foreach (var p in Model) { <div class="item" style="border-bottom:1px dashed silver;"> <h3>@p.Title</h3> <p>價格:@p.Price.ToString("c") </p> </div> }
最後我們還需要修改一下默認路由,讓系統運行後直接導向到我們的{controller = "Book", action = "List"},打開Global.asax文件,找到RegisterRoutes方法,進行如下修改:
public static void RegisterRoutes(RouteCollection routes) { routes.IgnoreRoute("{resource}.axd/{*pathInfo}"); routes.MapRoute( "Default", // Route name "{controller}/{action}/{id}", // URL with parameters new { controller = "Book", action = "List", id = UrlParameter.Optional } ); }
到這,我們的程序可以運行了,效果如下:
結束語:
本文是Ninject在ASP.NET MVC中使用的一個簡單示例,目的是讓大家了解Ninject在MVC中的使用方法。當然,Ninject的強大之處不僅限於本文所演示的,相信當你熟悉了Niject之後,在搭建MVC應用程序時,你一定會喜歡上它的。
評論精選
#8樓[樓主] 2013-11-02 08:23 | Liam Wang
@heren2013
BookController類的創建(含初始化)主要經過下面這三個過程:
1.在Application_Start中,ControllerBuilder.Current.SetControllerFactory(new NinjectControllerFactory());這段註冊代碼告訴MVC用NinjectControllerFactory工廠類來創建所有Controller對象。
在NinjectControllerFactory類中包含了下面兩個過程:綁定接口到接口的實現和創建Controller類對象。
2.ninjectKernel.Bind<IBookRepository>().To<BookRepository>();這段綁定代碼告訴ninjectKernel當被請求一個IBookRepository接口的實現時則返回一個BookRepository對象。
3.請你閱讀NinjectControllerFactory類中的GetControllerInstance方法,通過ninjectKernel.Get(controllerType)這句代碼,ninject獲取controller(如BookController)對象的信息並創建該controller的實例,這個過程會調用controller的構造函數,它會自動判斷構造函數所需要的參數,如BookController類的構造函數需要一個IBookRepository接口參數,根據第2個過程ninject註冊的綁定,ninject會給該構造函數傳遞BookRepository對象(IBookRepository接口的實現者)的引用。
#19樓 2013-11-28 09:57 | 彼年豆蔻
@Liam Wang
不需要啊,只需要在Application_Start()函數中註冊一下:
DependencyResolver.SetResolver(new Code.NinjectDependencyResolver());//註冊Ioc容器
然後在具體使用中,Controller構造註入或者使用屬性註入即可
相關代碼:namespace LvJl.WebMvc.Code { public class NinjectDependencyResolver:System.Web.Mvc.IDependencyResolver { private readonly IKernel _kernel; public NinjectDependencyResolver() { _kernel=new StandardKernel(); AddBindings(); } private void AddBindings() { _kernel.Bind<IUserService>().To<UserService>(); _kernel.Bind<IRoleService>().To<RoleService>(); } public object GetService(Type serviceType) { return _kernel.TryGet(serviceType); } public IEnumerable<object> GetServices(Type serviceType) { return _kernel.GetAll(serviceType); } } } protected void Application_Start() { DependencyResolver.SetResolver(new Code.NinjectDependencyResolver());//註冊Ioc容器 AreaRegistration.RegisterAllAreas(); WebApiConfig.Register(GlobalConfiguration.Configuration); FilterConfig.RegisterGlobalFilters(GlobalFilters.Filters); RouteConfig.RegisterRoutes(RouteTable.Routes); BundleConfig.RegisterBundles(BundleTable.Bundles); } public class UserController : Controller { private readonly IUserService _user; public UserController(IUserService userService) { _user = userService; } public ActionResult Index() { return View(); } public ActionResult GetAllUsers() { var pageIndex = Request["page"] == null ? 1 : int.Parse(Request["page"]); var pageSize = Request["rows"] == null ? 1 : int.Parse(Request["rows"]); int total; var data = _user.Query(pageIndex, pageSize, out total, u => true, true, u => u.Id); var result = new {total, rows = data}; return Json(result, JsonRequestBehavior.AllowGet); } }
[ASP.NET MVC 小牛之路]05 - 使用 Ninject實現依賴註入