[轉]ASP.NET 2.0新特性在PetShop4中的應用2

6.4.2    Membership特性

PetShop 4.0並沒有利用Membership的高級功能，而是直接讓Membership特性和ASP.NET 2.0新增的登錄控件進行綁定。由於.NET Framework 2.0已經定義了針對SQL Server的SqlMembershipProvider，因此對於PetShop 4.0而言，實現Membership比之實現Profile要簡單，僅僅需要爲Oracle數據庫定義MembershipProvider即可。在 PetShop.Membership模塊中，定義了OracleMembershipProvider類，它繼承自 System.Web.Security.MembershipProvider抽象類。

OracleMembershipProvider類的實現具有極高的參考價值，如果我們需要定義自己的MembershipProvider類，可以參考該類的實現。
事實上OracleMemberShip類的實現並不複雜，在該類中，主要是針對用戶及用戶安全而實現相關的行爲。由於在父類 MembershipProvider中，已經定義了相關操作的虛方法，因此我們需要作的是重寫這些虛方法。由於與Membership有關的信息都是存儲在數據庫中，因而OracleMembershipProvider與SqlMembershipProvider類的主要區別還是在於對數據庫的訪問。對於SQL Server而言，我們利用aspnet_regsql工具爲Membership建立了相關的數據表以及存儲過程。也許是因爲知識產權的原因， Microsoft並沒有爲Oracle數據庫提供類似的工具，因而需要我們自己去創建membership的數據表。此外，由於沒有創建Oracle數據庫的存儲過程，因而OracleMembershipProvider類中的實現是直接調用SQL語句。以CreateUser()方法爲例，剔除那些繁雜的參數判斷與安全性判斷，SqlMembershipProvider類的實現如下：

public override MembershipUser CreateUser(string username, string password, string email, string passwordQuestion, string passwordAnswer, bool isApproved, object providerUserKey, out MembershipCreateStatus status)
{
        MembershipUser user1;
      //前面的代碼略;
      try
      {
              SqlConnectionHolder holder1 = null;
            try
            {
                    holder1 = SqlConnectionHelper.GetConnection(this._sqlConnectionString, true);
                  this.CheckSchemaVersion(holder1.Connection);
                    DateTime time1 = this.RoundToSeconds(DateTime.UtcNow);
                    SqlCommand command1 = new SqlCommand("dbo.aspnet_Membership_CreateUser", holder1.Connection);
                    command1.CommandTimeout = this.CommandTimeout;
                    command1.CommandType = CommandType.StoredProcedure;
                    command1.Parameters.Add(this.CreateInputParam("@ApplicationName", SqlDbType.NVarChar, this.ApplicationName));
                    command1.Parameters.Add(this.CreateInputParam("@UserName", SqlDbType.NVarChar, username));
                    command1.Parameters.Add(this.CreateInputParam("@Password", SqlDbType.NVarChar, text2));
                    command1.Parameters.Add(this.CreateInputParam("@PasswordSalt", SqlDbType.NVarChar, text1));
                    command1.Parameters.Add(this.CreateInputParam("@Email", SqlDbType.NVarChar, email));
                    command1.Parameters.Add(this.CreateInputParam("@PasswordQuestion", SqlDbType.NVarChar, passwordQuestion));
                    command1.Parameters.Add(this.CreateInputParam("@PasswordAnswer", SqlDbType.NVarChar, text3));
                    command1.Parameters.Add(this.CreateInputParam("@IsApproved", SqlDbType.Bit, isApproved));
                    command1.Parameters.Add(this.CreateInputParam("@UniqueEmail", SqlDbType.Int, this.RequiresUniqueEmail ? 1 : 0));
                    command1.Parameters.Add(this.CreateInputParam("@PasswordFormat", SqlDbType.Int, (int) this.PasswordFormat));
                    command1.Parameters.Add(this.CreateInputParam("@CurrentTimeUtc", SqlDbType.DateTime, time1));
                    SqlParameter parameter1 = this.CreateInputParam("@UserId", SqlDbType.UniqueIdentifier, providerUserKey);
                    parameter1.Direction = ParameterDirection.InputOutput;
                    command1.Parameters.Add(parameter1);
                    parameter1 = new SqlParameter("@ReturnValue", SqlDbType.Int);
                    parameter1.Direction = ParameterDirection.ReturnValue;
                    command1.Parameters.Add(parameter1);
                    command1.ExecuteNonQuery();
                  int num3 = (parameter1.Value != null) ? ((int) parameter1.Value) : -1;
                  if ((num3 < 0) || (num3 > 11))
                  {
                          num3 = 11;
                    }
                    status = (MembershipCreateStatus) num3;
                  if (num3 != 0)
                  {
                        return null;
                    }
                    providerUserKey = new Guid(command1.Parameters["@UserId"].Value.ToString());
                    time1 = time1.ToLocalTime();
                    user1 = new MembershipUser(this.Name, username, providerUserKey, email, passwordQuestion, null, isApproved, false, time1, time1, time1, time1, new DateTime(0x6da, 1, 1));
              }
            finally
            {
                  if (holder1 != null)
                  {
                          holder1.Close();
                          holder1 = null;
                    }
              }
        }
      catch
      {
            throw;
        }
      return user1;
}

 

