jeesite框架搭建maven项目 (mysql数据库)

官网文档地址： 
https://github.com/thinkgem/jeesite/tree/master/doc 
官网源码地址： 
https://github.com/thinkgem/jeesite

文档可以下载下来看看

介绍与安装
1. 平台简介
JeeSite是基于多个优秀的开源项目，高度整合封装而成的高效，高性能，强安全性的开源Java EE快速开发平台。
JeeSite本身是以Spring Framework为核心容器，Spring MVC为模型视图控制器，MyBatis为数据访问层， Apache Shiro为权限授权层，Ehcahe对常用数据进行缓存，Activit为工作流引擎。
JeeSite主要定位于企业信息化领域，已内置企业信息化系统的基础功能和高效的代码生成工具，包括：系统权限组件、数据权限组件、数据字典组件、核心工具组件、视图操作组件、工作流组件、代码生成等。前端界面风格采用了结构简单、性能优良、页面美观大气的Twitter Bootstrap页面展示框架。采用分层设计、双重验证、提交数据安全编码、密码加密、访问验证、数据权限验证。使用Maven做项目管理，提高项目的易开发性、扩展性。
JeeSite目前包括以下三大模块，系统管理（SYS）模块、内容管理（CMS）模块、在线办公（OA）模块、代码生成（GEN）模块。 系统管理模块 ，包括企业组织架构（用户管理、机构管理、区域管理）、菜单管理、角色权限管理、字典管理等功能； 内容管理模块 ，包括内容管理（文章、链接），栏目管理、站点管理、公共留言、文件管理、前端网站展示等功能； 在线办公模块 ，提供简单的请假流程实例。
JeeSite 提供了常用工具进行封装，包括日志工具、缓存工具、服务器端验证、数据字典、当前组织机构数据（用户、机构、区域）以及其它常用小工具等。另外还提供一个强大的在线 代码生成 工具，此工具提供简单的单表、一对多、树结构功能的生成，如果对外观要求不是很高，生成的功能就可以用了。如果你使用了JeeSite基础框架，就可以很高效的快速开发出，优秀的信息管理系统。
2. 内置功能
1. 用户管理：用户是系统操作者，该功能主要完成系统用户配置。 
2. 机构管理：配置系统组织机构（公司、部门、小组），树结构展现，可随意调整上下级。 
3. 区域管理：系统城市区域模型，如：国家、省市、地市、区县的维护。 
4. 菜单管理：配置系统菜单，操作权限，按钮权限标识等。 
5. 角色管理：角色菜单权限分配、设置角色按机构进行数据范围权限划分。 
6. 字典管理：对系统中经常使用的一些较为固定的数据进行维护，如：是否、男女、类别、级别等。 
7. 操作日志：系统正常操作日志记录和查询；系统异常信息日志记录和查询。 
8. 连接池监视：监视当期系统数据库连接池状态，可进行分析SQL找出系统性能瓶颈。 
9. 工作流引擎：实现业务工单流转、在线流程设计器。
3. 开发工具
1. Eclipse IDE：采用Maven项目管理，模块化。
2. 在线演示：演示系统常用组件的使用代码，内嵌地图案例等。
3. 代码生成：通过界面方式简单配置，自动生成相应代码，目前包括三种生成方式（增删改查）：单表、一对多、树结构。生成后的代码如果不需要注意美观程度，生成后即可用。
4. 设计思想
1、 分层设计：（数据访问层，业务逻辑层，展示层）层次清楚，低耦合，各层必须通过接口才能接入并进行参数校验（如：在展示层不可直接操作数据库），保证数据操作的安全。
2、 双重验证：用户表单提交双验证：包括服务器端验证及客户端验证，防止用户通过浏览器恶意修改（如不可写文本域、隐藏变量篡改、上传非法文件等）而跳过客户端验证操作数据库。

3、 安全编码：用户表单提交所有数据，在服务器端都进行安全编码，防止用户提交非法脚本及SQL注入获取敏感数据等，确保数据安全。

