Shiro 学习 05 - 集成 Spring

博主： zhaojun
发布时间：2022 年 05 月 02 日
1852 次浏览
暂无评论
7551字数
分类：默认分类

## 前言

本章我们来学习 Shiro 集成 Spring，即在 Web 环境下如何使用 Shiro 来进行权限控制。

本章所需知识：

* Shiro 认证 && 授权
* Spring、SpringMVC

## 基础环境搭建

### 引入依赖

```xml

<dependency>
    <groupId>org.springframework</groupId>
    <artifactId>spring-webmvc</artifactId>
    <version>5.0.7.RELEASE</version>
</dependency>

<dependency>
    <groupId>org.apache.shiro</groupId>
    <artifactId>shiro-all</artifactId>
    <version>1.4.0</version>
</dependency>

<dependency>
    <groupId>log4j</groupId>
    <artifactId>log4j</artifactId>
    <version>1.2.17</version>
</dependency>

<dependency>
    <groupId>org.slf4j</groupId>
    <artifactId>slf4j-log4j12</artifactId>
    <version>1.7.25</version>
</dependency>
```

### web.xml

```xml
<context-param>
    <param-name>contextConfigLocation</param-name>
    <param-value>
        classpath:spring.xml,
        classpath:spring-shiro.xml
    </param-value>
</context-param>

<listener>
    <listener-class>org.springframework.web.context.ContextLoaderListener</listener-class>
</listener>

<servlet>
    <servlet-name>springmvc</servlet-name>
    <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
    <init-param>
        <param-name>contextConfigLocation</param-name>
        <param-value>classpath:spring-web.xml</param-value>
    </init-param>
</servlet>
<servlet-mapping>
    <servlet-name>springmvc</servlet-name>
    <url-pattern>/</url-pattern>
</servlet-mapping>
```

比较常见的 Spring 配置，这里就不过多介绍了。我们需要 3 个配置文件，分别为 `spring.xml`, `spring-web.xml`, `spring-shiro.xml`。

我们暂时只需要配置 `spring-web.xml`, `spring-shiro.xml` 即可 (`spring.xml` 文件也需要创建，但不需要配置东西)。

### spring-web.xml

```xml
<context:component-scan base-package="im.zhaojun.controller"/>

<mvc:annotation-driven>
    <mvc:message-converters>
        <bean class="org.springframework.http.converter.StringHttpMessageConverter">
            <constructor-arg value="UTF-8" />
        </bean>
    </mvc:message-converters>
</mvc:annotation-driven>

<mvc:default-servlet-handler/>
```

### spring-shiro.xml

之前我们都是手工 `new` 一个 `DefaultSecurityManager` ，但既然用到了 Spring，就将交由 Spring 容器来管理 :

```xml

<bean id="shiroFilter" class="org.apache.shiro.spring.web.ShiroFilterFactoryBean">
    <property name="securityManager" ref="securityManager"/>
    
    <property name="loginUrl" value="/login.jsp"/>
    
    <property name="successUrl" value="/index.jsp"/>
    
    <property name="unauthorizedUrl" value="/unauthorized.jsp"/>
    <property name="filterChainDefinitions">
        <value>
            /login.jsp = anon
            /login = anon
            /user.jsp = roles[user]
            /admin.jsp = roles[admin]
            /userList.jsp = perms[select]
            /** = authc
        </value>
    </property>
</bean>

<bean id="myRealm" class="im.zhaojun.realm.MyRealm"/>
```

securityManager 和自定义 Realm 的配置很容易理解，但 shiroFilter 是个啥东西呢？

其实他是 Shiro 的权限过滤器，用来在 web 环境下对权限进行过滤，既然是一个 Filter，显然我们还需要在 web.xml 中增加 Shiro 的 Filter 配置:

```xml
<filter>
    <filter-name>shiroFilter</filter-name>
    <filter-class>org.springframework.web.filter.DelegatingFilterProxy</filter-class>
    <init-param>
        <param-name>targetFilterLifecycle</param-name>
        <param-value>true</param-value>
    </init-param>
</filter>

<filter-mapping>
    <filter-name>shiroFilter</filter-name>
    <url-pattern>/*</url-pattern>
</filter-mapping>
```

