基于MVC4+EasyUI的Web開發(fā)框架形成之旅--MVC控制器的設(shè)計(jì)

自從上篇《基于MVC4+EasyUI的Web開發(fā)框架形成之旅--總體介紹》總體性的概括，得到很多同行的關(guān)注和支持，不過上一篇主要是介紹一個總體的界面效果和思路，本系列的文章將逐步介紹其中的細(xì)節(jié)，本文主要介紹整個Web開發(fā)框架中的MVC控制器的設(shè)計(jì)。在設(shè)計(jì)之初，我就希望盡可能的減少代碼，提高編程模型的統(tǒng)一性。因此希望能夠以基類繼承的方式，和我Winform開發(fā)框架一樣，盡可能通過基類，而不是子類的重復(fù)代碼來實(shí)現(xiàn)各種通用的操作。

1、登錄控制的控制器基類設(shè)計(jì)

我們知道，一般我們創(chuàng)建一個MVC的控制器，都是基于Controller這樣的基類來實(shí)現(xiàn)。如下代碼所示。

public class TestController : Controller
{
	//
	// GET: /Test/

	public ActionResult Index()
	{
		return View();
	}

}

在我的Winform開發(fā)框架里面，用到了泛型的類型，非常方便實(shí)現(xiàn)業(yè)務(wù)邏輯和數(shù)據(jù)訪問基類的設(shè)計(jì)，控制器是否也可以這樣做的呢？

我們知道，一般的MVC控制器需要驗(yàn)證用戶是否已經(jīng)登陸了，這也是很多常見Web操作前的驗(yàn)證，還有對異常的處理，在MVC的基類，可以一并進(jìn)行記錄（這個非常不錯），于是我們先來設(shè)計(jì)一個驗(yàn)證用戶身份是否登陸的基類BaseController

/// <summary>
/// 所有需要進(jìn)行登錄控制的控制器基類
/// </summary>
public class BaseController : Controller 
{
	/// <summary>
	/// 當(dāng)前登錄的用戶屬性
	/// </summary>
	public UserInfo CurrentUserInfo { get; set; }

	/// <summary>
	/// 重新基類在Action執(zhí)行之前的事情
	/// </summary>
	/// <param name="filterContext">重寫方法的參數(shù)</param>
	protected override void OnActionExecuting(ActionExecutingContext filterContext)
	{
		base.OnActionExecuting(filterContext);
		//得到用戶登錄的信息
		CurrentUserInfo = Session["UserInfo"] as UserInfo;

		//判斷用戶是否為空
		if (CurrentUserInfo == null)
		{
			Response.Redirect("/Login/Index");
		}
	}

	protected override void OnException(ExceptionContext filterContext)
	{
		base.OnException(filterContext);

		//錯誤記錄
		WHC.Framework.Commons.LogTextHelper.Error(filterContext.Exception);

		// 當(dāng)自定義顯示錯誤 mode = On，顯示友好錯誤頁面
		if (filterContext.HttpContext.IsCustomErrorEnabled)
		{
			filterContext.ExceptionHandled = true;
			this.View("Error").ExecuteResult(this.ControllerContext);
		}
	}
........................
}

有了這個基類，我們在主頁的Home控制類，就可以使用用戶信息對象了進(jìn)行操作了，而且必須要求客戶登陸了。

public class HomeController : BaseController
{
	public ActionResult Index()
	{
		if (CurrentUserInfo != null)
		{
			ViewBag.FullName = CurrentUserInfo.FullName;
			ViewBag.Name = CurrentUserInfo.Name;
		}
		return View();
	}
................
}

2、數(shù)據(jù)訪問業(yè)務(wù)基類控制器的設(shè)計(jì)

我在我的Winform開發(fā)框架里面，對很多基類都使用泛型進(jìn)行設(shè)計(jì)，這樣可以傳遞相應(yīng)的數(shù)據(jù)類型到基類里面進(jìn)行處理，如下面的BLL層的業(yè)務(wù)對象定義代碼如下所示。

namespace WHC.Security.BLL
{
    /// <summary>
    /// 角色信息業(yè)務(wù)管理類
    /// </summary>
    public class Role : BaseBLL<RoleInfo>
    {

....................

/// <summary>
/// 業(yè)務(wù)基類對象
/// </summary>
/// <typeparam name="T">業(yè)務(wù)對象類型</typeparam>
public class BaseBLL<T> where T : BaseEntity, new()
{

