JeeSite 4.0 开发环境部署运行调试(Eclipse)
博客专区 > ThinkGem 的博客 > 博客详情
JeeSite 4.0 开发环境部署运行调试(Eclipse)
ThinkGem 发表于3个月前
JeeSite 4.0 开发环境部署运行调试(Eclipse)
  • 发表于 3个月前
  • 阅读 19124
  • 收藏 30
  • 点赞 9
  • 评论 45

移动开发云端新模式探索实践 >>>   

环境要求

1、Java SDK 1.8 下载

2、Eclipse IDE for Java EE Mars 2 (4.5.2) 下载

3、Apache Maven 3.3+ 下载

4、MySql 5.7+ 下载

导入到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模式,否则建表的时候可能会出现问题

set session sql_mode='ONLY_FULL_GROUP_BY,STRICT_TRANS_TABLES,ERROR_FOR_DIVISION_BY_ZERO,NO_AUTO_CREATE_USER,NO_ENGINE_SUBSTITUTION';

2、 创建用户和授权

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连接

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.javacom.jeesite.test.InitGenData.java两个文件并打开,然后在空白处右键,点击 Run As -> JUnit Test 运行单元测试进行初始化数据库脚本。

启动Tomcat服务

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

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

server:

  port: 8080
  context-path: /jeesite
  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

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

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

清理Demo数据

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

DELETE FROM js_sys_company;
DELETE FROM js_sys_office;
DELETE FROM js_sys_post;
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里已配置,由于相关core项目的pom.xml里没有配置仓库地址,所以你需要根据【快速体验->本地运行】操作一遍,预先下载下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按钮即可。

今后如何升级?

尽量不修改web项目以外的源码项目,如jeesite-common、jeesite-modele-core,如果修改了,请尽量 Pull Requests 上来,否则代码编码将与官方不同步,将对你的日后升级带来困难。

JeeSite的小版本(4.0.x)升级是非常便捷的,你只需要进行Maven快照强制更新,即可将最新版的依赖jar更新到本地,下面介绍一下在Eclipse里如何操作:

在web项目上右键,选择菜单 -> Maven -> Update Project...(或按Alt+F5) -> 点击 Select All 按钮 -> 选择 Force Update of Snapshots/Releases 复选框 -> 点击OK按钮即可。

如果进行相对大的版本(4.x.x)升级这里我们会附加一个声明,帮助你进行迁移操作。

  • 打赏
  • 点赞
  • 收藏
  • 分享
共有 人打赏支持
ThinkGem
粉丝 818
博文 135
码字总数 20086
作品 1
评论 (45)
xusheng1987
打开/src/main/resources/config/jeesite.yml文件,配置你的服务端口port,这里应该是application.yml
ThinkGem

引用来自“xusheng1987”的评论

打开/src/main/resources/config/jeesite.yml文件,配置你的服务端口port,这里应该是application.yml
谢谢指正:blush:
请叫我酸奶
jeesite 都4.0啦 用了好长时间的老版本了
南京大猫
已经出来啦,真的太棒了!
hhi_world
java.util.concurrent.ExecutionException: org.apache.catalina.LifecycleException: Failed to start component [StandardEngine[Tomcat].StandardHost[localhost].TomcatEmbeddedContext[/jeesite4]]一直报这个错误
ThinkGem

引用来自“hhi_world”的评论

java.util.concurrent.ExecutionException: org.apache.catalina.LifecycleException: Failed to start component [StandardEngine[Tomcat].StandardHost[localhost].TomcatEmbeddedContext[/jeesite4]]一直报这个错误
错误信息不全没有办法定位问题,建议在这里提问:https://gitee.com/thinkgem/jeesite4/issues
脚步jn
数据导入不成功,怎么办呀!
ThinkGem

引用来自“脚步jn”的评论

数据导入不成功,怎么办呀!
什么错误信息呢?建议在这里提问:https://gitee.com/thinkgem/jeesite4/issues
李成梁
create database jeesite DEFAULT CHARSET utf8 COLLATE utf8_general_ci;
这里的数据库名叫jeesite ,下面配置JDBC的地方又叫jeesite4了,我说怎么一直出错呢,不严谨啊
SunYiJie
按照这篇博客一步一步来,结果数据库一直初始化失败,提示MAVEN父工程的坐标错误。然后关机回去睡觉,第二天打开用同样的操作,正常运行了
Max__Wang
作者可以用idea开发吗,感觉这个现在主流。配置更加容易点。用eclipse导入的时候使用application文件入口启动项目报错,是否需要修改其他的文件呢?
androidios
后台界面怎么更改呢?
ThinkGem

引用来自“androidios”的评论

后台界面怎么更改呢?

https://my.oschina.net/thinkgem/blog/1626539
ThinkGem
不限ide的,根据个人喜好选择,我还是用习惯了eclipse,你可以把错误信息发到issues里,看看具体什么问题
MATT0614
建议楼主别搞那么智能,脚本一键生成数据库。反而没以前那么容易跑起来。我反正是折腾一下午没折腾起来,以前的老版本下载下来就能跑一起。
ThinkGem

引用来自“MATT0614”的评论

建议楼主别搞那么智能,脚本一键生成数据库。反而没以前那么容易跑起来。我反正是折腾一下午没折腾起来,以前的老版本下载下来就能跑一起。
嗯,谢谢提议,发布正式的时候附带sql和dmp,写这个是为了支持多种数据库初始化用的。你这个什么问题可以到issues里贴上错误信息大家看看。
小小七aaa
还好先来看看评论排掉一些坑,一小时就跑起来了。:laughing:
丶青羽乄
公司要求使用jeesite,本人也把源码部署到自己的机器上跑起来了,但是不知道这个平台怎么使用,不知道能干些什么,请问官方能否出一份使用指南,最好配一些使用案例!
zhoujdong
代码生成的代码4.0有源码吗
ThinkGem

引用来自“丶青羽乄”的评论

公司要求使用jeesite,本人也把源码部署到自己的机器上跑起来了,但是不知道这个平台怎么使用,不知道能干些什么,请问官方能否出一份使用指南,最好配一些使用案例!
http://jeesite4.mydoc.io/ 里面配备的单表、主子表、树表增删改就是最好的入门例子。
×
ThinkGem
如果觉得我的文章对您有用,请随意打赏。您的支持将鼓励我继续创作!
* 金额(元)
¥1 ¥5 ¥10 ¥20 其他金额
打赏人
留言
* 支付类型
微信扫码支付
打赏金额:
已支付成功
打赏金额: