JeeSite开发（一）——JeeSite4开发基础实例

JeeSite开发（⼀）——JeeSite4开发基础实例
⽬录：
〇、开发环境
⼀、JeeSite介绍
⼆、获取JeeSite4
三、运⾏JeeSite后台（部署运⾏）
四、启动并访问
五、增加⼀个功能模块
〇、开发环境
JDK1.8、eclipse、maven、MySQL57
⼀、JeeSite介绍
JeeSite 基于最主流的 Spring Boot 2 + MyBatis + Shiro + J2Cache/Redis + Beetl 的稳定架构。

前端采⽤了⽬前极为流⾏的扁平化响应式的设计风格，可以完美兼容电脑，平板，⼿机等多个平台。

基于 jQuery + Bootstrap + AdminLTE 实现。

⽤JeeSite可以快速搭建⼀个web⽹站，⽽且可以不写或者只需写很少的业务代码。

⼆、获取JeeSite4
以下为其⽬录：
三、运⾏JeeSite后台（部署运⾏）
3.1 引⼊项⽬
1.将以上的web⽬录复制到⾃⼰的⼯作⽬录，并按需重命名（例如：jeesite-demo）。

2.打开其中的poi.xml⽂件，修改其中的第⼗三⾏，改为您刚刚修改的⽂件夹名，例如：<artifactId>jeesite-demo</artifactId>
3.⽽后在eclipse中将其引⼊进来，右键空⽩处->Import->选择Maven下的Existing Maven Projects，点确定，此时Maven会⾃动加载依赖包，效果如下。

3.2 初始化数据库
1.配置my.ini：打开MySQL安装⽂件夹下的my.ini⽂件，
在[mysqld]下增
加 sql_mode="ONLY_FULL_GROUP_BY,STRICT_TRANS_TABLES,ERROR_FOR_DIVISION_BY_ZERO,NO_AUTO_CREATE_USER,NO_ENGINE_SUBSTITUTION"
2.在MySQL中创建⽤户和数据库
set global read_only=0;
set global optimizer_switch='derived_merge=off';
create user 'jeesite'@'%' identified by 'jeesite';
create database jeesite DEFAULT CHARSET 'utf8mb4' COLLATE 'utf8mb4_unicode_ci';
grant all privileges on jeesite.* to 'jeesite'@'%' identified by 'jeesite';
flush privileges;
3.在刚刚引⼊的项⽬中，找到 /src/main/resources/config/application.yml ⽂件，修改MySQL数据库配置：
# 数据库连接
jdbc:
# Mysql 数据库配置
type: mysql
driver: com.mysql.jdbc.Driver
url: jdbc:mysql://127.0.0.1:3306/jeesite?useSSL=false&useUnicode=true&characterEncoding=utf-8&zeroDateTimeBehavior=convertToNull
username: jeesite
password: jeesite
testSql: SELECT 1
4.双击运⾏项⽬下的 /bin/init-data.bat 脚本，将会⾃动初始化数据库（建表）
四、启动并访问
1.可在 /src/main/resources/config/application.yml ⽂件中修改服务器端⼝和部署路径
server:
port: 8980
servlet:
context-path: /jeesite-demo
tomcat:
uri-encoding: UTF-8
2.启动：由于JeeSite集成了Spring boot框架，即内部集成了tomcat服务器，所以只需右键点击com.jeesite.modules.config.Application.java⽂件，再点击 Run As -> Java Application 即可启动服务。

五、增加⼀个功能模块
1.⽬的，增加⼀个客户管理模块
2.在jeesite数据库中，增加⼀张 demo_customer表，其中必不可少的字段有：
use jeesite;
create table demo_customer(
id varchar(64) primary key,
create_by varchar(64) not null,
create_date datetime not null,
update_by varchar(64) not null,
remarks varchar(255),
status char(1)
);
截取⾃DataEntity类，新增实体都继承⾃此
@Table(columns = {
@Column(name = "status", attrName = "status", label = "状态", isUpdate = false, comment = "（推荐状态：0：正常；1：删除；2：停⽤；3：冻结；4：审核、待审核；5：审核驳回；9：草稿）"), @Column(name = "create_by", attrName = "createBy", label = "创建者", isUpdate = false),
@Column(name = "create_date", attrName = "createDate", label = "创建时间", isUpdate = false, isQuery = false),
@Column(name = "update_by", attrName = "updateBy", label = "更新者", isUpdate = true),
@Column(name = "update_date", attrName = "updateDate", label = "更新时间", isUpdate = true, isQuery = false),
@Column(name = "remarks", attrName = "remarks", label = "备注信息", queryType = QueryType.LIKE)})
其它字段按需增加（客户名称、客户编号、性别、电话、删除标志）：
3.配置新模块
（1）在jeesite后台找到代码⽣成⼯具（研发⼯具->代码⽣成⼯具），点击右上⾓“新增”按钮。

⽽后选中刚刚我们建⽴的新表，点下⼀步：
（2）填写基本信息（表说明、功能作者）、字段信息（按需调整）、⽣成信息（⽣成模板、⽣成模块名、⽣成功能名），⽽后点击保存并⽣成代码
———分割线———
———分割线———
此时，可以在⽣成基础路径中看到⽣成的代码。

刷新⼀下eclipse中的jeesite-demo项⽬，便可以看到新增的模块（com.jeesite.modules.cust），基本的业务代码和前端页⾯也已经⽣成好了。

重启服务器。

4.将刚刚的新模块添加进系统
（1）找到后台中的菜单管理（系统设置->菜单管理），在组织管理下增加⼀个下级菜单——客户管理。

其中“链接”可在新模块的
com.jeesite.modules.cust.web.DemoCustomerController.java中查看。

（2）在客户管理下增加两个下级菜单——查看、编辑。

注意“菜单类型”和“权限标识”，可见要选择“隐藏”
———分割线———
（3）为当前账户（系统管理员）添加权限权限管理->⾓⾊管理->相应的⾓⾊，操作下的<按钮，点击功能菜单，⽽后勾选客户管理，保存。

然后再为当前账号增加此⾓⾊。

（4）尝试是否可以访问客户管理，若不可，重启服务器。

（5）最终效果如下，其中增删改查功能皆已实现：。