開篇 概述
基於JFinal的web項目需要創建一個繼承自JFinalConfig類的子類，該類用於對整個web項目進行配置。
JFinalConfig子類需要實現六個抽象方法，如下所示：
public class DemoConfig extends JFinalConfig { public void configConstant(Constants me) {} public void configRoute(Routes me) {} public void configEngine(Engine me) {} public void configPlugin(Plugins me) {} public void configInterceptor(Interceptors me) {} public void configHandler(Handlers me) {} }
詳解
1.configConstant(..)
此方法用來配置JFinal常量值，如開發模式常量devMode的配置，如下代碼配置了JFinal運行在開發模式
public void configConstant(Constants me) { //開發者模式 me.setDevMode(true); }
在開發模式下，JFinal會對每次請求輸出報告，如輸出本次請求的URL、Controller、Method以及請求所攜帶的參數。
2.configRoute(..)
此方法用來配置訪問路由，如下代碼配置了將 "/hello" 映射到HelloController這個控制器，通過以下的配置，http://localhost/hello 將訪問 HelloController.index() 方法，而http://localhost/hello/methodName 將訪問到 HelloController.methodName() 方法。
public void configRoute(Routes me) { me.setBaseViewPath("/view"); me.addInterceptor(new FrontInterceptor()); me.add("/hello", HelloController.class); }
Routes.setBaseViewPath(baseViewPath)方法用於為該Routes 內部的所有Controller設置視圖渲染時的基礎路徑，該基礎路徑與Routes.add(…, viewPath)方法傳入的viewPath以及 Controller.render(view) 方法傳入的 view 參數聯合組成最終的視圖路徑，規則如下：
finalView = baseViewPath + viewPath + view
注意：當view以 “/” 字符打頭時表示絕對路徑，baseViewPath 與 viewPath 將被忽略。
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路由規則如下表：
從表中可以看出，JFinal訪問一個確切的Action(Action定義見3.2節)需要使用controllerKey與method來精確定位，當method省略時默認值為index。urlPara是為了能在url中攜帶參數值，urlPara可以在一次請求中同時攜帶多個值，JFinal默認使用減號“-”來分隔多個值（可通過constants. setUrlParaSeparator(String)設置分隔符），在Controller中可以通過getPara(int index)分別取出這些值。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() { setBaseViewPath("/view/front"); add("/", IndexController.class); add("/blog", BlogController.class); } }
public class AdminRoutes extends Routes { public void config() { setBaseViewPath("/view/admin"); addInterceptor(new AdminInterceptor()); add("/admin", AdminController.class); add("/admin/user", UserController.class); } }
public class MyJFinalConfig extends JFinalConfig { public void configRoute(Routes me) { me.add(new FrontRoutes()); // 前端路由 me.add(new AdminRoutes()); // 后端路由 } public void configConstant(Constants me) {} public void configEngine(Engine me) {} public void configPlugin(Plugins me) {} public void configInterceptor(Interceptors me) {} public void configHandler(Handlers me) {} }
如上三段代碼，FrontRoutes類中配置了系統前端路由，AdminRoutes配置了系統后端路由，MyJFinalConfig.configRoute(…)方法將拆分后的這兩個路由合並起來。使用這種拆分配置不僅可以讓MyJFinalConfig文件更簡潔，而且有利於大規模團隊開發，避免多人同時修改MyJFinalConfig時的版本沖突。
FrontRoutes與AdminRoutes中分別使用setBaseViewPath(…)設置了各自Controller.render(view)時使用的baseViewPath。
AdminRoutes 還通過addInterceptor(new AdminInterceptor())添加了Routes級別的攔截器，該攔截器將攔截AdminRoutes中添加的所有Controller，相當於業務層的inject攔截器，會在class攔截器之前被調用。這種用法可以避免在后台管理這樣的模塊中的所有class上使用@Before(AdminInterceptor.class)，減少代碼冗余。
3.configEngine(..)
此方法用來配置Template Engine，以下是代碼示例：
public void configEngine(Engine me) { me.addSharedFunction("/view/common/layout.html"); me.addSharedFunction("/view/common/paginate.html"); me.addSharedFunction("/view/admin/common/layout.html"); }
上面的方法向模板引擎中添加了三個定義了 template function 的模板文件
4.configPlugin(..)
加載插件此方法用來配置JFinal的Plugin，如下代碼配置了Druid數據庫連接池插件與ActiveRecord數據庫訪問插件。通過以下的配置，可以在應用中使用ActiveRecord非常方便地操作數據庫。
public void configPlugin(Plugins me) { DruidPlugin dp = new DruidPlugin(jdbcUrl, userName, password); me.add(dp); ActiveRecordPlugin arp = new ActiveRecordPlugin(dp); arp.addMapping("user", User.class); me.add(arp); }
JFinal插件架構是其主要擴展方式之一，可以方便地創建插件並應用到項目中去。
5.configInterceptor(..)
此方法用來配置JFinal的全局攔截器，全局攔截器將攔截所有 action 請求，除非使用@Clear在Controller中清除，如下代碼配置了名為AuthInterceptor的攔截器。
public void configInterceptor(Interceptors me) { me.add(new AuthInterceptor()); }
JFinal 的 Interceptor 非常類似於 Struts2，但使用起來更方便，Interceptor 配置粒度分為 Global、Inject、Class、Method四個層次，其中以上代碼配置粒度為全局。Inject、Class與Method級的Interceptor配置將在后續章節中詳細介紹。
6.configHandler(..)
此方法用來配置JFinal的Handler，如下代碼配置了名為ResourceHandler的處理器，Handler可以接管所有web請求，並對應用擁有完全的控制權，可以很方便地實現更高層的功能性擴展。
public void configHandler(Handlers me) { me.add(new ResourceHandler()); }
7.回調方法配置
在 JFinalConfig 繼承類中可以添加 afterJFinalStart() 與 beforeJFinalStop()，JFinal 會在系統啟動完成之后以及系統關閉之前分別回調這兩個方法：
// 系統啟動完成后回調 public void afterJFinalStart() { } // 系統關閉之前回調 public void beforeJFinalStop() { }
這兩個方法可以很方便地在項目啟動后與關閉前讓開發者有機會進行額外操作，如在系統啟動后創建調度線程或在系統關閉前寫回緩存 或 處理垃圾回收。
8.PropKit 讀取配置
PropKit工具類用來讀取外部鍵值對配置文件，PropKit可以極度方便地在系統任意時空使用，配置文件的格式如下：
userName=james email=no-reply@jfinal.com devMode=true
如下是 PropKit 代碼示例：
PropKit.use("config.txt");
String userName = PropKit.get("userName");
String email = PropKit.get("email");
// Prop 配合用法
Prop p = PropKit.use("config.txt");
Boolean devMode = p.getBoolean("devMode");
多種用法詳解：
如下是在項目中具體的使用示例：
public class AppConfig extends JFinalConfig { public void configConstant(Constants me) { // 第一次使用use加載的配置將成為主配置，可以通過PropKit.get(...)直接取值 PropKit.use("a_little_config.txt"); me.setDevMode(PropKit.getBoolean("devMode")); } public void configPlugin(Plugins me) { // 非第一次使用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 中，可以在項目的任何地方使用。此外PropKit.use(…)方法在加載配置文件內容以后會將數據緩存在內存之中，可以通過PropKit.useless(…)將緩存的內容進行清除。