jeesite框架的简单应⽤
个⼈觉得⽐较完善的⼀个讲解jeesite的⽹站
jeesite官⽹
公司项⽬都是基于jeesite做的项⽬
所以就资料了解⼀下啦
企业信息化快速开发平台 JeeSite简介
由 ThinkGem 创建，最后⼀次修改 2016-10-18
JeeSite是基于多个优秀的开源项⽬，⾼度整合封装⽽成的⾼效，⾼性能，强安全性的开源 Java EE快速开发平台。
JeeSite本⾝是以Spring Framework为核⼼容器，Spring MVC为模型视图控制器，MyBatis为数据访问层， Apache Shiro为权限授权层，Ehcahe对常⽤数据进⾏缓存，Activit为⼯作流引擎。
JeeSite主要定位于企业信息化领域，已内置企业信息化系统的基础功能和⾼效的代码⽣成⼯具，包括：
系统权限组件、数据权限组件、数据字典组件、核⼼⼯具组件、视图操作组件、⼯作流组件、代码⽣成等。前端界⾯风格采⽤了结构简单、性能优良、页⾯美观⼤⽓的Twitter Bootstrap页⾯展⽰框架。采⽤分层设计、双重验证、提交数据安全编码、密码加密、访问验证、数据权限验证。使⽤Maven做项⽬管理，提⾼项⽬的易开发性、扩展性。
JeeSite⽬前包括以下三⼤模块，系统管理（SYS）模块、内容管理（CMS）模块、在线办公（OA）模块、代码⽣成（GEN）模块。系统管理模块，包括企业组织架构（⽤户管理、机构管理、区域管理）、菜单管理、⾓⾊权限管理、字典管理等功能；内容管理模块，包括内容管理（⽂章、链接），栏⽬管理、站点管理、公共留⾔、⽂件管理、前端⽹站展⽰等功能；在线办公模块，提供简单的请假流程实例。
JeeSite 提供了常⽤⼯具进⾏封装，包括⽇志⼯具、缓存⼯具、服务器端验证、数据字典、当前组织机构数据（⽤户、机构、区域）以及其它常⽤⼩⼯具等。另外还提供⼀个强⼤的在线代码⽣成⼯具，此⼯具提供简单的单表、⼀对多、树结构功能的⽣成，如果对外观要求不是很⾼，⽣成的功能就可以⽤了。如果你使⽤了JeeSite基础框架，就可以很⾼效的快速开发出，优秀的信息管理系统。
内置功能
⽤户管理：⽤户是系统操作者，该功能主要完成系统⽤户配置。
机构管理：配置系统组织机构（公司、部门、⼩组），树结构展现，可随意调整上下级。
区域管理：系统城市区域模型，如：国家、省市、地市、区县的维护。
菜单管理：配置系统菜单，操作权限，按钮权限标识等。
⾓⾊管理：⾓⾊菜单权限分配、设置⾓⾊按机构进⾏数据范围权限划分。
字典管理：对系统中经常使⽤的⼀些较为固定的数据进⾏维护，如：是否、男⼥、类别、级别等。
操作⽇志：系统正常操作⽇志记录和查询；系统异常信息⽇志记录和查询。
连接池监视：监视当期系统数据库连接池状态，可进⾏分析SQL出系统性能瓶颈。
⼯作流引擎：实现业务⼯单流转、在线流程设计器。
为何选择JeeSite
使⽤ Apache License 2.0 协议，源代码完全开源，⽆商业限制。
使⽤⽬前主流的Java EE开发框架，简单易学，学习成本低。
数据库⽆限制，⽬前⽀持MySql、Oracle，可扩充SQL Server、PostgreSQL、H2等。
模块化设计，层次结构清晰。内置⼀系列企业信息管理的基础功能。
操作权限控制精密细致，对所有管理链接都进⾏权限验证，可控制到按钮。
数据权限控制精密细致，对指定数据集权限进⾏过滤，七种数据权限可供选择。
提供在线功能代码⽣成⼯具，提⾼开发效率及质量。
提供常⽤⼯具类封装，⽇志、缓存、验证、字典、组织机构等，常⽤标签（taglib），获取当前组织机构、字典等数据。
兼容⽬前最流⾏浏览器（IE7+、Chrome、Firefox）IE6也⽀持，但体验效果差。
技术选型
1、后端
核⼼框架：Spring Framework 4.0
安全框架：Apache Shiro 1.2
视图框架：Spring MVC 4.0
服务端验证：Hibernate Validator 5.1
布局框架：SiteMesh 2.4
⼯作流引擎：Activiti 5.15、FoxBPM 6
任务调度：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。
数据库⽀持：⽬前仅提供MySql、Oracle数据库的⽀持，但不限于数据库，平台留有其它数据库⽀持接⼝，可⽅便更改为其它数据库，如：SqlServer 2008、MySql 5.5、H2等
开发环境：Java EE、Eclipse、Maven、Git
安全考虑
开发语⾔：系统采⽤Java 语⾔开发，具有卓越的通⽤性、⾼效性、平台移植性和安全性。
分层设计：（数据库层，数据访问层，业务逻辑层，展⽰层）层次清楚，低耦合，各层必须通过接⼝才能接⼊并进⾏参数校验（如：在展⽰层不可直接操作数据库），保证数据操作的安全。
双重验证：⽤户表单提交双验证：包括服务器端验证及客户端验证，防⽌⽤户通过浏览器恶意修改（如不可写⽂本域、隐藏变量篡改、上传⾮法⽂件等），跳过客户端验证操作数据库。
安全编码：⽤户表单提交所有数据，在服务器端都进⾏安全编码，防⽌⽤户提交⾮法脚本及SQL注⼊获取敏感数据等，确保数据安全。
密码加密：登录⽤户密码进⾏SHA1散列加密，此加密⽅法是不可逆的。保证密⽂泄露后的安全问题。
强制访问：系统对所有管理端链接都进⾏⽤户⾝份权限验证，防⽌⽤户
快速体验
具备运⾏环境：JDK1.6+、Maven3.0+、MySql5+或Oracle10g+。
修改src\main\resources\jeesite.properties⽂件中的数据库设置参数。
根据修改参数创建对应MySql或Oracle数据库⽤户和参数。
运⾏bin\init-db.bat脚本，即可导⼊表结构及演⽰数据(linux操作系统：在控制台中切换⾄项⽬根⽬录，运⾏命令：mvn antrun:run -Pinit-db)
运⾏bin\run-tomcat7.bat或bin\run-jetty.bat，启动Web服务器（第⼀次运⾏，需要下载依赖jar包，请耐⼼等待）。
最⾼管理员账号，⽤户名：thinkgem 密码：admin
常见问题
有时出现⽂字乱码：修改Tomcat的l⽂件的Connector项，增加URIEncoding="UTF-8"
⽤⼀段时间提⽰内存溢出，请修改JVM参数：-Xmx512m -XX:MaxPermSize=256m
为什么新建菜单后看不到新建的菜单？因为授权问题，菜单管理只允许最⾼管理员账号管理（最⾼管理员默认账号：thinkgem 密码：admin）。
JeeSite的安装
由 ThinkGem 创建，最后⼀次修改 2016-10-18
安装部署
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. 配置l的Connector项，增加URIEncoding="UTF-8"
8. 部署到Tomcat，设置Auto Reload为Disabled。
9. 访问⼯程：127.0.0.1:8080/ jeesite ⽤户名：thinkgem 密码：admin
常见问题
1. 'mvn' 不是内部或外部命令，原因如下
PATH未配置或配置了多个不⼀致的Maven地址，如⽤户/系统变量。
M2_HOME系统/⽤户变量地址不正确，可删除M2_HOME变量。
检查mvn运⾏是否正常，cmd执⾏：mvn -v
2. 运⾏eclipse.bat 不到⽂件路径或乱码：⼀般原因是路径中包含空格或中⽂。
3. 导⼊到eclipse下不到jar包：maven未配置，查看m2_repo仓库路径是否正确。
4. 运⾏init-db.bat提⽰ORA-xxx：根据错误码排除错误，⼀般是数据库url不对，⽤户名或密码错误。
5. 部署时出现某某被锁定，⼀般原因：Tomcat服务中的两个选项未选中。
6. 字典列表，添加键值，出现乱码：l未配置url编码为utf-8。
JeeSite的⽂件结构与配置
由 ThinkGem 创建，最后⼀次修改 2016-10-18
⼀、⽂件结构
1.1. 源码⽬录
src/main/java
com.thinkgem.jeesite Jeesite平台⽬录
├ common公共模块存放⽬录
│├ beanvalidator实体Bean验证相关类
│├ log⽇志⼯具相关类
│├ mapper各种Object到Xml、Object到Json的映射转换类
│├ persistence持久层相关类
│├ security安全相关类
│├ service业务层相关类
│├ servlet公共servlet相关类
│├ utils各种操作⼩⼯具类
│└ web模型控制器层相关类
└ modules JeeSite内置功能模块存放⽬录
├ act Activiti⼯作流引擎⽬录
├ cms内容管理、新闻发布模块⽬录
├ gen Web版本代码⽣成器⽬录
├ oa在线办公模块演⽰⽤例存放⽬录
└ sys系统核⼼模块存放⽬录
├ dao数据访问层相关类
├ entity实体相关类
├ interceptor系统模块相关类
├ service业务处相关类
├ web模型控制器层相关类
└ utils系统模块的⼯具类
1.2. 资源⽬录
src/main/resource
act Activiti⼯作流引擎相关⽂件（部署⽂件、bpmn）
cache Ehcache缓存配置存放⽬录
mappings Mybatis Sql映射⽂件存放⽬录
jeesite.properties系统配置属性⽂件
spring-*.xml Spring相关⽂件
log4j.properties Log4j⽇志配置属性⽂件
1.3. 发布⽬录
src/main/webapp
static静态⽂件存放⽬录（JS、CSS、前端插件类库等）
└ compressor.bat JavaScrpt和CSS⽂件压缩脚本
userfiles⽤户上传⽂件⽬录
WEB-INF WEB应⽤安全⽬录，通过映射访问相关⽂件。
├ lib依赖jar包⽬录
├ tags Tags标签存放⽬录
├ views视图⽂件⽬录
│├ reportlets帆软报表⽂件存放路径
│├ resources帆软报表配置⽂件存放⽬录
│├ error系统异常映射相关页⾯
│├ include视图相关包含⽂件
│├ layouts视图布局相关⽂件
│└ modules内置核⼼功能模块视图相关⽂件
│├ act Activiti模块视图相关⽂件
│├ cms内容管理模块视图相关⽂件
│├ gen代码⽣成模块视图相关⽂件
│├ oa在线办公模块视图相关⽂件
│└ sys系统管理模块视图相关⽂件
│ └ sys
系统管理模块视图相关⽂件├ l CKfinder 配置⽂件
├ l Decorator 配置⽂件
└ l
Web 配置⽂件
1.4. 执⾏⽬录
db db
数据库相关脚本、模型及执⾏⽂件├ act
各模块数据初始化， Oracle 建表脚本，数据初始数据脚本⽂件。
├ cms
├ gen
├ oa
├ sys └ init-db.bat 初始化数据库执⾏脚本（需要Maven ⽀持）
bin
clean.bat
清理项⽬⽣成的⽂件脚本eclipase.bat
⽣成eclipse 项⽬执⾏脚本package.bat
⽣成编译项⽬⽂件（war 包）run-jetty.bat Jetty 服务器运⾏脚本
run-tomcat6.bat Tomcat6服务器运⾏脚本
run-tomcat7.bat Tomcat7服务器运⾏脚本
⼆、 jeesite.properties
2.1. 数据源配置
# 数据库驱动，连接设置。
jdbc.driver=oracle.jdbc.driver.OracleDriver
jdbc.url=jdbc:oracle:thin:@127.0.0.1:1521:orcl
jdbc.username=jeesite
jdbc.password=123456
# 连接池设置，初始⼤⼩，最⼩，最⼤连接数。
jdbc.pool.init=1
jdbc.pool.minIdle=3
jdbc.pool.maxActive=20
# 测试连接sql 语句
2.2. 系统配置
# 配置产品名称，版权⽇期和版本号
productName=JeeSite Admin
copyrightYear=2014
version=V1.1.1
# 是否是演⽰模式，如果是，则如下模块，⽆法进⾏保存操作
# sys: area/office/user/role/menu/dict, cms: site/category
demoMode=false
# 管理端跟路径
adminPath=/a
# 前端跟路径
frontPath=/f
# 信息发布时的URL 后缀，可配置HTML 后缀的页⾯进⾏缓存
urlSuffix=.html
# 分页⼤⼩，默认每页15条
page.pageSize=15
# 硕正组件是否使⽤Cache （⼀般开发阶段，关闭Cache ）
supcan.useCache=false
# 设置通知间隔访问时间，单位毫秒.
2.3. 框架参数配置
# 设置SESSION 超时时间，l ⾥设置⽆效，单位毫秒.
session.sessionTimeout=120000
session.sessionTimeoutClean=120000
# 缓存设置
#figFile=l
# ⾸页地址
web.view.index=/a
# 视图⽂件配置，前缀和后缀
web.view.prefix=/WEB-INF/views/
web.view.suffix=.jsp
# 最⼤上传字节数 10M=10*1024*1024(B)=10485760
web.maxUploadSize=10485760
# 设置⽇志，拦击的URI ，@RequestMapping 值
web.logInterceptExcludeUri=/, /login, /sys/menu/tree, /sys/menu/treeData, /oa/oaNotify/self/count
web.logInterceptIncludeRequestMapping=save, delete, import, updateSort
三、l
3.1. 修改项⽬名称
artifactId ：项⽬名称 version ：版本
修改完成后运⾏eclipse.bat 重新⽣成项⽬⽂件。
3.2. 添加jar 依赖包
1） 可联系王震添加依赖jar ，
2）将jar⽂件拷贝项⽬WEB-INF下的lib⽬录，并配置pom，例如：
<dependency>
<groupId&st</groupId>
<artifactId>test-core</artifactId>
<version>1.0</version>
<scope>system</scope>
<systemPath>
${project.basedir}/src/main/webapp/WEB-INF/lib/test-core-1.0.jar
</systemPath>
</dependency>
3.3. 删除init-db插件
项⽬初始化完成后，⼀定要删除或重命名pom⾥⾯的init-db插件，防⽌项⽬进⾏中误操作运⾏了init-db.bat⽂件，数据库被清空。
四、数据库设计
模型⽂件：/ jeesite/db/
业务数据表必须包含以下公共字段：
五、重要规范
1. 类注释：必须包含类功能描述，作者，时间
2. ⽅法注释：除⾮常容易理解的⽅法如get、form、save、delete等⽅法外的⽅法必须加注释来说明⽤途，传递参数。
3. 按照以上命名结构进⾏⽂件分配存放。
4. 视图⽂件名要加模块或功能前缀，例如actTaskTodoList.jsp，代表：⼯作流任务待办列表，不要写成list.jsp或todoList.jsp或taskTodoList.jsp。
5. Sql与定义分离：不在万不得已的情况下不要写在java⽂件⾥，分离。
JeeSite 内置组件的应⽤
由 ThinkGem 创建，最后⼀次修改 2016-10-18
1. 常⽤组件
1.1. 布局组件
布局⽂件配置：
/ jeesite/src/main/webapp/l
默认布局⽂件：
/ jeesite/src/main/webapp/WEB-INF/views/layouts/default.jsp
⾮公共，⾃⼰建⽴的布局⽂件：
/ jeesite/src/main/webapp/WEB-INF/views/模块路径/layouts/布局⽂件.jsp
使⽤布局⽂件：
JSP的head⾥添加：<meta name="decorator" content="default"/>
1.2. ⽤户⼯具 UserUtils.java fns.tld
应⽤场景：在java⽂件或jsp页⾯上，获取当前⽤户相关信息
1. 获取当前⽤户：
1） User();
2） entity.currentUser()
3） ${fns:getUser()}
2. 获取当前⽤户部门：
1） OfficeList()
2） ${fns:getOfficeList()}
3. 获取当前⽤户区域：
1） AreaList()
2） ${fns:getAreaList()}
4. 获取当前⽤户菜单：
1） MenuList()
2） ${fns:getMenuList()}
5. 获取当前⽤户缓存：
1） Cache(key);
2） ${fns:getCache(cacheName, defaultValue)}
6. 设置当前⽤户缓存：
1） UserUtils.putCache(key);
1.3. 全局缓存 CacheUtils.java
应⽤场景：系统字典
1. 设置应⽤程序缓存：CacheUtils.put(key);
2. 获取应⽤程序缓存：(key);
1.4. 字典⼯具 DictUtils.java
应⽤场景：系统全局固定的字典数据，java或jsp中获取字典相关数据。
1. 根据类型和值获取字典标签（列表取值）：
a) DictLabel(Stringvalue, String type, String defaultValue)
b) ${ fns:getDictLabel (value,type, defaultValue)}
2. 根据类型和标签获取字典值（根据标签取值）：
a) DictValue(Stringlabel, String type, String defaultLabel)
b) ${fns:getDictValue(label, type,defaultValue)}
3. 根据类型获取字典列表（下拉框，复选框，单选框）：
a) DictList(Stringtype)
b) ${fns:getDictList(type)}
1.5. 功能权限控制
应⽤场景：访问功能授权，查看权限，编辑权限，导⼊权限，审核权限。
1. 给⽅法添加权限标志
@RequiresPermissions("sys:submodule:user:view")
@RequiresUser
2. 菜单中设置权限标志。
3. 判断权限：
4. 视图中控制按钮（shiro.tld）：
<shiro:hasPermissionname="sys:user:edit">
<inputid="btnSubmit" class="btn btn-primary"type="submit" value="保存"/>
</shiro:hasPermission>
<!-- 任何⼀个符合条件的权限 -->
<shiro:hasAnyPermissions name="sys:user:view,sys:user:edit,">
<inputid="btnSubmit" class="btn btn-primary"type="submit" value="返回"/>
</shiro: hasAnyPermissions>
1.6. 数据权限
应⽤场景：某⽤户访问数据范围：公司及⼦公司，本公司，部门及⼦部门，本部门，当前⽤户，明细设置。
// ⽣成数据权限过滤条件（dsf为dataScopeFilter的简写，在xml中使⽤ ${sqlMap.dsf}调⽤权限SQL）
<!-- 分页查询⽤户信息 -->
<select id="findList" parameterType="User"resultMap="userResult">
SELECT
<include refid="userColumns"/>
FROM sys_user a
<include refid="userJoins"/>
WHERE a.del_flag = '0'
<!-- 数据范围过滤 -->
${sqlMap.dsf}
</select>
/**
* 数据范围过滤
* @param user 当前⽤户对象，通过“CurrentUser()”获取
* @param officeAlias 机构表别名，多个⽤“,”逗号隔开。
* @param userAlias ⽤户表别名，多个⽤“,”逗号隔开，传递空，忽略此参数
* @return 标准连接条件对象
*/
String dataScopeFilter (User user, StringofficeAlias, String userAlias)
1.7. 智能分页组件
// 设置分页参数，则分页，如果不设置，则根据条件获取全部
user.setPage(page);
// 执⾏分页查询
page.setList(userDao.findPage(user));
1.8. 树选择组件
标签⽂件：/ jeesite/src/main/webapp/WEB-INF/tags/treeselect.tag
1.8.1. 区域选择组件
<tags:treeselect id="area"name="area.id" value="${area.id}" labelName="area.name"labelValue="${area.name}" title="区域" url="/sys/area/treeData"cssClass="input-small" allowClear="true" notAllowSelectParent="true"/>
多选需要加 checked="true" 属性
1.8.
2. 公司选择组件
jquery在线库<tags:treeselectid="office" name="office.id"value="${user.office.id}" labelName="office.name"labelValue="${user.office.name}" title="部门" url="/sys/office/treeData?type=1"cssClass="input-small" allowClear="true"notAllowSelectParent="true"/>多选需要加 checked="true" 属性
1.8.3. 部门选择组件
<tags:treeselectid="office" name="office.id"value="${user.office.id}" labelName="office.name"labelVal
ue="${user.office.name}" title="部门" url="/sys/office/treeData?type=2"cssClass="input-small" allowClear="true"notAllowSelectParent="true"/>多选需要加 checked="true" 属性
1.8.4. ⼈员选择组件
<tags:treeselectid="user" name="user.id" value="${user.id}"labelName="user.name" labelValue="${user.name}" title="⽤户" url="/sys/office/treeData?type=3"cssClass="input-small" allowClear="true"notAllowSelectParent="true"/>
多选需要加 checked="true" 属性
1.9. ⽂件选择、⽂件上传组件
<form:hidden path="name"htmlEscape="false" maxlength="255"class="input-xlarge"/>
<tags:ckfinder input="name"type="files" uploadPath="/test "/>
1.10. 富⽂本在线编辑器组件
<form:textarea id="name"htmlEscape="true" path="name" rows="4"maxlength="200" class="input-xxlarge"/>
<tags:ckeditor replace="name"uploadPath="/test " />
1.11. 其它⼯具
/src/main/java/com/thinkgem/jeesite/common/utils/...
Excel(Export/Import)、StringUtils、DateUtils、FileUtils、Encodes、CookieUtils、Collections3
2. 封装及组件
2.1. ⼯具类组件
1） UserUtils：⽤户⼯具类（获取当前⽤户的相关信息）。
版权声明：本站内容均来自互联网，仅供演示用，请勿用于商业和其他非法用途。如果侵犯了您的权益请与我们联系QQ:729038198，我们将在24小时内删除。
发表评论