手册目录

摘要

极速体验 Model与Bean

极速体验 Generator 相关生成文件 Model 与 Bean 合体后主要优势 Model 与 Bean 合体后注意事项

快速上手

创建项目放入 JFinal 库文件修改 web.xml 添加 java 文件启动项目开启浏览器看效果

JFinalConfig

概述 configConstant(Constants me) configRoute(Routes me) configPlugin (Plugins me) configInterceptor (Interceptors me) configHandler (Handlers me) afterJFinalStart()与 beforeJFinalStop() PropKit

Controller

概述 Action getPara 系列方法 getModel 与 getBean 系列方法 setAttr 方法 getFile 文件上传 renderFile 文件下载 session 操作方法 render 系列方法

AOP

概述 Interceptor Before Clear Interceptor 的触发 Duang、Enhancer Inject 拦截器

ActiveRecord

概述 ActiveRecordPlugin Model JavaBean 与 Model 合体 JFinal 独创 Db + Record 模式声明式事务 Cache Dialect 多数据库支持表关联操作复合主键 Oracle 支持多数据源支持非 web 环境下使用 ActiveRecord

EhCachePlugin

概述 EhCachePlugin CacheInterceptor EvictInterceptor CacheKit ehcache.xml 简介

RedisPlugin

概述 RedisPlugin Redis 与 Cache 非 web 环境使用 RedisPlugin

Validator

概述 Validator Validator 配置

国际化

概述 I18n 与 Res I18nInterceptor

FreeMarker

概述 FreeMarker 示例在 JFinal 中扩展

JFinal 架构及扩展

概述架构

JFinal在线手册

更新时间2022-04-11

configConstant(Constants me) configPlugin (Plugins me)

此方法用来配置 JFinal 访问路由，如下代码配置了将”/hello”映射到 HelloController 这个控制器，通过以下的配置， http://localhost/hello 将访问 HelloController.index() 方法，而 http://localhost/hello/methodName 将访问到 HelloController.methodName()方法。

public void configRoute(Routes me)
{ me.add("/hello",
HelloController.class);

Routes 类主要有如下两个方法：

public Routes add(String controllerKey, Class<? extends Controller>
controllerClass, String viewPath)

public Routes add(String controllerKey, Class<? extends Controller>

controllerClass)

第一个参数 controllerKey 是指访问某个 Controller 所需要的一个字符串，该字符串唯一对应一个 Controller，controllerKey 仅能定位到 Controller。第二个参数 controllerClass 是该 controllerKey 所对应到的 Controller。第三个参数 viewPath 是指该 Controller 返回的视图的相对路径(该参数具体细节将在 Controller 相关章节中给出)。当 viewPath 未指定时默认值为 controllerKey。

JFinal 路由规则如下表：

QQ截图20170206095411.png

从表中可以看出，JFinal 访问一个确切的Action(Action 定义见 3.2 节)需要使用 controllerKey与 method 来精确定位，当method 省略时默认值为 index。urlPara 是为了能在 url 中携带参数值，urlPara 可以在一次请求中同时携带多个值，JFinal 默认使用减号“-”来分隔多个值（可通过constants. setUrlParaSeparator(String)设置分隔符），在 Controller 中可以通过 getPara(intindex)分别取出这些值。controllerKey、method、urlPara 这三部分必须使用正斜杠“/”分隔。注意，controllerKey 自身也可以包含正斜杠“/”，如“/admin/article”，这样实质上实现了struts2 的 namespace 功能。

JFinal 在以上路由规则之外还提供了 ActionKey 注解，可以打破原有规则，以下是代码示例：

public class UserController extends Controller {
@ActionKey("/login")
public void login()
{ render("login.html");
}

假定 UserController 的 controllerKey 值为“/user”，在使用了@ActionKey(“/login”)注解以后，actionKey 由原来的“/user/login”变为了“/login”。该注解还可以让 actionKey 中使用减号或数字等字符，如“/user/123-456”。

如果 JFinal 默认路由规则不能满足需求，开发者还可以根据需要使用 Handler 定制更加个性化的路由，大体思路就是在 Handler 中改变第一个参数 String target 的值。

JFinal 路由还可以进行拆分配置，这对大规模团队开发特别有用，以下是代码示例：

public class FrontRoutes extends Routes {

public void config(){

add("/",IndexController.class);

add("/blog", BlogController.class);

}

}

public class AdminRoutesextends Routes{

public void config(){

add("/admin",AdminController.class);

add("/admin/user", UserController.class);

}

}

public class MyJFinalConfigextends JFinalConfig{

publicvoid configRoute(Routesme)

{ me.add(new FrontRoutes()); // 前端路由

me.add(new AdminRoutes()); // 后端路由

}

public void configConstant(Constantsme) {}

public void configPlugin(Pluginsme) {}

public void configInterceptor(Interceptorsme) {}

public void configHandler(Handlersme) {}

}

如上三段代码，FrontRoutes 类中配置了系统前端路由，AdminRoutes 配置了系统后端路由， MyJFinalConfig.configRoute(…)方法将拆分后的这两个路由合并起来。使用这种拆分配置不仅可以让 MyJFinalConfig 文件更简洁，而且有利于大规模团队开发，避免多人同时修改 MyJFinalConfig 时的版本冲突。

configConstant(Constants me) configPlugin (Plugins me)