	/// <summary>
	/// 插入指定對象到數(shù)據(jù)庫中
	/// </summary>
	/// <param name="obj">指定的對象</param>
	/// <returns>執(zhí)行操作是否成功。</returns>
	public virtual bool Insert(T obj)
	{
		return baseDal.Insert(obj);
	}

............

業(yè)務(wù)對象Role，要求傳入RoleInfo給基類處理，這樣基類就能定義到都對應(yīng)的T為具體的RoleInfo類型了。在MVC的控制器是否也可以這樣做呢？當(dāng)然可以，下面是我定義的一個控制器繼承關(guān)系圖。

上面的介紹也已經(jīng)比較明白了，其實(shí)就是在BusinessController<B, T>里面?zhèn)魅肓藘蓚€參數(shù)，定義代碼如下所示。

/// <summary>
/// 本控制器基類專門為訪問數(shù)據(jù)業(yè)務(wù)對象而設(shè)的基類
/// </summary>
/// <typeparam name="B">業(yè)務(wù)對象類型</typeparam>
/// <typeparam name="T">實(shí)體類類型</typeparam>
public class BusinessController<B, T> : BaseController
	where B : class
	where T : WHC.Framework.ControlUtil.BaseEntity, new()
{

	/// <summary>
	/// 插入指定對象到數(shù)據(jù)庫中
	/// </summary>
	/// <param name="info">指定的對象</param>
	/// <returns>執(zhí)行操作是否成功。</returns>
	public virtual ActionResult Insert(T info)
	{
		bool result = false;
		if (info != null)
		{
			result = baseBLL.Insert(info);
		}
		return Content(result);
	}

................

我根據(jù)傳入的BLL業(yè)務(wù)對象類型B，對象實(shí)體類類型T，那么我們就可以構(gòu)造對應(yīng)的baseBLL對象，然后調(diào)用其基類接口實(shí)現(xiàn)基本的操作，如插入，刪除，更新，查找等等，這樣的模式就和我的Winform開發(fā)框架的理念非常吻合了。

我們以角色控制器來說明，它的定義如下所示，如果不需要實(shí)現(xiàn)額外的接口（除了常見的操作），基本上不需要寫任何代碼了，因?yàn)樗泻芏喑Ｒ姷牟僮?，都已?jīng)封裝在了基類控制器BusinessController<B, T>里面了。

/// <summary>
/// 角色業(yè)務(wù)操作控制器
/// </summary>
public class RoleController : BusinessController<Role, RoleInfo>
{
	public RoleController() : base()
	{
	}

...............

對于一些需要特殊數(shù)據(jù)處理的操作，可以增加一些自定義的接口函數(shù)，也可以重寫基類的一些接口，實(shí)現(xiàn)數(shù)據(jù)的相應(yīng)處理。如我的菜單界面顯示中，需要根據(jù)縮進(jìn)的層級對菜單名稱進(jìn)行縮進(jìn)，以便更好的展示它們的層級結(jié)構(gòu)，那么我就需要對分頁函數(shù)進(jìn)行重寫了，如下代碼所示是整個菜單Menu類的控制器類代碼。

public class MenuController : BusinessController<Menu, MenuInfo>
{
	public override ActionResult FindWithPager()
	{
		string where = GetPagerCondition(); //基類實(shí)現(xiàn)
		PagerInfo pagerInfo = GetPagerInfo(); //基類實(shí)現(xiàn)            
		List<MenuInfo> list = baseBLL.FindWithPager(where, pagerInfo);
		list = CollectionHelper<MenuInfo>.Fill("-1", 0, list, "PID", "ID", "Name");

		//Json格式的要求{total:22,rows:{}}
		//構(gòu)造成Json的格式傳遞
		var result = new { total = pagerInfo.RecordCount, rows = list };
		return JsonDate(result);
	}

	/// <summary>
	/// 用作下拉列表的菜單Json數(shù)據(jù)
	/// </summary>
	/// <returns></returns>
	public ActionResult GetDictJson()
	{
		List<MenuInfo> list = baseBLL.GetAll();
		list = CollectionHelper<MenuInfo>.Fill("-1", 0, list, "PID", "ID", "Name");

		List<CListItem> itemList = new List<CListItem>();
		foreach (MenuInfo info in list)
		{
			itemList.Add(new CListItem(info.Name, info.ID));
		}
		return Json(itemList, JsonRequestBehavior.AllowGet);
	}
}

我們來看看一段HTML頁面里面，使用javascript腳本調(diào)用控制器API來實(shí)現(xiàn)數(shù)據(jù)的綁定的操作，也就是使用示例。

$.getJSON("/Role/FindById?r=" + Math.random() + "&id=" + id, function (json) {
	$("#txtID").val(json.ID);
	$("#txtName").val(json.Name);
	$("#txtNote").val(json.Note);
});

上面這個很標(biāo)準(zhǔn)的接口FindById是業(yè)務(wù)基類控制器BusinessController<B, T>里提供的。

當(dāng)然，BusinessController里面可以類似我Winform開發(fā)框架里面基類一樣，提供很豐富的操作接口，如返回列表Json集合，增刪改查的操作及返回，分頁數(shù)據(jù)的返回，以及一些特殊的操作都可以實(shí)現(xiàn)。而這些都不需要子類進(jìn)行任何實(shí)現(xiàn)。

如下面實(shí)際案例的用戶登陸日志，里面的界面功能還是很豐富的，當(dāng)他的控制器業(yè)務(wù)類不需要任何實(shí)現(xiàn)，只需要繼承基類即可。

