[.NET 基於角色安全性驗證] 之四：ASP.NET 2.0 成員資格和角色管理授權

// 我們從 ValidateUser 方法入手。
public static bool ValidateUser(string username, string password)
{
  // 通過 Provider 屬性獲取提供程序對象
  return Membership.Provider.ValidateUser(username, password);
}

public static MembershipProvider Provider
{
  get
  {
    // 應該是通過 Initialize() 方法獲取，並賦值給 s_Provider 變量的。
    Membership.Initialize();
    return Membership.s_Provider;
  }
}

private static void Initialize()
{
  // 從配置文件中讀取配置信息
  RuntimeConfig config1 = RuntimeConfig.GetAppConfig();
  MembershipSection section1 = config1.Membership;

  Membership.s_Providers = new MembershipProviderCollection();

  // 使用 ProvidersHelper.InstantiateProviders 方法從配置信息中讀取設置。
  ProvidersHelper.InstantiateProviders(section1.Providers, Membership.s_Providers, typeof(MembershipProvider));

  // 將缺省提供程序對象賦值給 s_Provider 變量。
  Membership.s_Provider = Membership.s_Providers[section1.DefaultProvider];
  Membership.s_Initialized = true;
}

public static void ProvidersHelper.InstantiateProviders(ProviderSettingsCollection configProviders, ProviderCollection providers, Type providerType)
{
  // 循環讀取配置信息，並創建提供程序對象。
  foreach (ProviderSettings settings1 in configProviders)
  {
    providers.Add(ProvidersHelper.InstantiateProvider(settings1, providerType));
  }
}

public static ProviderBase ProvidersHelper.InstantiateProvider(ProviderSettings providerSettings, Type providerType)
{
  ProviderBase base1 = null;
  try
  {
    // 調用 HttpRuntime.CreatePublicInstance 創建提供程序對象。
    base1 = (ProviderBase)HttpRuntime.CreatePublicInstance(type1);
  }
  catch (Exception exception1)
  {
  }
  return base1;
}

internal static object HttpRuntime.CreatePublicInstance(Type type)
{
  // 利用反射創建對象
  return Activator.CreateInstance(type);
}

private void AttemptLogin()
{
  if ((this.Page == null) || this.Page.IsValid)
  {
    LoginCancelEventArgs args1 = new LoginCancelEventArgs();
    this.OnLoggingIn(args1);
    if (!args1.Cancel)
    {
      AuthenticateEventArgs args2 = new AuthenticateEventArgs();

      // 調用核心代碼
      this.OnAuthenticate(args2);

      // 看到了什麼？標準的身份驗證代碼。詳情可以查看上一篇Blog。
      if (args2.Authenticated)
      {
        FormsAuthentication.SetAuthCookie(this.UserNameInternal, this.RememberMeSet);
        this.OnLoggedIn(EventArgs.Empty);
        this.Page.Response.Redirect(this.GetRedirectUrl(), false);
      }
      else
      {
        this.OnLoginError(EventArgs.Empty);
        if (this.FailureAction == LoginFailureAction.RedirectToLoginPage)
        {
          FormsAuthentication.RedirectToLoginPage("loginfailure=1");
        }
        ITextControl control1 = (ITextControl)this.TemplateContainer.FailureTextLabel;
        if (control1 != null)
        {
          control1.Text = this.FailureText;
        }
      }
    }
  }
}

protected virtual void OnAuthenticate(AuthenticateEventArgs e)
{
  AuthenticateEventHandler handler1 = (AuthenticateEventHandler)base.Events[Login.EventAuthenticate];
  if (handler1 != null)
  {
    // 用戶使用了自定義身份驗證服務
    handler1(this, e);
  }
  else
  {
    // 使用成員資格提供程序
    this.AuthenticateUsingMembershipProvider(e);
  }
}

private void AuthenticateUsingMembershipProvider(AuthenticateEventArgs e)
{
  // 使用 LoginUtil.GetProvider 獲取成員資格提供程序對象，並調用其 ValidateUser 進行身份驗證。
  e.Authenticated = LoginUtil.GetProvider(this.MembershipProvider).ValidateUser(this.UserNameInternal, this.PasswordInternal);
}

internal static LoginUtil.MembershipProvider GetProvider(string providerName)
{
  if (string.IsNullOrEmpty(providerName))
  {
    return Membership.Provider;
  }

  // 調用 Membership 相關屬性，獲取提供程序對象。
  MembershipProvider provider1 = Membership.Providers[providerName];
  if (provider1 == null)
  {
    throw new HttpException(SR.GetString("WebControl_CantFindProvider"));
  }
  return provider1;
}

private void OnEnter(object source, EventArgs eventArgs)
{
  // ...
  // 注意下麵的代碼， RoleManagerModule 使用 RolePrincipal 替代了缺省的 GenericPrincipal。
  if (!(context1.User is RolePrincipal))
  {
    context1.User = new RolePrincipal(context1.User.Identity);
  }
}