# JeeSite 4.x
**Repository Path**: sdwl_git/jeesite4
## Basic Information
- **Project Name**: JeeSite 4.x
- **Description**: Java EE 企业级快速开发平台，基于 Spring Boot、Spring MVC、Shiro、MyBatis、Beetl、Bootstrap、AdminLTE 在线代码生成功能，采用经典开发模式，让初学者能够更快的入门并投入到团队开发中去。包括核心模块如：组织机构、角色用户、菜单及按钮授权、数据权限、系统参数、内容管理、工作流等。松耦合设计；界面无刷新；一键换肤；众多账号安全设置，密码策略；在线定时任务配置；支持 Spring Cloud 微服务；支持 SAAS 多租户；支持集群部署；支持多数据源；
- **Primary Language**: Java
- **License**: Apache-2.0
- **Default Branch**: v5.5
- **Homepage**: http://jeesite.com
- **GVP Project**: No
## Statistics
- **Stars**: 0
- **Forks**: 5586
- **Created**: 2019-03-01
- **Last Updated**: 2023-10-19
## Categories & Tags
**Categories**: Uncategorized
**Tags**: None
## README
快速开发平台 - Spring Boot
## 技术交流
* 交流 QQ 群（千人大群）：`127515876`、`209330483`、`223507718`、`709534275`、`730390092`、`1373527`、`183903863(外包)`
* 码云Gitee：
* GitHub：
* 作者博客：
* **帮助文档：**
* 官方网站：
* 问题反馈： [【新手必读】](https://gitee.com/thinkgem/jeesite4/issues/I18ARR)
* 关注微信公众号，了解最新动态：
* 源码仓库地址：
* 分离版前端源码仓库：
## 平台介绍
JeeSite 快速开发平台，不仅仅是一个后台开发框架，它是一个企业级快速开发解决方案，后端基于经典组合 Spring Boot、Shiro、MyBatis，前端采用 Beetl、Bootstrap、AdminLTE 经典开发模式，或者分离版 Vue3、Vite、Ant Design Vue、TypeScript、Vben Admin 最先进技术栈。
提供在线代码生成功能，可自动创建业务模块工程和微服务模块工程，自动生成前端代码和后端代码；包括功能模块如：组织机构、角色用户、菜单及按钮授权、数据权限、系统参数、内容管理、工作流等。
采用松耦合设计，微内核和插件架构，模块增减便捷；界面细节到位，一键换肤；众多账号安全设置，密码策略；文件在线预览；消息推送；多元化第三方登录；在线定时任务配置；支持集群，支持SAAS；支持多数据源；支持读写分离、分库分表；支持微服务应用。
主要目的是能够让初级的研发人员快速的开发出复杂的业务功能，中高级人员有时间做一些更有用的事情。让开发者注重专注业务，其余有平台来封装技术细节，降低技术难度，从而节省人力成本，缩短项目周期，提高软件安全质量。
JeeSite 自 2013 年发布以来已被广大爱好者用到了企业、政府、医疗、金融、互联网等各个领域中，拥有：精良架构、易于扩展、大众思维的设计模式，工匠精神，用心打磨每一个细节，深入开发者的内心，并荣获开源中国《最受欢迎中国开源软件》多次奖项，期间也帮助了不少刚毕业的大学生，教师作为入门教材，快速的去实践。
2019 年换代升级，作者结合了多年总结和经验，以及各方面的应用案例，对架构完成了一次全部重构，也纳入很多新的思想。不管是从开发者模式、底层架构、逻辑处理还是到用户界面，用户交互体验上都有很大的进步，在不忘学习成本、提高开发效率的情况下，安全方面也做和很多工作，包括：身份认证、密码策略、安全审计、日志收集等众多安全选项供您选择。努力为大中小微企业打造全方位企业级快速开发解决方案。
2021 年终发布 Vue3 的前后分离版本，使得 JeeSite 拥有同一个后台服务 Web 来支撑分离版和全栈版两套前端技术栈。
## 平台优势
JeeSite 非常易于二次开发，可控性高，整体架构清晰、技术稳定而先进、源代码书写规范、经典技术会的人多、易于维护、易于扩展、安全稳定。
JeeSite 功能全，知识点非常多，也非常少。因为她使用的都是一些通用的技术，通俗的设计风格，大多数基础知识点，多数人都能掌握，所以每一个 JeeSite 的功能点都非常容易掌握。只要您学会使用这些功能和组件的应用，就可以顺利的完成系统开发了。
JeeSite 是一个低代码开发平台，具有较高的封装度、扩展性，封装不是限制您去做一些事情，而是在便捷的同时，也具有较好的扩展性，在不具备一些功能的情况下，JeeSite 提供了扩展接口，提供了原生调用方法。
大家都在用 Spring，也在学习 Spring 的优点，Spring 提供了较好的扩展性，可又有多少人去修改它的源代码呢，退一步说，大家去修改了 Spring 的源码，反而会对未来升级造成很大困扰，您说不是呢？这样的例子很多，所以不要纠结，我们非常注重这一点，JeeSite 也一样具备强大的扩展性。
为什么说 JeeSite 比较易于学习？JeeSite 很好的把握了设计的 “度”，避免过度设计的情况。过度设计是在产品设计过程中忽略了产品和用户的实际需求，反而带来了不必要的复杂性，而忽略了系统的学习、开发和维护成本。
* 至今 JeeSite 平台架构已经非常稳定。
* JeeSite 精益求精，用心打磨每一个细节。
* JeeSite 是一个专业的平台，是一个让你使用放心的平台。
* 社区版基于 Apache License 2.0 开源协议，永久免费使用。
### 架构特点及安全方面的优势：
## 技术选型
* 主框架：Spring Boot 2.7、Spring Framework 5.3、Apache Shiro 1.12、J2Cache
* 持久层：Apache MyBatis 3.5、Hibernate Validator 6.2、Alibaba Druid 1.2
* 视图层：Spring MVC 5.3、Beetl 3.10（替换JSP）、Bootstrap 3.3、AdminLTE 2.4
* 前端组件：jQuery 3.7、jqGrid 4.7、layer 3.5、zTree 3.5、jQuery Validation
* 分离前端版：Node.js、TypeScript、Vue3、Vite、Ant Design Vue、Vue Vben Admin
* 工作流引擎：Flowable 6.6、符合 BPMN 规范、在线流程设计器、中国式流程、退回、撤回、自由流
* Bootstrap 版 支持 IE9 及以上版本及其他所有现代浏览器，如：谷歌、火狐、国产浏览器 等
* Vue3 版 支持现代浏览器，如：谷歌 Chrome 86+、火狐、国产浏览器 等
* 技术选型（详细）：
* JeeSite Vue 版本：
* Spring Boot 3.x 版本：https://gitee.com/thinkgem/jeesite4/tree/v5.springboot3/
## 更多介绍
* 内置功能：
* 目录结构：
* 架构特点：
* 开发规范：
* 代码生成：
## 生态系统
* 分布式微服务（Spring Cloud）：
* Flowable业务流程引擎（BPM）：
* JFlow工作流引擎：
* 多站点内容管理模块（CMS）：
* 手机端移动端：
* PC客户端程序：
* Vue3分离版本：
* JeeSite统一认证：
* MybatisPlus:
* Magic接口快速开发：
* 内外网中间件：
## 快速体验
### 在线演示
1. 地址：
### 本地运行
1. 环境准备：`JDK 1.8 or 11、17`、`Maven 3.6+`、使用 `MySQL 5.7 or 8.0` 数据库、[其它数据库](https://jeesite.com/docs/technology/#_8、已支持数据库)
2. 下载源码： 并解压
3. 打开文件：`/web/src/main/resources/config/application.yml` 配置JDBC连接
4. 执行脚本：`/web/bin/init-data.bat` 初始化数据库
5. 执行脚本：`/web/bin/run-tomcat.bat` 启动服务即可
6. 浏览器访问： 账号 system 密码 admin
7. 部署常见问题：
8. 分离端安装：
### 快速运行
1. 环境准备：`JDK 1.8 or 11、17`、`Maven 3.6+`、无需准备数据库（使用内嵌 H2 DB）
2. 下载源码： 并解压
3. 执行脚本：`/web-fast/bin/run-tomcat.bat` 启动服务即可（自动初始化库）
4. 浏览器访问： 账号 system 密码 admin
5. 部署常见问题：
8. 分离端安装：
### 容器运行
- 拉取 Docker 镜像（演示使用，JeeSite版本较久）：
```sh
docker pull thinkgem/jeesite-web:latest(arm64)
```
- 启动脚本：
```sh
docker run --name jeesite-web \
-p 8980:8980 --privileged -d --restart unless-stopped \
-v ~:/data thinkgem/jeesite-web:latest(arm64) && docker logs -f jeesite-web
```
- 浏览器访问： 账号 system 密码 admin
- 分离端安装：
### 开发环境
1. 部署运行文档：
2. 部署常见问题：
3. 分离端安装：
## 技术文章
* 菜单和按钮权限：
* 强大的数据权限：
* 表结构数据字典：
* 持久层设计：
* 后端工具：
* 表单组件：
* 表格组件：
* js工具：
## 专题文章
* 自定义主题：
* 国际化多语言：
* 接口文档：
* BPM工作流引擎：
* 用户类型：
* 消息推送：
* 单点登录：
* 在线任务调度：
* 对象存储：
* 大屏设计器：
* 报表设计器：
* 文件在线预览：
* 三员管理员：
* 手机端框架：
* 统一认证服务：
* 树表结构设计：
## 云服务架构
* 多租户、SaaS服务：
* 集群、负载均衡、高可用：
* Spring Cloud 微服务：
* 分布式事务 Seata：
* 读写分离、分库分表：
## 前后分离版
* Vue 版介绍：
* Vue 安装部署：
* Vue 参数配置：
* Vue 前端权限：
* Vue 源码解析：
* Vue 表单组件：
* Vue 表格组件：
* Vue 常用组件：
* Vue 图标组件：
* Vue 国际化多语言：
* Vue 样式库：
## 授权协议声明
1. 基于 Apache License Version 2.0 协议发布，可用于商业项目，但必须遵守以下补充条款。
2. 不得将本软件应用于危害国家安全、荣誉和利益的行为，不能以任何形式用于非法为目的的行为。
3. 在延伸的代码中（修改和有源代码衍生的代码中）需要带有原来代码中的协议、版权声明和其他原作者
规定需要包含的说明（请尊重原作者的著作权，不要删除或修改文件中的`Copyright`和`@author`信息）
更不要，全局替换源代码中的 jeesite 或 ThinkGem 等字样，否则你将违反本协议条款承担责任。
4. 您若套用本软件的一些代码或功能参考，请保留源文件中的版权和作者，需要在您的软件介绍明显位置
说明出处，举例：本软件基于 JeeSite 快速开发平台，并附带链接：http://jeesite.com
5. 任何基于本软件而产生的一切法律纠纷和责任，均于我司无关。
6. 如果你对本软件有改进，希望可以贡献给我们，共同进步。
7. 本项目已申请软件著作权，请尊重开源，感谢阅读。
8. 无用户数限制，无在线人数限制，放心使用。
## 技术服务与支持
* 没有资金的支撑就很难得到发展，特别是一个好的产品，如果 JeeSite 帮助了您，请为我们点赞。支持我们，您可以获得更多回馈，我们会把公益事业做的更好，开放更多资源，回报社区和社会。请给我们一些动力吧，在此非常感谢已支持我们的朋友！
* **联系我们**：请访问技术支持服务页面：
## 今后如何升级？
尽量不修改 web 项目以外的源码项目，如 jeesite-common、jeesite-modele-core，如果修改了，请 Pull Requests 上来，否则代码与官方不同步，可能会将对你的日后升级增加难度。
如果您修改了依赖模块代码，也没关系，这时你需要利用 Git 版本控制工具，与官方仓库代码进行同步，合并代码即可。
每个版本升级，我们都会附带详细更新日志：。
在这里，你可以看到 JeeSite 新增哪些新功能和改进，在每个版本下都有对应升级方法。
如果跨版本升级，可以将版本号直接修改为最新版本，然后去看每个版本的升级方法，修改对应业务。
# Git 全局设置技巧
```
1、提交检出均不转换换行符
git config --global core.autocrlf false
2、拒绝提交包含混合换行符的文件
git config --global core.safecrlf true
```