乐时光博客园子

[reprinted:腾飞(Jesse)]

  Membership 三步曲之入门篇 - Membership基础示例

  1. Membership三步曲之入门篇 -  Membership基础示例

  2. Membership三步曲之进阶篇 -  深入剖析Provider model

  3. Membership三步曲之高级篇 -  从Membership 到 .NET 4.5 之 AspNet.Identity

  Membership是ASP.NET为我们提供的一套验证和存储用户凭证的框架。它可以帮助我们快速的开发用户登录、管理以及权限验证相关的模块,很多人可能会说Membership开发起来确实很快,但是总是和需求有那么一点不匹配,那我们就要用到Membership的自定义扩展功能了,如果真正掌握了Membership的话,对于我们快速开发还是有很大帮助的,更重要的是Membership是一套可灵活扩展的框架,包括里面的Provider模型对于想学习架构的同学来说是一个不错的案例,那么接下来我们就来一步一步的看看Membership是如何做到的。 

  入门篇会从0开始将Membership集成到一个空的MVC站点中,并且与ASP.NET的权限管理体系相结合。进阶篇将剖析Membership的设计理念以及它的结构。高级篇我们将会扩展自己的MembershipProvider和RolesProvider,目地是直接利用我们老系统中已经存在的用户表和角色表,也就是用我们已经存在的数据库去集成Membership。

  注意:使用VS2012建立一个Internet的MVC项目,会直接帮助我们生成一个已经集成好Membership的一个项目。但是我们会从头开始自己把Membership加入到一个空的项目中,这样更有利于我们理解它的工作原理 :)。

目录

  1. Membership类成员介绍

  2. 集成Membership到ASP.NET MVC网站中

  3. 为Membership启用角色管理

Membership类成员介绍

  一般来讲我们的网站要实现的与用户相关的最基本功能包括:注册,登录,修改用户资料和密码。Membership为我们提供了以下几个类来帮助我们完成这些功能。

Membership三步曲之入门篇 - Membership基础示例

  在System.Web.Security的命名空间包含了上图中的8个类,但是实际上我们只需要Membership一个类就可以帮助我们完成大部份的功能。接下来我们就来一步一步的将Membership集成到我们的MVC站点中去。

集成Membership到ASP.NET MVC网站中

  这里我们的需求很简单,只是要实现一个包含注册、登录、以及修改密码功能的网站就可以了。我们接下来要做的就是建立一个基本的MVC站点,然后再配置Membership,加上我们的功能代码。

2.1 新建一个基本的MVC站点

  Membership三步曲之入门篇 - Membership基础示例

  Membership三步曲之入门篇 - Membership基础示例

  我们的站点默认已经启用Forms认证,如果不了解Foms的话,园子里面有一篇比较好的文章,我已经加上链接了。但是Forms有安全方面的隐患,这个系列的后面我们会对比各种认证方式,有兴趣的同学请继续关注。

  同时,还为我们默认配置了一个MembershipProvider(我们下面会说这个东西,这里暂时忽略也没有关系)

Membership三步曲之入门篇 - Membership基础示例

2.2 添加功能代码

  虽然说我们建立的这个项目已经配置好了Membership,但是并没有地方去使用它。我们没有Controller也没有View。所以接下来我们就要开始加入调用Membership的代码了。

  首先我们在Layout里面加上三个链接:Register, Login, 如果已经登录的话我们就显示用户名和LogOff。 Membership三步曲之入门篇 - Membership基础示例

  当然我们还得加上HomeController并且添加一个默认的Index Action。然后我们再加上AccountController并且添加4个Action(Login和Register的Get、Post版本),View的代码我就不贴了,大家可以到未尾下载整个项目的源码。

  登录代码