4、 密码加密：登录用户密码进行SHA1散列加密，此加密方法是不可逆的。保证密文泄露后的安全问题。

5、 访问验证：系统对所有管理端链接都进行用户身份权限验证，防止用户直接通过URL进行未授权页面。

6、 数据验证：对指定数据集权限进行过滤，七种数据权限可供选择（所有权限，公司及子公司，本公司，部门及子部门，本部门，本人数据，跨机构数据）

7、 快速编码：提供基本功能模块的源代码生成器，提高开发效率及质量。

5. 技术选型
1、后端
* 核心框架：Spring Framework 4.0
* 安全框架：Apache Shiro 1.2
* 视图框架：Spring MVC 4.0
* 服务端验证：Hibernate Validator 5.1
* 布局框架：SiteMesh 2.4
* 工作流引擎：Activiti 5.15
* 任务调度：Spring Task 4.0
* 持久层框架：MyBatis 3.2
* 数据库连接池：Alibaba Druid 1.0
* 缓存框架：Ehcache 2.6、Redis
* 日志管理：SLF4J 1.7、Log4j
* 工具类：Apache Commons、Jackson 2.2、Xstream 1.4、Dozer 5.3、POI 3.9
2、前端
* JS框架：JQuery 1.9。
* CSS框架：Twitter Bootstrap 2.3.1。
* 客户端验证：JQuery Validation Plugin 1.11。
* 富文本：CKEcitor
* 文件管理：CKFinder
* 动态页签：Jerichotab
* 手机端框架：Jingle
* 数据表格：jqGrid
* 对话框：jQuery jBox
* 下拉选择框：jQuery Select2
* 树结构控件：jQuery zTree
* 日期控件： My97DatePicker
4、平台
* 服务器中间件：在Java EE 5规范（Servlet 2.5、JSP 2.1）下开发，支持应用服务器中间件
有Tomcat 6、Jboss 7、WebLogic 10、WebSphere 8。
* 数据库支持：目前仅提供Oracle数据库的支持，但不限于数据库，平台留有其它数据库支持接口，
可方便更改为其它数据库，如：SqlServer 2008、MySql 5.5、H2等
* 开发环境：Java EE、Eclipse、Maven、Git
6. 必会基础知识
1. 软件工程基础、Java语言基础、JSP内置对象、EL表达式
2. Spring Framework：类的依赖、自动注入、事务处理
3. Spring MVC：URL映射、参数传递
4. Apache Shiro：安全拦截方式，应用方法，控制按钮
5. SiteMesh：布局框架的用法
6. JSP标准标签库（JSTL）：if、choose、forEach、set
7. Spring MVC表单标签库：form、input、textarea、select、checkbox
8. 文件存放规范，命名规范。

JeeSite

是基于多个优秀的开源项目，高度整合封装而成的高效，高性能，强安全性的开源.Java EE快速开发平台。

JeeSite本身是以Spring Framework为核心容器，Spring MVC为模型视图控制器，MyBatis为数据访问层 Apache Shiro为权限授权层，Ehcahe对常用数据进行缓存，Activit为工作流引擎。 

