9大内置过滤器

当运行web应用程序时，Shiro将创建一些有用的默认过滤器实例，并使它们在[main]部分自动可用。您可以像配置任何其他bean一样在main中配置它们，并在链定义中引用它们。
默认筛选器实例由DefaultFilter enum中定义，enum s name字段是可用于配置的名称。
于是我看了一下 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. ...
    
14. }

终于知道我们常用的anon、authc、perms、roles、user过滤器是哪里来的了！这些过滤器我们都是可以直接使用的。但你要弄清楚这些默认过滤器，你还不得不去深入了解一下shiro更底层为我们提供的过滤器，基本我们的这些默认过滤器都是通过继承这几个底层过滤器演变而来的。
那么这些过滤器都有哪些呢？我们来看一个图：

上面我标记了7个我们接下来要介绍的过滤器，我们一个个来介绍，弄清楚这些过滤器之后，相信你对shiro的认识会更深一层了。具体authc、perms、roles等这些默认过滤器与这7个过滤器有什么关系你就会明白。

1、AbstractFilter

这个过滤器还得说说，shiro最底层的抽象过滤器，虽然我们极少直接继承它，它通过实现 Filter获得过滤器的特性。

完成一些过滤器基本初始化操作， FilterConfig：过滤器配置对象，用于servlet容器在初始化期间将信息传递给其他过滤器。

2、NameableFilter

命名过滤器，给过滤器定义名称！也是比较基层的过滤器了，未拓展其他功能，我们很少会直接继承这个过滤器。为重写doFilter方法。

3、OncePerRequestFilter

重写doFilter方法，保证每个servlet方法只会被过滤一次。可以看到doFilter方法中，第一行代码就是 StringalreadyFilteredAttributeName=getAlreadyFilteredAttributeName();然后通过 request.getAttribute(alreadyFilteredAttributeName)!=null来判断过滤器是否已经被调用过，从而保证过滤器不会被重复调用。
进入方法之前，先标记 alreadyFilteredAttributeName为True，抽象 doFilterInternal方法执行之后再remove掉 alreadyFilteredAttributeName。

所以OncePerRequestFilter过滤器保证只会被一次调用的功能，提供了抽象方法 doFilterInternal让后面的过滤器可以重写，执行真正的过滤器处理逻辑。

1. protected abstract void doFilterInternal(ServletRequest request, ServletResponse response, FilterChain chain)
   
2. throws ServletException, IOException;
   

这个过滤器我们已经可以开始在我们的项目继承使用，比如拦截用户请求，判断用户是否已经登录（携带token或cookie信息），如果未登录则返回Json数据告知未登录！
比如：开源mblog博客项目中，过滤器就是继承OncePerRequestFilter。

• https://gitee.com/mtons/mblog
  

1. /**
   
2. * 公众号：MarkerHub
   
3. **/
   
4. public class AuthenticatedFilter extends OncePerRequestFilter {
   
5. 
   
6. // 前端弹窗的js代码
   
7. private static final String JS = "<script type='text/javascript'>var wp=window.parent; if(wp!=null){while(wp.parent&&wp.parent!==wp){wp=wp.parent;}wp.location.href='%1$s';}else{window.location.href='%1$s';}</script>";
   
8. private String loginUrl = "/login";
   
9. 
   
10. // 重写doFilterInternal方法
    
11. @Override
    
12. protected void doFilterInternal(ServletRequest request, ServletResponse response, FilterChain chain)
    
13. throws ServletException, IOException {
    
14. 
    
15. Subject subject = SecurityUtils.getSubject();
    
16. // 已经登陆就跳过过滤器
    
17. if (subject.isAuthenticated() || subject.isRemembered()) {
    
18. chain.doFilter(request, response);
    
19. } else {
    
20. // 未登录就返回json或者js代码
    
21. WebUtils.saveRequest(request);
    
22. String path = WebUtils.getContextPath((HttpServletRequest) request);
    
23. String url = loginUrl;
    
24. if (StringUtils.isNotBlank(path) && path.length() > 1) {
    
25. url = path + url;
    
26. }
    
27. 
    
28. if (isAjaxRequest((HttpServletRequest) request)) {
    
29. response.setContentType("application/json;charset=UTF-8");
    
30. response.getWriter().print(JSON.toJSONString(Result.failure("您还没有登录!")));
    
31. } else {
    
32. response.getWriter().write(new Formatter().format(JS, url).toString());
    
33. }
    
34. }
    
35. }
    
36. }
    

