CosId 发行版 - Gitee.com

最新版

v3.0.3

1b983b8

2026-03-19 09:54

v3.0.3

## 🎉 CosId 3.0.3 正式发布：拥抱 Spring Boot 4.0

本次版本带来了多项重要更新，包括对 **Spring Boot 4.0** 的全面支持、机器 ID 分配机制的重构、全新的健康指标以及大量依赖升级，让分布式 ID 生成器更加稳定、高效且易于监控。

### 🚀 新特性与性能改进

*   **支持 Spring Boot 4.0**  
    紧跟生态步伐，全面兼容 Spring Boot 4.0，为现代应用提供无缝集成。

*   **重构机器 ID 分配与守卫机制**  
    将原有的 `MachineIdDistributor` 与 `MachineIdGuarder` 整合为全新的 **Guard Distribute** 模式，提升了分配过程的健壮性与可扩展性，同时引入状态跟踪与注册优化，让机器 ID 管理更可靠。

*   **机器 ID 健康指标**  
    为 Spring Boot Actuator 新增机器 ID 健康检查端点，实时监控机器 ID 状态，并增强了线程安全与文档说明，运维更安心。

*   **核心注解升级**  
    用 **JSpecify** 替换 Jakarta 注解，代码更规范，类型安全再上一层楼。

*   **Proxy 模块优化**  
    将 Jackson 依赖迁移至 `tools.jackson`，同时更新 Swagger 版本并优化自动配置排除项，API 文档生成更流畅。

### 📚 文档与生态

*   文档依赖全面升级，引入多语言支持和 `vitepress-plugin-llms`，文档体验大幅提升。
*   完善了核心类和 Spring Boot Starter 的 Javadoc，代码即文档，阅读更轻松。

### ⬆️ 依赖升级

本次版本同步升级了数十个核心依赖，确保与最新生态无缝衔接，包括但不限于：

*   Spring Boot → 4.0.3
*   Spring Cloud → 2025.1.1
*   Axon Framework → 4.13.0
*   MyBatis Spring Boot Starter → 4.0.1
*   MongoDB Driver → 5.6.4
*   Testcontainers → 2.x
*   JUnit → 6.0.3
*   Gradle → 9.3.1
*   pnpm → 10.30.3

### 🤝 新贡献者

感谢首次为 CosId 贡献代码的开发者：@qxo！