JeeSite主要定位于企业信息化领域，已内置企业信息化系统的基础功能和高效的代码生成工具，包括：系统权限组件、数据权限组件、数据字典组件、核心工具组件、视图操作组件、工作流组件、代码生成等。前端界面风格采用了结构简单、性能优良、页面美观大气的Twitter Bootstrap页面展示框架。采用分层设计、双重验证、提交数据安全编码、密码加密、访问验证、数据权限验证。使用Maven做项目管理，提高项目的易开发性、扩展性。JeeSite目前包括以下三大模块，系统管理（SYS）模块、内容管理（CMS）模块、在线办公（OA）模块、代码生成（GEN）模块。 系统管理模块，包括企业组织架构（用户管理、机构管理、区域管理）、菜单管理、角色权限管理、字典管理等功能； 内容管理模块 ，包括内容管理（文章、链接），栏目管理、站点管理、公共留言、文件管理、前端网站展示等功能； 在线办公模块，提供简单的请假流程实例。 JeeSite 提供了常用工具进行封装，包括日志工具、缓存工具、服务器端验证、数据字典、当前组织机构数据（用户、机构、区域）以及其它常用小工具等。另外还提供一个强大的在线代码生成工具，此工具提供简单的单表、一对多、树结构功能的生成，如果对外观要求不是很高，生成的功能就可以用了。如果你使用了JeeSite基础框架，就可以很高效的快速开发出，优秀的信息管理系统。JeeSite是基于多个优秀的开源项目，高度整合封装而成的高效，高性能，强安全性的开源Java EE快速开发平台。 JeeSite本身是以Spring Framework为核心容器，Spring MVC为模型视图控制器，MyBatis为数据访问层，Apache Shiro为权限授权层，Ehcahe对常用数据进行缓存，Activit为工作流引擎。JeeSite主要定位于企业信息化领域，已内置企业信息化系统的基础功能和高效的代码生成工具，包括：系统权限组件、数据权限组件、数据字典组件、核心工具组件、视图操作组件、工作流组件、代码生成等。前端界面风格采用了结构简单、性能优良、页面美观大气的Twitter Bootstrap页面展示框架。采用分层设计、双重验证、提交数据安全编码、密码加密、访问验证、数据权限验证。使用Maven做项目管理，提高项目的易开发性、扩展性。JeeSite目前包括以下三大模块，系统管理（SYS）模块、内容管理（CMS）模块、在线办公（OA）模块、代码生成（GEN）模块。 系统管理模块 ，包括企业组织架构（用户管理、机构管理、区域管理）、菜单管理、角色权限管理、字典管理等功能； 内容管理模块 ，包括内容管理（文章、链接），栏目管理、站点管理、公共留言、文件管理、前端网站展示等功能； 在线办公模块 ，提供简单的请假流程实例。 JeeSite 提供了常用工具进行封装，包括日志工具、缓存工具、服务器端验证、数据字典、当前组织机构数据（用户、机构、区域）以及其它常用小工具等。另外还提供一个强大的在线 代码生成工具，此工具提供简单的单表、一对多、树结构功能的生成，如果对外观要求不是很高，生成的功能就可以用了。如果你使用了JeeSite基础框架，就可以很高效的快速开发出，优秀的信息管理系统。JeeSite是基于多个优秀的开源项目，高度整合封装而成的高效，高性能，强安全性的开源Java EE快速开发平台。 JeeSite本身是以Spring Framework为核心容器，Spring MVC为模型视图控制器，MyBatis为数据访问层， Apache Shiro为权限授权层，Ehcahe对常用数据进行缓存，Activit为工作流引擎。JeeSite主要定位于企业信息化领域，已内置企业信息化系统的基础功能和高效的代码生成工具，包括：系统权限组件、数据权限组件、数据字典组件、核心工具组件、视图操作组件、工作流组件、代码生成等。前端界面风格采用了结构简单、性能优良、页面美观大气的Twitter Bootstrap页面展示框架。采用分层设计、双重验证、提交数据安全编码、密码加密、访问验证、数据权限验证。使用Maven做项目管理，提高项目的易开发性、扩展性。JeeSite目前包括以下三大模块，系统管理（SYS）模块、内容管理（CMS）模块、在线办公（OA）模块、代码生成（GEN）模块。 系统管理模块 ，包括企业组织架构（用户管理、机构管理、区域管理）、菜单管理、角色权限管理、字典管理等功能； 内容管理模块 ，包括内容管理（文章、链接），栏目管理、站点管理、公共留言、文件管理、前端网站展示等功能； 在线办公模块 ，提供简单的请假流程实例。 JeeSite 提供了常用工具进行封装，包括日志工具、缓存工具、服务器端验证、数据字典、当前组织机构数据（用户、机构、区域）以及其它常用小工具等。另外还提供一个强大的在线 代码生成 工具，此工具提供简单的单表、一对多、树结构功能的生成，如果对外观要求不是很高，生成的功能就可以用了。如果你使用了JeeSite基础框架，就可以很高效的快速开发出，优秀的信息管理系统。JeeSite是基于多个优秀的开源项目，高度整合封装而成的高效，高性能，强安全性的开源Java EE快速开发平台。 JeeSite本身是以Spring Framework为核心容器，Spring MVC为模型视图控制器，MyBatis为数据访问层， Apache Shiro为权限授权层，Ehcahe对常用据进行缓存，Activit为工作流引擎。 JeeSite主要定位于企业信息化领域，已内置企业信息化系统的基础功能和高效的代码生成工具，包括：系统权限组件、数据权限组件、数据字典组件、核心工具组件、视图操作组件、工作流组件、代码生成等。前端界面风格采用了结构简单、性能优良、页面美观大气的Twitter Bootstrap页面展示框架。采用分层设计、双重验证、提交数据安全编码、密码加密、访问验证、数据权限验证。使用Maven做项目管理，提高项目的易开发性、扩展性。 JeeSite目前包括以下三大模块，系统管理（SYS）模块、内容管理（CMS）模块、在线办公（OA）模块、代码生成（GEN）模块。 系统管理模块 ，包括企业组织架构（用户管理、机构管理、区域管理）、菜单管理、角色权限管理、字典管理等功能； 内容管理模块 ，包括内容管理（文章、链接），栏目管理、站点管理、公共留言、文件管理、前端网站展示等功能； 在线办公模块 ，提供简单的请假流程实例。 JeeSite 提供了常用工具进行封装，包括日志工具、缓存工具、服务器端验证、数据字典、当前组织机构数据（用户、机构、区域）以及其它常用工具等。另外还提供一个强大的在线 代码生成 工具，此工具提供简单的单表、一对多、树结构功能的生成，如果对外观要求不是很高，生成的功能就可以用了。如果你使用了JeeSite基础框架，就可以很高效的快速开发出，优秀的信息管理系统。JeeSite是基于多个优秀的开源项目，高度整合封装而成的高效，高性能，安全性的开源Java EE快速开发平台。 JeeSite本身是以Spring Framework为核心容器，Spring MVC为模型视图控制器，MyBatis为数据访问层， Apache Shiro为权限授权层，Ehcahe对常用数据进缓存，Activit为工作流引擎。 JeeSite主要定位于企业信息化领域，已内置企业信息化系统的基础功能和高效的代码生成工具，包括：系统权限组件、数据权限组件、数据字典组件、核心工具组件、视图操作组件、工作流组件、代码生成等。前端界面风格采用了结构简单、性能优良、页面美观大气的Twitter Bootstrap页面展示框架。采用分层设计、双重验证、提交数据安全编码、密码加密、访问验证、数据权限验证。使用Maven做项目管理，提高项目的易开发性、扩展性。 JeeSite目前包括以下三大模块，系统管理（SYS）模块、内容管理（CMS）模块、在线办公（OA）模块、代码生成（GEN）模块。系统管理模块，包括企业组织架构（用户管理、机构管理、区域管理）、菜单管理、角色权限管理、字典管理等功能； 内容管理模块 ，包括内容管理（文章、链接），栏目管理、站点管理、公共留言、文件管理、前端网站展示等功能； 在线办公模块 ，提供简单的请假流程实例。 JeeSite 提供了常用工具进行封装，包括日志工具、缓存工具、服务器端验证、数据字典、当前组织机构数据（用户、机构、区域）以及其它常用小工具等。另外还提供一个强大的在线 代码生成 工具，此工具提供简单的单表、一对多、树结构功能的生成，如果对外观要求不是很高，生成的功能就可以用了。如果你使用了JeeSite基础框架，就可以很高效的快速开发出，优秀的信息管理系统。接下来搭建环境：

