出处:https://www.cnblogs.com/huanzi-qch
序言逃离北上广从广州回老家南宁,入职这家公司用的技能是JFinal,借此机会得以学习这个国产的MVC框架,经由一段韶光的学习,基于之前的履历搭建一个通用项目jfinal-demo
jfinal-demo是基于JFinal封装的一个大略通用项目,一套通用代码,实现增编削查分页等根本功能,单表模块通过继续通用模块实现该根本功能,通过代码天生器可快速天生全套单表代码。

技能栈:JFinal + MySql
JFinal先容JFinal已连续多次得到GVP Gitee最有代价开源项目,gitee地址:https://gitee.com/jfinal/jfinal
JFinal官方文档:https://jfinal.com/doc
JFinal官方简介:
JFinal 是基于 Java 措辞的极速 WEB + ORM + AOP + Template Engine 框架,其核心设计目标是开拓迅速、代码量少、学习大略、功能强大、轻量级、易扩展、Restful。在拥有Java措辞所有上风的同时再拥有ruby、python、php等动态措辞的开拓效率!
为您节约更多韶光,去陪恋人、家人和朋友 :)
JFinal有如下紧张特点: MVC架构,设计风雅,利用大略 遵照COC原则,支持零配置,无xml 独创Db + Record模式,灵巧便利 ActiveRecord支持,使数据库开拓极致快速 自动加载修正后的java文件,开拓过程中无需重启web server AOP支持,拦截器配置灵巧,功能强大 Plugin体系构造,扩展性强 多视图支持,支持FreeMarker、JSP、Velocity 强大的Validator后端校验功能 功能完好,拥有struts2的绝大部分功能 体积小仅 723 KB,且无第三方依赖
代码编写项目构造
jfinal.bat、jfinal.sh是启动脚本
通用代码包括统一返回工具Result,分页条件PageCondition,掌握层CommonController,业务层CommonService/Impl
数据库表与实体类的关系映射须要在_MappingKit中手动进行掩护(实在也可以做成自动掩护,只是我们的代码天生器还不支持)
/ 数据表、主键、实体类关系映射 须要手动掩护 /public class _MappingKit { / 表、实体、主键关系凑集 方便SqlUtil工具类拼接查询sql / public static HashMap<String,String> tableMapping = new HashMap<>(); public static HashMap<String,String> primaryKeyMapping = new HashMap<>(); public static void mapping(ActiveRecordPlugin arp) { arp.addMapping("blog", "id", Blog.class); tableMapping.put(Blog.class.getName(),"blog"); primaryKeyMapping.put(Blog.class.getName(),"id"); arp.addMapping("user", "user_id", User.class); tableMapping.put(User.class.getName(),"user"); primaryKeyMapping.put(User.class.getName(),"user_id"); }}
表字段全部在BaseModel中(禁止改动)
/ 博客表 BaseModel 作者:Auto Generator By 'huanzi-qch' 天生日期:2021-07-26 09:31:41 /@SuppressWarnings("serial")public abstract class BaseBlog<M extends BaseBlog<M>> extends Model<M> implements IBean { //博客id private Integer id; public void setId(Integer id) { this.id = id; set("id", this.id); } public Integer getId() { this.id = get("id"); return this.id; } //博客标题 private String title; public void setTitle(String title) { this.title = title; set("title", this.title); } public String getTitle() { this.title = get("title"); return this.title; } //博客内容 private String content; public void setContent(String content) { this.content = content; set("content", this.content); } public String getContent() { this.content = get("content"); return this.content; } //用户id private String userId; public void setUserId(String userId) { this.userId = userId; set("user_id", this.userId); } public String getUserId() { this.userId = get("user_id"); return this.userId; }}
如果须要加与数据库表无关属性(例如方便接口接参,添加其他属性),在Model添加,其余,表关联也可以在这里掩护
/ 博客表 Model 作者:Auto Generator By 'huanzi-qch' 天生日期:2021-07-26 09:31:41 /@SuppressWarnings("serial")public class Blog extends BaseBlog<Blog> { public static final Blog dao = new Blog().dao(); / 表关联操作在这里掩护 User.userId = Blog.userId / public Result<User> getUser(String userId){ UserServiceImpl userService = Aop.get(UserServiceImpl.class); return userService.get(userId); }}
拦截器实现Controller层全局非常处理
/ Controller层全局非常处理 分外情形外,禁止捕获非常,所有非常都应交给这里处理 /public class GlobalExceptionInterceptor implements Interceptor{ private static Log log = Log.getLog(GlobalExceptionInterceptor.class); public void intercept(Invocation inv) { Result result = null; try { inv.invoke(); } //业务非常 catch (ServiceException e){ e.printStackTrace(); result = Result.error(e.getErrorEnum()); } //空指针、造孽参数 catch (NullPointerException | IllegalArgumentException e){ e.printStackTrace(); result = Result.error(ErrorEnum.INTERNAL_SERVER_ERROR); } //... //未知非常(放在末了) catch (Exception e){ e.printStackTrace(); result = Result.error(ErrorEnum.UNKNOWN); } if(StrKit.notNull(result)){ inv.getController().renderJson(result); } }}
须要在AppConfig中配置Routes级别全局拦截器
/ 配置路由 / public void configRoute(Routes me) { // 扫描仅会在该包以及该包的子包下进行 me.scan("cn.huanzi.qch."); //该方法用于配置是否要将掌握器父类中的 public方法映射成 action me.setMappingSuperClass(true); // 此处配置 Routes 级别的拦截器,可配置多个 me.addInterceptor(new GlobalExceptionInterceptor()); }
所有的非常信息都该当在ErrorEnum中掩护
/ 自定义非常列举类 /public enum ErrorEnum { //自定义系列 USER_NAME_IS_NOT_NULL(10001,"【参数校验】用户名不能为空"), PWD_IS_NOT_NULL(10002,"【参数校验】密码不能为空"), //400系列 BAD_REQUEST(400,"要求的数据格式不符!"), UNAUTHORIZED(401,"登录凭据过期!"), FORBIDDEN(403,"抱歉,你无权限访问!"), NOT_FOUND(404, "要求的资源找不到!"), //500系列 INTERNAL_SERVER_ERROR(500, "做事器内部缺点!"), SERVICE_UNAVAILABLE(503,"做事器正忙,请稍后再试!"), //未知非常 UNKNOWN(10000,"未知非常!"); / 缺点码 / private Integer code; / 缺点描述 / private String msg; ErrorEnum(Integer code, String msg) { this.code = code; this.msg = msg; } public Integer getCode() { return code; } public String getMsg() { return msg; }}
测试接口
Controller public void errorTest(){ throw new ServiceException(ErrorEnum.USER_NAME_IS_NOT_NULL); } public void errorTest2(){ renderJson(blogService.errorTest2()); } public void errorTest3(){ renderJson(blogService.errorTest3()); } ServiceImpl @Override public String errorTest2() { int i = 1/0; return "失落败乃成功之母!
"; } @Override public String errorTest3() { throw new NullPointerException(); }
自定义要求处理器
/ 自定义处理器 /public class MyActionHandler extends Handler { public MyActionHandler() { } @Override public void handle(String target, HttpServletRequest request, HttpServletResponse response, boolean[] isHandled) { //运用路径 request.setAttribute("ctx", request.getContextPath()); Action action = JFinal.me().getAction(target, new String[]{null}); boolean flag = false; List<String> allActionKeys = JFinal.me().getAllActionKeys(); if(!allActionKeys.contains(target)){ int i = target.lastIndexOf(47); if (i != -1) { String substring = target.substring(0, i); if (!allActionKeys.contains(substring) || action.getControllerPath().equals(substring)) { flag = true; } } } / 404 其他静态资源可直接访问,但.html页面禁止直接访问 / if ((target.contains(".html") || !target.contains(".")) && flag) { try { response.setCharacterEncoding("UTF-8"); response.setContentType("application/json; charset=utf-8"); PrintWriter out = response.getWriter(); out.print(JsonKit.toJson(Result.error(ErrorEnum.NOT_FOUND))); out.flush(); out.close(); response.flushBuffer(); } catch (IOException e) { e.printStackTrace(); } }else{ this.next.handle(target, request, response, isHandled); } }}
效果演示 get
id不存在新增
id存在则更新
delete
一个大略页面,包括CRUD、分页
非常处理
统一Controller层接口非常处理
非controller接口缺点,会跳转去配置好的500.html页面
后记习气了Spring百口桶,一时可能接管不了JFinal的风格,经由改造封装,jfinal-demo项目的编程风格只管即便与我们之前的习气同等
JFinal的生态远没有SpringBoot的好,碰到问题基本上靠百度是搜不到什么办理方案的,好在这个框架并不繁芜,依赖的东西也很少,大部分都可以按照须要进行魔改、扩展