README.md

一、项目简介

    本项目是机房报修管理系统的后端，基于SpringBoot框架搭建而成。机房报修机房管理系统实现前后端分离，所以此处项目仅是后端部分， 如需前端部分请点击右侧的超链接：点我跳转。

项目体验

    本项目已托管服务器中，各位可以通过下面的的连接访问网站进行体验，由于我提供的是超级管理员账户，所以任何人都能够自主删除管理员，希望各位体验的同学能够在做到以下几点：

• 不要胡乱删除管理员账号。

• 在产生了数据，如添加了管理员，实训室等操作，能够在登出的时候删除产生的数据，保持数据库的洁净。

• 添加维修工单可以上传图片，但希望不要涉及色情暴力的图片，亦不要上传过多的图片导致占满服务器带宽和容量。

• 体验地址：点我跳转

• 账户名：13842512341

• 密码：test13456

• 报修二维码（对应的二维码合一在后台生成并下载，如果后台在登录的状态下提交表单，会有自动刷新并且提示有新工单，间隔时间为30秒）

    本项目我将会以【机房报修管理系统】系列，以教程的形式发放在我的博客上：点我跳转，欢迎各位阅读我的文章。

文章目录：

【机房报修管理系统】1.简介篇 机房报修管理系统简介

【机房报修管理系统】后端篇（一） 设计数据表

【机房报修管理系统】后端篇（二） SpringBoot项目搭建

【机房报修管理系统】后端篇（三） 配置阿里巴巴Druid数据源

【机房报修管理系统】后端篇（四） 配置Mybitis、通用Mapper及Pagehelper

【机房报修管理系统】后端篇（五） 使用MybatisGenerator生成实体层和DAO层

【机房报修管理系统】后端篇（六） 配置Cros解决跨域问题

【机房报修管理系统】后端篇（七） 配置自定义JSON类及解决JSON的值空时不出现Null

【机房报修管理系统】后端篇（八） 配置接口管理利器——Swagger2

【机房报修管理系统】后端篇（九） 在SpringBoot配置非关系型数据库Redis

【机房报修管理系统】后端篇（十） Service层开发——管理员管理服务

【机房报修管理系统】后端篇（十一） 配置权限管理器——Shiro

【机房报修管理系统】后端篇（十二） Service层开发——工单管理服务

【机房报修管理系统】后端篇（十三） Service层开发——历史工单管理服务

【机房报修管理系统】后端篇（十四） Service层开发——实训室管理服务

【机房报修管理系统】后端篇（十五） Service层开发——实训楼管理服务

【机房报修管理系统】后端篇（十六） Service层开发——邮件服务

【机房报修管理系统】后端篇（十七） Service层开发——角色权限服务

【机房报修管理系统】后端篇（十八） Controller层开发——相关介绍Q&A

【机房报修管理系统】后端篇（十九） Controller层开发——管理员相关接口

【机房报修管理系统】后端篇（二十） Controller层开发——工单管理相关接口

【机房报修管理系统】后端篇（二十一） Controller层开发——历史工单相关接口

【机房报修管理系统】 后端篇（二十二）Controller层开发——二维码相关接口、Zip压缩以及定时任务

二、涉及到的技术

1.后端

（1）框架

• SpringBoot（含Spring、SpringMVC）

（2）数据库相关

• MySQL连接驱动：mysql-connector-java
• Redis操作工具：spring-boot-starter-data-redis
• Mybatis：mybatis-spring-boot-starter
• Mybatis通用Mapper：tk.mybatis
• 分页插件：com.github.pagehelper
• 阿里开源数据源: druid

（3）服务器

• SpringBoot自带Tomcat：spring-boot-starter-tomcat

（4）其他工具类

• SpringBoot测试：spring-boot-starter-test
• 密码加密工具：commons-codec
• 字符串判断工具：commons-lang3
• IO流工具：commons-io
• JavaBean工具：commons-beanutils
• 接口记录及调试工具：Swagger2
• 访问权限管理工具：Shiro
• 二维码生成器插件：qrcode-plugin
• 压缩文件工具：zip4j

2.项目构建工具

• Maven

3.数据库

• MySQL 5.7.10
• Redis 4.0.2

4.项目管理工具

• Git

5.本人电脑环境

• 操作系统：Windows10
• Java版本：1.8.0_172
• IDE：JetBrains IDEA 2018.2.6