未登录情况，ajax请求过滤器返回 您还没有登录!提示，web请求则返回一段js代码，前端渲染会跳出一个登陆窗口，这也就是未什么大家常遇到的点击登录，当前跳出一个登陆弹窗的一种实现方式！
效果：

4、AdviceFilter

看到Advice，很自然想到切面环绕编程，一般有pre、post、after几个方法。所以这个AdviceFilter过滤器就是提供了和AOP相似的切面功能。
继承OncePerRequestFilter过滤器重写doFilterInternal方法，我们可以先看看：

可以看到上面4个序号：

• 1、preHandle 前置过滤，默认true
  
• 2、executeChain 执行真正代码过滤逻辑->chain.doFilter
  
• 3、postHandle 后置过滤
  
• 4、cleanup 其实主要逻辑是afterCompletion方法
  

于是，我们从OncePerRequestFilter的一个doFilterInternal分化成了切面编程，更容易前后控制执行逻辑。所以如果继承AdviceFilter时候，我们可以重写preHandle方法，判断用户是否满足已登录或者其他业务逻辑，返回false时候表示不通过过滤器。

5、PathMatchingFilter

请求路径匹配过滤器，通过匹配请求url，判断请求是否需要过滤，如果url未在需要过滤的集合内，则跳过，否则进入 isFilterChainContinued的onPreHandle方法。
我们可以看下代码：


从上面3个步骤中可以看到，PathMatchingFilter提供的功能是：自定义匹配url，匹配上的请求最终跳转到 onPreHandle方法。
这个过滤器为后面的常用过滤器提供的基础，比如我们在config中配置如下

1. /login = anon
   
2. /admin/* = authc
   

拦截/login请求，经过AnonymousFilter过滤器，我们可以看下

• org.apache.shiro.web.filter.authc.AnonymousFilter
  

1. public class AnonymousFilter extends PathMatchingFilter {
   
2. 
   
3. /**
   
4. * 公众号：MarkerHub
   
5. **/
   
6. @Override
   
7. protected boolean onPreHandle(ServletRequest request, ServletResponse response, Object mappedValue) {
   
8. // Always return true since we allow access to anyone
   
9. return true;
   
10. }
    
11. }
    

AnonymousFilter重写了onPreHandle方法，只不过直接返回了true，说明拦截的链接可以直接通过，不需要其他拦截逻辑。
而authc->FormAuthenticationFilter也是间接继承了PathMatchingFilter。
public class FormAuthenticationFilter extends AuthenticatingFilter
所以，需要拦截某个链接进行业务逻辑过滤的可以继承PathMatchingFilter方法拓展哈。

6、AccessControlFilter

访问控制过滤器。继承PathMatchingFilter过滤器，重写onPreHandle方法，又分出了两个抽象方法来控制

• isAccessAllowed 是否允许访问
  
• onAccessDenied 是否拒绝访问
  

所以，我们现在可以通过重写这个抽象两个方法来控制过滤逻辑。另外多提供了3个方法，方便后面的过滤器使用。

1. /**
   
2. * 公众号：MarkerHub
   
3. **/
   
4. protected void saveRequestAndRedirectToLogin(ServletRequest request, ServletResponse response) throws IOException {
   
5. saveRequest(request);
   
6. redirectToLogin(request, response);
   
7. }
   
8. 
   
9. protected void saveRequest(ServletRequest request) {
   
10. WebUtils.saveRequest(request);
    
11. }
    
12. 
    
13. protected void redirectToLogin(ServletRequest request, ServletResponse response) throws IOException {
    
14. String loginUrl = getLoginUrl();
    
15. WebUtils.issueRedirect(request, response, loginUrl);
    
16. }
    

其中redirectToLogin提供了调整到登录页面的逻辑与实现，为后面的过滤器发现未登录跳转到登录页面提供了基础。
这个过滤器，我们可以灵活运用。