> 注意：这里的 `filter-name` 一定要与 `spring-shiro.xml` 中我们配置的对应的 bean 的名称相同。在此示例中均为 ：**`shiroFilter`**。

这里还有一个 `filterChainDefinitions` 表示的是过滤器链，即从上到下以此判断，直到获取到当前请求资源的权限。

此处我们将 `/login.jsp` 和 `/login` 配置成 *anon*，表示的是可以**匿名访问**。

`user.jsp` 配置为 *roles[user]*， 表示的是需要 **user 角色**可以访问。
`admin.jsp` 配置为 *roles[admin]*， 表示的是需要 **admin 角色**可以访问。

`userList.jsp` 配置为 *perms[select]*，表示的是需要 **select 权限**才可访问。

`/**` 配置为 *authc* 表示的是所有页面都需要**认证**(登录)后才可访问。

当然还有更多的权限通配符，以及自定义权限通配符，我们会在后面的章节讲到

## 前端页面

### index.jsp

```html
<html>
<body>
<h2>Index Page</h2>
</body>
</html>
```

### login.jsp

```html
<html>
<body>
<form action="login" method="post">
    username : <input type="text" name="username">
    <br>
    password : <input type="password" name="password">
    <br>
    <input type="submit" value="Login">
</form>
</body>
</html>
```

### user.jsp

```html
<%@ page contentType="text/html;charset=UTF-8" language="java" %>
<html>
<head>
    <title>User Page</title>
</head>
<body>
    <h1>User Page</h1>
</body>
</html>
```

### admin.jsp

```html
<%@ page contentType="text/html;charset=UTF-8" language="java" %>
<html>
<head>
    <title>Admin Page</title>
</head>
<body>
    <h1>Admin Page</h1>
</body>
</html>
```

### userList.jsp

```html
<%@ page contentType="text/html;charset=UTF-8" language="java" %>
<html>
<head>
    <title>UserList Page</title>
</head>
<body>
    <h1>UserList Page</h1>
</body>
</html>
```

## 后端代码

### MyRealm

```java
package im.zhaojun.realm;

import im.zhaojun.pojo.User;
import org.apache.shiro.authc.*;
import org.apache.shiro.authz.AuthorizationInfo;
import org.apache.shiro.authz.SimpleAuthorizationInfo;
import org.apache.shiro.realm.AuthorizingRealm;
import org.apache.shiro.subject.PrincipalCollection;

import java.util.HashSet;
import java.util.Set;

/**
 * 自定义 Relam
 */
public class MyRealm extends AuthorizingRealm {
    @Override
    protected AuthorizationInfo doGetAuthorizationInfo(PrincipalCollection principalCollection) {
        
        System.out.println("MyRealm doGetAuthorizationInfo...");
        
        SimpleAuthorizationInfo authorizationInfo = new SimpleAuthorizationInfo();

// 拥有 admin 角色
        Set<String> roles = new HashSet<>();
        roles.add("admin");
        authorizationInfo.setRoles(roles);

// 拥有权限
        Set<String> permissions = new HashSet<>();
        permissions.add("select");
        authorizationInfo.setStringPermissions(permissions);
        return authorizationInfo;
    }

@Override
    protected AuthenticationInfo doGetAuthenticationInfo(AuthenticationToken authenticationToken)
            throws AuthenticationException {

System.out.println("MyRealm doGetAuthenticationInfo...");

String username = (String) authenticationToken.getPrincipal();
        User user = selectUserByUserName(username);
        if (user == null) {
            throw new UnknownAccountException("当前账户不存在");
        }
        return new SimpleAuthenticationInfo(user.getUsername(), user.getPassword(), super.getName());
    }

/**
     * 模拟查询数据库, 假设数据库只有 zhao - 123456 这条数据
     * @param username 用户名
     * @return 查询到的用户
     */
    private User selectUserByUserName(String username) {
        if ("zhao".equals(username)) {
            return new User(username, "123456");
        }
        return null;
    }
}
```

当前只有一个用户，账户为 `zhao`， 密码为 `123456`。且拥有 `admin` 角色和 `select` 权限。

### Controller

