jeesite学习笔记（一）——环境搭建和部署

参考在线文档（jeesite官网在线文档）：http://jeesite.com/?t=267354

jeesite4.0源码下载：https://gitee.com/thinkgem/jeesite4

环境的要求

1.Java SDK 1.8

2.Eclipse IDE for Java EE Mars 2 (4.5.2) （依 Eclipse 举例，IDEA 雷同。）

3、Apache Maven 3.3.0+ 

4、MySql 5.7.11+ 

导入到Eclipse

1.下载jeesite4.0源码，下载网站链接在本文章的最上方

2、拷贝web文件夹，到你的工作目录（不包含中文和空格的目录）下，重命名为你的工程名，如：jeesite-demo

3、打开pom.xml文件，修改第13行，artifactId为你的工程名，如：<artifactId>jeesite-demo</artifactId>

4、导入到Eclipse，菜单 File -> Import，然后选择 Maven -> Existing Maven Projects，点击 Next> 按钮，选择第2步的jeesite-demo文件夹，然后点击 Finish 按钮，即可成功导入

5、这时，Eclipse会自动加载Maven依赖包，初次加载会比较慢（根据自身网络情况而定），若工程上有小叉号，请打开Problems窗口，查看具体错误内容，直到无错误为止

6、下载过程中你可以准备数据库环境了

初始化数据库

1.以mysql为例，配置SQL模式，否则建表的时候可能会出现问题

打开 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.创建用户和授权（可添加可不添加）

set global read_only=0;
set global optimizer_switch='derived_merge=off'; 
create user 'jeesite'@'%' identified by 'jeesite';
create database jeesite DEFAULT CHARSET utf8 COLLATE utf8_general_ci;  
grant all privileges on jeesite.* to 'jeesite'@'%' identified by 'jeesite';
flush privileges;

3.打开  /src/main/resources/config/jeesite.yml   配置产品和项目名称及JDBC连接

# 产品或项目名称、软件开发公司名称
productName: JeeSite Demo
companyName: ThinkGem

# 产品版本、版权年份
productVersion: V4.0
copyrightYear: 2018

# 数据库连接
jdbc: 

  # Mysql 数据库配置
  type: mysql
  driver: com.mysql.jdbc.Driver
  url: jdbc:mysql://127.0.0.1:3306/jeesite?useSSL=true&useUnicode=true&characterEncoding=utf-8&zeroDateTimeBehavior=convertToNull
  username: jeesite
  password: jeesite
  testSql: SELECT 1

4、若刚才导入到的Eclipse的项目已经完成加载jar并无错误，你就可以执行  /bin/init-data.bat  脚本初始化数据库了，第一次执行如果遇见  table xxx doesn't exist  的错误信息，忽略即可。

5、如果init-db.bat无法运行，你也可以直接在Eclipse里找到  com.jeesite.test.InitCoreData.java  文件并打开，然后在空白处右键，点击 Run As -> JUnit Test 运行单元测试，进行初始化数据库脚本。为了防止误操作，你还需要：打开 Run Configurations 找到 Arguments 选项卡，在 VM arguments 里增加 “-Djeesite.initdata=true” 参数，点击Run运行，执行完成后建议将该单元测试 Run Configuration 删除掉，防止误操作，不小心再把你的有用数据清理掉。

启动Tomcat服务

1、当前是 Spring Boot 工程，内部已经集成 Web 容器，你无需另外再下载 Tomcat 进行部署，只需按照以下方式进行即可。

2、打开  /src/main/resources/config/application.yml  文件，配置你的服务端口port、部署路径context-path，例如:

server:

  port: 8980
  context-path: /jeesite-demo
  tomcat:
    uri-encoding: UTF-8

3、在Eclipse里找到com.jeesite.modules.config.Application.java文件并打开，然后在空白处右键，点击 Debug As -> Java Application 即可启动服务。

4、注意使用 Debug 运行，有助于你调试程序和提升开发效率，如：修改方法内的代码，修改视图代码，修改mapper代码，是不需要重启Web服务的。如果改变java类的结构，如果增删属性、方法、参数等，新增文件，这是就需要重启服务了。

浏览器访问

1、地址：http://127.0.0.1:8980/jeesite-demo

2、默认最高管理员账号：system 密码：admin

5、这时已经配置完成，开启你的开发之旅吧

清理Demo数据

为了演示方法，初始化数据库后会载入一些演示数据，执行以下脚本即可清理

DELETE FROM js_sys_post;
DELETE FROM js_sys_office;
DELETE FROM js_sys_company;
DELETE FROM js_sys_employee;
DELETE FROM js_sys_employee_post;
DELETE FROM js_sys_role WHERE role_code NOT IN ('corpAdmin','default');
DELETE FROM js_sys_role_data_scope;
DELETE FROM js_sys_user WHERE user_code NOT IN ('system','admin');
DELETE FROM js_sys_user_data_scope;
DELETE FROM js_sys_user_role;
DELETE FROM js_sys_log;

使用自己的package包路径

1、Application.java 的 scanBasePackages 增加您的包路径

2、jeesite.yml 中找到 mybatis: scanBasePackage: 增加您的包路径，用逗号隔开

3、默认代码生成包路径修改：菜单系统设置->参数设置的gen.defaultPackageName为您的包名

4、完成

部署到正式服务器

1、确保正式服务器jdk1.8及数据库环境已经具备

2、配置系统环境变量JAVA_HOME指定jdk1.8路径，注意不要包含空格

3、执行bin/package.bat进行打成war包文件，并将此war拷贝到服务器上

4、进行解压war包，配置yml相关参数，运行/WEB-INF/startup.bat脚本

5、若需优化jvm参数，编辑startup.bat修改JAVA_OPTS即可