1. 安装jdk，配置环境这个不用说了吧 
   注意一点，jdk位数要和eclipse一样，比如jdk 32位的，那eclipse就也要 32位才行。
2. 安装eclipse，到官网上去下，记住要eclipse ide for java EEDevelopers 版的，不然导入maven项目可能会导不了。
3. 准备这些可以按照文档做了，运行Maven目录下的settings.bat文件，用来设置maven仓库路径，并按提示操作（设置PATH系统变量、配置Eclipse）
4. 这里会下载java包，让他下一会，执行jeesite/bin/eclipse.bat 生成工程文件并下载jar依赖包（如果需要修改默认项目名，请打开pom.xml修改第7行artifactId，然后再执行eclipse.bat文件）
5. 导工程了，导入的时候因为上面已经配置过eclipse了，所以这里导入可以导入maven项目，然后选中工程，刷新，这里会加载一段时间
6. 设置数据源：src/main/resources/jeesite.properties，就是说设置你的数据库，我的本地数据库mysql正好用户名密码和他一样，嘿嘿，我就不用改了，你们自己设置一下

jdbc.url=jdbc:mysql://localhost:3306/jeesite?useUnicode=true&characterEncoding=utf-8
jdbc.username=root
jdbc.password=123456

7.好了，接下来最关键的时候了，就是给MySQL设置utf-8字符格式，并创建utf-8格式的database；他是要求我们自己创建数据库的，默认库jeesite；

