Community Server专题八：MemberRole之Membership

 

 MemberRole是一个在asp.net  1 .1下实现用户管理、角色管理、用户特性信息存储(profile)等的一个组件，该组件被ASP.NET  2.0  Beta 2所采用，也就是ASP.NET  2.0  Beta 2中所说的Membership and Roles。如果你在asp.net  1 .1下采用了MemberRole，那么你的web程序将会很容易的过渡到asp.net  2.0 ，另外多个采取MemberRole进行用户管理的web程序需要整合时也非常容易。我将分4个专题来分析MemberRole，探索一下MemberRole到底是如何工作的，无论对CS的构架还是对了解asp.net  2 .0都是非常有帮助的。

CS中，运用该组件的4个部分：membership、roleManager、profile、anonymousIdentification的运用(整个MemberRole也这四部分功能)。

在分析前，准备需要一个工具：Reflector.exe，没有的朋友google一下，下载它。

本次专题分析membership，先看一下CS中Membership的配置文件(Web.Config中)：

< membership userIsOnlineTimeWindow = " 15 "   >

               < providers >

                    < add 

                       name = " CommunityServerSqlProvider "               

                       type = " Openlab.AutoRegister.CSAutoBlogGalleryMembershipProvider, Openlab.CSAddOns "

                       connectionStringName = " SiteSqlServer "

                       enablePasswordRetrieval = " false "

                       enablePasswordReset = " true "

                       requiresQuestionAndAnswer = " false "

                       requiresUniqueEmail = " true "

                       passwordFormat = " Hashed "

                       applicationName = " dev "

                       description = " Stores and retrieves membership data from the local Microsoft SQL Server database "

                       autoCreateBlog = " false "

                       defaultBlogGroupID = " 3 "

                       autoCreateGallery = " false "

                       defaultGalleryGroupID = " 2 "

                       maxInvalidPasswordAttempts  =   " 999 "

                       passwordAttemptWindow  =   " 999 "

                       minRequiredPasswordLength  =   " 4 "

                       minRequiredNonalphanumericCharacters  =   " 0 "

                    />

               </ providers >

</ membership >

userIsOnlineTimeWindow：这是一个数值，用来计算在线用户的数量，例如： 15 ，就表示如果用户在15分钟后不活动(发出Http请求)CS系统将视该用户不在线。

Name：名称

type：类的名字空间与所在的程序集合

connectionStringName：数据库连接字符串节点的key。通过这个key就可以找到连接数据库的用户名与密码

enablePasswordRetrieval：是否打开取回秘密功能

enablePasswordReset：是否打开秘密重新设功能

requiresQuestionAndAnswer：注册时是否需要填写Question与Answer

requiresUniqueEmail：注册时是否Email唯一

passwordFormat：密码的加密格式

applicationName：使用该membership应用程序的名称

description：描述信息

 

以下4个参数是CCS中添加的，目的是给注册用户自动开通相册和博客

autoCreateBlog：是否当用户注册时自动为该用户建立一个Blog

defaultBlogGroupID：默认的建立blog的分组ID

autoCreateGallery：是否当用户注册时自动为该用户建立一个相册

defaultGalleryGroupID：默认的建立相册的分组ID

 

用Reflector.exe打开MemberRole.dll，你可以看到以下的内容：


再打开Microsoft.ScalableHosting.Configuration节点


这次我们只关注两个类MembershipConfig、MembershipConfigHandler。MembershipConfigHandler实现了IConfigurationSectionHandler接口。也就是说，CS启动后如果调用ConfigurationSettings.GetConfig( " memberrolesprototype/membership " )，系统将会自动的调用MembershipConfigHandler中的Create方法把web.config中memberrolesprototype / membership的配置内容读入进行处理。先看以下Create做了些什么：

