zoukankan      html  css  js  c++  java

  • Shiro基础知识08----拦截器介绍（转）

    1 拦截器介绍

       Shiro使用了与Servlet一样的Filter接口进行扩展；所以如果对Filter不熟悉可以参考《Servlet3.1规范》http://www.iteye.com/blogs/subjects/Servlet-3-1了解Filter的工作原理。首先下图是Shiro拦截器的基础类图：

    1、NameableFilter
        NameableFilter给Filter起个名字，如果没有设置默认就是FilterName；还记得之前的如authc吗？当我们组装拦截器链时会根据这个名字找到相应的拦截器实例；
    2、OncePerRequestFilter
        OncePerRequestFilter用于防止多次执行Filter的；也就是说一次请求只会走一次拦截器链；另外提供enabled属性，表示是否开启该拦截器实例，默认enabled=true表示开启，如果不想让某个拦截器工作，可以设置为false即可。
    3、ShiroFilter
        ShiroFilter是整个Shiro的入口点，用于拦截需要安全控制的请求进行处理，这个之前已经用过了。
    4、AdviceFilter
        AdviceFilter提供了AOP风格的支持，类似于SpringMVC中的Interceptor

    [java] view plain copy
     print?
    1. boolean preHandle(ServletRequest request, ServletResponse response) throws Exception    
    2. void postHandle(ServletRequest request, ServletResponse response) throws Exception    
    3. void afterCompletion(ServletRequest request, ServletResponse response, Exception exception) throws Exception;    
        preHandler：类似于AOP中的前置增强；在拦截器链执行之前执行；如果返回true则继续拦截器链；否则中断后续的拦截器链的执行直接返回；进行预处理（如基于表单的身份验证、授权）
        postHandle：类似于AOP中的后置返回增强；在拦截器链执行完成后执行；进行后处理（如记录执行时间之类的）；
        afterCompletion：类似于AOP中的后置最终增强；即不管有没有异常都会执行；可以进行清理资源（如接触Subject与线程的绑定之类的）；

    5、PathMatchingFilter
        PathMatchingFilter提供了基于Ant风格的请求路径匹配功能及拦截器参数解析的功能，如“roles[admin,user]”自动根据“，”分割解析到一个路径参数配置并绑定到相应的路径：
    [java] view plain copy
     print?
    1. boolean pathsMatch(String path, ServletRequest request)    
    2. boolean onPreHandle(ServletRequest request, ServletResponse response, Object mappedValue) throws Exception    
        pathsMatch：该方法用于path与请求路径进行匹配的方法；如果匹配返回true；
        onPreHandle：在preHandle中，当pathsMatch匹配一个路径后，会调用opPreHandler方法并将路径绑定参数配置传给mappedValue；然后可以在这个方法中进行一些验证（如角色授权），如果验证失败可以返回false中断流程；默认返回true；也就是说子类可以只实现onPreHandle即可，无须实现preHandle。如果没有path与请求路径匹配，默认是通过的（即preHandle返回true）。

    6、AccessControlFilter
        AccessControlFilter提供了访问控制的基础功能；比如是否允许访问/当访问拒绝时如何处理等：

    [java] view plain copy
     print?
    1. abstract boolean isAccessAllowed(ServletRequest request, ServletResponse response, Object mappedValue) throws Exception;    
    2. boolean onAccessDenied(ServletRequest request, ServletResponse response, Object mappedValue) throws Exception;    
    3. abstract boolean onAccessDenied(ServletRequest request, ServletResponse response) throws Exception;    
        isAccessAllowed：表示是否允许访问；mappedValue就是[urls]配置中拦截器参数部分，如果允许访问返回true，否则false；
        onAccessDenied：表示当访问拒绝时是否已经处理了；如果返回true表示需要继续处理；如果返回false表示该拦截器实例已经处理了，将直接返回即可。

    onPreHandle会自动调用这两个方法决定是否继续处理：

    [java] view plain copy
     print?
    1. boolean onPreHandle(ServletRequest request, ServletResponse response, Object mappedValue) throws Exception {    
    2.     return isAccessAllowed(request, response, mappedValue) || onAccessDenied(request, response, mappedValue);    
    3. }   
    另外AccessControlFilter还提供了如下方法用于处理如登录成功后/重定向到上一个请求：
    [java] view plain copy
     print?
    1. void setLoginUrl(String loginUrl) //身份验证时使用，默认/login.jsp    
    2. String getLoginUrl()    
    3. Subject getSubject(ServletRequest request, ServletResponse response) //获取Subject实例    
    4. boolean isLoginRequest(ServletRequest request, ServletResponse response)//当前请求是否是登录请求    
    5. void saveRequestAndRedirectToLogin(ServletRequest request, ServletResponse response) throws IOException //将当前请求保存起来并重定向到登录页面    
    6. void saveRequest(ServletRequest request) //将请求保存起来，如登录成功后再重定向回该请求    
    7. void redirectToLogin(ServletRequest request, ServletResponse response) //重定向到登录页面     
        比如基于表单的身份验证就需要使用这些功能。
        到此基本的拦截器就完事了，如果我们想进行访问访问的控制就可以继承AccessControlFilter；如果我们要添加一些通用数据我们可以直接继承PathMatchingFilter。

    2 拦截器链

        Shiro对Servlet容器的FilterChain进行了代理，即ShiroFilter在继续Servlet容器的Filter链的执行之前，通过ProxiedFilterChain对Servlet容器的FilterChain进行了代理；即先走Shiro自己的Filter体系，然后才会委托给Servlet容器的FilterChain进行Servlet容器级别的Filter链执行；
        Shiro的ProxiedFilterChain执行流程：1、先执行Shiro自己的Filter链；2、再执行Servlet容器的Filter链（即原始的Filter）。
        而ProxiedFilterChain是通过FilterChainResolver根据配置文件中[urls]部分是否与请求的URL是否匹配解析得到的。

    [java] view plain copy
     print?
    1. FilterChain getChain(ServletRequest request, ServletResponse response, FilterChain originalChain);    
        即传入原始的chain得到一个代理的chain。
        Shiro内部提供了一个路径匹配的FilterChainResolver实现：PathMatchingFilterChainResolver，其根据[urls]中配置的url模式（默认Ant风格）=拦截器链和请求的url是否匹配来解析得到配置的拦截器链的；而PathMatchingFilterChainResolver内部通过FilterChainManager维护着拦截器链，比如DefaultFilterChainManager实现维护着url模式与拦截器链的关系。因此我们可以通过FilterChainManager进行动态动态增加url模式与拦截器链的关系。
        DefaultFilterChainManager会默认添加org.apache.shiro.web.filter.mgt.DefaultFilter中声明的拦截器：
    [java] view plain copy
     print?
    1. public enum DefaultFilter {    
    2.     anon(AnonymousFilter.class),    
    3.     authc(FormAuthenticationFilter.class),    
    4.     authcBasic(BasicHttpAuthenticationFilter.class),    
    5.     logout(LogoutFilter.class),    
    6.     noSessionCreation(NoSessionCreationFilter.class),    
    7.     perms(PermissionsAuthorizationFilter.class),    
    8.     port(PortFilter.class),    
    9.     rest(HttpMethodPermissionFilter.class),    
    10.     roles(RolesAuthorizationFilter.class),    
    11.     ssl(SslFilter.class),    
    12.     user(UserFilter.class);    
    13. }     
        如果要注册自定义拦截器，IniSecurityManagerFactory/WebIniSecurityManagerFactory在启动时会自动扫描ini配置文件中的[filters]/[main]部分并注册这些拦截器到DefaultFilterChainManager；且创建相应的url模式与其拦截器关系链。如果使用Spring后续章节会介绍如果注册自定义拦截器。
        如果想自定义FilterChainResolver，可以通过实现WebEnvironment接口完成：
    [java] view plain copy
     print?
    1. public class MyIniWebEnvironment extends IniWebEnvironment {    
    2.     @Override    
    3.     protected FilterChainResolver createFilterChainResolver() {    
    4.         //在此处扩展自己的FilterChainResolver    
    5.         return super.createFilterChainResolver();    
    6.     }    
    7. }     
        FilterChain之间的关系。如果想动态实现url-拦截器的注册，就可以通过实现此处的FilterChainResolver来完成，比如：
    [java] view plain copy
     print?
    1. //1、创建FilterChainResolver    
    2. PathMatchingFilterChainResolver filterChainResolver =    
    3.         new PathMatchingFilterChainResolver();    
    4. //2、创建FilterChainManager    
    5. DefaultFilterChainManager filterChainManager = new DefaultFilterChainManager();    
    6. //3、注册Filter    
    7. for(DefaultFilter filter : DefaultFilter.values()) {    
    8.     filterChainManager.addFilter(    
    9.         filter.name(), (Filter) ClassUtils.newInstance(filter.getFilterClass()));    
    10. }    
    11. //4、注册URL-Filter的映射关系    
    12. filterChainManager.addToChain("/login.jsp", "authc");    
    13. filterChainManager.addToChain("/unauthorized.jsp", "anon");    
    14. filterChainManager.addToChain("/**", "authc");    
    15. filterChainManager.addToChain("/**", "roles", "admin");    
    16.     
    17. //5、设置Filter的属性    
    18. FormAuthenticationFilter authcFilter =    
    19.          (FormAuthenticationFilter)filterChainManager.getFilter("authc");    
    20. authcFilter.setLoginUrl("/login.jsp");    
    21. RolesAuthorizationFilter rolesFilter =    
    22.           (RolesAuthorizationFilter)filterChainManager.getFilter("roles");    
    23. rolesFilter.setUnauthorizedUrl("/unauthorized.jsp");    
    24.     
    25. filterChainResolver.setFilterChainManager(filterChainManager);    
    26. return filterChainResolver;     
  • 相关阅读:
    计算机英语
    NSQ学习记录
    Java学习记录－注解
    VS插件开发
    树
    双链表
    顺序表
    顺序队列
    顺序栈
    图
  • 原文地址：https://www.cnblogs.com/jpfss/p/8334701.html
Copyright © 2011-2022 走看看