用MasterPage 代替 PageBase

2019-11-18 16:54:01

字體：大中小

供稿：網(wǎng)友

目的：
實現(xiàn)用MasterPage中的.cs文件代替項目中的PageBase。

動機(jī)：
寫這篇文章的動機(jī)，來自于一次項目重構(gòu)。在.Net Framwork 2.0的B/S架構(gòu)項目中同時采用PageBase和MasterPage技術(shù)，發(fā)現(xiàn)每次訪問頁面，頁面同時訪問PageBase和MasterPage，不僅造成性能降低，甚至有可能給日后的項目功能擴(kuò)充和調(diào)整帶來邏輯錯誤隱患。

技術(shù)環(huán)節(jié)：
PageBase：.Net Framework 1.1 中經(jīng)常使用的一種封裝多個頁面相同功能的技術(shù)。PageBase.cs類繼承自System.Web.UI.Page類，項目中的Web頁面繼承自PageBase.cs類，通過重寫基類中的頁面初始化方法，實現(xiàn)調(diào)用PageBase中的業(yè)務(wù)功能，例如：url參數(shù)驗證，保存訪問量等功能（具體實現(xiàn)方式參見微軟官方例子duwamishi）。
MasterPage：.Net Framework 2.0 中新特性，物理上包括兩個文件，分別是：.Master文件（html標(biāo)記），.cs文件（C＃代碼）。.Master文件實現(xiàn)顯示層繪制，.cs文件實現(xiàn)具體功能。繼承自MasterPage的Web頁面可以繼承MasterPage中的顯示層內(nèi)容。繪制通用的頁頭頁腳，定制統(tǒng)一的布局，MasterPage是不錯的選擇。

模擬需求：
用MasterPage技術(shù)，代替PageBase，實現(xiàn)地址欄參數(shù)驗證。
簡單的做個解釋吧，數(shù)據(jù)庫中Login表信息如下圖：

登錄系統(tǒng)之后，url地址欄中帶有參數(shù)，如下：
http://localhost:3730/MasterPageBaseDemo/TestPage.aspx?id=1001
此時用戶手動修改url地址欄中參數(shù)為：
http://localhost:3730/MasterPageBaseDemo/TestPage.aspx?id=1002
被視為非法操作，系統(tǒng)將自動跳轉(zhuǎn)回登錄頁面。

第一次代碼迭代：

1.參照傳統(tǒng)PageBase方法：
        傳統(tǒng)的Page做法為：
public class PageBase : System.Web.UI.Page
{
    public PageBase()
    {
    }
    /**//// <summary>
    /// 入口方法
    /// </summary>
    PRotected void Initialize()
    {
        // 插入通用業(yè)務(wù)邏輯
     }
}
        Web頁面：
public partial class TestPage : PageBase
{
    // 傳統(tǒng)的調(diào)用PageBase的方法
    /**///// <summary>
    /// 重寫基類OnPreInit() 方法，調(diào)用通用驗證方法
    /// </summary>
    /// <param name="e"></param>
    protected override void OnInit(eventargs e)
    {
        base.Initialize();
    }
}
參照其做法，將PageBase中的代碼移入MasterPage中：
MasterPage.cs：
public partial class MyMasterPage : System.Web.UI.MasterPage
{
    protected void Page_Load(object sender, EventArgs e)
    {
        if (!IsPostBack)
        {
            // 調(diào)用驗證方法
            Initialize();
        }
    }
}
將Web頁面中的代碼修改為：
public partial class TestPage : System.Web.UI.Page
{
    // 仿照PageBase方法，調(diào)用Master中的方法
    /**//// <summary>
    /// 重寫基類OnPreInit() 方法，調(diào)用通用驗證方法
    /// </summary>
    /// <param name="e"></param>
    protected override void OnInit(eventargs e)
    {
        // 獲得母板頁引用
        MyMasterPage myMasterPage = (MyMasterPage)this.Master;
        // 調(diào)用母板頁中通用驗證方法
        if (!IsPostBack)
        {
            myMasterPage.Initialize();
        }
    }
}將MasterPage中的Initialize()方法替換為實例中的，測試代碼：
        步驟1：用用戶名zhangsan登錄系統(tǒng)，登錄成功，
                      頁面顯示歡迎 zhangsan 登錄。
                      url地址顯示：
                      http://localhost:3730/MasterPageBaseDemo/TestPage.aspx?id=1001
        步驟2：手動修改url地址欄：如下：
                      http://localhost:3730/MasterPageBaseDemo/TestPage.aspx?id=1002
        頁面不會顯示歡迎lisi登錄，而是跳轉(zhuǎn)回登錄頁面。