public   virtual   object  Create( object  parent,  object  configContextObj, XmlNode section)
{
      MembershipConfig config1 = new MembershipConfig(parent as MembershipConfig);
      int num1 = -1;
      ConfigUtils.GetAndRemovePositiveIntegerAttribute(section, "userIsOnlineTimeWindow", ref num1);
      if (num1 > 0)
      {
            config1.UserIsOnlineTimeWindow = num1;
      }
      string text1 = null;
      ConfigUtils.GetAndRemoveStringAttribute(section, "hashAlgorithm", ref text1);
      if ((text1 != null) && (text1.Length > 0))
      {
            config1.HashAlgorithmType = text1;
      }
      ConfigUtils.CheckForUnrecognizedAttributes(section);
      MembershipProvider provider1 = null;
      foreach (XmlNode node1 in section.ChildNodes)
      {
            if (node1.NodeType != XmlNodeType.Element)
            {
                  continue;
            }
            if (node1.Name != "providers")
            {
                  throw new ConfigurationException("Unrecognized tag: " + node1.Name, node1);
            }
            foreach (XmlNode node2 in node1.ChildNodes)
            {
                  if (node2.NodeType == XmlNodeType.Element)
                  {
                        if (node2.Name != "add")
                        {
                              throw new ConfigurationException("Unrecognized tag: " + node2.Name, node2);
                        }
                        if (provider1 != null)
                        {
                              throw new ConfigurationException("Only one provider can be configured", node2);
                        }
                        string text2 = null;
                        string text3 = null;
                        ConfigUtils.GetAndRemoveRequiredNonEmptyStringAttribute(node2, "name", ref text2);
                        ConfigUtils.GetAndRemoveRequiredNonEmptyStringAttribute(node2, "type", ref text3);
                        NameValueCollection collection1 = new NameValueCollection();
                        foreach (XmlAttribute attribute1 in node2.Attributes)
                        {
                              if ((attribute1.Name != null) && (attribute1.Name.Length > 0))
                              {
                                    collection1.Add(attribute1.Name, attribute1.Value);
                              }
                        }
                        provider1 = (MembershipProvider) Activator.CreateInstance(Type.GetType(text3, true));
                        provider1.Initialize(text2, collection1);
                        config1.Provider = provider1;
                  }
            }
      }
      return config1;
}

 

代码有点长，其实这里就是把web.config下面membership节点的配置信息读入，进行初始化，然后通过GetType与Activator.CreateInstance方法反射后实例化一个MembershipProvider。

MembershipProvider又是什么，继续看看：

public   abstract   class  MembershipProvider : ProviderBase
{
      // Events
      public event MembershipValidatePasswordEventHandler ValidatingPassword;
 
      // Methods
      protected MembershipProvider();
      public abstract bool ChangePassword(string username, string oldPassword, string newPassword);
      public abstract bool ChangePasswordQuestionAndAnswer(string username, string password, string newPasswordQuestion, string newPasswordAnswer);
      public abstract MembershipUser CreateUser(string username, string password, string email, string passwordQuestion, string passwordAnswer, bool isApproved, object providerUserKey, out MembershipCreateStatus status);
      protected virtual byte[] DecryptPassword(byte[] encodedPassword);
      public abstract bool DeleteUser(string username, bool deleteAllRelatedData);
      internal string EncodePassword(string pass, int passwordFormat, string salt);
      protected virtual byte[] EncryptPassword(byte[] password);
      public abstract MembershipUserCollection FindUsersByEmail(string emailToMatch, int pageIndex, int pageSize, out int totalRecords);
      public abstract MembershipUserCollection FindUsersByName(string usernameToMatch, int pageIndex, int pageSize, out int totalRecords);
      internal string GenerateSalt();
      public abstract MembershipUserCollection GetAllUsers(int pageIndex, int pageSize, out int totalRecords);
      public abstract int GetNumberOfUsersOnline();
      public abstract string GetPassword(string username, string answer);
      public abstract MembershipUser GetUser(object providerUserKey, bool userIsOnline);
      public abstract MembershipUser GetUser(string username, bool userIsOnline);
      public abstract string GetUserNameByEmail(string email);
      protected virtual void OnValidatingPassword(ValidatePasswordEventArgs e);
      public abstract string ResetPassword(string username, string answer);
      internal string UnEncodePassword(string pass, int passwordFormat);
      public abstract bool UnlockUser(string userName);
      public abstract void UpdateUser(MembershipUser user);
      public abstract bool ValidateUser(string username, string password);
 
      // Properties
      public abstract string ApplicationName { get; set; }
      public abstract bool EnablePasswordReset { get; }
      public abstract bool EnablePasswordRetrieval { get; }
      public abstract int MaxInvalidPasswordAttempts { get; }
      public abstract int MinRequiredNonAlphanumericCharacters { get; }
      public abstract int MinRequiredPasswordLength { get; }
      public abstract int PasswordAttemptWindow { get; }
      public abstract MembershipPasswordFormat PasswordFormat { get; }
      public abstract string PasswordStrengthRegularExpression { get; }
      public abstract bool RequiresQuestionAndAnswer { get; }
      public abstract bool RequiresUniqueEmail { get; }
 
