一、前言
我們?cè)趯W(xué)習(xí)springboot的時(shí)候說(shuō)過(guò),要完成某項(xiàng)功能,引入一些依賴,我們第一反應(yīng)就是這個(gè)功能看看有沒(méi)有對(duì)應(yīng)的starter的依賴,因?yàn)橐肓藢?duì)應(yīng)的starter之后可以幫我們完成自動(dòng)裝配的功能.
其實(shí)Shiro是有提供starter的依賴的,但是在官網(wǎng)的文檔中好像沒(méi)找到對(duì)應(yīng)的文檔說(shuō)明(有找到的同學(xué)可以告知我一下),最后是在github中找到shiro對(duì)springboot的的支持.
github地址:
https://github.com/apache/shiro/tree/master/support/spring-boot/spring-boot-web-starter
有了這個(gè)starter我們整合起來(lái)就非常方便了.
二、回顧Spring整合Shiro的步驟
我們先回顧一下之前我們?cè)跊](méi)有使用springboot的環(huán)境下如何配置shiro
- (1) 需要在pom.xml添加shiro相關(guān)的依賴包.
<!--Shiro核心依賴-->
<dependency>
<groupId>org.apache.shiro</groupId>
<artifactId>shiro-core</artifactId>
<version>1.2.2</version>
</dependency>
<!--Shiro中Web相關(guān)的支持-->
<dependency>
<groupId>org.apache.shiro</groupId>
<artifactId>shiro-web</artifactId>
<version>1.2.2</version>
</dependency>
<!--Shiro與Spring整合-->
<dependency>
<groupId>org.apache.shiro</groupId>
<artifactId>shiro-spring</artifactId>
<version>1.2.2</version>
</dependency>
- (2) 在web.xml中配置ShiroFilter過(guò)濾器,攔截用戶的請(qǐng)求.
<!-- shiro過(guò)慮器坯沪,DelegatingFilterProx會(huì)從spring容器中找shiroFilter -->
<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>
- (3) 創(chuàng)建applicationContext-shiro.xml關(guān)于Shiro和Spring整合的配置文件,需要配置如下信息:
- 自定義Realm
- 安全管理器SecurityManager
- 處理請(qǐng)求的ShiroFilterFactoryBean
配置如下:
<!-- 自定義Realm -->
<bean id="userRealm" class="cn.lanxw.wms.realm.UserRealm"/>
<!-- 配置安全管理器SecurityManager -->
<bean id="securityManager" class="org.apache.shiro.web.mgt.DefaultWebSecurityManager">
<property name="realm" ref="userRealm"/>
</bean>
<!-- 定義ShiroFilter -->
<bean id="shiroFilter" class="org.apache.shiro.spring.web.ShiroFilterFactoryBean">
<property name="securityManager" ref="securityManager"/>
<property name="loginUrl" value="/login"/>
<property name="successUrl" value="/main"/>
<property name="unauthorizedUrl" value="/WEB-INF/views/common/nopermission.ftl"/>
<property name="filterChainDefinitions">
<value>
/js/**=anon
/images/**=anon
/style/**=anon
/logout=logout
/**=authc
</value>
</property>
</bean>
- (4) 如果還需要使用Shiro注解完成權(quán)限控制,還需要在配置文件中添加如下配置:
<!-- 開啟aop吭练,使用CGlib基于繼承的動(dòng)態(tài)代理 -->
<aop:config proxy-target-class="true"></aop:config>
<!-- 開啟shiro注解支持 -->
<bean class="org.apache.shiro.spring.security.interceptor.AuthorizationAttributeSourceAdvisor">
<property name="securityManager" ref="securityManager" />
</bean>
并在控制器方法上使用 @RequiresPermissions
注解,表示該方法是需要權(quán)限控制的.
@RequestMapping("/employee")
@RequiresPermissions("employee:page")
public String employeePage(){
return "employee/list";
}
使用了Shiro注解控制權(quán)限之后,當(dāng)?shù)顷懹脩魶](méi)有權(quán)限的時(shí)候,默認(rèn)會(huì)拋出AuthorizationException
異常.我們會(huì)寫一個(gè)控制器增強(qiáng)類,來(lái)對(duì)控制器中拋出的異常進(jìn)行統(tǒng)一的管理.
//對(duì)所有的Controller做增強(qiáng)
@ControllerAdvice
public class ErrorAdvice {
//需要捕獲的異常
@ExceptionHandler(AuthorizationException.class)
public String handlerException(){
//處理沒(méi)有權(quán)限的時(shí)候的邏輯 (TODO)
return "nopermission";//跳轉(zhuǎn)到?jīng)]有權(quán)限的頁(yè)面.
}
}
三襟雷、SpringBoot整合Shiro
我們需要導(dǎo)入springboot中關(guān)于shiro的starter的依賴,里面已經(jīng)配置好shiro相關(guān)的bean信息.具體幫我們創(chuàng)建了什么bean,可以看shiro-spring-boot-web-start-1.4.0.jar/META-INF/spring.factories
中所配置的配置類.
我們只需要配置少了的信息就可以完成springboot和shiro的集成.
步驟:
1.在pom.xml文件中添加springboot對(duì)shiro支持的依賴.
<dependency>
<groupId>org.apache.shiro</groupId>
<artifactId>shiro-spring-boot-web-starter</artifactId>
<version>1.4.0</version>
</dependency>
2.在application.properties中添加如下配置.
server.port=8088
#shiro登錄頁(yè)面的地址
shiro.loginUrl=/login
#登錄成功后主頁(yè)面的地址
shiro.successUrl=/main
#配置權(quán)限時(shí)候的登陸地址
shiro.unauthorizedUrl=/nopermission
3.在啟動(dòng)類中配置安全管理器DefaultWebSecurityManager對(duì)象和請(qǐng)求攔截規(guī)則ShiroFilterChainDefinition對(duì)象.配置如下:
package cn.lanxw.shiro;
import cn.lanxw.shiro.realm.UserRealm;
import org.apache.shiro.spring.web.config.DefaultShiroFilterChainDefinition;
import org.apache.shiro.spring.web.config.ShiroFilterChainDefinition;
import org.apache.shiro.web.mgt.DefaultWebSecurityManager;
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.context.annotation.Bean;
import sun.security.krb5.Realm;
import java.util.List;
@SpringBootApplication
public class BootApplication {
/*
創(chuàng)建安全管理器對(duì)象,關(guān)聯(lián)自定義Realm
*/
@Bean
public DefaultWebSecurityManager securityManager(UserRealm userRealm){
DefaultWebSecurityManager securityManager = new DefaultWebSecurityManager();
securityManager.setRealm(userRealm);
return securityManager;
}
/**
* 定義攔截的規(guī)則
* @return
*/
@Bean
public ShiroFilterChainDefinition shiroFilterChainDefinition(){
DefaultShiroFilterChainDefinition chainDefinition = new DefaultShiroFilterChainDefinition();
//瀏覽器標(biāo)簽頁(yè)的圖標(biāo)放行.
chainDefinition.addPathDefinition("/**/favicon.ico","anon");
//靜態(tài)資源放行
chainDefinition.addPathDefinition("/js/**","anon");
chainDefinition.addPathDefinition("/html/**","anon");
chainDefinition.addPathDefinition("/css/**","anon");
//剩下的資源都需要登錄才能訪問(wèn)
chainDefinition.addPathDefinition("/**","authc");
return chainDefinition;
}
public static void main(String[] args) {
SpringApplication.run(BootApplication.class, args);
}
}
到這步其實(shí)springboot和shiro就已經(jīng)整合完畢了,其他的該怎么配就怎么配.
其他:關(guān)于SpringBoot整合Shiro的簡(jiǎn)易代碼我上傳到gitHub了,有需要的同學(xué)可以自行下載.
https://github.com/javalanxiongwei/springboot-shiro