@buession/shiro
Version:
A security framework for JavaScript or TypeScript.
145 lines • 4.32 kB
JavaScript
import { ALL_PERMISSION, DefaultPrincipal } from './core';
import { has, hasAny, hasAll } from './utils/common';
export class Shiro {
constructor(principal) {
const $principal = principal;
if (typeof $principal.id === 'string' && Array.isArray($principal.roles) && Array.isArray($principal.permissions)) {
this.principal = new DefaultPrincipal($principal.id, $principal.roles, $principal.permissions);
}
else {
this.principal = principal;
}
}
/**
* 验证是否为已认证通过的用户,不包含已记住的用户,这是与 isUser 标签方法的区别所在
*
* @return 用户是否已通过认证
*/
isAuthenticated() {
return this.principal !== null;
}
/**
* 验证是否为未认证通过用户,与 isAuthenticated 标签相对应,与 isGuest 标签的区别是,该标签包含已记住用户
*
* @return 用户是否未通过认证
*/
isNotAuthenticated() {
return this.isAuthenticated() === false;
}
/**
* 验证用户是否为访客,即未认证(包含未记住)的用户
*
* @return 用户是否为访客
*/
isGuest() {
return this.principal === null;
}
/**
* 验证用户是否认证通过或已记住的用户
*
* @return 用户是否认证通过或已记住的用户
*/
isUser() {
return this.principal !== null;
}
/**
* 验证用户是否具备某角色。
*
* @param roleName
* 角色名称
*
* @return 用户是否具备某角色
*/
hasRole(roleName) {
return this.isAuthenticated() && has(this.principal.getRoles(), roleName);
}
/**
* 验证用户是否不具备某角色,与 hasRole 逻辑相反
*
* @param roleName
* 角色名称
*
* @return 用户是否不具备某角色
*/
lacksRole(roleName) {
return this.hasRole(roleName) === false;
}
/**
* 验证用户是否具有以下任意一个角色
*
* @param roleNames
* 角色列表
*
* @return 用户是否具有以下任意一个角色
*/
hasAnyRole(roleNames) {
return this.isAuthenticated() && hasAny(this.principal.getRoles(), roleNames);
}
/**
* 验证用户是否具有以下所有角色。
*
* @param roleNames
* 角色列表
*
* @return 用户是否具有以下所有角色
*/
hasRolesAll(roleNames) {
return this.isAuthenticated() && hasAll(this.principal.getRoles(), roleNames);
}
/**
* 验证用户是否具备某权限
*
* @param permission
* 权限名称
*
* @return 用户是否具备某权限
*/
hasPermission(permission) {
return this.isAuthenticated() && hasAny(this.principal.getPermissions(), [ALL_PERMISSION, permission]);
}
/**
* 验证用户是否不具备某权限,与 hasPermission 逻辑相反
*
* @param permission
* 权限名称
*
* @return 用户是否不具备某权限
*/
lacksPermission(permission) {
return this.hasPermission(permission) === false;
}
/**
* 验证用户是否具有以下任意一个权限
*
* @param permissions
* 权限列表
*
* @return 用户是否具有以下任意一个权限
*/
hasAnyPermission(permissions) {
return this.isAuthenticated() && hasAny(this.principal.getPermissions(), (permissions || []).concat(ALL_PERMISSION));
}
/**
* 验证用户是否具有以下所有权限
*
* @param permissions
* 权限列表
*
* @return 用户是否具有以下所有权限
*/
hasAllPermissions(permissions) {
return this.isAuthenticated() && (has(this.principal.getPermissions(), ALL_PERMISSION) || hasAll(this.principal.getPermissions(), permissions));
}
/**
* 验证用户是否具有以下所有权限
*
* @param permissions
* 权限列表
*
* @return 用户是否具有以下所有权限
*/
hasPermissionsAll(permissions) {
return this.hasAllPermissions(permissions);
}
}
//# sourceMappingURL=shiro.js.map