public ActionResult Login(){    return View();}[HttpPost][AllowAnonymous][ValidateAntiForgeryToken]public ActionResult Login(LoginModel model, string returnUrl){    // Membership.ValidateUser 判断用户名和密码是否正确    if (ModelState.IsValid && Membership.ValidateUser(model.UserName, model.Password))    {        // 调用Forms 的登录 User.Identity.IsAuthenticated 将设置为True        // User.Identity.Name 会设置成我们下面的UserName        FormsAuthentication.SetAuthCookie(model.UserName, false);        return RedirectToLocal(returnUrl);    }    ModelState.AddModelError("", "The user name or password provided is incorrect.");    return View(model);}

   注册相关代码

public ActionResult Register(){    return View();}[HttpPost][AllowAnonymous][ValidateAntiForgeryToken]public ActionResult Register(RegisterModel model){    if (ModelState.IsValid)    {        try        {               // Membership.CreateUser去创建用户            var user = Membership.CreateUser(model.UserName, model.Password);            if (user != null)            {                //注册完成之后直接登录用户                FormsAuthentication.SetAuthCookie(user.UserName, false);            }            return RedirectToAction("Index", "Home");        }        catch (MembershipCreateUserException e)        {            ModelState.AddModelError("", ErrorCodeToString(e.StatusCode));        }    }    return View(model);}

   登出相关代码

[HttpPost][ValidateAntiForgeryToken]public ActionResult LogOff(){    FormsAuthentication.SignOut();    return RedirectToAction("Index", "Home");}

  修改密码相关代码

[HttpPost][ValidateAntiForgeryToken]public ActionResult LogOff(){    FormsAuthentication.SignOut();    return RedirectToAction("Index", "Home");}[Authorize]public ActionResult Manage(){    return View();}/**************************************************//*注意我们为Manage这两个Action加上了Authorize标签,只有登录过的用户才能访问  如果用户没有登录直接访问/Account/Manage会被跳到/Account/Login要求登录*/[Authorize][HttpPost][ValidateAntiForgeryToken]public ActionResult Manage(LocalPasswordModel model){    if (ModelState.IsValid)    {        bool changePasswordSucceeded;        try        {            var user = Membership.GetUser(User.Identity.Name);            changePasswordSucceeded = user.ChangePassword(model.OldPassword,                model.NewPassword);        }        catch (Exception)        {            changePasswordSucceeded = false;        }        if (changePasswordSucceeded)        {            return RedirectToAction("Manage", new { Message = "修改密码成功!"});        }        else        {            ModelState.AddModelError("", "老密码不正确或新密码不符合要求");        }    }    return View(model);}

  就是这么简单,我们的注册,登录,以及修改密码功能就完成了。

Membership三步曲之入门篇 - Membership基础示例

  来看一下我们用到了哪些Membership的功能:

  • Membership.ValidateUser 验证用户名和密码实现登录 

  • Membership.CreateUser 创建新用户

  • Membership.GetUser 获取用户

  • MembershipUser.ChangePassword 修改密码

  还有更多的方法我们可以使用,在最上面的表中我们已经列出来了,大家可以自行尝试。这些功能都出来以后,我们还有一个疑问没有解答,那就是我们的用户保存到哪里去了? Membership三步曲之入门篇 - Membership基础示例

  Membership的配置节点中有一个connctionStringName的属性,可以指定我们的数据库连接字符串。那我们就来看一下它都帮我们搞了一个什么样的数据库。注:这个数据库是Membership帮我们生成的,我之前并没有创建它,也就是我们只需要写好连接字符串就可以了。

  而我们的用户信息就保存在Users表和Memberships表中。

Membership三步曲之入门篇 - Membership基础示例

为Membership启用角色管理

  我们已经完成了登录、注册和修改密码的功能。登录属性认证的范畴,而与认证如影随形的还是授权。通俗的讲,认证是看这个用户是不是合法的,像一扇门,你放不放穿上用户进来。而授权是在他进来之后能够干什么,他可以坐在椅子上,但绝对不能坐在你头上,又或者你只允许你爸或者你老婆坐在你头上,这就是授权了。

  相信很多人都自己写过权限相关的代码,也有人会写出一套权限管理的框架来。其实ASP.NET已经有一套比较成熟的权限体系,加上它的自定义功能基本可以满足我们大多数的需求了。

  在我们创建这个MVC站点的时候,VS也为我们配置了权限模块。就在挨着membership结点的下方:

Membership三步曲之入门篇 - Membership基础示例

  因为我们这里面的连接字符串与我们的membersihp中用到的是同一个,所以和权限相关的表Roles、UserInRoles也创建到了同一个数据库中。不一样的是我们不需要写一行代码就可以完成角色管理的功能,包括创建/修改/删除角色,以及给用户赋予角色。

  通过项目->ASP.NET 配置就可以打开这个小网站去管理我们的角色(抱歉,我用的英文版 - -! )。

Membership三步曲之入门篇 - Membership基础示例

Membership三步曲之入门篇 - Membership基础示例

  我们可以点击Security(安全)到管理用户和角色的地页面。

Membership三步曲之入门篇 - Membership基础示例

我们先添加3个角色:Admin, Manager, User

Membership三步曲之入门篇 - Membership基础示例

然后我们就可以给我们的用户赋予角色了。Membership三步曲之入门篇 - Membership基础示例

  接下来我们就可以在代码中使用User.IsInRole方法是看用户是否具有某一个角色的权限了。在MVC的Action上我们可以直接在Authorize标签中指定某个角色,那么这个Action就只有这个角色下的用户才能够访问了。

[Authorize(Roles="Admin")]public ActionResult Manage(){    return View();}

  我们还可以通过调用Roles.GetRolesForUser将这个用户相关的角色的都取出来。

Membership三步曲之入门篇 - Membership基础示例

Membership三步曲之入门篇 - Membership基础示例

  现在我们就已经为我们的网站添加认证和授权模块了,分分搞定啊!功能是完成了,但是还留下了不少的问题需要解决,因为大多数情况下我们的User表都不会这么简单,要多加一些字段怎么办? 我们使用了EF需要使用User entity怎么办?又或者角色是有父子关系的又该如何做呢?我们后面的进阶篇将会告诉你答案。

  Demo下载:http://pan.baidu.com/s/1gduY5CR (你点或不点,推荐按钮就在右下角 !)

本文来源于互联网:Membership三步曲之入门篇 - Membership基础示例  https://www.lesg.cn  本文中来自互联网如有侵权请联系删除。

上下篇:

相关推荐