# springboot-box-im-starter

**Repository Path**: zhourui815/springboot-box-im-starter

## Basic Information

- **Project Name**: springboot-box-im-starter
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: AGPL-3.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-12-02
- **Last Updated**: 2025-12-03

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# springboot-box-im-starter


## 项目简介

`springboot-box-im-starter` 是一个基于 Spring Boot 的通用 IM 系统客户端 Starter，封装了 Token 管理、Redis 缓存、自动刷新、失败重试以及 GET/POST 请求，简化了调用需要 Token 鉴权接口的流程。

⚠️ 本项目以 IM 系统为示例，方案可用于其他需要 Token 鉴权的系统接口。

---

## 核心功能

1. Redis 缓存 Token，减少重复登录。
2. 分布式锁防止并发刷新 Token。
3. 接口调用失败自动刷新 Token 并重试一次。
4. GET/POST 请求封装，自动带 Token 和 clientId。
5. 支持返回对象泛型，可处理 JSON、Map 或自定义对象。

---

## 配置示例

### YAML 配置

```yaml
spring:
  data:
    redis:
      host: 127.0.0.1
      port: 6379
      database: 0
      password: xxxxx
im:
  auth:
    base-url: http://127.0.0.1:8889
    tenant-id: 000000
    username: admin
    password: xxxxx
    client-id: xxxxxxxxx
    grant-type: password