      // Fields
      private MembershipValidatePasswordEventHandler _EventHandler;
      private const int SALT_SIZE_IN_BYTES = 0x10;
}
原来MembershipProvider是实现继承了ProviderBase的一个类，其实ProviderBase并没有什么，看看代码

public   abstract   class  ProviderBase
{
      // Methods
      protected ProviderBase();
      public virtual void Initialize(string name, NameValueCollection config);
 
      // Properties
      public virtual string Description { get; }
      public virtual string Name { get; }
 
      // Fields
      private string _Description;
      private bool _Initialized;
      private string _name;
}

ProviderBase仅仅只是保护了两个虚属性的类，设置这个类只是一种设计模式，没有特别的用途。我们把重点集中到MembershipProvider上，其实MembershipProvider类是Provider构架的一种体现形式，Provider构架常常用到对数据库的访问上，实现多数据库，同时也可以很好的隔离数据层与业务层的代码有利于协作开发。具体实现是这样的，先把要操作数据库的方法抽象出来，单独的放入一个abstract类，例如：MembershipProvider，然后通过继承，把这些抽象的方法全部的实现出来，例如：SqlMembershipProvider。这样有什么好处呢？对于三层构架的web应用程序来说，中间的业务逻辑层调用操作数据库的方法是从MembershipProvider，对于该层来说它并不关心该抽象层是如何被继承后实现抽象方法的。它只关心抽象层中是否有它想要的方法。如果能理解到这里，嘿嘿，我们的机会就来了，因为这隔离了具体的数据库操作实现，更进一步说就是隔离了使用何种数据库。再从团队协作考虑，假设你的MembershipProvider定义的完善后，继承MembershipProvider实现SQL Server操作的SqlMembershipProvider类中的方法无论怎么改变，都不会影响其它人员在业务逻辑层的开发。听起来这种方式好像很美，但是要实现这样的功能还需要一个关键的技术，那就是反射，所以我们看到在配置的字段里有这样的字节：。

type = " Openlab.AutoRegister.CSAutoBlogGalleryMembershipProvider, Openlab.CSAddOns "

这就是为了通过反射找到MembershipProvider具体方法实现的类而做的准备。

注：由于分析的代码来源于宝玉的CCS，在CCS中为了实现注册后能自动开通博客与相册又继承了SqlMembershipProvider类，重写了几个方法(关键是其中的Initialize与CreateUser方法)。

只要你继承MembershipProvider类，对其中的抽象方法进行实现，无论你是实现对Access的操作，还是其它数据库，都是没有问题的。在asp.net  2.0  beta2中的Membership已经提供access与sql server两种数据库操作实现。不过MemberRole.dll程序集中只实现了SqlMembershipProvider，也就是对SQL Server的操作。

其实Membership是一个没有表示层的运用组件，它包含了逻辑层与数据操作层，数据层我在这个专题中就不多做解释，他的实现是在SqlMembershipProvider类中，你可以通过Reflector.exe慢慢研究。上面的文字说过，实现Provider模式后业务逻辑层对数据层具体实现就不关心了，在MemberRole.dll中的Membership，它把所有的这些逻辑用一个类包装起来，那就是Membership类：


对于引用MemberRole.dll实现Membership功能的web app(DNN,CS就是典型)来说，只要做合适的配置之后就可以直接使用了。

例如，要建立一个用户只要调用Membership.CreateUser的静态方法，就可以完成（Membership会根据内部的方法和具体的数据库操作，把用户信息写入数据库）。

对于使用Membership来开发web app的程序员来说，完全可以不必要了解这些细节，asp  2.0  beta2就没有提供这样的机会，MS只要求你会用就可以了，不过很庆幸的是CS给我们提供了这样的一个机会，了解这些操作的实质(包括URL Rewrite等功能也是一样，这些功能都可以在asp  2.0  beta2中直接使用，而不要构架如何代码)。

这个专题只是大致的讲解了Membership，下一个专题，我们将更深入的去看看Membership的数据层的操作实现以及数据库表的设计(包括存储过程)。