代碼中，aspnet_Membership_CreateUser爲aspnet_regsql工具爲membership創建的存儲過程，它的功能就是創建一個用戶。

OracleMembershipProvider類中對CreateUser()方法的定義如下：

public override MembershipUser CreateUser(string username, string password, string email, string passwordQuestion, string passwordAnswer, bool isApproved, object userId, out MembershipCreateStatus status) {
    //前面的代碼略;
//Create connection
OracleConnection connection = new OracleConnection(OracleHelper.ConnectionStringMembership);
connection.Open();
OracleTransaction transaction = connection.BeginTransaction(IsolationLevel.ReadCommitted);
try {
    DateTime dt = DateTime.Now;
  bool isUserNew = true;

  // Step 1: Check if the user exists in the Users table: create if not    
  int uid = GetUserID(transaction, applicationId, username, true, false, dt, out isUserNew);
  if(uid == 0) { // User not created successfully!
     status = MembershipCreateStatus.ProviderError;
   return null;
    }
  // Step 2: Check if the user exists in the Membership table: Error if yes.
  if(IsUserInMembership(transaction, uid)) {
     status = MembershipCreateStatus.DuplicateUserName;
   return null;
    }
  // Step 3: Check if Email is duplicate
  if(IsEmailInMembership(transaction, email, applicationId)) {
     status = MembershipCreateStatus.DuplicateEmail;
   return null;
    }
  // Step 4: Create user in Membership table     
  int pFormat = (int)passwordFormat;
  if(!InsertUser(transaction, uid, email, pass, pFormat, salt, "", "", isApproved, dt)) {
     status = MembershipCreateStatus.ProviderError;
   return null;
    }
  // Step 5: Update activity date if user is not new
  if(!isUserNew) {
   if(!UpdateLastActivityDate(transaction, uid, dt)) {
      status = MembershipCreateStatus.ProviderError;
    return null;
     }
    }
    status = MembershipCreateStatus.Success;
  return new MembershipUser(this.Name, username, uid, email, passwordQuestion, null, isApproved, false, dt, dt, dt, dt, DateTime.MinValue);
}
catch(Exception) {
  if(status == MembershipCreateStatus.Success)
     status = MembershipCreateStatus.ProviderError;
  throw;
}
finally {
  if(status == MembershipCreateStatus.Success)
     transaction.Commit();
  else
     transaction.Rollback();
    connection.Close();
    connection.Dispose();
}
}

代碼中，InsertUser()方法就是負責用戶的創建，而在之前則需要判斷創建的用戶是否已經存在。InsertUser()方法的定義如下：

private static bool InsertUser(OracleTransaction transaction, int userId, string email, string password, int passFormat, string passSalt, string passQuestion, string passAnswer, bool isApproved, DateTime dt) {

string insert = "Insert INTO MEMBERSHIP (USERID, EMAIL, PASSWORD, PASSWORDFORMAT, PASSWORDSALT, PASSWORDQUESTION, PASSWORDANSWER, ISAPPROVED, CreateDDATE, LASTLOGINDATE, LASTPASSWORDCHANGEDDATE) VALUES (:UserID, :Email, :Pass, :PasswordFormat, :PasswordSalt, :PasswordQuestion, :PasswordAnswer, :IsApproved, :CDate, :LLDate, :LPCDate)";
OracleParameter[] insertParms = { new OracleParameter(":UserID", OracleType.Number, 10), new OracleParameter(":Email", OracleType.VarChar, 128), new OracleParameter(":Pass", OracleType.VarChar, 128), new OracleParameter(":PasswordFormat", OracleType.Number, 10), new OracleParameter(":PasswordSalt", OracleType.VarChar, 128), new OracleParameter(":PasswordQuestion", OracleType.VarChar, 256), new OracleParameter(":PasswordAnswer", OracleType.VarChar, 128), new OracleParameter(":IsApproved", OracleType.VarChar, 1), new OracleParameter(":CDate", OracleType.DateTime), new OracleParameter(":LLDate", OracleType.DateTime), new OracleParameter(":LPCDate", OracleType.DateTime) };
insertParms[0].Value = userId;
insertParms[1].Value = email;
insertParms[2].Value = password;
insertParms[3].Value = passFormat;
insertParms[4].Value = passSalt;
insertParms[5].Value = passQuestion;
insertParms[6].Value = passAnswer;
insertParms[7].Value = OracleHelper.OraBit(isApproved);
insertParms[8].Value = dt;
insertParms[9].Value = dt;
insertParms[10].Value = dt;

if(OracleHelper.ExecuteNonQuery(transaction, CommandType.Text, insert, insertParms) != 1)
  return false;
else
  return true;
}

