目录
第 0 章 极速升级至 2.0 ..................................................................................................................................... 6
0.1 AOP 升级 ................................................................................................................................................... 6
0.2 ActiveRecord 升级 ..................................................................................................................................... 6
0.3 其它部分升级 .......................................................................................................................................... 6
第一章 快速上手 ............................................................................................................................................... 7
1.1 创建项目 .................................................................................................................................................. 7
1.2 放入 JFinal 库文件 ................................................................................................................................. 10
1.3 修改 web.xml ......................................................................................................................................... 10
1.4 添加 java 文件 ....................................................................................................................................... 10
1.5 启动项目 ................................................................................................................................................ 11
1.6 开启浏览器看效果 ................................................................................................................................ 12
第二章 JFinalConfig .......................................................................................................................................... 13
2.1 概述 ........................................................................................................................................................ 13
2.2 configConstant(Constants me) ................................................................................................................ 13
2.3 configRoute(Routes me) .......................................................................................................................... 13
2.4 configPlugin (Plugins me) ........................................................................................................................ 16
2.5 configInterceptor (Interceptors me) ....................................................................................................... 16
2.6 configHandler (Handlers me) .................................................................................................................. 16
2.7 afterJFinalStart()与 beforeJFinalStop() .................................................................................................... 17
2.8 PropKit ..................................................................................................................................................... 17
第三章 Controller ............................................................................................................................................. 18
3.1 概述 ........................................................................................................................................................ 18
3.2 Action ....................................................................................................................................................... 18
3.3 getPara 系列方法 .................................................................................................................................... 18
3.4 getModel 系列方法 ................................................................................................................................ 19
3.5 getFile 文件上传 ..................................................................................................................................... 20
3.6 setAttr 方法 ............................................................................................................................................. 21
3.7 session 操作方法 .................................................................................................................................... 21
3.8 render 系列方法 ..................................................................................................................................... 21
第四章 AOP ...................................................................................................................................................... 23
4.1 概述 ........................................................................................................................................................ 23
4.2 Interceptor ............................................................................................................................................... 23
4.3 Before ...................................................................................................................................................... 24
4.4 Clear ......................................................................................................................................................... 25
4.5 Interceptor 的触发 .................................................................................................................................. 27
4.6 Duang、Enhancer ................................................................................................................................... 28
4.7 Inject 拦截器 ........................................................................................................................................... 28
第五章 ActiveRecord ........................................................................................................................................ 30
5.1 概述 ........................................................................................................................................................ 30
5.2 ActiveRecordPlugin .................................................................................................................................. 30
5.3 Model....................................................................................................................................................... 30
5.4 JFinal 独创 Db + Record 模式 ................................................................................................................. 32
5.5 声明式事务 ............................................................................................................................................ 33
5.6 Cache ....................................................................................................................................................... 34
5.7 Dialect 多数据库支持 ............................................................................................................................. 34
5.8 表关联操作 ............................................................................................................................................ 34
5.9 复合主键 ................................................................................................................................................ 35
5.10 Oracle 支持 ........................................................................................................................................... 36
5.11 多数据源支持 ...................................................................................................................................... 37
5.12 非 web 环境下使用 ActiveRecord ....................................................................................................... 39
第六章 EhCachePlugin ..................................................................................................................................... 41
6.1 概述 ........................................................................................................................................................ 41
6.2 EhCachePlugin ......................................................................................................................................... 41
6.3 CacheInterceptor ..................................................................................................................................... 41
6.4 EvictInterceptor ....................................................................................................................................... 42
6.5 CacheKit ................................................................................................................................................... 42
6.6 ehcache.xml 简介 .................................................................................................................................... 43
第七章 RedisPlugin .......................................................................................................................................... 44
7.1 概述 ........................................................................................................................................................ 44
7.2 RedisPlugin .............................................................................................................................................. 44
7.3 Redis 与 Cache......................................................................................................................................... 44
7.4 非 web 环境使用 RedisPlugin ............................................................................................................... 45
第八章 Validator .............................................................................................................................................. 46
8.1 概述 ........................................................................................................................................................ 46
8.2 Validator .................................................................................................................................................. 46
8.3 Validator 配置 ......................................................................................................................................... 46
第九章 国际化 ................................................................................................................................................. 48
9.1 概述 ........................................................................................................................................................ 48
9.2 I18n 与 Res .............................................................................................................................................. 48
9.3 I18nInterceptor ....................................................................................................................................... 49
第十章 FreeMarker 基础 ................................................................................................................................. 51
10.1 概述 ...................................................................................................................................................... 51
10.2 FreeMarker 示例 ................................................................................................................................... 51
10.3 在 JFinal 中扩展 ................................................................................................................................... 51
第十一章 JFinal 架构及扩展 ........................................................................................................................... 52
11.1 概述 ...................................................................................................................................................... 52
11.2 架构 ...................................................................................................................................................... 52
摘要
JFinal 是基于 Java 语言的极速 WEB + ORM 开发框架，其核心设计目标是开发迅速、代
码量少、学习简单、功能强大、轻量级、易扩展、Restful。在拥有 Java 语言所有优势的同时
再拥有 ruby、python、php 等动态语言的开发效率！为您节约更多时间，去陪恋人、家人和朋
友 : )
JFinal 有如下主要特点：
MVC 架构，设计精巧，使用简单
遵循 COC 原则，零配置，无 xml
独创 Db + Record 模式，灵活便利
ActiveRecord 支持，使数据库开发极致快速
自动加载修改后的 java 文件，开发过程中无需重启 web server
AOP 支持，拦截器配置灵活，功能强大
Plugin 体系结构，扩展性强
多视图支持，支持 FreeMarker、JSP、Velocity
强大的 Va lidator 后端校验功能
功能齐全，拥有 struts2 绝大部分核心功能
体积小仅 303K，且无第三方依赖
JFinal 官方网站：http://www.jfinal.com
JFinal QQ 群: 335699801、326297041、424949661、38707273
JFinal 官方微信:
