1.jeesite 介绍与安装

jeesite

第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刷新。

File->Import->Maven4MyEclipse->Existing Maven Projects

4. 设置数据源：src/main/resources/jeesite.properties

创建数据库如：test  字符集: utf8 -- UTF-8 Unicode   排序规则： utf8_bin

5. 导入数据表并初始化数据：运行db/init-db.bat文件。（导入时如果出现“drop”失败提示信息，请忽略。）

6. 新建Server（Tomcat），注意选择以下两个选项：

Serve modules without publishing

Publish module contexts to separate XML files

file:///C:\Users\firemail\AppData\Local\Temp\ksohtml\wps6C87.tmp.jpg

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。