# boot-backend

**Repository Path**: zzcdr/boot-backend

## Basic Information

- **Project Name**: boot-backend
- **Description**: 此项目源码采用前后端分离方式，spring boot开发后端，使用shiro进行权限控制,layui、bootstrap、jquery、html为前端,基于json进行交互,接口完全采用Restful的风格，实现按钮级权限控制，可以作为开发项目的脚手架，做为基础项目。
- **Primary Language**: Java
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 268
- **Created**: 2022-12-02
- **Last Updated**: 2024-10-22

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# JavaWeb - SpringBoot脚手架

## 项目介绍
此项目源码采用前后端分离方式，spring boot开发后端，使用shiro进行权限控制,layui、bootstrap、jquery、html为前端,基于json进行交互,接口完全采用Restful的风格，实现按钮级权限控制，可以作为开发项目的脚手架，做为基础项目。项目内置了Tomcat。

## 环境要求
1. JDK8、Mysql、Maven、Lombok

## 初始化工作
1. 运行数据库脚本，在/文档和sql/db/boot_backend.sql
2. 配置信息在application.yml里，数据库的用户名、密码、ip、端口等，根据情况修改一下

## 使用说明
1. 安装运行文档在/文档和sql/01 安装运行.docx
1. 右键运行启动类com.blackteachan.server.ServerApplication
2. 访问http://localhost:8080，用户名和密码都是admin

## 项目目录
```
   src
    ├── main  
    │	├── java  
    │	│   └── com.blackteachan.projectname
    │	│       ├── config      配置类
    │	│       ├── constants   常量类
    │	│       ├── controller  Controller类
    │	│       ├── dao         Dao类
    │	│       ├── dto         Dto类
    │	│       ├── job         定时任务类
    │	│       ├── model       Entity类
    │	│       ├── service     Service类
    │   │       │   └── impl    ServiceImpl类
    │	│       ├── socket      Socket服务端
    │	│       └── utils       工具类
    │	└── resource
    │	    ├── mybatis-mapper  mybatis的mapper.xml
    │	    ├── static          前端目录
    │	    └── application.yml 项目配置文件
    └── test                    测试
```

## 开发说明
### 环境
1. 开发环境使用dev
1. 正式环境使用pro

### 统一规范
参考：[阿里巴巴开发手册](https://blackteachan.github.io/阿里巴巴Java开发手册（泰山版）.pdf)
1. `Controller`负责调用接口
2. `Service`定义业务
3. `ServiceImpl`实现业务逻辑
4. `Dao`定义持久层
5. `Mapper`执行SQL
6. 后台返回前台统一使用`ResponseInfo`封装

### 类
1. **`ServerApplication`**：启动类
2. **`ExceptionHandlerAdcice`**：全局异常处理类
2. **`ResponseInfo`**：后台返回数据封装类 
3. **`BaseController`**：基础控制器

### 注释
1. **`@RestMapping`**、**`@RestController`**
2. **`@Service`**
3. **`@Mapper`**
2. **`@PostMapping`**：提交
2. **`@GetMapping`**：获取
2. **`@PutMapping`**：更新
2. **`@DeleteMapping`**：删除
1. **`@Transactional`**: 回滚
2. **`@LogAnnotation`**：记录日志
4. **`@Data`**：实体类
5. **`@Slf4j`**：Slf4j日志
6. **`@ExceptionHandler`**：异常处理
7. **`@RestControllerAdvice`**：全局处理