guns项目学习路程

guns开源项目学习之路

1、guns介绍
Guns基于Spring Boot2，致力于做更简洁的后台管理系统。包含系统管理，代码生成，多数据库适配，SSO单点登录，工作流，短信，邮件发送，OAuth2登录，任务调度，持续集成，docker部署等功。支持Spring Cloud Alibaba微服务。

管理系统功能

	1.用户管理 2.角色管理 3.部门管理 4.菜单管理 5.字典管理 6.业务日志 7.登录日志 8.监控管理 9.通知管理 10.职务管理 11.代码生成 12.在线参数配置

项目特点

	基于SpringBoot，简化了大量项目配置和maven依赖，让您更专注于业务开发，独特的分包方式，代码多而不乱。
	完善的日志记录体系，可记录登录日志，业务操作日志(可记录操作前和操作后的数据)，异常日志到数据库，通过@BussinessLog注解和LogObjectHolder.me().set()方法，业务操作日志可具体记录哪个用户，执行了哪些业务，修改了哪些数据，并且日志记录为异步执行，详情请见@BussinessLog注解和LogObjectHolder，LogManager，LogAop类。
	利用beetl模板引擎对前台页面进行封装和拆分，使臃肿的html代码变得简洁，更加易维护。
	对常用js插件进行二次封装，使js代码变得简洁，更加易维护。
	controller层采用map + warpper方式的返回结果，返回给前端更为灵活的数据，具体参见com.stylefeng.guns.modular.system.warpper包中具体类。
	防止XSS攻击，通过XssFilter类对所有的输入的非法字符串进行过滤以及替换。
	简单可用的代码生成体系，通过SimpleTemplateEngine可生成带有主页跳转和增删改查的通用控制器、html页面以及相关的js，还可以生成Service和Dao，并且这些生成项都为可选的，通过ContextConfig下的一些列xxxSwitch开关，可灵活控制生成模板代码，让您把时间放在真正的业务上。
	控制器层统一的异常拦截机制，利用@ControllerAdvice统一对异常拦截，具体见com.stylefeng.guns.core.aop.GlobalExceptionHandler类。
	页面统一的js key-value单例模式写法，每个页面生成一个唯一的全局变量，提高js的利用效率，并且有效防止多个人员开发引起的函数名/类名冲突，并且可以更好地去维护代码。
	在线系统参数配置，灵活控制常用功能的开关，无需重启项目即可生效，实时刷新。

2、导入项目到idea
项目地址 ： https://gitee.com/stylefeng/guns
项目官网 ：https://www.stylefeng.cn/
另外，这个项目还提供了视频教你如何使用，地址：https://www.bilibili.com/video/av56718207 。

Fork项目到自己的个人用户中
打开idea导入项目

在此输入项目的url


下载后的项目目录结构如下图

打开数据库生成代码生成系统表

打开数据源配置文件更改数据源地址

至此，项目的初步搭建就完成了，启动看看效果

在项目初始话遇到的问题

1、端口占用
这个问题我们就需要修改启动端口了，修改方法如下

2、数据库连接错误

这种情况首先需要判断数据库的连接地址是否正确，然后判断是否是时区的问题引起的;时区的查看及修改如下;
mysql数据库创建后。默认的时区比东八区少了八个小时。如果sql语句中使用到mysql的时间的话就会比正常时间少了八个小时。所以需要修改mysql的系统时区。
使用mysql连接工具或者命令好工具都可以。我用workbench输入命令行：
select now(); 查看mysql系统时间。和当前时间做对比
set global time_zone = ‘+8:00’;设置时区更改为东八区
flush privileges; 刷新权限
然后退出后重新登录就可以了，显示当前时间和我现在的时间一致了。

3、登录出现问题

这个问题原因是：
JAXB API是java EE 的API，因此在java SE 9.0 中不再包含这个 Jar 包。
java 9 中引入了模块的概念，默认情况下，Java SE中将不再包含java EE 的Jar包
而在 java 6/7 / 8 时关于这个API 都是捆绑在一起的
解决方法如下

在上图位置加入

javax.xml.bind
jaxb-api
2.3.0


com.sun.xml.bind
jaxb-impl
2.3.0


com.sun.xml.bind
jaxb-core
2.3.0


javax.activation
activation
1.1.1

到此终于可以只用了