写这篇简短的博文,并不是要故意贬低开源项目,而且我没必要这么做,因为本人并没有写这一类的开源框架,不会形成竞争。
写这篇文章,我是从个人的真实感受去写的。本人敢说,JFinal框架还是一个不错的MVC框架,而且ORM和支持多种数据库,相比Servlet那可配置简单、功能强大的多的去了,比如JDBC操作、事务支持、ORM、AOP、JSON等。
首先建立一个Maven Web项目:
Maven pom.xml加入JFinal包、数据库连接池等:
建立个包包,写几个Java代码吧:
建一个包:com.rocbin.jfinal
然后建立一个包config,写一个集成JFinalConfig的配置类:
configConstant方法是必须要写一点东西的,基本上也没什么,它可以配置视图设置、字符编码、是否开发模式等几个。
configPlugin 方法呢主要配置JFinal内置的插件和我们自己的插件,让这些插件跟随系统启动和停止。
configRoute 是必须的,他做的事情就是将你的Controller 配置映射到某些你要的URL上面。
configInterceptor 呢,这个要看你怎么用了,比如你可以用这个来实现Shiro拦截URL请求权限等。
configHandler呢,你可以做更多的事情了,这可以拦截一切请求,包括不被JFinal Controller处理的请求类型,如果你希望使用ContextPath这个变量,而你希望他的名字是ctx,你希望在jsp页面里面使用${ctx}来输出web上下文路径,就可以自定义一个Handler处理来实现的。
然后我们来建立一个Model吧,我们要做的是简单的用户注册、用户列表和用户中心。
建一个包models,建立一个SystemUser的类:
我是这样写Model的,我自己留了一手,先像写Bean一样写完里面的字段属性,然后呢再通过IDEA的LiveTemplate我自己定义的模板快速完成getter和setter,最后写上几个需要的DAO方法。我不喜欢那种定义个字段名的写法,因为我感觉那样子并没有我这么写的getter/setter方便。
被注释掉的那些属性,我就是为了随时替换掉Model而保留的,实际上然并卵,不如直接用工具生成实体类呢,更何况数据库又是100%和Bean对应的字段名,而且都是我设计的。
几个月前曾在OSC上面问答向作者 @JFinal 反馈过这个java.util.Date兼容性的问题:
https://www.oschina.net/question/1269352_2197692
不知道是不是作者太自信了,没有深入研究这个问题的存在与否。
为了证实这个问题的存在,我之前一直用的jtds驱动,在写这篇博客的时候我怀疑过是否jtds引起的,然后换了microsoft的驱动sqljdbc4.jar来测试,发现ActiveRecord insert的时候还是有问题。
我使用的是sql server2008 R2数据库,这个问题困扰了我大半年了,我头疼得很,我尝试了好几种方法,最后选择上面的解决办法,幸好java.sql.Timestamp是java.util.Date的子类。
好了,我们继续吧。
我们写完了Model,充血模型他就充当了实体类和DAO,现在可以写Service了,Service少不了的,不建议直接使用DAO来做事情,因为你很难保证别人是否有些逻辑在此DAO相应的Service里面控制的。
建立一个包services:
比较简单的一个Service,我用@NotNull和@Nullable 来规范这个属性是否可以传入null值(传入null的时候可能是可选的参数),而且IDE也会有相应的提示的。
基本上没什么,就在addUser加了一个事务,没错,这就是JFinal为我们提供的一种简便的控制数据库事务的方式,JFinal 自己会处理好这些事务嵌套的情况,如果外层事务是READ_COMMITED而内层事务是SERIABLIZABLE的话,JFinal会自动提升Connection的事务级别为SERIALIZABLE。JFinal的Connection基于ThreadLocal实现的,她不会有Spring的事务传播一说。另外JFinal的事务也可以在Controller上面加注解实现的@Before(value={TxSerializable.class})在你的Controller Class或者Controller方法之上,JFinal Tx的包在com.jfinal.plugin.activerecord.tx。
然后建立一个Controller类:
Controller 主要实现几个功能:首页index、用户注册页面registry、用户列表list、添加用户接口add、用户中心home。
剩下的几个jsp页面,代码都比较简单,为了一点点的容颜,就用bootstrap来修饰一下吧。
第一个页面 首页index.jsp:
上面只要就两个按钮,一个点击跳转到用户列表页,另一个是点击跳转到用户注册页。
页面截图:
第二个页面是 用户列表页user-list.jsp:
这个页面就主要展示系统里面所有的用户信息,我不考虑分页实现,因为这里没必要做分页,如果你想要做分页,在JFinal里面,model或record都有一个分页查询的方法paginate。
页面截图:
第三个页面:用户注册页面 registry.jsp:
我一个javascript也没写,数据校验都忽略了,正常情况下最好先用javascript做一次校验,然后在后端也要对表单填写的数据进行一次严格的校验(这个你必须要这么做、否则就呵呵哒)。
效果截图:
第四个页面是用户中心 user-home.jsp:
这个页面都比较简单的,上面显示的数据都是JFinal处理过的,jsp页面直接用el表达式处理输出,我有考虑过XSS问题,但这里只是个例子,不考虑例如user.profile内容里面可能会出现有XSS(XSS很危险,如果你不了解就赶紧去补补)的问题。
页面截图:
基本上,JFinal完成的这个简单的需求就这要这些代码,没有XML配置、不会繁琐。
实际上,我好像写了一篇JFinal的入门教程,跟JFinal官方的blog很是类似。
前面的片段也有说了几个不爽的"bug",
虽然我自己写过一个类用于启动WebConfig、Plugins。但是Controller你永远也只能启动Tomcat来测试,因为他内部依赖了Request、Response(这是servlet-api的,而Spring MVC是很不错的、他还有一个Model,虽然我只是刚入门)。
如果你要用了EhCache、CacheKit,要做一个测试简直就有噩梦,烦死人的找不到ehcache.xml文件的问题,只能每个人都改一改才可以,CacheKit的init方法是package可见级别的,为了EhCache能启动我也是豁出去了,不用Plugins,自己new EhCacheMange(file)然后用反射暴力了CacheKit的init方法。
没有依赖注入的日子里,我得靠着Holder、单例来过着写代码的日子,虽然可以简单的解决问题,但也带来烦恼,我宁愿有一个IOC容器。
如果有IOC,那是不是可以将JFinal的Duang做进去呢,AOP做到业务层上而不再仅限于Controller,然后顺便也把Spring 事务吸收下,把Db.tx 减少下使用频率,反而变得简单了。
我喜欢用注解,注解可以代替XML完成模块装配,JFinal官方可以多加一些注解,比如扫描Controller配置、依赖注入、Model映射等(我知道有非官方出品的)。
JFinal的Controller还是要吐槽一下,getPara、getParaToXXX是一个繁琐API,像Spring MVC他支持action方法参数注入,而且还可以扩展一下比如自动做数据校验等(如果你写JSON API服务呢……),而且可以注入Request、Response实例,从而可以解决JFinal Controller硬性依赖Request、Response的问题。
我认为这是一个bug,他不支持render null,一旦业务返回结果null,renderJson就会报错。而实际上json是支持传递null的(我测试过在浏览器中)。
很不爽吧,逼得你非得要加个判断(我不确定最新的版本是否解决了这个问题,我写这篇文章用的是2.0,我项目用的1.9都有这个问题)。
我发现,当我的SystemUser表里面没有数据的时候,插入第一笔数据他返回的主键的数据类型不是我期望的int类型,而是BigDecimal,这个也非常麻烦,怎么会遇到这个问题呢?刚刚试了一下,没有重现,抱歉。
JFinal 要有更多的人来支持才能做得更好,虽然你打着极速开发的旗帜,但也不要太过Geek,和Spring背着走,要吸取一些优秀的精华,另外,JFinal的JavaEE框架集成都比较麻烦,要自己来写着(去年搞定了Activiti工作流集成到JFinal数据源中,但至今也不敢打保票不会出现BUG),MyBatis想集成到JFinal中,感觉就是噩梦,做集成算了我不如研究下SpringMVC外加集成我想要的框架(前几个晚上就搞定了)。
文中涉及到大量代码,详情请点击“阅读原文”查看。