    public class LoginLogController : BusinessController<LoginLog, LoginLogInfo>
    {
        public LoginLogController() : base()
        {
        }

    }

界面部分代碼如下所示。

//實(shí)現(xiàn)對DataGird控件的綁定操作
function InitGrid(queryData) {
	$('#grid').datagrid({   //定位到Table標(biāo)簽，Table標(biāo)簽的ID是grid
		url: '/LoginLog/FindWithPager',   //指向后臺的Action來獲取當(dāng)前用戶的信息的Json格式的數(shù)據(jù)
		title: '用戶登陸日志', 
		//下面的這些屬性如果誰不太清楚的話我建議去官方網(wǎng)站去學(xué)習(xí)
		iconCls: 'icon-view',
		height: 450,
		nowrap: true,
		autoRowHeight: false,
		striped: true,
		collapsible: true,
		pagination: true,
		rownumbers: true,
		//sortName: 'ID',    //根據(jù)某個字段給easyUI排序
		sortOrder: 'asc',
		remoteSort: false,
		idField: 'ID',
		queryParams: queryData,  //異步查詢的參數(shù)
		columns: [[
			{ field: 'ck', checkbox: true },   //選擇
			{ title: 'ID', field: 'ID', width: 40, sortable: true },  //主鍵
			 { title: '登錄用戶ID', field: 'User_ID', width: 80, sortable: true },
			 { title: '登錄名稱', field: 'LoginName', width: 80, sortable: true },
			 { title: '真實(shí)名稱', field: 'FullName', width: 80, sortable: true },
			 { title: '日志描述', field: 'Note', width: 100, sortable: true },
			 { title: 'IP地址', field: 'IPAddress', width: 100, sortable: true },
			 { title: 'Mac地址', field: 'MacAddress', width: 120, sortable: true },
			 { title: '系統(tǒng)編號', field: 'SystemType_ID', width: 120, sortable: true },
			 { title: '記錄日期', field: 'LastUpdated', width: 120, sortable: true },
		]],
		toolbar: [{
			id: 'btnAdd',
			text: '添加',
			iconCls: 'icon-add',
			handler: function () {                        
				ShowAddDialog();//實(shí)現(xiàn)添加記錄的頁面
			}
		}, '-', {
			id: 'btnEdit',
			text: '修改',
			iconCls: 'icon-edit',
			handler: function () {                        
				ShowEditOrViewDialog();//實(shí)現(xiàn)修改記錄的方法
			}
		}, '-', {
			id: 'btnDelete',
			text: '刪除',
			iconCls: 'icon-remove',
			handler: function () {                        
				Delete();//實(shí)現(xiàn)直接刪除數(shù)據(jù)的方法
			}
		}, '-', {
			id: 'btnView',
			text: '查看',
			iconCls: 'icon-table',
			handler: function () {                        
				ShowEditOrViewDialog("view");//實(shí)現(xiàn)查看記錄詳細(xì)信息的方法
			}
		}, '-', {
			id: 'btnReload',
			text: '刷新',
			iconCls: 'icon-reload',
			handler: function () {
				//實(shí)現(xiàn)刷新欄目中的數(shù)據(jù)
				$("#grid").datagrid("reload");
			}
		}]
	});

	$('#grid').datagrid({
		onDblClickRow: function (rowIndex, rowData) {
			$('#grid').datagrid('uncheckAll');
			$('#grid').datagrid('checkRow', rowIndex);
			ShowEditOrViewDialog();
		}
	});
}

這個就是我的控制器設(shè)計(jì)的中心思想了，下一篇繼續(xù)介紹整體的MVC系列的Web開發(fā)框架，介紹其中Web界面部分的處理和相關(guān)經(jīng)驗(yàn)，希望大家多多提出寶貴的意見。