JFinal快速入门笔记

1.基于JFinal的web项目需要创建一个JFinalConfig的子类,用于配置整个项目,子类需要实现留个抽象方法:

public class DemoConfig extends JFinalConfig{
public void configConstant(Contants me){}
public void configRoute(Routes me){}
public void configEngine(Engine me){}
public void configPlugin(Plugin me){}
public void configInterceptor(Interceptors me){}
public void configHandler(Handlers me){}
}

(1)configConstant(Constants me)方法用于配置JFinal常量值,比如开发模式常量devMod配置如下:

public void configConstant(Constants me){
me.setDevMode(true);
}

Contants其他方法:setUrlParaSeparator(String string)设置参数分隔符(默认为"-")

(2)configRoute(Routes me)方法用于配置JFinal访问路由

Routes.setBaseViewPath(baseViewPath)方法用于设置此Routes内部所有Controller试图渲染时的基础路径
finalView=baseViewPath+viewPath+view(view以"/"开头时表示绝对路径,此时忽略

Routes类添加路由方法:add(String controllerKey,Class<? extends Controller> controllerClass,String viewPath)
                                  add(String controllerKey,Class<? extends Controller> controllerClass)
                                  controllerKey 访问Controller所需字符串,此字符串与Controller一一对应
                                  controllerClasscontrollerKey对应的Controller类
                                  viewPath是Controller返回的视图的相对路径(未指定是默认值为controllerKey)
controllerKey--Controller.index()
controllerKey/method--Controller.method()
controllerKey/method/v0-v1--Controller.method(),参数值:v0、v1
controllerKey/v0-v1--Controller.index(),参数值:v0、v1
访问一个确切的Action需要通过controllerKey与method来精确定位(method省略时默认值为index)
controllerKey、method、urlPara三部分必须使用"/"分隔

以上路由规则之外有提供@ActionKey注解
如UserController的controllerKey值为"/user",方法login()使用@ActionKey("/login")注解之后actionKey由原来的"/user/login"变为"/login"

默认路由规则不满足需求,可以使用Handler定制个性化路由

JFinal路由还可以进行拆分配置:

public class FrontRoutes extends Routes{
public void config(){
setBaseViewPath("/view/front");
add("/",IndexController.class);
add("/blog",BlogController.class);
}
}

public class AdminRoutes extends Router{
public void config(){
setBaseViewPath("/view/admin");
addInterceptor(new AdimnInterceptor())://添加Routes级别的拦截器,该拦截器将拦截AdminRoutes中添加的的所有Controller
add("/admin",AdminController.class);
add("/admin/user",UserController.class);
}
}

public class MyFinalConfig extends JFinalConfig{
public void configRoute(Routes me){
me.add(new FrontRoutes());//前端路由
me.add(new AdminRoutes());//后端路由
}
public void configContant(Contants me){}
public void configEngine(Engine me){}
public void configPlugin(Plugins me){}
public void configInterceptor(Interceptors me){}
public void configHandler(Handler me){}
}

以上代码将系统前端路由和后端路由拆分配置,使用JFinalConfig的configRouter(Routes me)方法合并,文件更简洁,同时有利于大规模团队开发时避免版本冲突

(3)configEngine(Engine me)方法用于配置Template Engine
(4)configPlugin(Plugins me)方法用于配置Plugin
(5)configInterceptor(Interceptors me)方法用于配置JFinal的全局拦截器,全局拦截器拦截所有action请求,可以@Clear注解在Controller中清除

JFinal的Interceptor配置粒度分为Global、Inject、Class、Method

(6)configHandler(Handlers me)方法用于配置Handler
如下代码配置了名为ResourceHandler的处理器:

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

(7)afterJFinalStart()与beforeJFinalStop()
以上两个方法供开发者在JFinalConfig继承类中覆盖
JFinal会在系统启动完成后毁掉afterJFinalStart()方法,会在系统关闭前毁掉beforeJFinalStop()方法,可以很方便地在系统启动house与关闭前让开发者有机会进行额外操作,如在系统启动就创建调度线程或在系统关闭前写回缓存
(8)ProKit工具类用来操作外部配置文件
2.Controller--JFinal核心类之一,作为MVC模式中的控制器,基于JFinal的Web英语的控制器需要继承该类,时定义Action方法的地点,组织Action的一种方式,一个Controller可以包含多个Action,线程安全
(1)Action
Controller中定义的public无参方法成为一个Action,Action时请求的最小单位,必须在Controller中声明,必须是public且没有形参
Controller中提供getPara、getModel系列、setAttr、render系列方法供Action使用
(2)getPara系列方法--用于从请求中获取参数
两种类型:getPara(String name)--对HttpServletRequest.getParameter(String name)的封装
              getPara(int index)/getPara()
(第一个参数为String类型,则将获取表单或者url中文号挂餐的域值;第一个参数为int或者无参,将获取urlPara中的参数值)
getPara("title")--返回表单域名为"title"的参数值
getParaToInt("age")--返回表单域名为"age"的参数值并转为int类型
getPara(0)--返回url请求中的urlPara参数的第一个值
getParaToInt(1)--返回url请求中的urlPara参数的第二个值并转换为int类型
getPara()--返回url请求中urlPara参数的整体值

(3)getModel域getBean系列方法
getModel用来接收页面表单域传递过来的model对象,表单域名称以"modelName.attrName"方式命名(getModel使用的attrName必须与数据表字段名完全一样)
getBean用于支持传统的Java Bean