```java
package im.zhaojun.controller;

import im.zhaojun.pojo.User;
import org.apache.shiro.SecurityUtils;
import org.apache.shiro.authc.AuthenticationException;
import org.apache.shiro.authc.UsernamePasswordToken;
import org.apache.shiro.subject.Subject;
import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.ResponseBody;

/**
 * 登录 Controller
 */
@Controller
public class LoginController {

@RequestMapping("login")
    @ResponseBody
    public String login(User user) {
        Subject subject = SecurityUtils.getSubject();
        UsernamePasswordToken token = new UsernamePasswordToken(user.getUsername(), user.getPassword());
        try {
            subject.login(token);
        } catch (AuthenticationException e) {
            return e.getMessage();
        }
        return "login success";
    }
}
```

登录成功，返回 `login success`，登录失败则返回对应的异常信息。

## 测试

### 过滤器基本测试

启动 web 服务，默认情况下会访问 `index.jsp`，但我们启动启动项目后自动跳转到了 `login.jsp`，且手动访问 `index.jsp` 页面也会自动跳转到 `login.jsp`。

原因是因为我们在 `filterChainDefinitions` 过滤器链中仅为 `login.jsp` 与 `login` 配置了可匿名访问，而 `index.jsp` 这上述配置中的是需要认证后才可访问。

> 由此可见 `filterChainDefinitions`，过滤器链是正常的。

### 认证/登录测试

#### 认证失败

先来试试用户名错误 (使用  `admin`, `123456` 来进行登录)，返回结果为 `当前账户不存在 `，因为我们在 Realm 中抛出了  `UnknownAccountException` 异常，并设置了相应的 message，所以在 controller 中捕获到了异常并返回给了页面。

再来试试密码错误 (使用 `zhao`, `123456` 来进行登录)，返回结果为 `Submitted credentials for token [org.apache.shiro.authc.UsernamePasswordToken - zhao, rememberMe=false] did not match the expected credentials.`。

#### 认证成功

使用正常的账号密码进行登录，返回结果为 `login success`。

> 由此可见认证成功和失败的功能是正常的。

### 授权测试

#### 角色

我们在过滤器链中关于角色的配置有：`/user.jsp = roles[user]` 和 `/admin.jsp = roles[admin]`。下面测试，假设以账号是 `zhao` 为例 (具备 `user` 角色)：

* 未登录情况下：访问 `user.jsp` 会跳转到登录页面。
* 已登录 `zhao` 且具备相应的角色：可以正常访问 `user.jsp`。
* 已登录 `zhao` 且未具备相应的角色：访问 `admin.jsp`会跳转到 `unauthorized.jsp`。

#### 权限

我们在过滤器链中关于权限的配置有：`/userList.jsp = perms[select]`。下面测试，假设以账号是 `zhao` 为例 (具备 `select` 权限)：

- 未登录情况下：访问 `userList.jsp` 会跳转到登录页面。
- 已登录 `zhao` 且具备相应的权限：可以正常访问 `userList.jsp`。
- 已登录 `zhao` 且未具备相应的权限：和不具备角色一样会跳转到 `unauthorized.jsp`。

### 缓存测试

可能细心的朋友会注意到我在 `MyRealm` 中的 `doGetAuthorizationInfo()` 和 `doGetAuthenticationInfo()` 分别加了一条输出语句，会有以下效果：

认证时会触发 `doGetAuthenticationInfo` 中的输出语句，证明每次登陆都会调用该方法。

授权时同样会触发 `doGetAuthorizationInfo` 中的输出语句，且每次授权也需要调用此方法一次。

> 那么我们来考虑一下缓存问题：
> 
> 认证就不用说了，涉及到的查询就一条，根据用户名返回用户信息即可，没必要进行缓存。
> 
> 但授权却比较麻烦，因为授权时我们一般都会去调用数据库来查询其用户所拥有的角色和权限，往往这都会涉及到多表查询。所以我们是否可以将授权数据缓存起来呢？应该如何进行缓存？缓存后角色或权限数据修改了怎么办？这里留下一个悬念，后面的章节中我们会讲到 Shiro 的缓存模块来完善缓存功能。

