# jfinal-admin

**Repository Path**: supyuan/jfinal-admin

## Basic Information

- **Project Name**: jfinal-admin
- **Description**: jfinal-admin 使开发者用很少的时间和代码量，开发出功能完备的管理后台。集组织机构管理，用户管理，角色管理，菜单管理，数据字典管理，日志管理。内置用户和权限系统mysql、oracle等多数据库支持支持引入第三方前端库基于jfinal_cms深度精简集成spring(可选)菜单权限、功能权限双重保障; 备份git 仓库https://git.dev.tencent.com/it666/jfinal-admin.git     文档api访问地址： https://apidoc.gitee.com/supyuan/jfinal-admin ，3.2以及以前的源代码请移步 https://gitlab.com/rain888/erpAdmin   3.6及以后的版本需要jdk8及以上环境支撑，演示系统
- **Primary Language**: Java
- **License**: MIT
- **Default Branch**: develop-3.6
- **Homepage**: https://tool.ypiaob.com
- **GVP Project**: No

## Statistics

- **Stars**: 366
- **Forks**: 151
- **Created**: 2017-05-09
- **Last Updated**: 2024-12-25

## Categories & Tags

**Categories**: backend

**Tags**: None

## README

### jfinal-admin 后台框架 (简称 jAdmin )
基于JFinal的后台管理系统，采用了简洁强大的JFinal作为web框架，模板引擎用的是beetl，数据库用mysql，前端bootstrap框架。
- 演示地址 http://jad.yxyun.win/ 密码 123456
- api文档 https://apidoc.gitee.com/supyuan/jfinal-admin/
- jfinal 文档 https://www.jfinal.com/doc/14-1
- beetl 文档 http://ibeetl.com/guide/#beetl
- jetbrains https://www.jetbrains.com/?from=jfinal-admin
### 3.6.06版本更新
- 1、简化获取执行类的参数类型逻辑 
- 2、全新的执行类运行机制，扩充了对基本数据类型的支持
- 3、执行类方法参数支持一览表如下
### 方法参数

|  class   | class  |
| -------|:-------:|
| Boolean.class  | boolean.class |
|Character.class| Byte.class|
| byte.class| Short.class| 
|short.class| Integer.class|
 |int.class| Long.class| 
|long.class| Float.class|
 |float.class| Double.class|
 |double.class| BigDecimal.class|
 |String.class|-|


### 3.6.05版本更新
- 1、升级 jfinal 到 4.9.06 ；fastjson 到 1.2.68 
- 2、清理不必要的 maven 配置

### 3.6.04版本更新
- 1、新增数据库版本管理工具 Flyway
- 2、具体看 BaseConfig 里面的实现
- 3、Flyway 是独立于数据库的应用、管理并跟踪数据库变更的数据库版本管理工具。

### 3.6.03版本更新
- 1、将原来集中处理权限模块拆分为2个独立的模块（菜单权限与功能权限）
- 2、预留门户入口的配置信息
- 3、修复了一些 BUG 提高程序稳定性

### 3.6.02版本更新
- 1、数据库连接池替换为 HikariPool
- 2、移除不必要的 class 以及精简工具类
### 3.6.01版本更新
- 1、jfinal 升级到 4.5，beetl  模板升级到 3.0.11.RELEASE；
- 2、默认关闭任务调度（BaseConfig.java 83行自行按需开启）
- 3、执行类全名为： com.supyuan.modules.system.job.jobWeb.job.TestJob（自行修改库中原来的执行类）

### 3.6版本更新
- 1、jfinal 升级到 4.3，beetl  模板升级到 3.0.7.RELEASE；
- 2、升级并精简了部分 jar 包以及工具类；
- 3、修改包结构，使得业务部分和框架部分独立（做到即使删除业务部分后，框架支撑部分也能通过编译）；
- 4、前端页面结构微调。