---
更多详情请访问 [CosId 项目官网](https://cosid.ahoo.me/)。

最后提交信息为： fix(deps): update flowable to v8

v2.13.0

343f633

2025-06-04 07:56

v2.13.0

最后提交信息为： build(deps): update coapi version to 1.12.0 (#804)

v2.10.1

150fd03

2024-12-11 10:33

v2.10.1

最后提交信息为： Update Version

v2.9.6

148d6a9

2024-09-05 12:32

v2.9.6

最后提交信息为： Update Version

v2.9.4

bda992f

2024-08-15 09:01

v2.9.4

最后提交信息为： feat(mongo): Optimize the blocking calls of the responsive API (#611)

v2.9.1

2b67b8b

2024-07-10 08:52

v2.9.1

最后提交信息为： Update Version

v1.20.0

889046e

2024-07-10 08:49

v1.20.0

最后提交信息为： Update Version

v2.9.0

70b1c86

2024-06-24 09:32

v2.9.0

## 更新内容

* 特性(core): 增加 `DatePrefixIdConverter` 以支持日期前缀的字符串ID
* 特性(core): `SegmentIdStat` 添加对`GroupedKey`的支持
* 特性(spring-bo0t): 支持`DatePrefix`自动配置
* 依赖: 升级 `org.springframework.boot:spring-boot-dependencies` 版本 `v3.3.1`
* 依赖: 升级 `dependency org.springframework.cloud:spring-cloud-dependencies` 版本 `v2023.0.2`
* 依赖: 升级 `com.github.spotbugs` 版本 `v6.0.18`
* 依赖: 升级 `om.google.guava:guava` 版本 `v33.2.1-jre`
* 依赖: 升级 `gradle ` 版本 `v8.8`
* 依赖: 升级 `ocker/build-push-action` 版本 `v6`

### `DatePrefixIdConverter`

使用 _SegmentId_ 算法，要求输出的ID字符串：
- 格式：`<prefix><date><sequence>`
- 日期位：6位日期字符串，格式`yyMMdd`
- 例如：`BIZ-240618-25`

> 配置

```yaml
cosid:
  segment:
    enabled: true
    distributor:
      type: redis
    provider:
      date_prefix_no:
        converter:
          type: to_string
          prefix: BIZ-
          date-prefix:
            enabled: true
            pattern: yyMMdd
```
> ID定义统计信息
```json
{
  "date_prefix_no": {
    "kind": "StringSegmentId",
    "actual": {
      "kind": "SegmentChainId",
      "fetchTime": 1718704101,
      "maxId": 20,
      "offset": 0,
      "sequence": 0,
      "step": 20,
      "isExpired": false,
      "isOverflow": false,
      "isAvailable": true,
      "groupedKey": {
        "key": "",
        "ttlAt": 9223372036854776000
      },
      "converter": {
        "kind": "Radix62IdConverter",
        "radix": 62,
        "charSize": 11,
        "padStart": true,
        "maxId": 9223372036854776000
      }
    },
    "converter": {
      "kind": "PrefixIdConverter",
      "prefix": "BIZ-",
      "actual": {
        "kind": "DatePrefixIdConverter",
        "pattern": "yyMMdd",
        "actual": {
          "kind": "ToStringIdConverter",
          "padStart": false,
          "charSize": 10
        }
      }
    }
  }
}
```

最后提交信息为： Update Version

v2.8.0

65b5abb

2024-05-16 17:53

v2.8.0

## 更新内容

* 特性: 支持按照日期分组重置的序列号 `YearGroupBySupplier` / `YearMonthGroupBySupplier` / `YearMonthDayGroupBySupplier`
* 依赖: 升级 `org.springframework.boot:spring-boot-dependencies` 版本 `v3.2.5`
* 依赖: 升级 `org.springframework.cloud:spring-cloud-dependencies` 版本 `v2023.0.1`
* 依赖: 升级 `com.github.spotbugs` 版本 `v6.0.14`
* 依赖: 升级 `org.axonframework:axon-bom` 版本 `v4.9.4`
* 依赖: 升级 `org.testcontainers:testcontainers-bom` 版本 `v1.19.8`
* 依赖: 升级 `flowable` 版本 `v7`
* 依赖: 升级 `gradle` 版本 `v8.7`

### `YearGroupBySupplier`

使用 _SegmentId_ 算法，要求输出的ID字符串：
- 起始序号：`0`
- 格式：`<prefix><year><sequence>`
- 分组：按年分组，每年序号从0开始。即每年序号需要重置为0.
- 序号位：8位数值，不足8位前补0
- 例如：`BIZ-2024-00000231`

```yaml
cosid:
  segment:
    enabled: true
    distributor:
      type: redis
    provider:
      group_year_biz:
        group:
          by: year
          pattern: yyyy
        converter:
          type: to_string
          to-string:
            pad-start: true
            char-size: 8
          prefix: BIZ-
          group-prefix:
            enabled: true
```

### `YearMonthGroupBySupplier`

使用 _SegmentId_ 算法，要求输出的ID字符串：
- 起始序号：`0`
- 格式：`<prefix><year_month><sequence>`
- 分组：按年月分组，序号从0开始。即跨月序号需要重置为0.
- 序号位：8位数值，不足8位前补0
- 例如：`BIZ-240516-00000061`

```yaml
cosid:
  segment:
    enabled: true
    distributor:
      type: redis
    provider:
      group_year_month_biz:
        group:
          by: year_month
          pattern: yyyyMM
        converter:
          type: to_string
          to-string:
            pad-start: true
            char-size: 8
          prefix: BIZ-
          group-prefix:
            enabled: true
```

### `YearMonthDayGroupBySupplier`

使用 _SegmentId_ 算法，要求输出的ID字符串：
- 起始序号：`0`
- 格式：`<prefix><year_month_day><sequence>`
- 分组：按日期分组，序号从0开始。即明天序号需要重置为0.
- 序号位：8位数值，不足8位前补0
- 例如：`BIZ-240516-00000001`

```yaml
cosid:
  segment:
    enabled: true
    distributor:
      type: redis
    provider:
      group_year_month_day_biz:
        group:
          by: year_month_day
          pattern: yyMMdd
        converter:
          type: to_string
          to-string:
            pad-start: true
            char-size: 8
          prefix: BIZ-
          group-prefix:
            enabled: true
```

最后提交信息为： feat(doc): Update specific-id.md (#565)

v2.6.6

1424b18

2024-02-23 14:11

v2.6.6

最后提交信息为： Update Version

v2.6.5

d735051

2024-01-20 13:04

v2.6.5

最后提交信息为： Update Version

v2.6.4

a5ec5ff

2024-01-03 16:36

v2.6.4

最后提交信息为： fix(deps): update dependency com.google.guava:guava to v33 (#512)

v2.6.2

4b1e7d9

2023-12-10 11:42

v2.6.2

最后提交信息为： feat: Refactor the test container image (#506)

v2.6.0

4a52658

2023-11-27 09:43

v2.6.0

最后提交信息为： fix: CI test. (#490)

v2.5.6

86296fd

2023-11-01 11:42

v2.5.6

最后提交信息为： feat: support ActivitiIdGeneratorAutoConfiguration (#467)

v2.5.5

98075ec

2023-10-25 11:28

v2.5.5

最后提交信息为： doc: update document

v2.5.0

a7c92d8

2023-08-17 08:43

v2.5.0

## 更新内容 🎉 🎉 🎉

> 增强`IdGenerator`状态统计

- 依赖：更新 `com.github.spotbugs` 版本 `v5.1.2`
- 依赖：更新 `org.openjdk.jmh` 版本 `v1.37`
- 依赖：更新 `org.springdoc:springdoc-openapi-starter-webflux-ui` 版本 `v2.2.0`
- 依赖：更新 `org.axonframework:axon-bom` 版本 `v4.8.2`
- 文档：更新 快速使用指南
- 重构：新增 `Decorator`标记接口到 `ClockSyncCosIdGenerator `
- 特性：增强`IdGenerator`状态统计以支持运行时调试查看
```
 GET http://127.0.0.1:8080/actuator/cosid
```
```
{
  "__share__": {
    "kind": "StringSegmentId",
    "actual": {
      "kind": "SegmentChainId",
      "fetchTime": 1692195877,
      "maxId": 430,
      "offset": 410,
      "sequence": 410,
      "step": 20,
      "isExpired": false,
      "isOverflow": false,
      "isAvailable": true,
      "converter": {
        "kind": "Radix62IdConverter",
        "radix": 62,
        "charSize": 11,
        "padStart": true,
        "maxId": 9223372036854775807
      }
    },
    "converter": {
      "kind": "PrefixIdConverter",
      "prefix": "COSID-",
      "actual": {
        "kind": "GroupedPrefixIdConverter",
        "delimiter": "-",
        "actual": {
          "kind": "ToStringIdConverter",
          "padStart": true,
          "charSize": 8
        }
      }
    }
  }
}
```

最后提交信息为： feat: Enhanced stats to support viewing ID generator status informa...