悟空 CRM 9.0 发布，高品质 JFinal 开源项目

悟空CRM采用全新的前后端分离模式，本仓库代码中已集成前端vue打包后文件，可免去打包操作

如需调整前端代码，请单独下载前端代码，前端代码在根目录的ux文件夹中

主要技术栈

核心框架：jfinal3.8

缓存：redis caffeine

数据库连接池：Druid

工具类：hutool,fastjson,poi-ooxml

定时任务：jfinal-cron

项目构建工具：maven

Web容器：tomcat,undertow(默认)

前端MVVM框架：Vue.JS 2.5.x

路由：Vue-Router 3.x

数据交互：Axios

UI框架：Element-UI 2.6.3

悟空CRM是一个基于jfinal的开源crm系统，采用前后端分离的开发模式，提供了Aop，查询缓存，数据库连接池，定时器，excel导入导出等功能。

项目中主要有CRM，OA，项目管理，BI等模块，通过角色，部门，菜单实现了按钮级的功能权限控制和数据权限控制，通过将用户登录信息保存至redis来实现支持项目的热重启和分布式部署。

项目还拥有如下特性：

项目通过jfinal强大的AOP将权限判断从代码中抽离出来，用户无需手动判断登陆角色是否拥有权限，以下为通过权限注解在拦截器判断用户是否拥有访问权限

@Override public void intercept(Invocation invocation) { //TODO 权限功能后台拦截 Permissions permissions=invocation.getMethod().getAnnotation(Permissions.class); if(permissions!=null&&permissions.value().length>0){ JSONObject jsonObject= Aop.get(AdminRoleService.class).auth(BaseUtil.getUserId()); //组装应有权限列表 List<String> arr=queryAuth(jsonObject, ""); boolean isRelease=false; for (String key : permissions.value()) { if(!isRelease){ if(arr.contains(key)){ isRelease=true; } } } if(!isRelease){ invocation.getController().renderJson(R.error("无权访问")); return; } } invocation.invoke(); }

通过AOP和注解对数据进行非空校验，无需一个个判断参数是否为空，数据为空直接返回
自定义分页数据接收，自动处理分页参数和数据对象，给controller方法加上参数
BasePageRequest,T为对象类型，然后参数就会自动组装成分页参数和定义的对象类，以下为实现代码：

public class PageParaGetter extends ParaGetter<BasePageRequest> { public PageParaGetter(String parameterName, String defaultValue) { super(parameterName, defaultValue); } @Override protected BasePageRequest to(String s) { return null; }

@Override @SuppressWarnings("unchecked") public BasePageRequest get(Action action, Controller controller) { Parameter[] parameters=action.getMethod().getParameters(); Class clazz=null; for (Parameter parameter:parameters){ if(BasePageRequest.class.isAssignableFrom(parameter.getType())){ Type parameterizedType=parameter.getParameterizedType(); if (parameterizedType instanceof ParameterizedType) { Type[] params = ((ParameterizedType) parameterizedType).getActualTypeArguments(); clazz= TypeUtils.getClass(params[0]); } break; } } boolean isJson=controller.getHeader("Content-Type")!=null&&controller.getHeader("Content-Type").toLowerCase().contains("application/json"); return isJson?new BasePageRequest(controller.getRawData(),clazz):new BasePageRequest(controller.getKv(),clazz); }

}

自定义json工厂，实现对数据的个性化解析返回，如实现将数据返回时将数据转成驼峰规则，自定义某种类型的对象的返回格式等。

可以自定义错误处理模板，在出现错误或者其他异常的情况下，可以给予用户一个清晰的提示，避免用户看到一些无用的错误信息等功能

文件可以上传到项目目录之外，避免了重新打包项目后文件的丢失

@Override public void configConstant(Constants me) { me.setDevMode(prop.getBoolean("jfinal.devMode", true)); me.setInjectDependency(true); //设置上传文件到哪个目录 me.setBaseUploadPath(BaseConstant.UPLOAD_PATH); me.setBaseDownloadPath(BaseConstant.UPLOAD_PATH); //自定义json工厂 me.setJsonFactory(new ErpJsonFactory()); //限制上传100M me.setMaxPostSize(104857600); }

采用项目分层化的设计，职责分工明确，降低代码的耦合性Hander->对指定规则的url进行捕获或者放心Interceptor->环绕式AOP拦截，对访问权限，数据权限，参数等进行校验，可以配置在全局，单个路由，单个controller，单个方法等上面，可进行自定义实现，对数据进行处理

Router->对不同规则的数据进行分发，不同url进入不同路由和controller

Controller->对参数进行组装，将数据传入到service处理后进行render返回

Service->对业务代码进行处理，并将数据转入Db处理或缓存
Db->对数据库进行操作
Render->将service返回的数据在controller进行返回，以及出错后通过

SQL模板功能，将sql写入到xx.sql文件中，如果sql文件有变动，无需重新编译打包，直接改动sql文件中的sql即可，以下为自动扫描指定路径下sql文件的代码：

private void getSqlTemplate(String path, ActiveRecordPlugin arp) { File file = new File(path); if (file.exists()) { File[] files = file.listFiles(); if (files != null && files.length > 0) { for (File childFile : files) { if (childFile.isDirectory()) { getSqlTemplate(childFile.getAbsolutePath(), arp); } else { if (childFile.getName().toLowerCase().endsWith(".sql")) { arp.addSqlTemplate(childFile.getAbsolutePath().replace(PathKit.getRootClassPath(), "").replace("\\", "/")); } } } } } }

以下是系统的部分截图：
以下为悟空CRM9.0 JAVA版部分功能系统截图