开发环境部署运行 # 环境要求 1、Java SDK 1.8 [下载](http://www.oracle.com/technetwork/cn/java/javase/downloads/jdk8-downloads-2133151-zhs.html) 2、Eclipse IDE for Java EE Mars 2 (4.5.2) [下载](https://www.eclipse.org/downloads/packages/eclipse-ide-java-ee-developers/mars2)（依Eclipse举例，IDEA雷同。） 3、Apache Maven 3.3+ [下载](https://maven.apache.org/download.cgi) 4、MySql 5.7+ [下载](https://dev.mysql.com/downloads/windows/installer/5.7.html) # 导入到Eclipse 1、检出JeeSite4源代码： ``` git clone https://gitee.com/thinkgem/jeesite4.git ``` 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、 创建用户和授权 ```sql set global read_only=0; 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连接 ```yml # 产品或项目名称、版本、版权年份 productName: JeeSite Demo productVersion: V4.0 copyrightYear: 2018 # 软件提供商公司或个人名称 companyName: 你的公司或个人名称 # 数据库连接 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、如果执行bat不成功，你也可以直接在Eclipse里找到`com.jeesite.test.InitCoreData.java`和`com.jeesite.test.InitGenData.java`两个文件并打开，然后在空白处右键，点击 Run As -> JUnit Test 运行单元测试进行初始化数据库脚本。 # 启动Tomcat服务 1、当前是Spring Boot工程，内部已经集成Web容器，你无需另外再下载Tomcat进行部署，只需按照以下方式进行即可。 2、打开`/src/main/resources/config/application.yml`文件，配置你的服务端口`port`、部署路径`context-path`，例如: ```yml 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数据 为了演示方法，初始化数据库后会载入一些演示数据，执行以下脚本即可清理 ```sql 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; ``` # 部署常见问题 * 管理员账号system与admin的区别：system为开发者使用的最高级别管理员，主要用于开发和调试，有些修改会直接影响系统的正常运行；admin为客户方使用的系统管理员，用于一些基础数据配置，如机构、用户、权限、用户字典等。 * 下载不到`jeesite-xxx.jar`依赖包：相关包已经发布到`Sonatype Repository`快照仓库，在`web`项目的`pom.xml`里已配置，有可能是你的 Maven `setting.xml`里添加了`mirror`或`repository`导致的问题，请清理或追加添加`Sonatype Repository`仓库地址，再尝试执行 /web`/bin/package.bat` 脚本，预先下载依赖jar包即可。 * IntelliJ IDEA中提示`NoClassDefFoundError: javax/servlet/ServletOutputStream `错误，你只需要修改web项目下的pom.xml,注释掉`spring-boot-starter-tomcat`的`<scope>provided</scope>`部分改为`<scope>compile</scope>`即可。 * 出现NoSuchMethodError错误，一般是依赖包版本需要更新，请尝试如下操作：在web项目上右键，选择菜单 -> Maven -> Update Project...（或按Alt+F5） -> 点击 Select All 按钮 -> 选择 Force Update of Snapshots/Releases 复选框 -> 点击OK按钮即可。 * MySql执行`init-data.bat`初始化数据失败，你可尝试设置下 my.ini 给 [mysqld] 增加如下配置：`sql_mode=ONLY_FULL_GROUP_BY,STRICT_TRANS_TABLES,ERROR_FOR_DIVISION_BY_ZERO,NO_AUTO_CREATE_USER,NO_ENGINE_SUBSTITUTION`