[.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);
  }
}