在爲Membership建立了Provider類後，還需要在配置文件中配置相關的配置節，例如SqlMembershipProvider的配置：

<membership defaultProvider="SQLMembershipProvider">
<providers>
  <add name="SQLMembershipProvider" type="System.Web.Security.SqlMembershipProvider" connectionStringName="SQLMembershipConnString" applicationName=".NET Pet Shop 4.0" enablePasswordRetrieval="false" enablePasswordReset="true" requiresQuestionAndAnswer="false" requiresUniqueEmail="false" passwordFormat="Hashed"/>
</providers>
</membership>

對於OracleMembershipProvider而言，配置大致相似：

<membership defaultProvider="OracleMembershipProvider">
<providers>
  <clear/>
  <add name="OracleMembershipProvider"
     type="PetShop.Membership.OracleMembershipProvider"
     connectionStringName="OraMembershipConnString"
     enablePasswordRetrieval="false"
     enablePasswordReset="false"
     requiresUniqueEmail="false"
     requiresQuestionAndAnswer="false"
     minRequiredPasswordLength="7"
     minRequiredNonalphanumericCharacters="1"
     applicationName=".NET Pet Shop 4.0"
     hashAlgorithmType="SHA1"
     passwordFormat="Hashed"/>
</providers>
</membership>

有關配置節屬性的意義，可以參考MSDN等相關文檔。

6.4.3    ASP.NET登錄控件

這裏所謂的登錄控件並不是指一個控件，而是ASP.NET 2.0新提供的一組用於解決用戶登錄的控件。登錄控件與Membership進行集成，快速簡便地實現用戶登錄的處理。ASP.NET登錄控件包括 Login控件、LoginView控件、LoginStatus控件、LoginName控件、PasswordRescovery控件、 CreateUserWizard控件以及ChangePassword控件。
PetShop 4.0猶如一本展示登錄控件用法的完美教程。我們可以從諸如SignIn、NewUser等頁面中，看到ASP.NET登錄控件的使用方法。例如在 SignIn.aspx中，用到了Login控件。在該控件中，可以包含TextBox、Button等類型的控件，用法如下所示：

<asp:Login ID="Login" runat="server" CreateUserUrl="~/NewUser.aspx" SkinID="Login" FailureText="Login failed. Please try again.">
</asp:Login>

又例如NewUser.aspx中對CreateUserWizard控件的使用：

<asp:CreateUserWizard ID="CreateUserWizard" runat="server" CreateUserButtonText="Sign Up" InvalidPasswordErrorMessage="Please enter a more secure password." PasswordRegularExpressionErrorMessage="Please enter a more secure password."
RequireEmail="False" SkinID="NewUser">
<WizardSteps>
            <asp:CreateUserWizardStep ID="CreateUserWizardStep1" runat="server">
   </asp:CreateUserWizardStp>
</WizardSteps>
</asp:CreateUserWizard>

使用了登錄控件後，我們毋需編寫與用戶登錄相關的代碼，登錄控件已經爲我們完成了相關的功能，這就大大地簡化了這個系統的設計與實現。

6.4.4    Master Page特性

Master Page相當於是整個Web站點的統一模板，建立的Master Page文件擴展名爲.master。它可以包含靜態文本、html元素和服務器控件。Master Page由特殊的@Master指令識別，如：

<%@ Master Language="C#" CodeFile="MasterPage.master.cs" Inherits="MasterPage" %>

使用Master Page可以爲網站建立一個統一的樣式，且能夠利用它方便地創建一組控件和代碼，然後將其應用於一組頁。對於那些樣式與功能相似的頁而言，利用Master Page就可以集中處理爲Master Page，一旦進行修改，就可以在一個位置上進行更新。