本章代码地址：https://github.com/zhaojun1998/Premission-Study/tree/master/Permission-Shiro-05

最后修改：2022 年 05 月 02 日

如果觉得我的文章对你有用，请我喝杯咖啡吧。

发表评论取消回复
使用cookie技术保留您的个人信息以便您下次快速评论，继续评论表示您已同意该条款

评论 *

私密评论

名称 *

🎲

邮箱 *

地址

快帆云
你好，我们的机场：快帆云，已经稳定运营三年多，现在诚邀推广员。...
在nginx层面给任意项目站点增加访问限制：casdoor+oauth2-proxy - Blog By chenchen.site
[...]如果是宝塔用户可以直接使用以下方法安装模块，参考文章...
大概
你好，我就想整一个网盘，用作知识付费，就是普通用户只可以看到标...
zhao
测试
知名1842
表评论1842

Shiro 学习 05 - 集成 Spring

zhaojun • 2022 年 05 月 02 日

## 前言

本章我们来学习 Shiro 集成 Spring，即在 Web 环境下如何使用 Shiro 来进行权限控制。

本章所需知识：

* Shiro 认证 && 授权
* Spring、SpringMVC

## 基础环境搭建

### 引入依赖

<dependency>
    <groupId>log4j</groupId>
    <artifactId>log4j</artifactId>
    <version>1.2.17</version>
</dependency>

<dependency>
    <groupId>org.slf4j</groupId>
    <artifactId>slf4j-log4j12</artifactId>
    <version>1.7.25</version>
</dependency>
```

### web.xml

```xml
<context-param>
    <param-name>contextConfigLocation</param-name>
    <param-value>
        classpath:spring.xml,
        classpath:spring-shiro.xml
    </param-value>
</context-param>

<listener>
    <listener-class>org.springframework.web.context.ContextLoaderListener</listener-class>
</listener>

比较常见的 Spring 配置，这里就不过多介绍了。我们需要 3 个配置文件，分别为 `spring.xml`, `spring-web.xml`, `spring-shiro.xml`。

我们暂时只需要配置 `spring-web.xml`, `spring-shiro.xml` 即可 (`spring.xml` 文件也需要创建，但不需要配置东西)。

### spring-web.xml

```xml
<context:component-scan base-package="im.zhaojun.controller"/>

<mvc:default-servlet-handler/>
```

### spring-shiro.xml

之前我们都是手工 `new` 一个 `DefaultSecurityManager` ，但既然用到了 Spring，就将交由 Spring 容器来管理 :

<bean id="myRealm" class="im.zhaojun.realm.MyRealm"/>
```

securityManager 和自定义 Realm 的配置很容易理解，但 shiroFilter 是个啥东西呢？

其实他是 Shiro 的权限过滤器，用来在 web 环境下对权限进行过滤，既然是一个 Filter，显然我们还需要在 web.xml 中增加 Shiro 的 Filter 配置:

<filter-mapping>
    <filter-name>shiroFilter</filter-name>
    <url-pattern>/*</url-pattern>
</filter-mapping>
```

> 注意：这里的 `filter-name` 一定要与 `spring-shiro.xml` 中我们配置的对应的 bean 的名称相同。在此示例中均为 ：**`shiroFilter`**。

这里还有一个 `filterChainDefinitions` 表示的是过滤器链，即从上到下以此判断，直到获取到当前请求资源的权限。

此处我们将 `/login.jsp` 和 `/login` 配置成 *anon*，表示的是可以**匿名访问**。

`user.jsp` 配置为 *roles[user]*， 表示的是需要 **user 角色**可以访问。
`admin.jsp` 配置为 *roles[admin]*， 表示的是需要 **admin 角色**可以访问。

`userList.jsp` 配置为 *perms[select]*，表示的是需要 **select 权限**才可访问。

`/**` 配置为 *authc* 表示的是所有页面都需要**认证**(登录)后才可访问。

当然还有更多的权限通配符，以及自定义权限通配符，我们会在后面的章节讲到

## 前端页面

### index.jsp

```html
<html>
<body>
<h2>Index Page</h2>
</body>
</html>
```

### login.jsp

### user.jsp

