# Customized

**Repository Path**: jinlibo/customized

## Basic Information

- **Project Name**: Customized
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-08-13
- **Last Updated**: 2025-08-27

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

该项目是一个基于Spring Boot的定制化后端应用，实现了用户认证、权限控制、JWT令牌处理以及与Redis的集成。以下是项目的结构和主要组件概述：

### 主要功能

- **用户认证与权限控制**：使用Spring Security实现，包括登录、登出、权限验证等功能。
- **JWT令牌处理**：通过`JwtUtils`类生成和验证JWT令牌。
- **Redis集成**：用于缓存用户信息和其他数据，通过`RedisTemplate`和`RedissonClient`实现。
- **RESTful API**：提供用户管理相关的接口，如获取用户列表等。

### 项目结构

- **配置类**：
  - `JacksonConfig`：配置Jackson以支持JSON序列化和反序列化。
  - `Knife4jConfig`：配置Knife4j以生成API文档。
  - `RedisConfig`：配置Redis连接和序列化方式。
  - `RedissonConfig`：配置Redisson客户端。
  - `WebSecurityConfig`：配置Spring Security，包括过滤器链、认证管理器等。

- **控制器**：
  - `AuthController`：处理用户认证相关的请求。
  - `SysUserController`：处理用户管理相关的请求，如获取用户列表。

- **实体类**：
  - `SysUser`：表示系统用户的实体类，包含用户的基本信息和权限状态。

- **过滤器**：
  - `JsonLoginFilter`：处理JSON格式的登录请求。
  - `JwtCheckFilter`：检查JWT令牌的有效性，并在请求中进行身份验证。

- **处理器**：
  - `CustomAccessDeniedHandler`：处理访问被拒绝的情况。
  - `CustomAuthenticationEntryPoint`：处理未认证用户的访问。
  - `CustomAuthenticationFailureHandler`：处理认证失败的情况。
  - `CustomAuthenticationSuccessHandler`：处理认证成功的情况。
  - `CustomLogoutSuccessHandler`：处理登出成功的情况。
  - `CustomSessionInformationExpiredStrategy`：处理会话过期的情况。

- **服务类**：
  - `DBUserDetailsManager`：实现用户详情的加载和管理。
  - `SysUserService`：定义用户服务接口。
  - `SysUserServiceImpl`：实现用户服务接口的具体逻辑。

- **工具类**：
  - `JwtUtils`：提供JWT令牌的生成和验证功能。
  - `ResponseUtils`：提供响应数据的封装方法。
  - `CommonResponse`：统一的响应数据结构，用于返回给前端。

### 依赖管理

- **Maven**：使用`pom.xml`进行依赖管理，包含Spring Boot、Spring Security、MyBatis Plus、Redis、JWT等相关依赖。

### 配置文件

- **application.yml**：主配置文件，包含数据库连接、Redis配置、JWT密钥等。

### 数据库

- **MyBatis Plus**：使用MyBatis Plus进行数据库操作，`SysUserMapper`接口继承自`BaseMapper`，提供基本的CRUD操作。

### API文档

- **Knife4j**：通过Knife4j生成API文档，方便开发者查看和测试接口。

### 安全性

- **Spring Security**：提供全面的安全控制，包括认证、授权、CSRF保护等。
- **JWT**：使用JWT令牌进行无状态的身份验证，确保安全性。

### 缓存

- **Redis**：用于缓存用户信息和其他需要快速访问的数据，提升系统性能。

### 日志

- **Lombok**：使用Lombok的`@Slf4j`注解简化日志记录。

### 构建与部署

- **Spring Boot**：项目基于Spring Boot，支持快速启动和部署。

### 开发环境

- **Java 8+**：项目使用Java 8或更高版本。
- **Maven**：项目构建工具。
- **IDE**：推荐使用IntelliJ IDEA或Eclipse进行开发。

### 如何运行

1. **克隆仓库**：
   ```bash
   git clone https://gitee.com/jinlibo/customized.git
   ```

2. **安装依赖**：
   ```bash
   cd customized
   mvn clean install
   ```

3. **启动应用**：
   ```bash
   mvn spring-boot:run
   ```

4. **访问API文档**：
   打开浏览器访问`http://localhost:8080/doc.html`，查看和测试API接口。

### 贡献指南

- **提交Issue**：如果您发现任何问题或有改进建议，请提交Issue。
- **提交Pull Request**：欢迎提交代码贡献，帮助我们改进项目。

### 许可证

该项目使用MIT许可证，详情请参阅LICENSE文件。

---

以上是该项目的简要介绍和主要组件说明。如需更详细的文档或帮助，请参考项目中的源代码和配置文件。