7、AuthenticationFilter

继承AccessControlFilter，重写了isAccessAllowed方法，通过判断用户是否已经完成登录来判断用户是否允许继续后面的逻辑判断。这里可以看出，从这个过滤器开始，后续的判断会与用户的登录状态相关，直接继承这些过滤器，我们不需要再自己手动去判断用户是否已经登录。并且提供了登录成功之后跳转的方法。

1. public abstract class AuthenticationFilter extends AccessControlFilter {
   
2. public void setSuccessUrl(String successUrl) {
   
3. this.successUrl = successUrl;
   
4. }
   
5. 
   
6. protected boolean isAccessAllowed(ServletRequest request, ServletResponse response, Object mappedValue) {
   
7. Subject subject = getSubject(request, response);
   
8. return subject.isAuthenticated();
   
9. }
   

10. }
    

    8、AuthenticatingFilter

    继承AuthenticationFilter，提供了自动登录、是否登录请求等方法。

11. /**
    

12. * 公众号：MarkerHub
    
13. **/
    
14. public abstract class AuthenticatingFilter extends AuthenticationFilter {
    
15. public static final String PERMISSIVE = "permissive";
    
16. 
    
17. //TODO - complete JavaDoc
    
18. 
    
19. protected boolean executeLogin(ServletRequest request, ServletResponse response) throws Exception {
    
20. AuthenticationToken token = createToken(request, response);
    
21. if (token == null) {
    
22. String msg = "createToken method implementation returned null. A valid non-null AuthenticationToken " +
    
23. "must be created in order to execute a login attempt.";
    
24. throw new IllegalStateException(msg);
    
25. }
    
26. try {
    
27. Subject subject = getSubject(request, response);
    
28. subject.login(token);
    
29. return onLoginSuccess(token, subject, request, response);
    
30. } catch (AuthenticationException e) {
    
31. return onLoginFailure(token, e, request, response);
    
32. }
    
33. }
    
34. 
    
35. protected abstract AuthenticationToken createToken(ServletRequest request, ServletResponse response) throws Exception;
    
36. 
    
37. /**
    
38. * 公众号：MarkerHub
    
39. **/
    
40. @Override
    
41. protected boolean isAccessAllowed(ServletRequest request, ServletResponse response, Object mappedValue) {
    
42. return super.isAccessAllowed(request, response, mappedValue) ||
    
43. (!isLoginRequest(request, response) && isPermissive(mappedValue));
    
44. }
    
45. ...
    
46. }
    

• executeLogin 执行登录
  
• onLoginSuccess 登录成功跳转
  
• onLoginFailure 登录失败跳转
  
• createToken 创建登录的身份token
  
• isAccessAllowed 是否允许被访问
  
• isLoginRequest 是否登录请求
  

这个方法提供了自动登录的课程，比如我们获取到token之后实行自动登录，这场景还是很场景的。
比如在开源项目renren-fast中，就是这样处理的：

• https://gitee.com/renrenio/renren-fast
  

