Apache Shiro内置拦截器

绝地灬酷狼 2021-06-24 16:12 392阅读 0赞

Shiro内置了很多默认的拦截器，比如身份验证、授权等相关的。默认拦截器可以参考org.apache.shiro.web.filter.mgt.DefaultFilter中的枚举拦截器。

public enum DefaultFilter{
      anno(AnonymousFilter.class),
      authc(FormAuthenticationFilter.class),
      authcBasic(BasicHttpAuthenticationFilter.class),
      logout(LogoutFilter.class),
      noSessionCreation(NoSessionCreationFilter.class),
      perms(PermissionsAuthorizationFilter.class),
      port(PortFilter.class),
      rest(HttpMethodPermissionFilter.class),
      roles(RolesAuthorizationFilter.class),
      ssl(SslFilter.class),
      user(UserFilter.class);
    }

# 与身份验证相关的拦截器 #

<table> 
 <thead> 
  <tr> 
   <th align="left">默认拦截器名</th> 
   <th align="left">拦截器类</th> 
   <th align="left">说明（括号里的表述默认值）</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td align="left">authc</td> 
   <td align="left">org.apache.shiro.web.filter.authc.<br>FormAuthenticationFilter</td> 
   <td align="left">基于表单的拦截器；如“/**=authc”，如果没有登录会跳转到相应的登录页面登录。<br>主要属性：<br>usernameParam:表单提交的用户名参数名(username)。<br>passwordParam:表单提交的密码参数名(password)。<br>rememberMeParam:表单提交的记住我参数名(rememberMe)。<br>loginUrl:登录页面地址(/login.jsp)。<br>successUrl:登录成功后的默认重定向地址。<br>failureKeyAttribute:登录失败后错误信息存储Key(shiroLoginFailure)。</td> 
  </tr> 
  <tr> 
   <td align="left">authcBasic</td> 
   <td align="left">org.apache.shiro.web.filter.authc.<br>BasicHttpAuthenticationFilter</td> 
   <td align="left">Basic HTTP身份验证拦截器，主要属性：<br>applicationName:弹出登录框显示的信息(application)。</td> 
  </tr> 
  <tr> 
   <td align="left">logout</td> 
   <td align="left">org.apache.shiro.web.filter.authc.<br>LogoutFilter</td> 
   <td align="left">退出拦截器，主要属性：<br>redirectUrl:退出成功后重定向的地址（/）。<br>示例：“/logout=logout”</td> 
  </tr> 
  <tr> 
   <td align="left">user</td> 
   <td align="left">org.apache.shiro.web.filter.authc.<br>UserFilter</td> 
   <td align="left">用户拦截器，用户已经身份验证/记住我登录的都可。<br>示例：“/**=user”</td> 
  </tr> 
  <tr> 
   <td align="left">anon</td> 
   <td align="left">org.apache.shiro.web.filter.authc.<br>AnnonymousFilter</td> 
   <td align="left">匿名拦截器，即不需要登录即可访问，一般用于静态资源过滤。<br>示例：“/static/**=anon”</td> 
  </tr> 
 </tbody> 
</table>

# 与授权相关的拦截器 #

<table> 
 <thead> 
  <tr> 
   <th align="left">默认拦截器名</th> 
   <th align="left">拦截器类</th> 
   <th align="left">说明（括号里的表述默认值）</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td align="left">roles</td> 
   <td align="left">org.apache.shiro.web.filter.authz.<br>RolesAuthorizationFilter</td> 
   <td align="left">角色授权拦截器，验证用户是否拥有所有角色。主要属性：<br>loginUrl:登录页面地址(/login.jsp)。<br>unauthorizedUrl:未授权后重定向的地址。<br>示例：“/admin/**=roles[admin]”</td> 
  </tr> 
  <tr> 
   <td align="left">perms</td> 
   <td align="left">org.apache.shiro.web.filter.authz.<br>PermissionsAuthorizationFilter</td> 
   <td align="left">权限授权拦截器，验证用户是否拥有所有权限，属性和roles一样。<br>示例：“/user/**=perms[“user:create”]”</td> 
  </tr> 
  <tr> 
   <td align="left">port</td> 
   <td align="left">org.apache.shiro.web.filter.authz.<br>PortFilter</td> 
   <td align="left">端口拦截器，主要属性：<br>port(80):可以通过的端口。<br>示例：“/test=port[80]”，如果用户访问该页面是非80端口，将自动将端口改为80并重定向到该80端口，其他路径/参数等都一样。</td> 
  </tr> 
  <tr> 
   <td align="left">rest</td> 
   <td align="left">org.apache.shiro.web.filter.authz.<br>HttpMethodPermissionFilter</td> 
   <td align="left">rest风格拦截器，自动根据请求方法构建权限字符串(GET=read,POST=create,PUT=update,DELETE=delete,HEAD=read,TRACE=read,OPTIONS=read,MKCOL=create)构建权限字符串。<br>示例：“/users=rest[user]”，会自动拼出“user:read,user:create,user:update,user:delete”权限字符串进行权限匹配（所有都得匹配，isPermittedAll）。</td> 
  </tr> 
  <tr> 
   <td align="left">ssl</td> 
   <td align="left">org.apache.shiro.web.filter.authz.<br>SslFilter</td> 
   <td align="left">SSL拦截器，只有请求协议是https才能通过，否则自动跳转到https端口（443），其他和port拦截器一样。</td> 
  </tr> 
 </tbody> 
</table>

# 其他拦截器 #

<table> 
 <thead> 
  <tr> 
   <th align="left">默认拦截器名</th> 
   <th align="left">拦截器类</th> 
   <th align="left">说明（括号里的表述默认值）</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td align="left">noSessionCreation</td> 
   <td align="left">org.apache.shiro.web.filter.<br>session.NoSessionCreationFilter</td> 
   <td align="left">不创建会话拦截器，调用subject.getSession(false)不会有问题，但是如果subject.getSession(true)将抛出异常。</td> 
  </tr> 
 </tbody> 
</table>