第十二章 与Spring集成

Shiro的组件都是JavaBean/POJO式的组件，所以非常容易使用Spring进行组件管理，可以非常方便的从ini配置迁移到Spring进行管理，且支持JavaSE应用及Web应用的集成。

在示例之前，需要导入shiro-spring及spring-context依赖，具体请参考pom.xml。

spring-beans.xml配置文件提供了基础组件如DataSource、DAO、Service组件的配置。

JavaSE应用

spring-shiro.xml提供了普通JavaSE独立应用的Spring配置：

1. <!-- 缓存管理器 使用Ehcache实现 -->  
2. <bean id="cacheManager" class="org.apache.shiro.cache.ehcache.EhCacheManager">  
3. "cacheManagerConfigFile" value="classpath:ehcache.xml"/>  
4. </bean>  
5.   
6. <!-- 凭证匹配器 -->  
7. <bean id="credentialsMatcher" class="  
8. com.github.zhangkaitao.shiro.chapter12.credentials.RetryLimitHashedCredentialsMatcher">  
9. "cacheManager"/>  
10. "hashAlgorithmName" value="md5"/>  
11. "hashIterations" value="2"/>  
12. "storedCredentialsHexEncoded" value="true"/>  
13. </bean>  
14.   
15. <!-- Realm实现 -->  
16. <bean id="userRealm" class="com.github.zhangkaitao.shiro.chapter12.realm.UserRealm">  
17. "userService" ref="userService"/>  
18. "credentialsMatcher" ref="credentialsMatcher"/>  
19. "cachingEnabled" value="true"/>  
20. "authenticationCachingEnabled" value="true"/>  
21. "authenticationCacheName" value="authenticationCache"/>  
22. "authorizationCachingEnabled" value="true"/>  
23. "authorizationCacheName" value="authorizationCache"/>  
24. </bean>  
25. <!-- 会话ID生成器 -->  
26. <bean id="sessionIdGenerator"
27. class="org.apache.shiro.session.mgt.eis.JavaUuidSessionIdGenerator"/>  
28. <!-- 会话DAO -->  
29. <bean id="sessionDAO"
30. class="org.apache.shiro.session.mgt.eis.EnterpriseCacheSessionDAO">  
31. "activeSessionsCacheName" value="shiro-activeSessionCache"/>  
32. "sessionIdGenerator" ref="sessionIdGenerator"/>  
33. </bean>  
34. <!-- 会话验证调度器 -->  
35. <bean id="sessionValidationScheduler"
36. class="org.apache.shiro.session.mgt.quartz.QuartzSessionValidationScheduler">  
37. "sessionValidationInterval" value="1800000"/>  
38. "sessionManager" ref="sessionManager"/>  
39. </bean>  
40. <!-- 会话管理器 -->  
41. <bean id="sessionManager" class="org.apache.shiro.session.mgt.DefaultSessionManager">  
42. "globalSessionTimeout" value="1800000"/>  
43. "deleteInvalidSessions" value="true"/>  
44. "sessionValidationSchedulerEnabled" value="true"/>  
45. "sessionValidationScheduler" ref="sessionValidationScheduler"/>  
46. "sessionDAO" ref="sessionDAO"/>  
47. </bean>  
48. <!-- 安全管理器 -->  
49. <bean id="securityManager" class="org.apache.shiro.mgt.DefaultSecurityManager">  
50. "realms">  
51. "userRealm"/></list>  
52.     </property>  
53. "sessionManager" ref="sessionManager"/>  
54. "cacheManager" ref="cacheManager"/>  
55. </bean>  
56. <!-- 相当于调用SecurityUtils.setSecurityManager(securityManager) -->  
57. <bean class="org.springframework.beans.factory.config.MethodInvokingFactoryBean">  
58. <property name="staticMethod"
59. value="org.apache.shiro.SecurityUtils.setSecurityManager"/>  
60. "arguments" ref="securityManager"/>  
61. </bean>  
62. <!-- Shiro生命周期处理器-->  
63. <bean id="lifecycleBeanPostProcessor"
64. class="org.apache.shiro.spring.LifecycleBeanPostProcessor"/>  

可以看出，只要把之前的ini配置翻译为此处的spring xml配置方式即可，无须多解释。LifecycleBeanPostProcessor用于在实现了Initializable接口的Shiro bean初始化时调用Initializable接口回调，在实现了Destroyable接口的Shiro bean销毁时调用 Destroyable接口回调。如UserRealm就实现了Initializable，而DefaultSecurityManager实现了Destroyable。具体可以查看它们的继承关系。

测试用例请参考com.github.zhangkaitao.shiro.chapter12.ShiroTest。 

Web应用

Web应用和普通JavaSE应用的某些配置是类似的，此处只提供一些不一样的配置，详细配置可以参考spring-shiro-web.xml。 

1. <!-- 会话Cookie模板 -->  
2. <bean id="sessionIdCookie" class="org.apache.shiro.web.servlet.SimpleCookie">  
3. "sid"/>  
4. "httpOnly" value="true"/>  
5. "maxAge" value="180000"/>  
6. </bean>  
7. <!-- 会话管理器 -->  
8. <bean id="sessionManager"
9. class="org.apache.shiro.web.session.mgt.DefaultWebSessionManager">  
10. "globalSessionTimeout" value="1800000"/>  
11. "deleteInvalidSessions" value="true"/>  
12. "sessionValidationSchedulerEnabled" value="true"/>  
13. "sessionValidationScheduler" ref="sessionValidationScheduler"/>  
14. "sessionDAO" ref="sessionDAO"/>  
15. "sessionIdCookieEnabled" value="true"/>  
16. "sessionIdCookie" ref="sessionIdCookie"/>  
17. </bean>  
18. <!-- 安全管理器 -->  
19. <bean id="securityManager" class="org.apache.shiro.web.mgt.DefaultWebSecurityManager">  
20. <property name="realm" ref="userRealm"/>  
21. "sessionManager" ref="sessionManager"/>  
22. "cacheManager" ref="cacheManager"/>  
23. </bean>   