反思：雖然功能實現(xiàn)，但是存在不理想的環(huán)節(jié)：
        1. Master中的被子類調(diào)用方法必須是public方法；
        2. 雖然不用修改Web頁的繼承，但是依然要機(jī)械的復(fù)制粘貼重寫基類的OnInit()方法。
為了消除這些懷味道，于是開始：
第二次代碼迭代：
修改MasterPage.cs中的代碼：
public partial class MyMasterPage : System.Web.UI.MasterPage
{
    protected void Page_Load(object sender, EventArgs e)
    {
        if (!IsPostBack)
        {
            // 調(diào)用驗證方法
            CheckLogin();
        }
    }
    /**//// <summary>
    /// 驗證訪問是否合法
    /// </summary>
    private void CheckLogin()
    {
        // 如果 url中的編號或 cookie中的編號
        if (string.IsNullOrEmpty(Request.QueryString["id"])
            || string.IsNullOrEmpty(CookieUtil.ReadCookieByKey("id")))
        {
            Response.Redirect("Login.aspx");
        }// 如果url中的編號和 cookie中的編號不匹配，返回登錄頁
        else if (int.Parse(Request.QueryString["id"]) != int.Parse(CookieUtil.ReadCookieByKey("id")))
        {
            Response.Redirect("Login.aspx");
        }
    }
}重構(gòu)之后，Web頁可以不進(jìn)行任何修改，MasterPage在自身的Page_Load()方法中自動調(diào)用驗證方法，而且將驗證方法設(shè)置為private，僅供MasterPage自身調(diào)用，提高安全性。至此，代碼似乎比較理想了，測試：
        步驟一：用用戶名 zhangsan登錄系統(tǒng)，
                        依然顯示用戶登錄頁面。
                        測試失敗。
用斷點跟蹤代碼，發(fā)現(xiàn)問題出現(xiàn)在MasterPage.cs中的CheckLogin()方法中的代碼片段：
if (string.IsNullOrEmpty(Request.QueryString["id"])
            || string.IsNullOrEmpty(CookieUtil.ReadCookieByKey("id")))
{
      Response.Redirect("Login.aspx");
}
由于登錄頁繼承自MasterPage，所以頁面加載時自動調(diào)用MasterPage.cs中的驗證方法，而自身的參數(shù)又不滿足string.IsNullOrEmpty()方法，于是又跳回到登錄頁面，登錄頁面在再次在加載時調(diào)用基類中的驗證方法，于是形成死循環(huán)。
在PageBase技術(shù)中，Web頁面可以有選擇的繼承自PageBase，而MasterPage技術(shù)中，為了獲得一致的顯示層效果，Web頁面對繼承MasterPage的選擇性是非常底的，而且我們也不應(yīng)該采用新建相同顯示，不帶有驗證代碼的MasterPage，來給不需要繼承基類功能的Web頁面來繼承，這種方式顯然不合理。為了解決這個問題，于是開始了
第三次迭代：
引入配置文件：
<?xml version="1.0" encoding="utf-8" ?>
<pages>
<testpage>
    <page title="TestPage" url="TestPage.aspx" needvalidate="true"/>
    <page title="Login" url="Login.aspx" needvalidate="false"/>
</testpage>
<adminpages>
    <page title="Page1" url="~/Admin/Page1.aspx" needvalidate="false"/>
    <page title="Page2" url="~/Admin/Page2.aspx" needvalidate="false"/>
