配置

基于 JFinal 的 web 项目需要创建一个继承自 JFinalConfig 类的子类，该类用于对整个 web项目进行配置。

JFinalConfig 子类需要实现五个抽象方法，如下所示：

public class DemoConfigextends JFinalConfig
    { publicvoid configConstant(Constants me)
    {} public void configRoute(Routesme) {} 
    publicvoid configPlugin(Plugins me) {}
    public void configInterceptor(Interceptors me) {}
    public void configHandler(Handlersme) {}
}

配置常量（常量me）

此方法用来配置 JFinal 常量值，如开发模式常量 devMode 的配置，默认视图类型 ViewType的配置，如下代码配置了 JFinal 运行在开发模式下且默认视图类型为 JSP：

public void configConstant(Constantsme)
     { me.setDevMode(true); 
    me.setViewType(ViewType.JSP);
}

在开发模式下，JFinal 会对每次请求输出报告，如输出本次请求的 Controller、Method 以及请求所携带的参数。JFinal 支持 JSP、FreeMarker、Velocity 三种常用视图。

配置路由（路由 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 路由规则如下表：

url 组成	访问目标
controllerKey	YourController.index()
controllerKey/method	YourController.method()
controllerKey/method/v0-v1	YourController.method()，所带 url 参数值为：v0-v1
controllerKey/v0-v1	YourController.index()，所带 url 参数值为：v0-v1

从表中可以看出，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 时的版本冲突。

配置插件（Plugins me）

此方法用来配置 JFinal 的 Plugin，如下代码配置了 C3p0 数据库连接池插件与 ActiveRecord数据库访问插件。通过以下的配置，可以在应用中使用 ActiveRecord 非常方便地操作数据库。

public void configPlugin(Pluginsme)
     { loadPropertyFile("your_app_config.txt");
    C3p0Plugin c3p0Plugin = new C3p0Plugin(getProperty("jdbcUrl"), getProperty("user"), getProperty("password"));
    me.add(c3p0Plugin);
    ActiveRecordPlugin arp = new ActiveRecordPlugin(c3p0Plugin);me.add(arp);
    arp.addMapping("user",User.class);

JFinal 插件架构是其主要扩展方式之一，可以方便地创建插件并应用到项目中去。

拦截器（拦截器配置）

此方法用来配置 JFinal 的全局拦截器，全局拦截器将拦截所有 action 请求，除非使用@Clear 在 Controller 中清除，如下代码配置了名为 AuthInterceptor 的拦截器。

public void configInterceptor(Interceptorsme)
     { me.add(newAuthInterceptor());
}

JFinal 的 Interceptor 非常类似于 Struts2，但使用起来更方便，Interceptor 配置粒度分为 Global、Class、Method 三个层次，其中以上代码配置粒度为全局。Class 与 Method 级的 Interceptor 配置将在后续章节中详细介绍。

处理程序（Handlers me）

此方法用来配置 JFinal 的 Handler，如下代码配置了名为 ResourceHandler 的处理器，Handler 可以接管所有 web 请求，并对应用拥有完全的控制权，可以很方便地实现更高层的功能性扩展。

public void configHandler(Handlers me) { 
    me.add(new ResourceHandler());
}

afterJFinalStart()与 beforeJFinalStop()

JFinalConfig 中的 afterJFinalStart()与 beforeJFinalStop()方法供开发者在 JFinalConfig 继承类中覆盖。

JFinal 会在系统启动完成后回调 afterJFinalStart() 方法，会在系统关闭前回调 beforeJFinalStop()方法。

这两个方法可以很方便地在项目启动后与关闭前让开发者有机会进行额外操作，如在系统启动后创建调度线程或在系统关闭前写回缓存。

PropKit

PropKit 工具类用来操作外部配置文件。PropKit 可以极度方便地在系统任意时空使用，如下是示例代码：

public class AppConfigextends JFinalConfig{
    public void configConstant(Constantsme) {
        // 第一次使用use加载的配置将成为主配置，可以通过PropKit.get(...)直接取值     PropKit.use("a_little_config.txt");
        me.setDevMode(PropKit.getBoolean("devMode"));
}
    public void configPlugin(Pluginsme) {
    // 非第一次使用use加载的配置，需要通过每次使用use来指定配置文件名再来取值 String redisHost= PropKit.use("redis_config.txt").get("host"); int     redisPort= PropKit.use("redis_config.txt").getInt("port"); RedisPlugin rp =new RedisPlugin("myRedis", redisHost, redisPort);me.add(rp);

    // 非第一次使用 use加载的配置，也可以先得到一个Prop对象，再通过该对象来获取值 Prop p =PropKit.use("db_config.txt");
    DruidPlugin dp = new DruidPlugin(p.get("jdbcUrl"), p.get("user")…); me.add(dp);
}
}

如上代码所示，PropKit 可同时加载多个配置文件，第一个被加载的配置文件可以使用 PorpKit.get(…)方法直接操作，非第一个被加载的配置文件则需要使用 PropKit.use(…).get(…) 来操作。

PropKit 的使用并不限于在 YourJFinalConfig 中，可以在项目的任何地方使用， JFinalConfig 的 getProperty 方法其底层依赖于 PropKit 实现。

配置

配置