作者: gh-xiaohe
gh-xiaohe的博客
觉得博主文章写的不错的话,希望大家三连(✌关注,✌点赞,✌评论),多多支持一下!!!
Apache Shiro是一个功能强大且易于使用的 Java 安全(权限)框架。Shiro可以完成:认证、授权、加密、会话管理、与 Web 集成、缓存等。借助 Shiro您可以快速轻松 地保护任何应用程序——从最小的移动应用程序到最大的 Web 和企业应用程序。
官网:https://shiro.apache.org/
自 2003 年以来,框架格局发生了相当大的变化,因此今天仍然有很多系统在使用Shiro。这与Shiro的特性密不可分。
好处:
对比缺点:
对比优点:
1、基本功能点如下图所示
(1)Authentication:身份认证/登录,验证用户是不是拥有相应的身份;
(2)Authorization:授权,即权限验证,验证某个已认证的用户是否拥有某个权限;即判断用户是否能进行什么操作,如:验证某个用户是否拥有某个角色。或者细粒度的验证 某个用户 对某个资源是否具有某个权限;
(3)Session Manager:会话管理,即用户登录后就是一次会话,在没有退出之前,它的所有 信息都在会话中;会话可以是普通 JavaSE 环境,也可以是Web 环境的;
(4)Cryptography:加密,保护数据的安全性,如:密码加密存储到数据库,而不是明文存储;
(5)Web Support:Web 支持,可以非常容易的集成到 Web 环境;
(6)Caching:缓存,如:用户登录后,其用户信息、拥有的角色/权限不必每次去查,这样可以提高效率;
(7)Concurrency:Shiro 支持多线程应用的并发验证,如:在一个线程中开启另一个线程,能把权限自动传播过去;
(8)Testing:提供测试支持;
(9)Run As:允许一个用户假装为另一个用户(如果他们允许)的身份进行访问;
(10)Remember Me:记住我,这个是非常常见的功能,即一次登录后,下次再来的话不用登录了
从外部来看 Shiro ,即从应用程序角度的来观察如何使用 Shiro 完成 工作
(1)Subject:应用代码直接交互的对象是 Subject,也就是说 Shiro 的对外 API 核心就 Subject。Subject 代表了当前“用户”, 这个用户不一定是一个具体的人,与当前应用交互的任何东西都是 Subject,如:网络爬虫,机器人等;与 Subject 的所有交互 都会委托给 SecurityManager;Subject 其实是一个门面,SecurityManager 才是实际的执行者;
(2)SecurityManager:安全管理器;即所有与安全有关的操作都会与 SecurityManager 交互;且其管理着所有 Subject; 可以看出它是 Shiro 的核心,它负责与 Shiro 的其他组件进行交互,它相当于 SpringMVC 中 DispatcherServlet 的角色
(3)Realm:Shiro 从 Realm 获取安全数据(如:用户、角色、权限),就是说SecurityManager 要验证用户身份,那么它需要从 Realm 获取相应的用户进行比较以确定用户身份是否合法;也需要从 Realm 得到用户相应的角色/ 权限进行验证用户是否能进行操作 ;可以把 Realm 看成 DataSource
(2)SecurityManager:相当于 SpringMVC 中的 DispatcherServlet;是 Shiro 的心脏; 所有具体的交互都通过 SecurityManager 进行控制;它管理着所有 Subject、且负责进行认证、授权、会话及缓存的管理。
(3)Authenticator:负责 Subject 认证,是一个扩展点,可以自定义实现;可以使用认证策略(Authentication Strategy),即什么情况下算用户认证通过了;
(4)Authorizer:授权器、即访问控制器,用来决定主体是否有权限进行相应的操作,即控制着用户能访问应用中的哪些功能;
(5)Realm:可以有 1 个或多个 Realm,可以认为是安全实体数据源,即用于获取安全实体的;可以是 JDBC 实现,也可以是内存实现等等;由用户提供;所以一般在应用中都需要实现自己的 Realm;
(6)SessionManager:管理 Session 生命周期的组件;而 Shiro 并不仅仅可以用在 Web环境,也可以用在如普通的 JavaSE 环境
(7)CacheManager:缓存控制器,来管理如:用户、角色、权限等的缓存的;因为这些数据基本上很少改变,放到缓存中后可以提高访问的性能
(8)Cryptography:密码模块,Shiro 提高了一些常见的加密组件用于如密码加密/解密。
(1)Shiro不依赖容器,直接创建maven工程即可
(2)添加依赖
<dependencies>
<dependency>
<groupId>org.apache.shirogroupId>
<artifactId>shiro-coreartifactId>
<version>1.9.0version>
dependency>
<dependency>
<groupId>commons-logginggroupId>
<artifactId>commons-loggingartifactId>
<version>1.2version>
dependency>
dependencies>
Shiro获取权限相关信息可以通过数据库获取,也可以通过 ini配置文件获取
创建ini文件
(1)身份验证:一般需要提供如身份ID等一些标识信息来表明登录者的身份,如:提供 email,用户名/密码来证明。
(2)在shiro中,用户需要提供principals(身份)和credentials(证明)给shiro,从 而应用能验证用户身份。
(3)principals:身份,即主体的标识属性,可以是任何属性,如:用户名、邮箱等,唯一即可。一个主体可以有多个principals,但只能有一个Primary principals,一般是用户名/邮箱/手机号。
(4)credentials:证明/凭证,即只有主体知道的安全值,如密码/数字证书等。
(5)最常见的principals和credentials组合就是用户名/密码
(1)收集用户身份/凭证,即如用户名/密码
(2)调用 Subject.login 进行登录,如果失败将得到相应的 AuthenticationException 异常,根据异常提示用户错误信息;否则登录成功
(3)创建自定义的 Realm 类,继承 org.apache.shiro.realm.AuthenticatingRealm类,实现 doGetAuthenticationInfo() 方法
创建测试类,获取认证对象,进行登录认证,如下:
import org.apache.shiro.SecurityUtils;
import org.apache.shiro.authc.*;
import org.apache.shiro.config.IniSecurityManagerFactory;
import org.apache.shiro.mgt.SecurityManager;
import org.apache.shiro.subject.Subject;
/**
* @author gh Email:@2495140780qq.com
* @Description
* @date 2022-11-10-下午 2:06
*/
public class ShiroRun {
public static void main(String[] args) {
// 1、初始化获取SecurityManager
IniSecurityManagerFactory factory = new IniSecurityManagerFactory("classpath:shiro.ini");
// 从工厂中拿到认证管理器
SecurityManager securityManager = factory.getInstance();
// 把认证管理器放入 工具中
SecurityUtils.setSecurityManager(securityManager);
// 2、获取Subject对象
Subject subject = SecurityUtils.getSubject();
// 3、创建token对象,web应用用户名密码从页面传递 借助AuthenticationToken (UsernamePasswordToken 匿名实现)接口生成先关的token字符串
AuthenticationToken token = new UsernamePasswordToken("zhangsan", "z3");
// 4、完成登录
try {
// 打印相关信息
subject.login(token);
System.out.println("登录成功");
} catch (UnknownAccountException e) {
e.printStackTrace();
System.out.println("用户不存在");
} catch (IncorrectCredentialsException e) {
e.printStackTrace();
System.out.println("密码错误");
} catch (AuthenticationException e) {
e.printStackTrace();
}
}
}
(1)首先调用 Subject.login(token) 进行登录,其会自动委托给 SecurityManager
(2)SecurityManager 负责真正的身份验证逻辑;它会委托给 Authenticator 进行身份验证;
(3)Authenticator 才是真正的身份验证者,Shiro API 中核心的身份 认证入口点,此处可以自定义插入自己的实现;
(4)Authenticator 可能会委托给相应的 AuthenticationStrategy 进行多 Realm 身份验证,默认 ModularRealmAuthenticator 会调用 AuthenticationStrategy 进行多 Realm 身份验证;
(5)Authenticator 会把相应的 token 传入 Realm,从 Realm 获取 身份验证信息,如果没有返回抛出异常表示身份验证失败了。此处 可以配置多个Realm,将按照相应的顺序及策略进行访问。
(1)授权,也叫访问控制,即在应用中控制谁访问哪些资源(如访问页面/编辑数据/页面操作等)。在授权中需了解的几个关键对象:主体(Subject)、资源(Resource)、权限 (Permission)、角色(Role)。
(2)主体(Subject):访问应用的用户,在 Shiro 中使用 Subject 代表该用户。用户只有授权后才允许访问相应的资源。
(3)资源(Resource):在应用中用户可以访问的 URL,比如访问 JSP 页面、查看/编辑某些数据、访问某个业务方法、打印文本等等都是资源。用户只要授权后才能访问。
(4)权限(Permission):安全策略中的原子授权单位,通过权限我们可以表示在应用中用户有没有操作某个资源的权力。即权限表示在应用中用户能不能访问某个资源,如:访 问用 户列表页面查看/新增/修改/删除用户数据(即很多时候都是CRUD(增查改删)式权限控制)等。权限代表了用户有没有操作某个资源的权利,即反映在某个资源上的操作允 不允 许。
(5)Shiro 支持粗粒度权限(如用户模块的所有权限)和细粒度权限(操作某个用户的权 限,即实例级别的)
(6)角色(Role):权限的集合,一般情况下会赋予用户角色而不是权限,即这样用户可以拥有 一组权限,赋予权限时比较方便。典型的如:项目经理、技术总监、CTO、开发工程师等都是角色,不同的角色拥有一组不同的权限
(1)编程式:通过写if/else 授权代码块完成
(2)注解式:通过在执行的Java方法上放置相应的注解完成,没有权限将抛出相应的异常
(3)JSP/GSP 标签:在JSP/GSP 页面通过相应的标签完成
(1)首先调用Subject.isPermitted*/hasRole*接口,其会委托给SecurityManager,而 SecurityManager接着会委托给 Authorizer;
(2)Authorizer是真正的授权者,如果调用如isPermitted(“user:view”),其首先会通过PermissionResolver把字符串转换成相应的Permission实例;
(3)在进行授权之前,其会调用相应的Realm获取Subject相应的角色/权限用于匹配传入的角色/权限;
(4)Authorizer会判断Realm的角色/权限是否和传入的匹配,如果有多个Realm,会委托给ModularRealmAuthorizer进行循环判断,如果匹配如isPermitted*/hasRole* 会返回 true,否则返回false表示授权失败
(1.1)基于单角色权限控制
(1.3)是否具有其中一个角色
(2.1)判断权限信息信息
(2.2) 基于权限字符串的访问控制 资源标识符:操作:资源类型
(2.4) 同时具有哪些权限
实际系统开发中,一些敏感信息需要进行加密,比如说用户的密码。Shiro内嵌很多常用的加密算法,比如 MD5加密。Shiro可以很简单的使用信息加密。
1、 使用Shiro进行密码加密
import org.apache.shiro.crypto.hash.Md5Hash;
import org.apache.shiro.crypto.hash.SimpleHash;
/**
* @author gh Email:@2495140780qq.com
* @Description
* @date 2022-11-10-下午 2:05
*/
public class ShiroMD5 {
public static void main(String[] args) {
// 密码明文
String password = "z3";
// 使用md5加密
Md5Hash md5Hash = new Md5Hash(password);
System.out.println("md5加密 = " + md5Hash.toHex());
// 带盐的md5加密,盐就是在密码明文后拼接新字符串,然后再进行加密
Md5Hash md5Hash2 = new Md5Hash(password, "salt");
System.out.println("带盐的md5加密 = " + md5Hash2.toHex());
// 为了保证安全,避免被破解还可以多次迭代加密,保证数据安全
Md5Hash md5Hash3 = new Md5Hash(password, "salt", 3);
System.out.println("md5带盐的3次加密 = " + md5Hash3.toHex());
// 使用父类进行加密 加密方式 密码 盐 加密次数
SimpleHash simpleHash = new SimpleHash("MD5", password, "salt", 3);
System.out.println("父类带盐的3次加密 = " + simpleHash.toHex());
}
}
Shiro默认的登录认证是不带加密的,如果想要实现加密认证需要自定义登录认证,自定义Realm。
1 、自定义登录认证
import org.apache.shiro.authc.AuthenticationException;
import org.apache.shiro.authc.AuthenticationToken;
import org.apache.shiro.authc.AuthenticationInfo;
import org.apache.shiro.authc.SimpleAuthenticationInfo;
import org.apache.shiro.realm.AuthenticatingRealm;
import org.apache.shiro.util.ByteSource;
/**
* @author gh Email:@2495140780qq.com
* @Description
* @date 2022-11-10-下午 2:05
*/
public class MyRealm extends AuthenticatingRealm {
/*
自定义登录认证方法,shiro的login方法底层会调用该类的认证方法进行认证,
需要配置自定义的realm生效,
在ini文件中配置,或者
在Springboot中配置,
该方法只是获取进行对比的信息,认证逻辑还是按照shiro底层认证逻辑完成
*/
protected AuthenticationInfo doGetAuthenticationInfo(AuthenticationToken authenticationToken) throws AuthenticationException {
// 1、获取身份信息
String principal = authenticationToken.getPrincipal().toString();
// 2、获取凭证信息
String password = new String((char[]) authenticationToken.getCredentials());
System.out.println("认证用户信息:" + principal + "--- 密码:" + password);
// 3、获取数据库中存储的用户信息
if (principal.equals("zhangsan")) {
// 3.1、数据库中存储的加盐3次迭代的密码
String pwdInfo = "7174f64b13022acd3c56e2781e098a5f";
// 4、创建封装校验逻辑对象,封装数据返回
AuthenticationInfo info = new SimpleAuthenticationInfo(
authenticationToken.getPrincipal(), // 参数一: 身份信息
pwdInfo, // 参数二: 密码信息
ByteSource.Util.bytes("salt"), // 参数三: 盐相关的信息
authenticationToken.getPrincipal().toString() // 参数四: Realm --> 身份信息转化成字符串
// 或者 this.getName()(Realm的名字)
);
return info;
}
return null;
}
}
2 、在shiro.ini中添加配置信息
3、在ShiroRun中进行测试
<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd">
<modelVersion>4.0.0modelVersion>
<groupId>com.ghgroupId>
<artifactId>Shiro-SpringBootartifactId>
<version>1.0.0version>
<name>Shiro-SpringBootname>
<description>Shiro-SpringBootdescription>
<properties>
<java.version>1.8java.version>
<project.build.sourceEncoding>UTF-8project.build.sourceEncoding>
<project.reporting.outputEncoding>UTF-8project.reporting.outputEncoding>
properties>
<parent>
<groupId>org.springframework.bootgroupId>
<artifactId>spring-boot-starter-parentartifactId>
<version>2.2.1.RELEASEversion>
parent>
<dependencies>
<dependency>
<groupId>org.apache.shirogroupId>
<artifactId>shiro-spring-boot-web-starterartifactId>
<version>1.9.0version>
dependency>
<dependency>
<groupId>com.baomidougroupId>
<artifactId>mybatis-plus-boot-starterartifactId>
<version>3.0.5version>
dependency>
<dependency>
<groupId>mysqlgroupId>
<artifactId>mysql-connector-javaartifactId>
<version>5.1.46version>
dependency>
<dependency>
<groupId>org.projectlombokgroupId>
<artifactId>lombokartifactId>
dependency>
<dependency>
<groupId>org.springframework.bootgroupId>
<artifactId>spring-boot-starter-thymeleafartifactId>
dependency>
dependencies>
project>
mybatis-plus:
configuration:
# 日志输出
log-impl: org.apache.ibatis.logging.stdout.StdOutImpl
mapper-locations: classpath:mapper/*.xml
# 应用名称
spring:
application:
name: Shiro-SpringBoot
datasource:
type: com.zaxxer.hikari.HikariDataSource
driver-class-name: com.mysql.jdbc.Driver
url: jdbc:mysql://localhost:3306/shirodb?characterEncoding=utf-8&useSSL=false
username: root
password: 123456
jackson:
# 返回的日期格式:格式化
date-format: yyyy-MM-dd HH:mm:ss
time-zone: GMT+8
shiro:
# 登录的相关的url
loginUrl: /myController/login
@SpringBootApplication
@MapperScan("com.gh.shirospringboot.mapper")
public class ShiroSpringBootApplication {
public static void main(String[] args) {
SpringApplication.run(ShiroSpringBootApplication.class, args);
}
}
(1)创建库表
CREATE DATABASE IF NOT EXISTS `shirodb` CHARACTER SET utf8mb4;
USE `shirodb`;
SET NAMES utf8mb4;
SET FOREIGN_KEY_CHECKS = 0;
-- ----------------------------
-- Table structure for user
-- ----------------------------
DROP TABLE IF EXISTS `user`;
CREATE TABLE `user` (
`id` bigint(20) NOT NULL AUTO_INCREMENT COMMENT '编号',
`name` varchar(30) CHARACTER SET utf8 COLLATE utf8_general_ci NULL DEFAULT NULL COMMENT '用户名',
`pwd` varchar(50) CHARACTER SET utf8 COLLATE utf8_general_ci NULL DEFAULT NULL COMMENT '密码',
`rid` bigint(20) NULL DEFAULT NULL COMMENT '角色编号',
PRIMARY KEY (`id`) USING BTREE
) ENGINE = InnoDB AUTO_INCREMENT = 3 CHARACTER SET = utf8 COLLATE = utf8_general_ci COMMENT = '用户表' ROW_FORMAT = Dynamic;
-- ----------------------------
-- Records of user
-- ----------------------------
INSERT INTO `user` VALUES (1, '张三', '7174f64b13022acd3c56e2781e098a5f', NULL);
INSERT INTO `user` VALUES (2, '李四', '7174f64b13022acd3c56e2781e098a5f', NULL);
SET FOREIGN_KEY_CHECKS = 1;
(2)创建实体
@Data
@NoArgsConstructor // 无参构造
@AllArgsConstructor // 有参构造
public class User {
private Integer id;
private String name;
private String pwd;
private Integer rid;
}
(3)创建Mapper
@Repository
public interface UserMapper extends BaseMapper<User> {
}
(4)创建Service
public interface UserService {
//用户登录
User getUserInfoByName(String name);
}
(4.1)创建ServiceImpl
@Service
public class UserServiceImpl implements UserService {
@Autowired
private UserMapper userMapper;
@Override
public User getUserInfoByName(String name) {
QueryWrapper<User> wrapper = new QueryWrapper<>();
wrapper.eq("name",name);
User user = userMapper.selectOne(wrapper);
return user;
}
}
(5)自定义Realm
@Component
public class MyRealm extends AuthorizingRealm {
@Autowired
private UserService userService;
// 自定义授权方法: 获取当前登录用户的角色、权限信息,返回给shiro用来进行授权认证
@Override
protected AuthorizationInfo doGetAuthorizationInfo(PrincipalCollection principalCollection) {
return null;
}
// 自定义登录认证方法
@Override
protected AuthenticationInfo doGetAuthenticationInfo(AuthenticationToken authenticationToken) throws AuthenticationException {
// 1、获取用户身份信息
String name = authenticationToken.getPrincipal().toString();
// 2、调用业务层获取用户信息(数据库)
User user = userService.getUserInfoByName(name);
// 3、非空判断,将数据封装返回
if (user != null) {
AuthenticationInfo info = new SimpleAuthenticationInfo(
authenticationToken.getPrincipal(),
user.getPwd(),
ByteSource.Util.bytes("salt"),
authenticationToken.getPrincipal().toString()
);
return info;
}
return null;
}
}
(6)编写配置类
@Configuration
public class ShiroConfig {
@Autowired
private MyRealm myRealm;
// 配置SecurityManager
@Bean
public DefaultWebSecurityManager defaultWebSecurityManager() {
// 1、创建defaultWebSecurityManager 对象
DefaultWebSecurityManager defaultWebSecurityManager = new DefaultWebSecurityManager();
// 2、创建加密对象,设置相关属性
HashedCredentialsMatcher matcher = new HashedCredentialsMatcher();
// 2.1、采用md5加密
matcher.setHashAlgorithmName("md5");
// 2.2、迭代加密次数
matcher.setHashIterations(3);
// 3、将加密对象存储到myRealm中
myRealm.setCredentialsMatcher(matcher);
// 4、将myRealm存入defaultWebSecurityManager 对象
defaultWebSecurityManager.setRealm(myRealm);
// 5、返回
return defaultWebSecurityManager;
}
// 配置Shiro内置过滤器拦截范围
@Bean
public DefaultShiroFilterChainDefinition shiroFilterChainDefinition() {
DefaultShiroFilterChainDefinition definition = new DefaultShiroFilterChainDefinition();
// 设置不认证可以访问的资源
definition.addPathDefinition("/myController/userLogin", "anon");
definition.addPathDefinition("/myController/login", "anon");
// 设置需要进行登录认证的拦截范围
definition.addPathDefinition("/**", "authc");
return definition;
}
}
(7)实现Controller
@Controller
@RequestMapping("myController")
public class MyController {
@GetMapping("userLogin")
public String userLogin(String name, String pwd) {
// 1、获取subject对象
Subject subject = SecurityUtils.getSubject();
// 2、封装请求数据到token
AuthenticationToken token = new UsernamePasswordToken(name, pwd);
// 3、调用login方法进行登录认证
try {
subject.login(token);
return "登录成功";
} catch (AuthenticationException e) {
e.printStackTrace();
System.out.println("登录失败");
return "登录失败";
}
}
}
(8)测试
(9)拓展生成随机盐的工具类
Shiro整合Thymeleaf
(1)确认依赖
<dependency>
<groupId>org.springframework.bootgroupId>
<artifactId>spring-boot-starter-thymeleafartifactId>
dependency>
(2)添加 login页面
DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<title>Titletitle>
head>
<body>
<h1>Shiro登录认证h1>
<br>
<form action="/myController/userLogin">
<div>用户名:<input type="text" name="name" value="">div>
<div>密码:<input type="password" name="pwd" value="">div>
<div><input type="submit" value="登录">div>
form>
body>
html>
(3)添加 main页面
DOCTYPE html>
<html lang="en" xmlns:th="http://www.thymeleaf.org"
xmlns:shiro="http://www.w3.org/1999/xhtml">
<head>
<meta charset="UTF-8">
<title>Titletitle>
head>
<body>
<h1>Shiro登录认证后主页面h1>
<br>
登录用户为:<span th:text="${session.user}">span>
<br>
body>
(4)添加 controller方法,改造认证方法
@Controller
@RequestMapping("myController")
public class MyController {
//跳转登录页面
@GetMapping("login")
public String login() {
return "login";
}
@GetMapping("userLogin")
public String userLogin(String name, String pwd, HttpSession session) {
// 1、获取subject对象
Subject subject = SecurityUtils.getSubject();
// 2、封装请求数据到token
AuthenticationToken token = new UsernamePasswordToken(name, pwd);
// 3、调用login方法进行登录认证
try {
subject.login(token);
// return "登录成功";
session.setAttribute("user", token.getPrincipal().toString());
return "main"; // 跳转main页面
} catch (AuthenticationException e) {
e.printStackTrace();
System.out.println("登录失败");
return "登录失败";
}
}
}
(5)修改配置文件
shiro:
# 登录的相关的url
loginUrl: /myController/login
(6)修改配置类
@Configuration
public class ShiroConfig {
// 配置Shiro内置过滤器拦截范围
@Bean
public DefaultShiroFilterChainDefinition shiroFilterChainDefinition() {
DefaultShiroFilterChainDefinition definition = new DefaultShiroFilterChainDefinition();
// 设置不认证可以访问的资源
definition.addPathDefinition("/myController/userLogin", "anon");
definition.addPathDefinition("/myController/login", "anon");
// 设置需要进行登录认证的拦截范围
definition.addPathDefinition("/**", "authc");
return definition;
}
}
(7)启动,访问测试
当应用程序配置多个 Realm 4次时,例如:用户名密码校验、手机号验证码校验等等。 Shiro的 ModularRealmAuthenticator会使用内部的 AuthenticationStrategy组件判断认证是成功还是失败。
AuthenticationStrategy是一个无状态的组件,它在身份验证尝试中被询问 4次(这 4 次交互所需的任何必要的状态将被作为方法参数):
1)在所有 Realm被调用之前
2)在调用 Realm的 getAuthenticationInfo 方法之前
3)在调用 Realm的 getAuthenticationInfo 方法之后
4)在所有 Realm被调用之后
认证策略的另外一项工作就是聚合所有 Realm的结果信息封装至一个AuthenticationInfo实例中,并将此信息返回,以此作为 Subject的身份信息。
Shiro中定义了 3种认证策略的实现:
AuthenticationStrategy class | 描述 |
---|---|
AtLeastOneSuccessfulStrategy | 只要有一个(或更多)的 Realm 验证成功,那么认证将视为成功 |
FirstSuccessfulStrategy | 第一个 Realm 验证成功,整体认证将视为成功,且后续Realm将被忽略 |
AllSuccessfulStrategy | 所有Realm成功 认证才视为成功 |
ModularRealmAuthenticator 内置的认证策略默认实现是 AtLeastOneSuccessfulStrategy方式。可以通过配置修改策略
@Bean
public DefaultWebSecurityManager defaultWebSecurityManager(){
//1 创建 defaultWebSecurityManager 对象
DefaultWebSecurityManager defaultWebSecurityManager = new DefaultWebSecurityManager();
//2 创建认证对象,并设置认证策略
ModularRealmAuthenticator modularRealmAuthenticator = new ModularRealmAuthenticator();
modularRealmAuthenticator.setAuthenticationStrategy(new AllSuccessfulStrategy());
defaultWebSecurityManager.setAuthenticator(modularRealmAuthenticator)
;
//3 封装 myRealm 集合
List<Realm> list = new ArrayList<>();
list.add(myRealm);
list.add(myRealm2);
//4 将 myRealm 存入 defaultWebSecurityManager 对象
defaultWebSecurityManager.setRealms(list);
//5 返回
return defaultWebSecurityManager;
}
1、首先在登录页面选中 RememberMe然后登录成功;如果是浏览器登录,一般会把 RememberMe的 Cookie写到客户端并保存下来;
2、关闭浏览器再重新打开;会发现浏览器还是记住你的;
3、访问一般的网页服务器端,仍然知道你是谁,且能正常访问;
4、但是,如果我们访问电商平台时,如果要查看我的订单或进行支付时,此时还是需要再进行身份认证的,以确保当前用户还是你。
(1)修改配置类
@Configuration
public class ShiroConfig {
@Autowired
private MyRealm myRealm;
// 配置SecurityManager
@Bean
public DefaultWebSecurityManager defaultWebSecurityManager() {
// 1、创建defaultWebSecurityManager 对象
DefaultWebSecurityManager defaultWebSecurityManager = new DefaultWebSecurityManager();
// 2、创建加密对象,设置相关属性
HashedCredentialsMatcher matcher = new HashedCredentialsMatcher();
// 2.1、采用md5加密
matcher.setHashAlgorithmName("md5");
// 2.2、迭代加密次数
matcher.setHashIterations(3);
// 3、将加密对象存储到myRealm中
myRealm.setCredentialsMatcher(matcher);
// 4、将myRealm存入defaultWebSecurityManager 对象
defaultWebSecurityManager.setRealm(myRealm);
// 4.1、设置rememberMe
defaultWebSecurityManager.setRememberMeManager(rememberMeManager());
// 5、返回
return defaultWebSecurityManager;
}
// cookie属性设置
public SimpleCookie rememberMeCookie() {
SimpleCookie cookie = new SimpleCookie("rememberMe");
//设置跨域
//cookie.setDomain(domain);
cookie.setPath("/");
cookie.setHttpOnly(true);
cookie.setMaxAge(30 * 24 * 60 * 60);
return cookie;
}
// 创建Shiro的cookie管理对象
public CookieRememberMeManager rememberMeManager() {
CookieRememberMeManager cookieRememberMeManager = new CookieRememberMeManager();
cookieRememberMeManager.setCookie(rememberMeCookie());
cookieRememberMeManager.setCipherKey("1234567890987654".getBytes());
return cookieRememberMeManager;
}
// 配置Shiro内置过滤器拦截范围
@Bean
public DefaultShiroFilterChainDefinition shiroFilterChainDefinition() {
DefaultShiroFilterChainDefinition definition = new DefaultShiroFilterChainDefinition();
// 设置不认证可以访问的资源
definition.addPathDefinition("/myController/userLogin", "anon");
definition.addPathDefinition("/login", "anon");
// 设置登出过滤器
// definition.addPathDefinition("/logout", "logout");
// 设置需要进行登录认证的拦截范围
definition.addPathDefinition("/**", "authc");
// 添加存在用户的过滤器(rememberMe)
// definition.addPathDefinition("/**", "user");
return definition;
}
}
(1.1)拦截过滤器做相关设置
// 配置Shiro内置过滤器拦截范围
@Bean
public DefaultShiroFilterChainDefinition shiroFilterChainDefinition() {
DefaultShiroFilterChainDefinition definition = new DefaultShiroFilterChainDefinition();
// 设置不认证可以访问的资源
definition.addPathDefinition("/myController/userLogin", "anon");
definition.addPathDefinition("/login", "anon");
// 设置登出过滤器
// definition.addPathDefinition("/logout", "logout");
// 设置需要进行登录认证的拦截范围
definition.addPathDefinition("/**", "authc");
// 添加存在用户的过滤器(rememberMe)
definition.addPathDefinition("/**", "user");
return definition;
}
(2)修改 controller
@GetMapping("userLogin")
public String userLogin(String name, String pwd,
// 默认不开启 rememberMe
@RequestParam(defaultValue = "false") boolean rememberMe,
HttpSession session) {
// 1、获取subject对象
Subject subject = SecurityUtils.getSubject();
// 2、封装请求数据到token
AuthenticationToken token = new UsernamePasswordToken(name, pwd, rememberMe);
// 3、调用login方法进行登录认证
try {
subject.login(token);
//return "登录成功";
session.setAttribute("user", token.getPrincipal().toString());
return "main";
} catch (AuthenticationException e) {
e.printStackTrace();
System.out.println("登录失败");
return "登录失败";
}
}
(3.1)登录验证rememberMe功能 Controller中
//登录认证验证rememberMe
@GetMapping("userLoginRm")
public String userLogin(HttpSession session) {
session.setAttribute("user", "rememberMe");
return "main";
}
(3)改造页面 login.html
(4)测试
用户登录后,配套的有登出操作。直接通过Shiro过滤器即可实现登出
(1)修改登录后的 main.html
(2)修改配置类,添加 logout过滤器
(3)测试
用户登录后,需要验证是否具有指定角色指定权限。Shiro也提供了方便的工具进行判
这个工具就是Realm的doGetAuthorizationInfo方法进行判断。触发权限判断的有两种断。
******
属性判断******
进行判断通过给接口服务方法添加注解可以实现权限校验,可以加在控制器方法上,也可以加 在业务方法上,一般加在控制器方法上。常用注解如下:
(1)@RequiresAuthentication
(2)@RequiresUser
(3)@RequiresGuest
验证是否是一个guest的请求,是否是游客的请求 此时subject.getPrincipal()为null
(4)@RequiresRoles
验证subject是否有相应角色,有角色访问方法,没有则会抛出异常AuthorizationException。
例如:@RequiresRoles(“aRoleName”) void someMethod();
只有subject有aRoleName角色才能访问方法someMethod()
(5)@RequiresPermissions
验证subject是否有相应权限,有权限访问方法,没有则会抛出异常AuthorizationException。
例如:@RequiresPermissions (“file:read”,”wite:aFile.txt”) void someMethod();
subject必须同时含有file:read和wite:aFile.txt权限才能访问方法someMethod()
(1)添加 controller方法,并添加验证角色注解
@Controller
@RequestMapping("myController")
public class MyController {
//登录认证验证角色
@RequiresRoles("admin")
@GetMapping("userLoginRoles")
@ResponseBody
public String userLoginRoles() {
System.out.println("登录认证验证角色");
return "验证角色成功";
}
}
(2)修改 main.html
(3)修改 MyRealm方法
@Component
public class MyRealm extends AuthorizingRealm {
@Autowired
private UserService userService;
// 自定义授权方法:
@Override
protected AuthorizationInfo doGetAuthorizationInfo(PrincipalCollection principalCollection) {
System.out.println("自定义授权方法");
return null;
}
}
(4)运行测试
(1)修改 MyRealm方法
@Component
public class MyRealm extends AuthorizingRealm {
@Autowired
private UserService userService;
@Override
protected AuthorizationInfo
doGetAuthorizationInfo(PrincipalCollection principalCollection) {
System.out.println("进入自定义授权方法");
// 1、创建对象,存储当前登录的用户的权限和角色
SimpleAuthorizationInfo info = new SimpleAuthorizationInfo();
// 2、存储角色
info.addRole("admin");
// 3、返回信息
return info;
}
(2)运行测试
(3)确认库表
-- ----------------------------
-- Table structure for role
-- ----------------------------
DROP TABLE IF EXISTS `role`;
CREATE TABLE `role` (
`id` bigint(20) NOT NULL AUTO_INCREMENT COMMENT '编号',
`name` varchar(30) CHARACTER SET utf8 COLLATE utf8_general_ci NULL DEFAULT NULL COMMENT '角色名',
`desc` varchar(50) CHARACTER SET utf8 COLLATE utf8_general_ci NULL DEFAULT NULL COMMENT '描述',
`realname` varchar(20) CHARACTER SET utf8 COLLATE utf8_general_ci NULL DEFAULT NULL COMMENT '角色显示名',
PRIMARY KEY (`id`) USING BTREE
) ENGINE = InnoDB AUTO_INCREMENT = 3 CHARACTER SET = utf8 COLLATE = utf8_general_ci COMMENT = '角色表' ROW_FORMAT = Dynamic;
-- ----------------------------
-- Records of role
-- ----------------------------
INSERT INTO `role` VALUES (1, 'admin', '所有权限', '管理源');
INSERT INTO `role` VALUES (2, 'userMag', '用户管理员', '用户管理');
-- ----------------------------
-- Table structure for role_user
-- ----------------------------
DROP TABLE IF EXISTS `role_user`;
CREATE TABLE `role_user` (
`id` bigint(20) NOT NULL AUTO_INCREMENT COMMENT '编号',
`uid` bigint(20) NULL DEFAULT NULL COMMENT '用户 id',
`rid` bigint(20) NULL DEFAULT NULL COMMENT '角色 id',
PRIMARY KEY (`id`) USING BTREE
) ENGINE = InnoDB AUTO_INCREMENT = 4 CHARACTER SET = utf8 COLLATE = utf8_general_ci COMMENT = '角色用户映射表' ROW_FORMAT = Dynamic;
-- ----------------------------
-- Records of role_user
-- ----------------------------
INSERT INTO `role_user` VALUES (1, 1, 1);
INSERT INTO `role_user` VALUES (2, 1, 2);
INSERT INTO `role_user` VALUES (3, 2, 2);
(4)查询 sql
# 根据用户名查询角色名
SELECT NAME
FROM
role
WHERE
id IN (
SELECT
rid
FROM
role_user
WHERE
uid =(
SELECT
id
FROM
USER
WHERE
NAME = '张三'
));
(5)mapper方法
@Repository
public interface UserMapper extends BaseMapper<User> {
// 获取用户信息的角色方法
@Select("SELECT NAME FROM role WHERE id IN (SELECT rid FROM role_user WHERE uid=(SELECT id FROM USER WHERE NAME=#{principal}))")
List<String> getUserRoleInfoMapper(@Param("principal") String principal);
}
(6)service实现
public interface UserService {
//根据用户查询角色信息
List<String> getUserRoleInfo(String principal);
}
@Service
public class UserServiceImpl implements UserService {
@Autowired
private UserMapper userMapper;
//根据用户查询角色信息
@Override
public List<String> getUserRoleInfo(String principal) {
return userMapper.getUserRoleInfoMapper(principal);
}
}
(7)MyRealm方法改造
@Component
public class MyRealm extends AuthorizingRealm {
@Autowired
private UserService userService;
// 自定义授权方法: 获取当前登录用户的角色、权限信息,返回给shiro用来进行授权认证
@Override
protected AuthorizationInfo doGetAuthorizationInfo(PrincipalCollection principalCollection) {
// 自定义授权方法: 获取当前登录用户的角色、权限信息,返回给shiro用来进行授权认证
@Override
protected AuthorizationInfo doGetAuthorizationInfo(PrincipalCollection principalCollection) {
System.out.println("自定义授权方法");
// 1、获取用户身份信息
String principal = principalCollection.getPrimaryPrincipal().toString();
// 2、调用业务层获取用户的角色信息(数据库)
List<String> roles = userService.getUserRoleInfo(principal);
System.out.println("当前用户角色信息 = " + roles);
// 3、创建对象,封装当前登录用户的角色、权限信息
SimpleAuthorizationInfo info = new SimpleAuthorizationInfo();
info.addRoles(roles);
// 4、返回信息
return info;
}
}
(8)启动登录测试
获取权限验证和获取角色相类似
(1)确认库表
-- ----------------------------
-- Table structure for permissions
-- ----------------------------
DROP TABLE IF EXISTS `permissions`;
CREATE TABLE `permissions` (
`id` bigint(20) NOT NULL AUTO_INCREMENT COMMENT '编号',
`name` varchar(30) CHARACTER SET utf8 COLLATE utf8_general_ci NULL DEFAULT NULL COMMENT '权限名',
`info` varchar(30) CHARACTER SET utf8 COLLATE utf8_general_ci NULL DEFAULT NULL COMMENT '权限信息',
`desc` varchar(50) CHARACTER SET utf8 COLLATE utf8_general_ci NULL DEFAULT NULL COMMENT '描述',
PRIMARY KEY (`id`) USING BTREE
) ENGINE = InnoDB AUTO_INCREMENT = 4 CHARACTER SET = utf8 COLLATE = utf8_general_ci COMMENT = '权限表' ROW_FORMAT = Dynamic;
-- ----------------------------
-- Records of permissions
-- ----------------------------
INSERT INTO `permissions` VALUES (1, '删除用户', 'user:delete', '删除用户');
INSERT INTO `permissions` VALUES (2, '新增用户 ', 'user:add', '新增用户');
INSERT INTO `permissions` VALUES (3, '修改用户', 'user:edit', '修改用户');
-- ----------------------------
-- Table structure for role_ps
-- ----------------------------
DROP TABLE IF EXISTS `role_ps`;
CREATE TABLE `role_ps` (
`id` bigint(20) NOT NULL AUTO_INCREMENT COMMENT '编号',
`rid` bigint(20) NULL DEFAULT NULL COMMENT '角色 id',
`pid` bigint(20) NULL DEFAULT NULL COMMENT '权限 id',
PRIMARY KEY (`id`) USING BTREE
) ENGINE = InnoDB AUTO_INCREMENT = 4 CHARACTER SET = utf8 COLLATE = utf8_general_ci COMMENT = '角色权限映射表' ROW_FORMAT = Dynamic;
-- ----------------------------
-- Records of role_ps
-- ----------------------------
INSERT INTO `role_ps` VALUES (1, 1, 1);
INSERT INTO `role_ps` VALUES (2, 1, 2);
INSERT INTO `role_ps` VALUES (3, 1, 3);
(2)查询 sql
SELECT
info
FROM
permissions
WHERE
id IN (
SELECT
pid
FROM
role_ps
WHERE
rid IN (
SELECT
id
FROM
role
WHERE
NAME IN ( 'admin', 'userMag' )));
(3)mapper方法
@Repository
public interface UserMapper extends BaseMapper<User> {
// 根据角色名查询对应权限信息
@Select({
""
})
List<String> getUserPermissionInfoMapper(@Param("roles") List<String> roles);
}
(4)service实现
public interface UserService {
//获取用户角色权限信息
List<String> getUserPermissionInfo(List<String> roles);
}
@Service
public class UserServiceImpl implements UserService {
@Autowired
private UserMapper userMapper;
//获取用户角色权限信息
@Override
public List<String> getUserPermissionInfo(List<String> roles) {
return userMapper.getUserPermissionInfoMapper(roles);
}
}
(5)MyRealm方法改造
@Component
public class MyRealm extends AuthorizingRealm {
@Autowired
private UserService userService;
// 自定义授权方法: 获取当前登录用户的角色、权限信息,返回给shiro用来进行授权认证
@Override
protected AuthorizationInfo doGetAuthorizationInfo(PrincipalCollection principalCollection) {
System.out.println("自定义授权方法");
// 1、获取用户身份信息
String principal = principalCollection.getPrimaryPrincipal().toString();
// 2、调用业务层获取用户的角色信息(数据库)
List<String> roles = userService.getUserRoleInfo(principal);
System.out.println("当前用户角色信息 = " + roles);
// 2.1、调用业务层获取用户的权限信息(数据库)
List<String> permissions = userService.getUserPermissionInfo(roles);
System.out.println("当前用户权限信息 = " + permissions);
// 3、创建对象,封装当前登录用户的角色、权限信息
SimpleAuthorizationInfo info = new SimpleAuthorizationInfo();
info.addRoles(roles);
info.addStringPermissions(permissions);
// 4、返回信息
return info;
}
}
(6)添加 controller方法
@Controller
@RequestMapping("myController")
public class MyController {
//登录认证验证权限
@RequiresPermissions("user:delete")
@GetMapping("userPermissions")
@ResponseBody
public String userLoginPermissions() {
System.out.println("登录认证验证权限");
return "验证权限成功";
}
}
(7)改造 main.html
(8)启动登录测试
(1)创建认证异常处理类,使用@ControllerAdvice加@ExceptionHandler实现特殊异常处理。
import org.apache.shiro.authz.AuthorizationException;
import org.apache.shiro.authz.UnauthorizedException;
import org.springframework.web.bind.annotation.ControllerAdvice;
import org.springframework.web.bind.annotation.ExceptionHandler;
import org.springframework.web.bind.annotation.ResponseBody;
@ControllerAdvice
public class PermissionsException {
@ResponseBody
@ExceptionHandler(UnauthorizedException.class)
public String unauthorizedException(Exception e){
return "无权限";
}
@ResponseBody
@ExceptionHandler(AuthorizationException.class)
public String authorizationException(Exception e){
return "权限认证失败";
}
}
(2)启动运行,用李四登录测试。
(1)添加依赖
<dependency>
<groupId>com.github.theborakompanionigroupId>
<artifactId>thymeleaf-extras-shiroartifactId>
<version>2.0.0version>
dependency>
(2)配置类添加新配置
@Configuration
public class ShiroConfig {
// 用于解析 thymeleaf中的 shiro:相关属性
@Bean
public ShiroDialect shiroDialect() {
return new ShiroDialect();
}
}
(3)Thymeleaf中常用的 shiro:属性
(4)改造 main.html
(5)测试
EhCache是一种广泛使用的开源Java分布式缓存。主要面向通用缓存,Java EE和轻量级容器。可以和大部分Java项目无缝整合,例如:Hibernate中的缓存就是基于EhCache实现的。
EhCache支持内存和磁盘存储,默认存储在内存中,如内存不够时把缓存数据同步到磁盘中 。EhCache支持基于Filter的Cache实现,也支持Gzip压缩算法。
EhCache直接在JVM虚拟机中缓存,速度快,效率高;
EhCache缺点是缓存共享麻烦,集群分布式应用使用不方便
**Cache 缓存: **计算机内存中一段数据
**作用: **用来减轻DB的访问压力,从而提高系统的查询效率
**流程: **
(1)创建模块
(2)添加依赖
<dependency>
<groupId>net.sf.ehcachegroupId>
<artifactId>ehcacheartifactId>
<version>2.6.11version>
<type>pomtype>
dependency>
(3)添加配置文件 ehcache.xml
<ehcache>
<diskStore path="java.io.tmpdir/ehcache"/>
<defaultCache
maxEntriesLocalHeap="10000"
eternal="false"
timeToIdleSeconds="120"
timeToLiveSeconds="120"
maxEntriesLocalDisk="10000000"
diskExpiryThreadIntervalSeconds="120"
memoryStoreEvictionPolicy="LRU">
<persistence strategy="localTempSwap"/>
defaultCache>
<cache name="HelloWorldCache"
maxElementsInMemory="1000"
eternal="false"
timeToIdleSeconds="5"
timeToLiveSeconds="5"
overflowToDisk="false"
memoryStoreEvictionPolicy="LRU"/>
ehcache>
(4)创建测试类,操作缓存
public class TestEH {
public static void main(String[] args) {
// 1、获取编译目录下的资源的流对象
InputStream input =
TestEH.class.getClassLoader().getResourceAsStream("ehcache.xml");
// 2、获取EhCache的缓存管理对象
CacheManager cacheManager = new CacheManager(input);
// 3、获取缓存对象
Cache cache = cacheManager.getCache("HelloWorldCache");
// 4、创建缓存数据
Element element = new Element("name","zhang3");
// 5、存入缓存
cache.put(element);
// 6、从缓存中取出数据输出
Element element1 = cache.get("name");
System.out.println("缓存中数据 = " + element1.getObjectValue());
}
}
Shiro官方提供了shiro-ehcache,实现了整合EhCache作为Shiro的缓存工具。可以缓存认证执行的Realm方法,减少对数据库的访问,提高认证效率
(1)添加依赖
<dependency>
<groupId>org.apache.shirogroupId>
<artifactId>shiro-ehcacheartifactId>
<version>1.8.0version>
dependency>
<dependency>
<groupId>commons-iogroupId>
<artifactId>commons-ioartifactId>
<version>2.6version>
dependency>
(2)在resources下添加配置文件 ehcache/ehcache-shiro.xml
(3)修改配置类 ShiroConfig
import at.pollux.thymeleaf.shiro.dialect.ShiroDialect;
import com.gh.shirospringboot.realm.MyRealm;
import net.sf.ehcache.CacheManager;
import org.apache.shiro.authc.credential.HashedCredentialsMatcher;
import org.apache.shiro.cache.ehcache.EhCacheManager;
import org.apache.shiro.io.ResourceUtils;
import org.apache.shiro.spring.web.config.DefaultShiroFilterChainDefinition;
import org.apache.shiro.web.mgt.CookieRememberMeManager;
import org.apache.shiro.web.mgt.DefaultWebSecurityManager;
import org.apache.shiro.web.servlet.SimpleCookie;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import java.io.IOException;
import java.io.InputStream;
@Configuration
public class ShiroConfig {
// 配置SecurityManager
@Bean
public DefaultWebSecurityManager defaultWebSecurityManager() {
// 1、创建defaultWebSecurityManager 对象
DefaultWebSecurityManager defaultWebSecurityManager = new DefaultWebSecurityManager();
// 2、创建加密对象,设置相关属性
HashedCredentialsMatcher matcher = new HashedCredentialsMatcher();
// 2.1、采用md5加密
matcher.setHashAlgorithmName("md5");
// 2.2、迭代加密次数
matcher.setHashIterations(3);
// 3、将加密对象存储到myRealm中
myRealm.setCredentialsMatcher(matcher);
// 4、将myRealm存入defaultWebSecurityManager 对象
defaultWebSecurityManager.setRealm(myRealm);
// 4.1、设置rememberMe
defaultWebSecurityManager.setRememberMeManager(rememberMeManager());
// 4.2、设置缓存管理器
defaultWebSecurityManager.setCacheManager(getEhCacheManager());
// 5、返回
return defaultWebSecurityManager;
}
// 缓存管理器
public EhCacheManager getEhCacheManager() {
// 1、创建缓存管理器
EhCacheManager ehCacheManager = new EhCacheManager();
InputStream is = null;
try {
// 2、获取输入流信息 根据输入流创建 CacheManager
is = ResourceUtils.getInputStreamForPath("classpath:ehcache/ehcache-shiro.xml");
} catch (IOException e) {
e.printStackTrace();
}
// 3、创建CacheManager net.sf.ehcache 包下
CacheManager cacheManager = new CacheManager(is);
// 4、存放到 缓存管理器中
ehCacheManager.setCacheManager(cacheManager);
return ehCacheManager;
}
}
(4)启动测试自动
会话管理器,负责创建和管理用户的会话(Session)生命周期,它能够在任何环境中在本地管理用户会话,即使没有Web/Servlet/EJB容器,也一样可以保存会话。默认情况 下,Shiro会检测当前环境中现有的会话机制(比如Servlet容器)进行适配,如果没有(比如独立应用程序或者非Web环境),它将会使用内置的企业会话管理器来提供相应的会话管理服务,其中还涉及一个名为SessionDAO的对象。SessionDAO负责Session的持久化操作(CRUD),允许Session数据写入到后端持久化数据库。
SessionManager由SecurityManager管理。Shiro提供了三种实现
(1)DefaultSessionManager:用于JavaSE环境
(2)ServletContainerSessionManager:用于web环境,直接使用Servlet容器的会话
(3)DefaultWebSessionManager:用于web环境,自己维护会话(不使用Servlet容器的会话管理)
(1)实现
Session session = SecurityUtils.getSubject().getSession();
session.setAttribute(“key”,”value”)
(2)说明
Controller中的 request,在 shiro过滤器中的 doFilerInternal方法,被包装成 ShiroHttpServletRequest。
SecurityManager和 SessionManager会话管理器决定 session来源于 ServletRequest 还是由 Shiro管理的会话。
无论是通过 request.getSession或 subject.getSession获取到 session,操作session,两者都是等价的。