彭斌

[ 2006,2007 ASP.NET ' MVP ]
随笔 - 99, 文章 - 5, 评论 - 1027, 引用 - 16
数据加载中……

Community Server专题八:MemberRole之Membership

 

Community Server专题八:MemberRoleMembership

 

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个部分:membershiproleManagerprofileanonymousIdentification的运用(整个MemberRole也这四部分功能)

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

本次专题分析membership,先看一下CSMembership的配置文件(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:注册时是否需要填写QuestionAnswer

requiresUniqueEmail:注册时是否Email唯一

passwordFormat:密码的加密格式

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

description:描述信息

 

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

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

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

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

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

 

Reflector.exe打开MemberRole.dll,你可以看到以下的内容:

再打开Microsoft.ScalableHosting.Configuration节点

这次我们只关注两个类MembershipConfigMembershipConfigHandlerMembershipConfigHandler实现了IConfigurationSectionHandler接口。也就是说,CS启动后如果调用ConfigurationSettings.GetConfig("memberrolesprototype/membership"),系统将会自动的调用MembershipConfigHandler中的Create方法把web.configmemberrolesprototype/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节点的配置信息读入,进行初始化,然后通过GetTypeActivator.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 getset; }
      
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类,重写了几个方法(关键是其中的InitializeCreateUser方法)

只要你继承MembershipProvider类,对其中的抽象方法进行实现,无论你是实现对Access的操作,还是其它数据库,都是没有问题的。在asp.net 2.0 beta2中的Membership已经提供accesssql 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的数据层的操作实现以及数据库表的设计(包括存储过程)

posted on 2005-09-17 18:47 彭斌 阅读(7145) 评论(18)  编辑 收藏 网摘 所属分类: CommunityServer

评论

#1楼   回复  引用  查看    

搂主发贴挺快的,呵呵,字体显示不太好。这个CS确实很值得研究。
2005-09-17 19:36 | 蛙蛙池塘      

#2楼   回复  引用  查看    

期待后续文章。正在学习中。
2005-09-17 21:57 | 浮云      

#3楼   回复  引用  查看    

这类复杂的东西,我觉得画些uml图对理解有很大帮助,对各个类之间的关系容易搞清楚。
2005-09-17 23:26 | Vincent Trent      

#4楼   回复  引用  查看    

好文,楼主辛苦了!
2005-09-18 00:44 | culturenet      

#5楼   回复  引用    

不过,我感觉Community Server(CS)其实是ASP.NET Community Starter Kit(CSK)的变种。或者说CS是在CSK的基础上改写的。原因非常简单:CSK在CS之前由微软给出,而且你说的功能CSK几乎全部都有。例如CSK里还有搜索的原理,利用WEB Service进行站点资源共享,定时器等等
2005-09-18 07:31 | asp[未注册用户]

#6楼[楼主]   回复  引用  查看    

@Vincent Trent
怪我太懒,uml后续文章我会补上
@asp
CSK是一个Starter Kit,比起CS来粗糙很多
2005-09-19 10:11 | uGoer      

#7楼   回复  引用    

如果想知道原因。直接到www.asp.net下载Community Starterkit
Communisty StarterKit是CS的妈妈,所有看起来比CS更直观
CS太大,太复杂,根本不适合一般人学习。
等你会了Community Starter Kit 再看CS,你会感觉CS“不过如此”
2005-09-19 16:02 | 晕[未注册用户]

#8楼[楼主]   回复  引用  查看    

@晕
对于软件开发而言,新技术固然重要,但是构架比技术更重要,CS优秀,是因为他的构架值得学习,而他所采用的一些新技术,在asp.net 2.0中可以不构架任何代码就实现,如果不需要深入理解你只要会用就可以了。
2005-09-19 16:35 | uGoer      

#9楼   回复  引用    

我对CS没什么了解,我在学AspNetForums,我是通过HttpModule开始的,现在也正在看user角色权限这一块,一知半解,谢谢你的专题。我认为anf也许更容易接受些,CS集成了好几个项目,看到config.web就头大了。呵呵
2005-09-22 20:49 | 一两独白[未注册用户]

#10楼   回复  引用    

好文章
2005-10-10 11:35 | hdh[未注册用户]

#11楼   回复  引用    

你写的太棒了,爱死你了,简直和MSN上的你简直是两个人,支持支持!
2005-10-10 19:35 | zhuf[未注册用户]

#12楼   回复  引用    

你这里提到“在asp.net 2.0 beta2中的Membership已经提供access与sql server两种数据库操作实现。”请问,你是否知道我用什么方法能够得到access访问Membership的Provider?
我想在我的虚拟主机上安装DNN3,但是因为虚拟主机的SQLServer没有提供dbo权限,没法使用DNN3提供的那个SQL Provider(无法得到需要的权限)。
2005-10-30 01:15 | Will[未注册用户]

#13楼[楼主]   回复  引用  查看    

@Will
目前我没有发现1.1版本下的Access 的 Membership的Provider,如果你要做一个也行,通过Reflector 反编译后重写一个 access访问Membership的Provider。估计要花费一点时间。
另外,就是你有了access访问Membership的Provider,你的dnn还使用了很多的存储过程,这些不是Membership的Provider所做的工作。因此要移植是有难度的
2005-10-31 09:13 | uGoer      

#14楼   回复  引用  查看    

MembershipConfigHandler实现了IConfigurationSectionHandler接口。也就是说,CS启动后如果调用ConfigurationSettings.GetConfig("memberrolesprototype/membership"),系统将会自动的调用MembershipConfigHandler中的Create方法,把web.config中memberrolesprototype/membership的配置内容读入进行处理。
为什么自动调用MembershipConfigHandler中的Create方法??
2006-05-12 15:06 | 思无邪      

#15楼   回复  引用    

@思无邪 :
IConfigurationSectionHandler接口中的Create方法 ,是有系统自动调用
2006-08-08 15:24 | doitnow

#16楼   回复  引用    

不错.

#17楼   回复  引用    

、我一直不知道blog的二级域名如何设定,能不能大致上给我讲讲呢,
http://____.sina.com就那个空格 上填写相关的内容了,那个内容就是你自己申请的博客地址!
2008-05-30 09:11 | 陈力[未注册用户]



发表评论

昵称: [登录] [注册]

主页:

邮箱:(仅博主可见)

评论内容:

  登录  注册

[使用Ctrl+Enter键快速提交评论]

0 238978




相关文章:

相关链接: