1 快速上手

2 JFinalConfig

3 Controller

4 AOP

5 ActiveRecord

6 Enjoy 模板引擎

7 EhCachePlugin

8 RedisPlugin

9 Cron4jPlugin

10 Validator

11 国际化

12 Json 转换

13 JFinal架构及扩展

14 升级到 4.5

3.2 Action

1、Action 定义

    在 Controller 之中定义的 public 方法称为Action。Action 是请求的最小单位。Action 方法必须在 Controller 中定义,且必须是 public 可见性。

public class HelloController extends Controller {
    public void index() {
       renderText("此方法是一个action");
    }
    public String test() {
       return "index.html";
    }
}

    以上代码中定义了两个Action:HelloController.index()、HelloController.test()。

    Action可以有返回值,返回值可在拦截器中通过invocation.getReturnValue() 获取到,以便进行render控制。

2、@NotAction 注解

     如果希望 controller 中的 public 方法不成为一个 action,可以使用 @NotAction 注解。@NotAction 注解通常用于引入了 BaseController 的中间 Controller,例如:

public class BaseController extends Controller {
   
   // 不希望成为 action,仅供子类调用,或拦截器中调用
   @NotAction
   public void getLoginUser() {
   
   }
}


3、控制器超类的路由映射

    自 jfinal 3.6 开始,控制器超类中的所有方法默认不会被映射为 action。(也就是自 jfinal 3.6 版本开始上例中 BaseController 中的 @NotAction 默认已经不需要了,因为 BaseController 是你最终控制器 XxxController 的超类)

    如果希望超类中的方法也被映射为 action 只需添加一行配置:

public void configRoute(Routes me) {
    me.setMappingSuperClass(true);
}


    该功能属于性能优化,拥有大量路由的大型项目可加快启动速度。该配置如果配置在 "子Routes" 中,将只对该 "子Routes" 有效,例如:

public FrontRoutes extends Routes {
   public void config() {
      // 这里配置只对 FrontRoutes 下的路由有效,建议这样配置以提升性能
      setMappingSuperClass(true);
      
      add("/weixin", WeixinController.class);
   }
}

    "子Routes" 相关内容详见文档第二章 configRoute(...) 章节。