生成后的 Model 将与 java bean 合体，立即拥有了 getter、setter 方法，使之遵守传统的 java bean 规范，立即拥有了传统 JavaBean 所有的优势，开发过程中不再需要记忆字段名。

使用生成器通常只需配置 Generator 的四个参数即可，以下是具体使用示例：

baseModelPackageName、baseModelOutputDir、modelPackageName、modelOutputDir，四个参数分别表示 base model 的包名，baseModel 的输出路径，model 的包名，model 的输出路径。

由于后三个参数可以根据第一个参数来生成，所以通常只需要配置 modelPackageName 这一个参数即可。

可在官网下载 jfinal-demo 项目，其中的生成器可直接用于项目：http://www.jfinal.com

生成器的各部分组件都可以扩展，例如，MetaBuilder 可以指定 table 的过滤规则：

此外，生成器 Generator 提供了很多 setter 配置方法，可以很方便控制生成的结果，如下配置可以指定生成器依赖的模板文件：

以上代码可以用于指定生成器所依赖的模板文件，将模板文件放入 src/main/resources 目录下面可以被生成器获取到。定制模板文件一般需要在原有模板文件的基础之上做修改，原有模板文件在 jfinal 源码中有提供：https://gitee.com/jfinal/jfinal/tree/master/src/main/java/com/jfinal/plugin/activerecord/generator

后缀为 “.jf” 即为生成器所需的模板文件，里面所使用的语法为 enjoy 模板引擎语法。

2、相关生成文件

BaseModel 是用于被最终的 Model 继承的基类，所有的 getter、setter 方法都将生成在此文件内，这样就保障了最终 Model 的清爽与干净，BaseModel不需要人工维护，在数据库有任何变化时重新生成一次即可。

DataDictionary 是指生成的数据字典，会生成数据表所有字段的名称、类型、长度、备注、是否主键等信息。

Generator 内部工作流程由 MetaBuilder、ModelGenerator、BaseModelGenerator、MappingKitGenerator、DataDictionaryGenerator 组件组合而成，而这些组件都可以通过继承扩展，或者独立配置，然后再组装到 Generator 中，从而实现个性化的定制功能

jfinal 5.0.0 版本新增了 Generator.addBlacklist(blacklist) 以及 addWhitelist(whitelist) 两个方法，可以将需要生成的 table 添加到白名单或者黑名单，用法如下：

以下内容是 jfinal 5.0.0 版本之前的过滤、排除方式，不再建议使用：

下面代码通过配置 MetaBuilder 实现 table 过滤功能，过滤掉的 table 将不会生成相应的类与映射文件：

以上代码通过创建 MetaBuilder 对象，并单独对它进行 filter 配置，然后再通过 generator.setMetaBuilder(…) 将其注入到生成器之中，从而实现了 talbe 的定制化过滤。

注意：jfinal 4.9.05 版本之后，filter(…) 方法将更名为 skip(…);

除此之外，还可以通过继承 MetaBuilder、ModelGenerator、BaseModelGenerator 等等组件，然后再将其注入到生成器之中，实现更多的个性化功能。

4、使用生成器的主要优势

  • 充分利用海量的针对于 Bean 设计的第三方工具，例如 jackson、freemarker

  • BaseModel 设计令 Model 中依然保持清爽，在表结构变化时极速重构关联代码

  • 自动化 table 至 Model 映射

  • 自动化主键、复合主键名称识别与映射

  • MappingKit 承载映射代码，JFinalConfig 保持干净清爽

  • 有利于分布式场景和无数据源时使用 Model

  • 合体后 JSP 模板输出 Bean 中的数据将依赖其 getter 方法，输出的变量名即为 getter 方法去掉 ”get” 前缀字符后剩下的字符首字母变小写，如果希望 JSP 仍然使用之前的输出方式，可以在系统启动时调用一下 ModelRecordElResolver. setResolveBeanAsModel(true);

  • Controller 之中的 getModel() 需要表单域名称对应于数据表字段名，而 getBean() 则依赖于setter方法，表单域名对应于 setter 方法去掉 ”set” 前缀字符后剩下的字符串字母变小写。

  • 许多类似于 jackson、fastjson 的第三方工具依赖于 Bean 的 getter 方法进行操作，所以只有合体后才可以使用 jackson、fastjson

  • JFinalJson将 Model 转换为json数据时，json 的 keyName 是原始的数据表字段名，而 jackson、fastjson 这类依赖于 getter 方法转化成的 json 的 keyName 是数据表字段名转换而成的驼峰命名

  • 总之，合体后的 Bean 在使用时要清楚使用的是其 BaseModel 中的 getter、setter 方法还是其 Model 中的 get(String attrName) 方法

6、常见问题解决