CREATE DATABASE jeesite DEFAULT CHARACTER SET utf8 COLLATE utf8_general_ci;

这句话就是创建utf-8数据库，在mysql里跑一下按理来说就可以了，但我是先设置 mysql 都设成 utf-8，再跑的这一行代码，你们跑完创建数据库这行，可以直接下一步往下做，如果你们试了，运行init-db.bat还是出现编码问题的话，就回来也设置一下吧。 
设置方法如下：

配置文件my-default.ini里面添加这么几句，然后重启mysql
[client]
default-character-set=utf8
[mysql]
default-character-set=utf8
[mysqld]
default-character-set=utf8

8.配置完utf-8下一步是运行db/init-db.bat文件，这里我要说一句，最好先在eclipse里面找到bin/eclipse.bat，在项目里面运行一遍然后success。然后再跑init-db.bat,而init-db.bat文件最好在文件夹里面直接启动，在项目里面启动可能会找不到pom。然后就是巴拉巴拉一堆代码跑过去，数据就初始化完成了，真开心。 
9.如果到这都没错的话就快大功告成拉，新建server,我这里直接建的Tomcat 8，用的自己的jdk 1.8，并没有设置到文档里面的两个选项 
10.配置serverl.xml的Connector项,增加URIEncoding=”UTF-8”，这个是要设置的 
原文是

<Connector connectionTimeout="20000" port="8080" protocol="HTTP/1.1" redirectPort="8443"/>

你加上utf-8就行了，如下面所示：

<Connector URIEncoding="UTF-8" connectionTimeout="20000" port="8080" protocol="HTTP/1.1" redirectPort="8443"/>

11.最后了，跑起来吧兄弟！部署到tomcat，登录访问就行了 
http://127.0.0.1:8080/ jeesite 用户名：thinkgem 密码：admin，到此大功告成！我是这么成功的，希望能对大家有点帮助

大家也可以看看官方标明的一些常见问题： 
1. ‘mvn’ 不是内部或外部命令，原因如下 
a) PATH未配置或配置了多个不一致的Maven地址，如用户/系统变量。 
b) M2_HOME系统/用户变量地址不正确，可删除M2_HOME变量。 
c) 检查mvn运行是否正常，cmd执行：mvn -v 
2. 运行eclipse.bat 找不到文件路径或乱码：一般原因是路径中包含空格或中文。 
3. 导入到eclipse下找不到jar包：maven未配置，查看m2_repo仓库路径是否正确。 
4. 运行init-db.bat提示ORA-xxx：根据错误码排除错误，一般是数据库url不对，用户名或密码错误。 
5. 部署时出现某某被锁定，一般原因：Tomcat服务中的两个选项未选中。 
6. 字典列表，添加键值，出现乱码：server.xml未配置url编码为utf-8。