### 最新更新
- 1.菜单栏 xss 漏洞修复
- 2.废弃 dubbo 注解的方式集成 spring，提供 spring 集成开关配置默认关闭
- 3.角色授权 bug 修复
- 4.合并任务调度（QuickJob [QuickJob ](https://gitee.com/supyuan/QuickJob)）
- 5.新增 XSS 脚本处理功能，示例 : ${nameHtml,xss}
- 6.修复个别情况下，当前页数大于总页数时，分页的 bug
- 7.权限控制精准到功能按钮
- 8.全新登录界面
- 9.全新404、500页面
- 10.任务调度合并到 system 模块，修复登录404的问题、beetl模板升级到2.7.14
- 11.seo 优化，basePath端口是80的时候不显示
- 12.任务管理 bug 修复
- 13.des 加密密钥问题修复
- 14.更换ui为调整配色

### 更新日志
- 2018年7月12日
- 功能更新<br/>
      修复任务调度配置时执行类参数获取不正确的bug 修复DES秘钥初始化的bug<br/>
- 次要调整<br/>
      系统提示美化更新，操作提示改为layer.msg；
- 2018年4月18日
- 细节调整<br/>
      任务调度合并到system模块，修复登录404的问题、beetl模板升级到2.7.14<br/>
- 次要调整<br/>
      seo优化，basePath端口是80的时候不显示；
- 2018年2月7日
- 主要更新
	由于linux下使用javaassist的反射方法获取方法的参数名时，获取的参数名与实际参数名不一致。
本次更新使用spring 方式替代了javaassist，感兴趣的小伙伴可以查阅源码修改的两处源码分别是：
QuartzJobClassSvc 106至142行
GetParamUtil 102至150行
- 次要更新
	1、修复未登录情况时，直接前往某个路由报错问题，UserInterceptor.java移动到系统基础部分；
	
![输入图片说明](https://gitee.com/uploads/images/2017/1215/094356_924f59cf_22738.png "1.png")
![输入图片说明](https://gitee.com/uploads/images/2017/1215/094408_27becaa2_22738.png "2.png")
![输入图片说明](https://gitee.com/uploads/images/2017/1215/094417_2dcf7299_22738.png "3.png")
![](https://git.oschina.net/uploads/images/2017/0516/223055_56ede065_22738.png "在这里输入图片标题")


### 其他
jfinal_cms深度精简，不再依赖jflyfox_base，jflyfox_jfinal。

### 代码质量分析
![输入图片说明](https://gitee.com/uploads/images/2017/1103/105801_c6f199f4_22738.png "fx3.png")

### 界面预览
![输入图片说明](https://gitee.com/uploads/images/2017/1103/110136_c846750a_22738.png "2017-11-03_110222.png")

### 配置说明
- 数据库连接配置 修改pom.xml
```
<profiles>

        <profile>

            <id>develop</id>

            <activation>

                <activeByDefault>true</activeByDefault>

            </activation>

            <properties>

                <jdbc-url>
                    <![CDATA[jdbc:mysql://127.0.0.1:3306/jfinal_job?useUnicode=true&characterEncoding=utf-8&zeroDateTimeBehavior=convertToNull]]></jdbc-url>

                <jdbc-username>root</jdbc-username>

                <jdbc-password>123456</jdbc-password>

            </properties>

        </profile>

    </profiles>
```
- 登录系统账号  admin/123456
- 入口在哪里 部署后登录地址示例 http://localhost:8989/admin/logout 
注意 8989/ 这里根据实际情况变通 例如 8080/jad/
- spring使用
第一步 CONSTANTS.SPRING=false 开启
第二步 继承 BaseProjectController 调用 getClassBeanByName("classname") 即可获取spring管理的bean对象

### 特色
1. 内置用户和权限系统
2. mysql、oracle等多数据库支持
3. 支持引入第三方前端库
4. 基于jfinal_cms深度精简
5. 集成spring(可选)
6. 菜单权限、功能权限双重保障
7. 门户网站（开发中）

### 部署重要说明
3.6及以后的版本需要jdk8及以上环境支撑，需要maven最好用idea部署，系统默认密码123456

### 鸣谢
- [JFinal](http://www.oschina.net/p/jfinal)

- [beetl](http://ibeetl.com/)

- [flyfox](http://git.oschina.net/flyfox)

### 关于作者
- IT小香猪(qq:454979901)