拦截器从上到下依次分为Global、Routes、Class、Method四个层次,Clear用于清除自身所处层次以上层的拦截器。

    Clear声明在Method层时将针对Global、Routes、Class进行清除。Clear声明在Class层时将针对Global、Routes 进行清除。Clear注解携带参数时清除目标层中指定的拦截器。

    Clear用法记忆技巧:

    • 一共有Global、Routes、Class、Method 四层拦截器

    • 清除只针对Clear本身所处层的向上所有层,本层与下层不清除

    • 不带参数时清除所有拦截器,带参时清除参数指定的拦截器

    在某些应用场景之下,需要移除Global或Class拦截器。例如某个后台管理系统,配置了一个全局的权限拦截器,但是其登录action就必须清除掉她,否则无法完成登录操作,以下是代码示例:

    1. // login方法需要移除该权限拦截器才能正常登录
    2. @Before(AuthInterceptor.class)
    3. public class UserController extends Controller {
    4. // AuthInterceptor 已被Clear清除掉,不会被其拦截
    5. @Clear
    6. public void login() {
    7. }
    8. // 此方法将被AuthInterceptor拦截
    9. public void show() {
    10. }
    11. }

    Clear注解带有参数时,能清除指定的拦截器,以下是一个更加全面的示例:

    1. @Before(AAA.class)
    2. public class UserController extends Controller {
    3. @Clear
    4. @Before(BBB.class)
    5. public void login() {
    6. // Global、Class级别的拦截器将被清除,但本方法上声明的BBB不受影响
    7. }
    8. @Clear({AAA.class, CCC.class})// 清除指定的拦截器AAA与CCC
    9. @Before(CCC.class)
    10. public void show() {
    11. // 虽然Clear注解中指定清除CCC,但她无法被清除,因为清除操作只针对于本层以上的各层
    12. }
    13. }

    上面的清除都用在了 method 上,还可以将其用于 class 之上,例如:

    1. @Clear(AAA.class)
    2. public class UserController {
    3. public void index() {
    4. ...
    5. }
    6. }

    如上所示,@Clear(AAA.class) 将清除上层也就是 Global、Route 这两层中配置的 AAA.java 这个拦截器。