三、项目预览截图

1.登录页

2.主页面

3.维修工单管理页

4.实训室管理页

5.二维码生成下载页

四、项目部署步骤

本项目推荐使用JetBrains IDEA打开，此次部署基于JetBrains IDEA，部署方式有两种：基于Git/SVN Clone,直接下载项目直接部署。

步骤基于已搭建MySQL和Redis的基础上

1.基于Git/SVN Colne的方式（推荐）

（一）点击上方的Clone or download按钮，复制红框中的链接。

（二）打开IDEA，点击Git。

（三）将复制的链接粘贴到URL中

（四）等待右下角的进度跑完

（五）把MySQL文件导入到MySQL数据库

MySQL文件位于项目根目录的MySQL文件夹中（建议数据库名为machineroomsystem）

（六） 打开aplication.propperties文件，修改MySQL和Redis为自己本机的用户和密码

（七）启动项目

打开RepairsystemApplication,右键Run即可

看见下图即为成功启动项目

访问http://localhost:8081/swagger-ui.html能够访问成功即部署成功

2.直接下载项目的方式

（一）点击上方的Clone or download按钮，点击Download ZIP

（二）解压文件，打开IDEA，选择Import Project,选中之前解压的文件夹

（三）根据上面基于Git/SVN Colne的方式的（三）~（七）步骤执行即可

五 项目结构

com
    └─repairsystem
        │  RepairsystemApplication.java
        │  ServletInitializer.java
        │
        ├─config
        │  │  CorsConfig.java
        │  │  DruidConfig.java
        │  │  JacksonConfig.java
        │  │  SchedulerTask.java
        │  │  Swagger2Config.java
        │  │
        │  └─shiro
        │          MyRedisSessionDao.java
        │          MySessionIdGenerator.java
        │          MyShiroRealm.java
        │          MySignOutFilter.java
        │          ShiroConfig.java
        │          ShiroRedisCache.java
        │          ShiroRedisCacheManager.java
        │
        ├─dao
        │      AdministratorMapper.java
        │      BuildingMapper.java
        │      ClassMapper.java
        │      CompleteOrderMapper.java
        │      OrdersMapper.java
        │      RoleMapper.java
        │
        ├─entity
        │  │  Administrator.java
        │  │  Building.java
        │  │  Class.java
        │  │  CompleteOrder.java
        │  │  Orders.java
        │  │  Role.java
        │  │
        │  └─vo
        │          AdministratorVO.java
        │          ClassVO.java
        │          CompleteOrderVO.java
        │          OrderVO.java
        │
        ├─exception
        │  │  AdministratorIdIsNullException.java
        │  │  AdministratorNameIsNullException.java
        │  │  AdministratorPasswordIsNullException.java
        │  │  AdministratorPhoneIsNullException.java
        │  │  BuildingIdIsNullException.java
        │  │  BuildingNameIdIsNullException.java
        │  │  ClassIdIsNullException.java
        │  │  ClassNameIsNullException.java
        │  │  CompleteOrderIdIsNullException.java
        │  │  OrderIdIsNullException.java
        │  │  PageIsNullException.java
        │  │
        │  └─handler
        │          GlobalExceptionHandler.java
        │
        ├─service
        │  │  AdministratorService.java
        │  │  BuildingService.java
        │  │  ClassService.java
        │  │  CompleteOrderService.java
        │  │  EmailService.java
        │  │  OrdersService.java
        │  │  RoleService.java
        │  │
        │  └─Impl
        │          AdministratorServiceImpl.java
        │          BuildingServiceImpl.java
        │          ClassServiceImpl.java
        │          CompleteOrderServiceImpl.java
        │          EmailServiceImpl.java
        │          OrdersServiceImpl.java
        │          RoleServiceImpl.java
        │
        ├─utils
        │      ConstantUtils.java
        │      Entity2VO.java
        │      JsonResult.java
        │      MyMapper.java
        │      OrderUploadUtils.java
        │      PageUtils.java
        │      PasswordEncryptionUtils.java
        │      QRCodeUtils.java
        │      SerializeUtil.java
        │      ZipUtils.java
        │
        └─web
            ├─controller
            │      AdministratorController.java
            │      BuildingController.java
            │      ClassController.java
            │      CompleteOrderController.java
            │      OrderController.java
            │      QRCodeController.java
            │
            └─ui