# boot-framework

**Repository Path**: landashu/boot-framework

## Basic Information

- **Project Name**: boot-framework
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2024-05-16
- **Last Updated**: 2024-05-23

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

这是一个没有任何业务逻辑的纯后端单系统的框架，拿来即用，包含了国际化，全局异常处理，socket通信，文件上传，操作日志，运行日志，SQL初始化，是为提供编写系统级业务而创建的后端架构。

### 目录结构
```
|-- src
    |-- config 所有和业务无关的配置
        |-- i18n 国际化
        |-- prop 读取 application.yml 文件
        |-- security 认证逻辑的配置在这里
        |-- socket socket 基本配置
    |-- controller
    |-- domian
        |-- bo 切面对象
        |-- dto 传输对象
        |-- entity 数据库对象
        |-- vo  返回给前端对象
    |-- service
    |-- util
|-- resources
    |-- i18n 国际化配置文件
```

### 行为日志
行为日志使用方法切面的逻辑，只需要在你的 Controller 上加上 @LogAno("方法名称") 即可，
他会记录方法名称，请求参数，返回参数，请求IP，请求时间，请求URL，请求人，执行时间。如果你要修改包路径可以在 aspect/LogAspect.java 中修改
```java
@Around("execution(* com.fengqianrun.bootframework.controller..*(..))")
public Object Around(){}
```

### i18n
i18n 是完全配置好的，只需要在 resources/i18n/msg/ 目录下添加文件即可，文件名就是语言类型，比如 msg_ru.properties（俄语），`msg` 是一个前缀，这个前缀可以在 config/GlobalBeanConfig.java 中修改
```java
messageSource.setBasename("classpath:i18n/msg");
```
真正项目开发中，我们一般会校验参数，数据正确性等，所以你可以使用已经封装好的校验工具类，util/AssertCodeUtil.java
```java
AssertCodeUtil.objIsNull(null,BasicCode.BASIC_CODE_401);
```
会更方便的帮我们判断是否为空等逻辑，只需要传入错误代码即可完成校验并且返回国际化语言。
> 注意：
> 国际化需要前端传入语言类型，需要在请求头中设置 Accept-Language: en

### 认证鉴权
认证鉴权使用 easy-security，官网可见 https://easy-security.aizuda.com/ ,是一个非常轻量的鉴权框架，包含了前后端数据传输加密。