1、sessionIdCookie是用于生产Session ID Cookie的模板；

2、会话管理器使用用于web环境的DefaultWebSessionManager；

3、安全管理器使用用于web环境的DefaultWebSecurityManager。 

1. <!-- 基于Form表单的身份验证过滤器 -->  
2. <bean id="formAuthenticationFilter"
3. class="org.apache.shiro.web.filter.authc.FormAuthenticationFilter">  
4. "usernameParam" value="username"/>  
5. "passwordParam" value="password"/>  
6. "loginUrl" value="/login.jsp"/>  
7. </bean>  
8. <!-- Shiro的Web过滤器 -->  
9. <bean id="shiroFilter" class="org.apache.shiro.spring.web.ShiroFilterFactoryBean">  
10. "securityManager" ref="securityManager"/>  
11. "loginUrl" value="/login.jsp"/>  
12. "unauthorizedUrl" value="/unauthorized.jsp"/>  
13. "filters">  
14.         <util:map>  
15. "authc" value-ref="formAuthenticationFilter"/>  
16.         </util:map>  
17.     </property>  
18. "filterChainDefinitions">  
19.         <value>  
20.             /index.jsp = anon  
21.             /unauthorized.jsp = anon  
22.             /login.jsp = authc  
23.             /logout = logout  
24.             /** = user  
25.         </value>  
26.     </property>  
27. </bean>   

1、formAuthenticationFilter为基于Form表单的身份验证过滤器；此处可以再添加自己的Filter bean定义；

2、shiroFilter：此处使用ShiroFilterFactoryBean来创建ShiroFilter过滤器；filters属性用于定义自己的过滤器，即ini配置中的[filters]部分；filterChainDefinitions用于声明url和filter的关系，即ini配置中的[urls]部分。

接着需要在web.xml中进行如下配置： 

1. <context-param>  
2.     <param-name>contextConfigLocation</param-name>  
3.     <param-value>  
4.         classpath:spring-beans.xml,  
5.         classpath:spring-shiro-web.xml  
6.     </param-value>  
7. </context-param>  
8. <listener>  
9. class>  
10. org.springframework.web.context.ContextLoaderListener  
11. </listener-class>  
12. </listener>   

通过ContextLoaderListener加载contextConfigLocation指定的Spring配置文件。

1. <filter>  
2.     <filter-name>shiroFilter</filter-name>  
3. class>org.springframework.web.filter.DelegatingFilterProxy</filter-class>  
4.     <init-param>  
5.         <param-name>targetFilterLifecycle</param-name>  
6. true</param-value>  
7.     </init-param>  
8. </filter>  
9. <filter-mapping>  
10.     <filter-name>shiroFilter</filter-name>  
11.     <url-pattern>/*</url-pattern>  
12. </filter-mapping>   

DelegatingFilterProxy会自动到Spring容器中查找名字为shiroFilter的bean并把filter请求交给它处理。

其他配置请参考源代码。

Shiro权限注解

Shiro提供了相应的注解用于权限控制，如果使用这些注解就需要使用AOP的功能来进行判断，如Spring AOP；Shiro提供了Spring AOP集成用于权限注解的解析和验证。

为了测试，此处使用了Spring MVC来测试Shiro注解，当然Shiro注解不仅仅可以在web环境使用，在独立的JavaSE中也是可以用的，此处只是以web为例了。

在spring-mvc.xml配置文件添加Shiro Spring AOP权限注解的支持： 

1. <aop:config proxy-target-class="true"></aop:config>  
2. <bean class="  
3. org.apache.shiro.spring.security.interceptor.AuthorizationAttributeSourceAdvisor">  
4. "securityManager" ref="securityManager"/>  
5. </bean>   

如上配置用于开启Shiro Spring AOP权限注解的支持；<aop:config proxy-target-class="true">表示代理类。

接着就可以在相应的控制器（AnnotationController）中使用如下方式进行注解： 

1. @RequiresRoles("admin")  
2. @RequestMapping("/hello2")  
3. public
4. return "success";  
5. }   

访问hello2方法的前提是当前用户有admin角色。

当验证失败，其会抛出UnauthorizedException异常，此时可以使用Spring的ExceptionHandler（DefaultExceptionHandler）来进行拦截处理：

1. @ExceptionHandler({UnauthorizedException.class})  
2. @ResponseStatus(HttpStatus.UNAUTHORIZED)  
3. public
4. new
5. "exception", e);  
6. "unauthorized");  
7. return
8. }   

权限注解      

1. @RequiresAuthentication

表示当前Subject已经通过login进行了身份验证；即Subject. isAuthenticated()返回true。 

1. @RequiresUser

表示当前Subject已经身份验证或者通过记住我登录的。

1. @RequiresGuest

表示当前Subject没有身份验证或通过记住我登录过，即是游客身份。  

1. @RequiresRoles(value={“admin”, “user”}, logical= Logical.AND)  

表示当前Subject需要角色admin和user。

1. @RequiresPermissions

表示当前Subject需要权限user:a或user:b。