AngularJS中实现用户访问的身份认证和表单验证功能

身份验证
权限的设计中比较常见的就是rbac基于角色的访问控制,基本思想是，对系统操作的各种权限不是直接授予具体的用户，而是在用户集合与权限集合之间建立一个角色集合。每一种角色对应一组相应的权限。
    一旦用户被分配了适当的角色后，该用户就拥有此角色的所有操作权限。这样做的好处是，不必在每次创建用户时都进行分配权限的操作，只要分配用户相应的角色即可，而且角色的权限变更比用户的权限变更要少得多，这样将简化用户的权限管理，减少系统的开销。
在angular构建的单页面应用中,要实现这样的架构我们需要额外多做一些事.从整体项目上来讲,大约有3处地方,前端工程师需要进行处理.
    1. ui处理(根据用户拥有的权限,判断页面上的一些内容是否显示)
    2. 路由处理(当用户访问一个它没有权限访问的url时,跳转到一个错误提示的页面)
    3. http请求处理(当我们发送一个数据请求,如果返回的status是401或者403,则通常重定向到一个错误提示的页面)

访问身份控制的实现
    首先需要在angular启动之前就获取到当前用户的所有的 permissions,然后比较优雅的方式是通过一个service存放这个映射关系.对于ui处理一个页面上的内容是否根据权限进行显示,我们应该通 过一个directive来实现.当处理完这些,我们还需要在添加一个路由时额外为其添加一个"permission"属性,并为其赋值表明拥有哪些权限 的角色可以跳转这个url,然后通过angular监听routechangestart事件来进行当前用户是否拥有此url访问权限的校验.最后还需要 一个http拦截器监控当一个请求返回的status是401或者403时,跳转页面到一个错误提示页面.大致上的工作就是这些,看起来有些多,其实一个个来还是挺好处理的.
返回401，执行loginctrl，返回403执行permissionctrl。
 
在angular运行之前获取到permission的映射关系
    angular项目通过ng-app启动,但是一些情况下我们是希望 angular项目的启动在我们的控制之中.比如现在这种情况下,我就希望能获取到当前登录用户的所有permission映射关系后,再启动 angular的app.幸运的是angular本身提供了这种方式,也就是angular.bootstrap().

var permissionlist; 
angular.element(document).ready(function() { 
 $.get('/api/userpermission', function(data) { 
 permissionlist = data; 
 angular.bootstrap(document, ['app']); 
 }); 
}); 

看的仔细的人可能会注意到,这里使用的是$.get(),没有错用的是jquery而不是angular的$resource或者$http,因为在这个时候angular还没有启动,它的function我们还无法使用.
进一步使用上面的代码可以将获取到的映射关系放入一个service作为全局变量来使用.

// app.js 
var app = angular.module('myapp', []), permissionlist; 
 
app.run(function(permissions) { 
 permissions.setpermissions(permissionlist) 
}); 
 
angular.element(document).ready(function() { 
 $.get('/api/userpermission', function(data) { 
 permissionlist = data; 
 angular.bootstrap(document, ['app']); 
 }); 
}); 
 
// common_service.js 
angular.module('myapp') 
 .factory('permissions', function ($rootscope) { 
 var permissionlist; 
 return { 
  setpermissions: function(permissions) { 
  permissionlist = permissions; 
  $rootscope.$broadcast('permissionschanged') 
  } 
 }; 
 }); 

 在取得当前用户的权限集合后,我们将这个集合存档到对应的一个service中,然后又做了2件事:
    (1) 将permissions存放到factory变量中,使之一直处于内存中,实现全局变量的作用,但却没有污染命名空间.
    (2) 通过$broadcast广播事件,当权限发生变更的时候.
 
1.如何确定ui组件的依据权限进行显隐
    这里我们需要自己编写一个directive,它会依据权限关系来进行显示或者隐藏元素.

<!-- if the user has edit permission the show a link --> 
<div has-permission='edit'> 
 <a href="/#/courses/{{ id }}/edit"> {{ name }}</a> 
</div> 
 
<!-- if the user doesn't have edit permission then show text only (note the "!" before "edit") --> 
<div has-permission='!edit'> 
 {{ name }} 
</div> 

 这里看到了比较理想的情况是通关一个has-permission属性校验permission的name,如果当前用户有则显示,没有则隐藏.

angular.module('myapp').directive('haspermission', function(permissions) { 
 return { 
 link: function(scope, element, attrs) { 
  if(!_.isstring(attrs.haspermission)) 
  throw "haspermission value must be a string"; 
 
  var value = attrs.haspermission.trim(); 
  var notpermissionflag = value[0] === '!'; 
  if(notpermissionflag) { 
  value = value.slice(1).trim(); 
  } 
 
  function togglevisibilitybasedonpermission() { 
  var haspermission = permissions.haspermission(value); 
 
  if(haspermission && !notpermissionflag || !haspermission && notpermissionflag) 
   element.show(); 
  else 
   element.hide(); 
  } 
  togglevisibilitybasedonpermission(); 
  scope.$on('permissionschanged', togglevisibilitybasedonpermission); 
 } 
 }; 
}); 

 扩展一下之前的factory:

angular.module('myapp') 
 .factory('permissions', function ($rootscope) { 
 var permissionlist; 
 return { 
  setpermissions: function(permissions) { 
  permissionlist = permissions; 
  $rootscope.$broadcast('permissionschanged') 
  }, 
  haspermission: function (permission) { 
  permission = permission.trim(); 
  return _.some(permissionlist, function(item) { 
   if(_.isstring(item.name)) 
   return item.name.trim() === permission 
  }); 
  } 
 }; 
 }); 

 