在PetShop 4.0中，建立了名爲MasterPage.master的Master Page，它包含了header、LoginView控件、導航菜單以及用於呈現內容的html元素，如圖6-3所示：

圖6-3 PetShop 4.0的Master Page

@Master指令的定義如下：

<%@ Master Language="C#" AutoEventWireup="true" CodeFile="MasterPage.master.cs" Inherits="PetShop.Web.MasterPage" %>

Master Page同樣利用codebehind技術，以PetShop 4.0的Master Page爲例，codebehind的代碼放在文件MasterPage.master.cs中：

public partial class MasterPage : System.Web.UI.MasterPage {

      private const string HEADER_PREFIX = ".NET Pet Shop :: {0}";

      protected void Page_PreRender(object sender, EventArgs e) {
          ltlHeader.Text = Page.Header.Title;
          Page.Header.Title = string.Format(HEADER_PREFIX, Page.Header.Title);          
      }
      protected void btnSearch_Click(object sender, EventArgs e) {
          WebUtility.SearchRedirect(txtSearch.Text);    
      }
}

注意Master Page頁面不再繼承自System.Web.UI.Page，而是繼承System.Web.UI.MasterPage類。與Page類繼承 TemplateControl類不同，它是UserControl類的子類。因此，可以應用在Master Page上的有效指令與UserControl的可用指令相同，例如AutoEventWireup、ClassName、CodeFile、 EnableViewState、WarningLevel等。

每一個與Master Page相關的內容頁必須在@Page指令的MasterPageFile屬性中引用相關的Master Page。例如PetShop 4.0中的CheckOut內容頁，其@Page指令的定義如下：

<%@ Page Language="C#" MasterPageFile="~/MasterPage.master" AutoEventWireup="true" CodeFile="CheckOut.aspx.cs" Inherits="PetShop.Web.CheckOut" Title="Check Out" %>

Master Page可以進行嵌套，例如我們建立了父Master Page頁面Parent.master，那麼在子Master Page中，可以利用master屬性指定其父MasterPage：
<%@ Master Language="C#" master="Parent.master"%>

而內容頁則可以根據情況指向Parent.master或者Child.master頁面。

雖然說Master Page大部分情況下是以聲明方式創建，但我們也可以建立一個類繼承System.Web.UI.MasterPage，從而完成對Master Page的編程式創建。但在採用這種方式的同時，應該同時創建.master文件。此外對Master Page的調用也可以利用編程的方式完成，例如動態地添加Master Page，我們重寫內容頁的Page_PreInit()方法，如下所示：

void Page_PreInit(Object sender, EventArgs e)
{
    this.MasterPageFile = "~/NewMaster.master";
}

之所以重寫Page_PreInit()方法，是因爲Master Page會在內容頁初始化階段進行合併，也即是說是在PreInit階段完成Master Page的分配。
ASP.NET 2.0引入的新特性，並不僅僅限於上述介紹的內容。例如Theme、Wizard控件等新特性在PetShop 4.0中也得到了大量的應用。雖然ASP.NET 2.0及時地推陳出新，對表示層的設計有所改善，然而作爲ASP.NET 2.0的其中一部分，它們僅僅是對現有框架缺失的彌補與改進，屬於“錦上添花”的範疇，對於整個表示層設計技術而言，起到的推動作用卻非常有限。

直到AJAX（Asynchronous JavaScript and XML）的出現，整個局面才大爲改觀。雖然AJAX技術帶有幾分“舊瓶裝新酒”的味道，然而它從誕生之初，就具備了王者氣象，大有席捲天下之勢。各種支持 AJAX技術的框架如雨後春筍般紛紛吐出新芽，支撐起百花齊放的繁榮，氣勢洶洶地營造出唯AJAX獨尊的態勢。如今，AJAX已經成爲了Web應用的主流開發技術，許多業界大鱷都呲牙咧嘴開始了對這一塊新領地的搶灘登陸。例如IBM、Oracle、Yahoo等公司都紛紛啓動了開源的AJAX項目。微軟也不甘落後，及時地推出了ASP.NET AJAX，這是一個基於ASP.NET的AJAX框架，它包括了ASP.NET AJAX服務端組件和ASP.NET AJAX客戶端組件，並集成在Visual Studio中，爲ASP.NET開發者提供了一個強大的AJAX應用環境。

我現在還無法預知AJAX技術在未來的走向，然而單單從表示層設計的角度而言，AJAX技術亦然帶了一場全新的革命。我們或者可以期待未來的PetShop 5.0，可以在表示層設計上帶來更多的驚喜。