```html
<%@ page contentType="text/html;charset=UTF-8" language="java" %>
<html>
<head>
    <title>User Page</title>
</head>
<body>
    <h1>User Page</h1>
</body>
</html>
```

### admin.jsp

```html
<%@ page contentType="text/html;charset=UTF-8" language="java" %>
<html>
<head>
    <title>Admin Page</title>
</head>
<body>
    <h1>Admin Page</h1>
</body>
</html>
```

### userList.jsp

```html
<%@ page contentType="text/html;charset=UTF-8" language="java" %>
<html>
<head>
    <title>UserList Page</title>
</head>
<body>
    <h1>UserList Page</h1>
</body>
</html>
```

## 后端代码

### MyRealm

```java
package im.zhaojun.realm;

import java.util.HashSet;
import java.util.Set;

// 拥有 admin 角色
        Set<String> roles = new HashSet<>();
        roles.add("admin");
        authorizationInfo.setRoles(roles);

@Override
    protected AuthenticationInfo doGetAuthenticationInfo(AuthenticationToken authenticationToken)
            throws AuthenticationException {

System.out.println("MyRealm doGetAuthenticationInfo...");

当前只有一个用户，账户为 `zhao`， 密码为 `123456`。且拥有 `admin` 角色和 `select` 权限。

### Controller

```java
package im.zhaojun.controller;

/**
 * 登录 Controller
 */
@Controller
public class LoginController {

登录成功，返回 `login success`，登录失败则返回对应的异常信息。

## 测试

### 过滤器基本测试

启动 web 服务，默认情况下会访问 `index.jsp`，但我们启动启动项目后自动跳转到了 `login.jsp`，且手动访问 `index.jsp` 页面也会自动跳转到 `login.jsp`。

原因是因为我们在 `filterChainDefinitions` 过滤器链中仅为 `login.jsp` 与 `login` 配置了可匿名访问，而 `index.jsp` 这上述配置中的是需要认证后才可访问。

> 由此可见 `filterChainDefinitions`，过滤器链是正常的。

### 认证/登录测试

#### 认证失败

#### 认证成功

使用正常的账号密码进行登录，返回结果为 `login success`。

> 由此可见认证成功和失败的功能是正常的。

### 授权测试

#### 角色

我们在过滤器链中关于角色的配置有：`/user.jsp = roles[user]` 和 `/admin.jsp = roles[admin]`。下面测试，假设以账号是 `zhao` 为例 (具备 `user` 角色)：

#### 权限

我们在过滤器链中关于权限的配置有：`/userList.jsp = perms[select]`。下面测试，假设以账号是 `zhao` 为例 (具备 `select` 权限)：

### 缓存测试

可能细心的朋友会注意到我在 `MyRealm` 中的 `doGetAuthorizationInfo()` 和 `doGetAuthenticationInfo()` 分别加了一条输出语句，会有以下效果：

认证时会触发 `doGetAuthenticationInfo` 中的输出语句，证明每次登陆都会调用该方法。

授权时同样会触发 `doGetAuthorizationInfo` 中的输出语句，且每次授权也需要调用此方法一次。

本章代码地址：https://github.com/zhaojun1998/Premission-Study/tree/master/Permission-Shiro-05

Shiro 学习 05 - 集成 Spring

发表评论取消回复
使用cookie技术保留您的个人信息以便您下次快速评论，继续评论表示您已同意该条款

谈裸辞和开源的体会

剑指 Offer 04. 二维数组中的查找

宝塔 nginx 增加编译模块

通过 Github Actions 自动构建 ZFile 镜像并推送到 Docker Hub

优化 Java 项目 Docker 镜像内存占用从 500 M 到 100M

MySQL 学习 04 - 索引

Shiro 学习 10 - 集成 Spring 之注解

Git 常用命令

leetcode 345 反转字符串中的元音字母

巧用 MyBatis 构建树形结构

Shiro 学习 05 - 集成 Spring

发表评论 取消回复 使用cookie技术保留您的个人信息以便您下次快速评论，继续评论表示您已同意该条款

Shiro 学习 05 - 集成 Spring

发表评论取消回复
使用cookie技术保留您的个人信息以便您下次快速评论，继续评论表示您已同意该条款