引言

JeeSite 是一个 Java EE 企业级快速开发平台，基于经典技术组合（Spring Boot、Spring MVC、Apache Shiro、MyBatis、Beetl、Bootstrap、AdminLTE）采用经典开发模式，让初学者能够更快的入门并投入到团队开发中去。在线代码生成功能，包括核心模块如：组织机构、角色用户、菜单及按钮授权、数据权限、系统参数、内容管理、工作流等。采用松耦合设计；界面无刷新，一键换肤；众多账号安全设置，密码策略；在线定时任务配置；支持集群，支持SAAS；支持多数据源。

JeeSite 快速开发平台的主要目的是能够让初级的研发人员快速的开发出复杂的业务功能（经典架构会的人多），让开发者注重专注业务，其余有平台来封装技术细节，降低技术难度，从而节省人力成本，缩短项目周期，提高软件安全质量。

JeeSite 自开源以来已被广大爱好者用到了企业、政府、医疗、金融、互联网等各个领域中，JeeSite 依架构简单精良、易于扩展、大众思维的设计模式，深入开发者的内心，并得到一致好评，于2016和2017连续两年获得开源中国《最受欢迎中国开源软件》奖杯，期间也帮助了不少刚毕业的大学生作为入门教材，快速的去实践。

4.x的升级，作者结合了多年总结和经验，以及各方面的应用案例，对架构完成了一次全部重构，也纳入很多新的思想。不管是从开发者模式、底层架构、逻辑处理还是到用户界面，用户交互体验上都有很大的进步，在不忘学习成本、提高开发效率的情况下，安全方面也做和很多工作，包括：身份认证、密码策略、安全审计、日志收集。

4.x 新特性：http://jeesite4.mydoc.io/?t=281645

• 我们的优势： 整体架构清晰、稳定技术先进、入门简单、易于维护、易于扩展、安全稳定。

技术选型

• 主框架：Spring Boot 2.0、Spring Framework 5.0、Apache Shiro 1.4、J2Cache
• 持久层：Apache MyBatis 3.4、Hibernate Validation 6.0、Alibaba Druid 1.1
• 视图层：Spring MVC 5.0、Beetl 2.7 替换JSP、Bootstrap 3.3、AdminLTE 2.4
• 前端组件：jQuery 1.12、jqGrid 4.7、layer 3.0、zTree 3.5、jquery-validation
• 工具组件：Apache Commons、Logback 1.1、Jackson 2.8、POI 3.14、Quartz 2.2
• 技术选型详情：http://jeesite4.mydoc.io/?t=273599

内置功能

• http://jeesite4.mydoc.io/?t=270187

生态系统

• 分布式微服务系统（Spring Cloud）：https://gitee.com/thinkgem/jeesite4-cloud
• JFlow工作流引擎：https://gitee.com/thinkgem/jeesite4-jflow ：http://ccflow.org
• 内容管理模块（CMS）：https://gitee.com/thinkgem/jeesite4-cms【敬请期待】

快速体验

在线演示

1. 地址：http://demo.jeesite.com/
2. 账号：system
3. 密码：admin

本地运行

1. 环境准备：JDK 1.8、Maven 3.3、MySQL 5.7
2. 下载源码：https://gitee.com/thinkgem/jeesite4/attach_files
3. 打开文件：/web/src/main/resources/config/application.yml 配置JDBC连接
4. 执行脚本：/web/bin/init-data.bat 初始化数据库
5. 执行脚本：/web/bin/run-tomcat.bat 启动服务即可
6. 浏览器访问：http://127.0.0.1:8980/js/ 账号 system 密码 admin
7. 部署常见问题：http://jeesite4.mydoc.io/?t=284210

开发环境

1. 部署运行：http://jeesite4.mydoc.io/?t=267354
2. 常见问题：http://jeesite4.mydoc.io/?t=284210

开发手册

