renmengkai / X-SpringBoot

X-SpringBoot是一个轻量级的Java快速开发平台,能快速开发项目并交付【接私活利器】

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

X-SpringBoot

Image text Image text Image text

更新日志 | 项目地址 | SpringCloud版本 |动态数据源

项目说明

  • X-SpringBoot 是一个轻量级的Java快速开发平台,基于各大开源项目组合而来,用于快速构建中小型API、RESTful API项目,该项目已经有过多个真实项目的实践,稳定、简单、快速,使我们摆脱那些重复劳动。
  • 本项目已大量重构,精简了大量代码减少第三方依赖,最干净的脚手架。
  • 引入了lombok 大量简化了代码
  • 引入了MyBatis Plus 大量简化了SQL
  • 引入hutool 工具包 规范工具类
  • 引入minio 分布式文件系统
  • 前后端完全脱离,前端代码可单独部署
  • 自定义Spring Security 支持获取token
  • 账号密码:admin/admin

版本信息

  • 核心框架:Spring Boot 2.1.8
  • 安全框架:Spring Security
  • 视图框架:Spring MVC 5.1.x
  • 持久层框架:MyBatis Plus 3.1.0
  • 日志管理:SLF4J 1.7、Log4j
  • 页面交互:Vue2.x

环境

  • jdk 1.8
  • mysql 5.7+
  • redis
  • nginx

项目结构

X-SpringBoot
├─doc  
│  ├─db.sql 项目SQL语句
│  ├─nginx.confi nginx 配置文件
│  ├─updateLog 更新日志
│
├─authentication 权限认证
├─common 公共模块
│  ├─annotation 自定义注解
│  ├─aspect 系统日志
│  ├─base base包
│  ├─exception 异常处理
│  ├─utils 一些工具类
│  ├─validator 后台校验
│  └─xss XSS过滤
│ 
├─config 配置信息
├─interceptor token拦截器
│ 
├─modules 功能模块
│  ├─app API接口模块(APP调用)
│  ├─oss 文件服务模块
│  ├─sys 权限模块
│  ├─apkversion APK 版本管理
│  └─gen 代码生成
│ 
├─Application 项目启动类
├─Swagger2 swagger2类
│  
├──resources 
│  ├─mapper SQL对应的XML文件


部署

  • 后台部署
  1、 $git clone https://github.com/yzcheng90/X-SpringBoot.git
  
  2 、IDEA 打开项目引入依赖
  
  3、 创建数据库x_springboot,数据库编码为UTF-8,执行doc/db.sql文件,初始化数据
  
  4、 IDEA运行Application.java,则可启动项目 http://localhost:8080
  • 前台部署
   1、 打开nginx 目录 /conf/nginx.conf 
   
   2、 在server中修改 root 和 index  
       
       ...
       server {
           ....
           #静态页面目录
           root  E:\github\X-SpringBoot\x-springboot-ui;
           #默认首页
           index  login.html;
           ....
           
           location ^~// {
                proxy_pass   http://127.0.0.1:8080; #这里为后台服务地址
           }
       }
       ...
       
       ( 这里建议直接复制项目中的doc/nginx.conf替换你的nginx配置文件,然后修改静态页面目录 )
       
    3、启动nginx 访问 localhost

系统截图 Image text Image text Image text

常见问题

1、启动报错

 是因为依赖没有引入  maven --> 先clear 再reimport 重新引入

2、验证码获取失败

1) redis没有启动
2) nginx 没有配置好
3) 如果部署的不是同一台机器,前台common.js中的url要改成ip

3、数据库连接不上(mysql 5.7)

1) 看看application.yml 配置文件中 spring.profiles.active: dev  
   当前配置的是dev ,就修改application-dev.yml 中的数据库连接IP用户密码
2) 如果改完了还是不行,看看你mysql版本8.0以上 须要修改pom.xml中的 mysql-connector-java 的版本

4、启动了nginx 还是不能访问前台

1) 确认一下nginx.conf 配置有没有问题

2)把所有的nginx的进程都结束再启动试试 (一般有很多个nginx的进程,结束一个再重新启动也是没用的)

3)如果项目目录名带T开头,nginx.conf 里面的目录要 双反斜杠 \\  或改为 正斜杠 / 

最后

  • 交流QQ群:17470566
  • 本人QQ:913624256
  • 如果喜欢,记得star fork 谢谢您的关注 x-springboot会持续维护

About

X-SpringBoot是一个轻量级的Java快速开发平台,能快速开发项目并交付【接私活利器】


Languages

Language:Java 99.4%Language:CSS 0.6%