1. public class OAuth2Filter extends AuthenticatingFilter {
   
2. 
   
3. @Override
   
4. protected AuthenticationToken createToken(ServletRequest request, ServletResponse response) throws Exception {
   
5. //获取请求token
   
6. String token = getRequestToken((HttpServletRequest) request);
   
7. 
   
8. if(StringUtils.isBlank(token)){
   
9. return null;
   
10. }
    
11. 
    
12. return new OAuth2Token(token);
    
13. }
    
14. 
    
15. @Override
    
16. protected boolean isAccessAllowed(ServletRequest request, ServletResponse response, Object mappedValue) {
    
17. if(((HttpServletRequest) request).getMethod().equals(RequestMethod.OPTIONS.name())){
    
18. return true;
    
19. }
    
20. 
    
21. return false;
    
22. }
    
23. 
    
24. @Override
    
25. protected boolean onAccessDenied(ServletRequest request, ServletResponse response) throws Exception {
    
26. //获取请求token，如果token不存在，直接返回401
    
27. String token = getRequestToken((HttpServletRequest) request);
    
28. if(StringUtils.isBlank(token)){
    
29. HttpServletResponse httpResponse = (HttpServletResponse) response;
    
30. httpResponse.setHeader("Access-Control-Allow-Credentials", "true");
    
31. httpResponse.setHeader("Access-Control-Allow-Origin", HttpContextUtils.getOrigin());
    
32. 
    
33. String json = new Gson().toJson(R.error(HttpStatus.SC_UNAUTHORIZED, "invalid token"));
    
34. 
    
35. httpResponse.getWriter().print(json);
    
36. 
    
37. return false;
    
38. }
    
39. 
    
40. return executeLogin(request, response);
    
41. }
    
42. 
    
43. /**
    
44. *公众号：MarkerHub
    
45. **/
    
46. @Override
    
47. protected boolean onLoginFailure(AuthenticationToken token, AuthenticationException e, ServletRequest request, ServletResponse response) {
    
48. HttpServletResponse httpResponse = (HttpServletResponse) response;
    
49. httpResponse.setContentType("application/json;charset=utf-8");
    
50. httpResponse.setHeader("Access-Control-Allow-Credentials", "true");
    
51. httpResponse.setHeader("Access-Control-Allow-Origin", HttpContextUtils.getOrigin());
    
52. try {
    
53. //处理登录失败的异常
    
54. Throwable throwable = e.getCause() == null ? e : e.getCause();
    
55. R r = R.error(HttpStatus.SC_UNAUTHORIZED, throwable.getMessage());
    
56. 
    
57. String json = new Gson().toJson(r);
    
58. httpResponse.getWriter().print(json);
    
59. } catch (IOException e1) {
    
60. 
    
61. }
    
62. 
    
63. return false;
    
64. }
    
65. 
    
66. /**
    
67. * 获取请求的token
    
68. */
    
69. private String getRequestToken(HttpServletRequest httpRequest){
    
70. //从header中获取token
    
71. String token = httpRequest.getHeader("token");
    
72. 
    
73. //如果header中不存在token，则从参数中获取token
    
74. if(StringUtils.isBlank(token)){
    
75. token = httpRequest.getParameter("token");
    
76. }
    
77. 
    
78. return token;
    
79. }
    
80. 
    
81. 
    
82. }
    

在 onAccessDenied方法校验通过之后执行 executeLogin方法完成自动登录！

9、FormAuthenticationFilter

基于form表单的账号密码自动登录的过滤器，我们只需要看这个方法就明白，和renren-fast的实现相似：

1. public class FormAuthenticationFilter extends AuthenticatingFilter {
   
2. 
   
3. public static final String DEFAULT_USERNAME_PARAM = "username";
   
4. public static final String DEFAULT_PASSWORD_PARAM = "password";
   
5. public static final String DEFAULT_REMEMBER_ME_PARAM = "rememberMe";
   
6. 
   
7. protected AuthenticationToken createToken(ServletRequest request, ServletResponse response) {
   
8. String username = getUsername(request);
   
9. String password = getPassword(request);
   
10. return createToken(username, password, request, response);
    
11. }
    
12. /**
    
13. * 公众号：MarkerHub
    
14. **/
    
15. protected boolean onAccessDenied(ServletRequest request, ServletResponse response) throws Exception {
    
16. if (isLoginRequest(request, response)) {
    
17. if (isLoginSubmission(request, response)) {
    
18. if (log.isTraceEnabled()) {
    
19. log.trace("Login submission detected. Attempting to execute login.");
    
20. }
    
21. return executeLogin(request, response);
    
22. } else {
    
23. if (log.isTraceEnabled()) {
    
24. log.trace("Login page view.");
    
25. }
    
26. //allow them to see the login page ;)
    
27. return true;
    
28. }
    
29. } else {
    
30. if (log.isTraceEnabled()) {
    
31. log.trace("Attempting to access a path which requires authentication. Forwarding to the " +
    
32. "Authentication url [" + getLoginUrl() + "]");
    
33. }
    
34. 
    
35. saveRequestAndRedirectToLogin(request, response);
    
36. return false;
    
37. }
    
38. }
    
39. }
    

onAccessDenied调用executeLogin方法。默认的token是UsernamepasswordToken。