• 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

    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]”自动根据“,”分割解析到一个路径参数配置并绑定到相应的路径:
    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提供了访问控制的基础功能;比如是否允许访问/当访问拒绝时如何处理等:

    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会自动调用这两个方法决定是否继续处理:

    1. boolean onPreHandle(ServletRequest request, ServletResponse response, Object mappedValue) throws Exception {    
    2.     return isAccessAllowed(request, response, mappedValue) || onAccessDenied(request, response, mappedValue);    
    3. }   
    另外AccessControlFilter还提供了如下方法用于处理如登录成功后/重定向到上一个请求:
    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是否匹配解析得到的。

    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中声明的拦截器:
    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接口完成:
    1. public class MyIniWebEnvironment extends IniWebEnvironment {    
    2.     @Override    
    3.     protected FilterChainResolver createFilterChainResolver() {    
    4.         //在此处扩展自己的FilterChainResolver    
    5.         return super.createFilterChainResolver();    
    6.     }    
    7. }     
        FilterChain之间的关系。如果想动态实现url-拦截器的注册,就可以通过实现此处的FilterChainResolver来完成,比如:
    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;     
  • 相关阅读:
    Navicat 连接MySQL 8.0.11 出现2059错误
    安全技术运营的心得
    浅谈命令混淆
    2021年度总结与2022新的展望
    域环境搭建之安装exchange
    内网ADCS攻防
    CVE202142287复现
    企业安全建设——安全防线框架建设(一)
    frp_v0.37.1内网穿透,内网服务公网用不求人
    WP7XNA 多点触摸
  • 原文地址:https://www.cnblogs.com/jpfss/p/8334701.html
Copyright © 2020-2023  润新知