第1章 介绍与安装
第1章 介绍与安装
作者：ThinkGem
更新日期：2014-4-8
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. 文件存放规范，命名规范。
7. 学习索引
1. Spring Framework ：
• 跟我学Spring3
2. Spring MVC
• 跟开涛学Spring MVC
• JSP语法、Spring Form、JSTL、EL
• Bean Validation
3. Apache Shiro
• 官方文档
• 快速入门
4. SiteMesh 2.4
• 官方文档
• 入门实例、标签使用、装饰文件
5. Bootstrap 2.3
• Bootstrap官网
• Bootstrap中文网
6. jQuery
• jQuery API：官方文档 中文文档
• jQuery Validation：官方文档 使用范例
• jQuery zTree: 官方文档
• jQruey jBox：官方文档
7. Activiti
• 官方网站
• 中文文档
• 咖啡兔Activiti
8. Ehcache
• 官方文档
• EhCache分布式缓存
9. 其它资料
• Alibaba Druid
• FreeMarker
•
8. 安装部署
1. 运行Maven目录下的settings.bat文件，用来设置maven仓库路径，并按提示操作（设置PATH系统变量、配置Eclipse）。
2. 执行jeesite/bin/eclipse.bat 生成工程文件并下载jar依赖包（如果需要修改默认项目名，请打开pom.xml修改第7行artifactId，然后再执行eclipse.bat文件）。
3. 将 jeesite 工程导入到eclipse，选中工程，按F5刷新。
4. 设置数据源：src/main/resources/jeesite.properties
5. 导入数据表并初始化数据：运行db/init-db.bat文件。（导入时如果出现“drop”失败提示信息，请忽略。）
6. 新建Server（Tomcat），注意选择以下两个选项：
7. 配置server.xml的Connector项，增加URIEncoding="UTF-8"
8. 部署到Tomcat，设置Auto Reload为Disabled。
9. 访问工程：http://127.0.0.1:8080/ jeesite 用户名：thinkgem 密码：admin
9. 常见问题
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。
作者：ThinkGem
更新日期：2014-4-8
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. 文件存放规范，命名规范。
7. 学习索引
1. Spring Framework ：
• 跟我学Spring3
2. Spring MVC
• 跟开涛学Spring MVC
• JSP语法、Spring Form、JSTL、EL
• Bean Validation
3. Apache Shiro
• 官方文档
• 快速入门
4. SiteMesh 2.4
• 官方文档
• 入门实例、标签使用、装饰文件
5. Bootstrap 2.3
• Bootstrap官网
• Bootstrap中文网
6. jQuery
• jQuery API：官方文档 中文文档
• jQuery Validation：官方文档 使用范例
• jQuery zTree: 官方文档
• jQruey jBox：官方文档
7. Activiti
• 官方网站
• 中文文档
• 咖啡兔Activiti
8. Ehcache
• 官方文档
• EhCache分布式缓存
9. 其它资料
• Alibaba Druid
• FreeMarker
•
8. 安装部署
1. 运行Maven目录下的settings.bat文件，用来设置maven仓库路径，并按提示操作（设置PATH系统变量、配置Eclipse）。
2. 执行jeesite/bin/eclipse.bat 生成工程文件并下载jar依赖包（如果需要修改默认项目名，请打开pom.xml修改第7行artifactId，然后再执行eclipse.bat文件）。
3. 将 jeesite 工程导入到eclipse，选中工程，按F5刷新。
4. 设置数据源：src/main/resources/jeesite.properties
5. 导入数据表并初始化数据：运行db/init-db.bat文件。（导入时如果出现“drop”失败提示信息，请忽略。）
6. 新建Server（Tomcat），注意选择以下两个选项：
7. 配置server.xml的Connector项，增加URIEncoding="UTF-8"
8. 部署到Tomcat，设置Auto Reload为Disabled。
9. 访问工程：http://127.0.0.1:8080/ jeesite 用户名：thinkgem 密码：admin
9. 常见问题
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。