</adminpages>
</pages>
從中可以看到，將需要驗證的頁面加以標(biāo)識（needvalidate＝"true"）。
創(chuàng)建Xml數(shù)據(jù)訪問類：
public class XmlDAL
{
    private static string filePath = string.Empty;
    static XmlDAL()
    {
        // 初始化配置文件路徑
        filePath = HttpContext.Current.Request.MapPath("~/App_Data/xml/" + "Pages.xml");
    }
    /**//// <summary>
    /// 獲得需要驗證的頁面列表
    /// </summary>
    /// <returns>需要驗證的頁面列表</returns>
    public static IList<string> GetValidatePages()
    {
        IList<string> pages = new List<string>();
        // 如果指定配置文件存在
        if (System.IO.File.Exists(filePath))
        {
            try
            {
                XmlDocument xmlDoc = new XmlDocument();
                xmlDoc.Load(filePath);
                // 獲取配置文件根節(jié)點
                XmlNode root = xmlDoc.DocumentElement;
                string xpath = "/pages/testpage/page[@needvalidate='true']";
                XmlNodeList nodeList = root.SelectNodes(xpath);
                // 便利節(jié)點集合
                foreach (XmlNode node in nodeList)
                {
                    pages.Add(node.Attributes["title"].Value);
                }
            }
            catch (Exception ex)
            {
                throw new Exception(ex.Message);
            }
        }
        return pages;
    }
}
重構(gòu)MasterPage.cs中的代碼，加入IsValidateNeeded(string url)方法，用于檢測當(dāng)前頁面是否需要驗證，修改驗證方法：
public partial class MyMasterPage : System.Web.UI.MasterPage
{
    protected void Page_Load(object sender, EventArgs e)
    {
        if (!IsPostBack)
        {
            // 調(diào)用驗證方法
            CheckLogin();
        }
    }
    /**//// <summary>
    /// 驗證訪問是否合法
    /// </summary>
    private void CheckLogin()
    {
        // 判斷當(dāng)前訪問頁面是否需要進(jìn)行驗證
        if (IsValidateNeeded(Request.RawUrl))
        {
            // 如果 url中的編號或 cookie中的編號
            if (string.IsNullOrEmpty(Request.QueryString["id"])
                || string.IsNullOrEmpty(CookieUtil.ReadCookieByKey("id")))
            {
                Response.Redirect("Login.aspx");
            }// 如果url中的編號和 cookie中的編號不匹配，返回登錄頁
            else if (int.Parse(Request.QueryString["id"]) != int.Parse(CookieUtil.ReadCookieByKey("id")))
            {
                Response.Redirect("Login.aspx");
            }
        }
    }
    /**//// <summary>
    /// 驗證當(dāng)前頁是否需要驗證
    /// </summary>
    /// <param name="currentPage">當(dāng)前頁面名稱</param>
    /// <returns>是否需要驗證狀態(tài)</returns>
    private bool IsValidateNeeded(string url)
    {
        bool isNeeded = false;
        // GetValidatePages() 方法返回需要驗證頁面列表
        IList<string> pages = XmlDAL.GetValidatePages();
        IEnumerator<string> ie = pages.GetEnumerator();
        while (ie.MoveNext())
        {
            // 如果當(dāng)前頁面需要進(jìn)行驗證
            if (url.Contains(ie.Current))
                // 返回需要驗證狀態(tài)
                return isNeeded = true;
        }
        return isNeeded;
    }
}
進(jìn)行測試：
        步驟1：用用戶名zhangsan登錄系統(tǒng)，登錄成功，
                      頁面顯示歡迎 zhangsan 登錄。
                      url地址顯示：
                      http://localhost:3730/MasterPageBaseDemo/TestPage.aspx?id=1001
        步驟2：手動修改url地址欄：如下：
                      http://localhost:3730/MasterPageBaseDemo/TestPage.aspx?id=1002
        頁面不會顯示歡迎lisi登錄，而是跳轉(zhuǎn)回登錄頁面。

至此我的代碼迭代結(jié)束了。
代碼下載：
http://www.survivalescaperooms.com/Files/ayuan/MasterPageBaseDemo.rar
本人之前沒有寫技術(shù)文章的經(jīng)驗，所以以上的文字難免晦澀，而且自身技術(shù)水平也有限，可能有些觀點不太成熟，歡迎各位朋友指正。

上一篇：asp.net 2.0 緩存(理論篇)

下一篇：用C#實現(xiàn)智能設(shè)備上的NotifyIcon類