• 代码生成 / 快速入门 (Guide)：http://jeesite4.mydoc.io/?t=316743
• 持久层 / 数据库操作 (MyBatis)：http://jeesite4.mydoc.io/?t=267351
• 业务层 / 数据权限 (Service)：http://jeesite4.mydoc.io/?t=267352
• 视图层 / 表单组件 (Beetl)：http://jeesite4.mydoc.io/?t=267353
• 功能权限基础文档 (Shiro)：http://jeesite4.mydoc.io/?t=298473
• 常用JS类库API (jeesite.js)：http://jeesite4.mydoc.io/?t=301473
• 数据表格API (DataGrid.js)：http://jeesite4.mydoc.io/?t=301488
• 修改 (默认) 视图，新增主题：http://jeesite4.mydoc.io/?t=267355
• 手机 API 接口调用、前后分离：http://jeesite4.mydoc.io/?t=270527
• 消息提醒中心使用手册：http://jeesite4.mydoc.io/?t=323351
• 常见问题：http://jeesite4.mydoc.io/?t=284210

今后如何升级？

尽量不修改web项目以外的源码项目，如 jeesite-common、jeesite-modele-core，如果修改了，请 Pull Requests 上来，否则代码编码将与官方不同步，将对你的日后升级带来困难。

JeeSite的小版本（4.1.x）升级是非常便捷的，你只需要将 pom.xml 文件中的 parent.version 版本修改到最新版本即可，同版本下你可进行Maven快照强制更新，即可将最新版的依赖jar更新到本地，下面介绍一下在Eclipse里如何操作：

在web项目上右键，选择菜单 -> Maven -> Update Project...（或按Alt+F5） -> 点击 Select All 按钮 -> 选择 Force Update of Snapshots/Releases 复选框 -> 点击OK按钮即可。

如果您修改了其它依赖模块代码，这时你需要与官方Git仓库代码进行同步。

如果进行相对大的版本（4.x.x）升级这里我们会附加一个声明，帮助你进行迁移操作。

授权协议声明

1. 已开源的代码，授权协议采用 AGPL v3 + Apache Licence v2 进行发行。
2. 您可以免费使用、修改和衍生代码，但不允许修改后和衍生的代码做为闭源软件发布。
3. 修改后和衍生的代码必须也按照AGPL协议进行流通，对修改后和衍生的代码必须向社会公开。
4. 如果您修改了代码，需要在被修改的文件中进行说明，并遵守代码格式规范，帮助他人更好的理解您的用意。
5. 在延伸的代码中（修改和有源代码衍生的代码中）需要带有原来代码中的协议、版权声明和其他原作者规定需要包含的说明（请尊重原作者的著作权，不要删除或修改文件中的@author信息）。
6. 您可以应用于商业软件，但必须遵循以上条款原则（请协助改进本作品）。
7. 关系平台的发展战略考虑，底层部分代码暂未开源，但这不影响您的二次开发。
8. 请知悉社区版，用户数不可超过100个，最大允许10个用户同时在线（不含匿名）。

获得技术服务支持：http://jeesite4.mydoc.io/?t=267685

• 随着JeeSite发展，我们也需要有相应的资金支持才能持续的开发和维护。支持我们，您可以得到一些回报，我们有了这些也会把开源事业做的更好，请给我们一些动力吧，谢谢您的支持！

技术交流方式

• QQ 群号：127515876、209330483、223507718、709534275、730390092、183903863(外包)
• 问题反馈：https://gitee.com/thinkgem/jeesite4/issues 　【新手必读】
• 码云Gitee：https://gitee.com/thinkgem/jeesite4
• GitHub：https://github.com/thinkgem/jeesite4
• 作者博客：https://my.oschina.net/thinkgem
• 官方网站：http://jeesite.com
• 官方论坛：http://jeesite.net
• 微信公众号：

Git 全局设置技巧

1、提交检出均不转换换行符

git config --global core.autocrlf false

2、拒绝提交包含混合换行符的文件

git config --global core.safecrlf true