2.路由上的依权限访问
    这一部分的实现的思路是这样: 当我们定义一个路由的时候增加一个permission的属性,属性的值就是有哪些权限才能访问当前url.然后通过routechangestart事 件一直监听url变化.每次变化url的时候,去校验当前要跳转的url是否符合条件,然后决定是跳转成功还是跳转到错误的提示页面.

app.config(function ($routeprovider) { 
 $routeprovider 
 .when('/', { 
  templateurl: 'views/viewcourses.html', 
  controller: 'viewcoursesctrl' 
 }) 
 .when('/unauthorized', { 
  templateurl: 'views/error.html', 
  controller: 'errorctrl' 
 }) 
 .when('/courses/:id/edit', { 
  templateurl: 'views/editcourses.html', 
  controller: 'editcourses', 
  permission: 'edit' 
 }); 
}); 

 maincontroller.js 或者 indexcontroller.js (总之是父层controller)

app.controller('mainappctrl', function($scope, $location, permissions) { 
 $scope.$on('$routechangestart', function(scope, next, current) { 
 var permission = next.$$route.permission; 
 if(_.isstring(permission) && !permissions.haspermission(permission)) 
  $location.path('/unauthorized'); 
 }); 
}); 

这里依然用到了之前写的haspermission,这些东西都是高度可复用的.这样就搞定了,在每次view的route跳转前,在父容器的controller中判断一些它到底有没有跳转的权限即可.

3.http请求处理
    这个应该相对来说好处理一点,思想的思路也很简单.因为angular应用推荐的是restful风格的借口,所以对于http协议的使用很清晰.对于请求返回的status code如果是401或者403则表示没有权限,就跳转到对应的错误提示页面即可.
    当然我们不可能每个请求都去手动校验转发一次,所以肯定需要一个总的filter.代码如下:

angular.module('myapp') 
 .config(function($httpprovider) { 
 $httpprovider.responseinterceptors.push('securityinterceptor'); 
 }) 
 .provider('securityinterceptor', function() { 
 this.$get = function($location, $q) { 
  return function(promise) { 
  return promise.then(null, function(response) { 
   if(response.status === 403 || response.status === 401) { 
   $location.path('/unauthorized'); 
   } 
   return $q.reject(response); 
  }); 
  }; 
 }; 
 }); 

写到这里就差不多可以实现在这种前后端分离模式下,前端部分的权限管理和控制了。

表单验证
angularjs 前端验证指令

var rcsubmitdirective = { 
 'rcsubmit': function ($parse) { 
 return { 
  restrict: "a", 
  require: [ "rcsubmit", "?form" ], 
  controller: function() { 
  this.attempted = false; 
  var formcontroller = null; 
  this.setattempted = function() { 
   this.attempted = true; 
  }; 
  this.setformcontroller = function(controller) { 
   formcontroller = controller; 
  }; 
  this.needsattention = function(fieldmodelcontroller) { 
   if (!formcontroller) return false; 
   if (fieldmodelcontroller) { 
   return fieldmodelcontroller.$invalid && (fieldmodelcontroller.$dirty || this.attempted); 
   } else { 
   return formcontroller && formcontroller.$invalid && (formcontroller.$dirty || this.attempted); 
   } 
  }; 
  }, 
  compile: function() { 
  return { 
   pre: function(scope, formelement, attributes, controllers) { 
   var submitcontroller = controllers[0]; 
   var formcontroller = controllers.length > 1 ? controllers[1] : null; 
   submitcontroller.setformcontroller(formcontroller); 
   scope.rc = scope.rc || {}; 
   scope.rc[attributes.name] = submitcontroller; 
   }, 
   post: function(scope, formelement, attributes, controllers) { 
   var submitcontroller = controllers[0]; 
   var formcontroller = controllers.length > 1 ? controllers[1] : null; 
   var fn = $parse(attributes.rcsubmit); 
   formelement.bind("submit", function(event) { 
    submitcontroller.setattempted(); 
    if (!scope.$$phase) scope.$apply(); 
    if (!formcontroller.$valid) return; 
    scope.$apply(function() { 
    fn(scope, { 
     $event: event 
    }); 
    }); 
   }); 
   } 
  }; 
  } 
 }; 
 } 
}; 

 
验证通过

<form name="loginform" novalidate 
  ng-app="loginapp" ng-controller="logincontroller" rc-submit="login()"> 
 <div class="form-group" 
   ng-class="{'has-error': rc.loginform.needsattention(loginform.username)}"> 
  <input class="form-control" name="username" type="text" 
    placeholder="username" required ng-model="session.username" /> 
  <span class="help-block" 
    ng-show="rc.form.needsattention(loginform.username) && loginform.username.$error.required">required</span> 
 </div> 
 <div class="form-group" 
   ng-class="{'has-error': rc.loginform.needsattention(loginform.password)}"> 
  <input class="form-control" name="password" type="password" 
    placeholder="password" required ng-model="session.password" /> 
  <span class="help-block" 
    ng-show="rc.form.needsattention(loginform.password) && loginform.password.$error.required">required</span> 
 </div> 
 <div class="form-group"> 
  <button type="submit" class="btn btn-primary pull-right" 
    value="login" title="login"> 
   <span>login</span> 
  </button> 
 </div> 
</form> 

样式如下

前端验证通过会调用login()。