Обновлено

Поддержка Spring Boot 3.4.0

• Функционал(тест): Улучшение набора тестовых случаев TCK
• Функционал(спринг): Реализация метода Namespaces.firstNotBlank с использованием String-инструментов Spring (@Chivenh)
• В зависимости: Обновление версии org.springframework.boot:spring-boot-dependencies до v3.4.0
• В зависимости: Обновление версии org.springframework.cloud:spring-cloud-dependencies до v2024
• В зависимости: Обновление версии com.google.guava:guava до v33.3.1-jre
• В зависимости: Обновление версии org.mybatis:mybatis до v3.5.17
• В зависимости: Обновление версии org.axonframework:axon-bom до v4.10.4
• В зависимости(тест): Обновление версии com.github.spotbugs до v6.0.26
• В зависимости(тест): Обновление версии junit5 до v5.11.1
• В зависимости(тест): Обновление версии org.junit.jupiter:junit-jupiter-params до v5.11.0
• В зависимости(тест): Обновление версии org.testcontainers:testcontainers-bom до v1.20.4
• Функционал(тест): Увеличение охвата юнит-тестами
• В зависимости(билд): Обновление версии gradle до v8.11.1

Обновлено

• Функционал(ядра): Предотвращение откатов часов в CacheClock.
• Функционал(mongo): Замена EnsureIdSegment на UPDATE_UPSERT_AFTER_OPTIONS для снижения количества запросов к базе данных.
• Внешние зависимости: Обновление версии com.google.guava:guava до v33.3.0-jre.
• Внешние зависимости(тестирование): Обновление версии junit5 до v5.11.0.
• Внешние зависимости(тестирование): Обновление версии org.junit.jupiter:junit-jupiter-params до v5.11.0.
• Внешние зависимости(тестирование): Обновление версии org.testcontainers:testcontainers-bom до v1.20.1.
• Внешние зависимости(построение): Обновление версии gradle до v8.10.

Обновленные изменения

• Функционал (mongo): Оптимизация блокирующих вызовов для клиентов реактивных API.
• В зависимости: Обновление версии org.springframework.cloud:spring-cloud-dependencies до v2023.0.3.
• В зависимости: Обновление версии org.springframework.boot:spring-boot-dependencies до v3.3.2.
• В зависимости: Обновление версии org.axonframework:axon-bom до v4.10.0.
• В зависимости (тест): Обновление версии com.github.spotbugs до v6.0.20.
• В зависимости (тест): Обновление версии org.hamcrest:hamcrest до v3.
• В зависимости (тест): Обновление версии org.testcontainers:testcontainers-bom до v1.20.1.
• В зависимости (билдинг): Обновление версии gradle до v8.10.

Обновлено

• Функционал (core): замена record на данные классы (data class) для повышения совместимости с Java 8
• Взаимозависимости: обновление версии junit5 до v5.10.3
• Взаимозависимости: обновление версии org.springdoc:springdoc-openapi-starter-webflux-ui до v2.6.0

Обновленные изменения

• Функционал(ядра): Добавлен DatePrefixIdConverter для поддержки строковых ID с префиксом даты
• Функционал(ядра): SegmentIdStat добавляет поддержку GroupedKey
• Функционал(spring-boot): Поддержка автоматической конфигурации 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
• В зависимости: Обновлен com.google.guava:guava до версии v33.2.1-jre
• В зависимости: Обновлен gradle до версии v8.8
• В зависимости: Обновлен docker/build-push-action до версии v6

DatePrefixIdConverter

Использует алгоритм SegmentId, требуя от выходного ID строки следующего формата:

• Формат: <префикс><дата><последовательность>
• Часть даты: шестизначная строка даты в формате yyMMdd
• Пример: BIZ-240618-25

Настройки

cosid:
  segment:
    enabled: true
    distributor:
      type: redis
    provider:
      date_prefix_no:
        converter:
          type: to_string
          prefix: BIZ-
          date-prefix:
            enabled: true
            pattern: yyMMdd

Статистика определения ID

{
  "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
        }
      }
    }
  }
}

Обновленные изменения

• Функционал: Поддержка последовательностей с группировкой по году 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
• Формат: <префикс><год><последовательность>
• Группировка: По годам, каждый год начинается с нулевой позиции.
• Количество цифр в последовательности: 8, недостающие цифры заполняются нулями слева.
• Пример: BIZ-2024-00000231

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
• Формат: <префикс><год_месяц><последовательность>
• Группировка: По годам и месяцам, каждое новое число месяца начинается с нулевой позиции.
• Количество цифр в последовательности: 8, недостающие цифры заполняются нулями слева.
• Пример: BIZ-240516-00000061

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
• Формат: <префикс><год_месяц_день><последовательность>
• Группировка: По дням, каждое новое число дня начинается с нулевой позиции.
• Количество цифр в последовательности: 8, недостающие цифры заполняются нулями слева.
• Пример: BIZ-240516-00000001

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

Обновленные зависимости

• Установлена новая версия зависимостей org.springframework.boot:spring-boot-dependencies: v3.2.3
• Обновлен com.github.spotbugs до версии v6.0.7
• Обновлен org.axonframework:axon-bom до версии v4.9.3
• Обновлен org.testcontainers:testcontainers-bom до версии v1.19.6
• Обновлен flowable до версии v7
• Обновлен gradle до версии v8.6
• Обновлен junit5 до версии v5.10.2

Обновлено

• Функционал (документация): Поддержка просмотра JavaDoc в официальной документации
• Зависимости: Обновление версии com.github.spotbugs до v6.0.6
• Зависимости: Обновление версии org.springframework.boot:spring-boot-dependencies до v3.2.2

Обновленные изменения

Официальный новый документ выпущен! https://ahoowang.gitee.io/cosid/

• Характеристики (doc): Используется VitePress вместо VuePress в качестве генератора статических документов
• Зависимости: Обновлена версия dependency org.springframework.boot:spring-boot-dependencies до v3.2.1
• Зависимости: Обновлена версия com.google.guava:guava до v33
• Зависимости: Обновлена версия com.github.spotbugs до v6.0.4
• Зависимости (расширение): Обновлена версия org.axonframework:axon-bom до v4.9.2
• Зависимости (расширение): Обновлена версия org.mybatis:mybatis до v3.5.15

🎉Обновленные изменения🎉

Добавлена единица тестирования модульной схемы (ModSpec) — тест равномерности разделения

• Зависимости: Обновление версии gradle до v8.5
• Зависимости: Обновление версии org.springframework.cloud:spring-cloud-dependencies до v2023
• Зависимости: Обновление версии com.github.spotbugs до v6.0.2
• Зависимости: Обновление версии org.gradle.test-retry до v1.5.8
• Зависимости: Обновление версии Docker-образа MongoDB до 6.0.12

Обновлено 🎉 🎉 🎉

Поддержка Spring-Boot 3.2.0

• Зависимости: Обновление версии org.springframework.boot:spring-boot-dependencies до v3.2.0
• Зависимости: Обновление версии org.mybatis.spring.boot:mybatis-spring-boot-starter до v3.0.3

Обновлено 🎉 🎉 🎉

Добавлена поддержка Activiti IdGenerator

• Функциональность: добавлена поддержка ActivitiIdGenerator
• Взаимозависимости: добавлена поддержка ActivitiIdGeneratorAutoConfiguration для автоматической конфигурации

Обновлено 🎉 🎉 🎉

Добавлена поддержка Flowable IdGenerator

• Функциональность: добавлена поддержка FlowableIdGenerator
• Взаимозависимость: добавлена поддержка автоматической конфигурации FlowableIdGeneratorAutoConfiguration
• Взаимозависимость: обновлено использование версии spring-boot v3.1.5

Обновленные изменения 🎉 🎉 🎉

Улучшение статистики состояния 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
        }
      }
    }
  }
}

Обновлено 🎉 🎉 🎉

Поддержка аннотаций @Id / @CosId в spring-data-jdbc

• Новая функциональность: поддержка аннотаций @Id / @CosId в spring-data-jdbc, автоматическое присвоение первичного ключа
• Новая функциональность: добавлена новая репозитория образов cosid-proxy (registry.cn-shanghai.aliyuncs.com/ahoo/cosid-proxy) для удобства использования внутри Китая
• Улучшено: расширены возможности OpenAPI для cosid-proxy

Обновленные возможности 🎉 🎉 🎉

Поддержка spring-boot-actuator

• Функциональность: Добавлены CustomizeSegmentIdProperties / CustomizeSnowflakeIdProperties, чтобы поддерживать конфигурацию Id через код
• Зависимости: Обновлена зависимость org.axonframework:axon-bom до версии v4.8.1
• Зависимости: Обновлена зависимость com.google.guava:guava до версии v32.1.2-jre
• Зависимости: Обновлена зависимость com.github.spotbugs до версии v5.1.0
• Функциональность: Поддержка spring-boot-actuator
  • Поддержка статистических (Statistical) API
  • Поддержка статистики генератора ID сегмента (SegmentIdStat)
  • Поддержка статистики генератора ID Snowflake (SnowflakeIdStat)
  • Добавлен CosIdEndpoint
  • Добавлен CosIdGeneratorEndpoint
  • Добавлен CosIdStringGeneratorEndpoint

management:
  endpoints:
    web:
      exposure:
        include:
          - cosid
          - cosidGenerator
          - cosidStringGenerator

Обновленные возможности (v2.2.0) 🎉 🎉 🎉

• Новая функция: Поддержка распределителя сгруппированных номерных сегментов (GroupedIdSegmentDistributor)

    share:
      group:
        by: year
      converter:
        type: to_string
        to-string:
          pad-start: true
          char-size: 8
        prefix: COSID-
        year-prefix:
          enabled: true
          delimiter: "-"

• Улучшение удобства использования: Пользовательская конвертация ID (IdConverter)

      converter:
        type: custom
        custom:
          type: me.ahoo.cosid.example.redis.controller.CustomIdConverter

• Внешние зависимости: Обновление org.springframework.boot:spring-boot-dependencies до версии v3.1.1

Обновлено (v2.1.0) 🎉 🎉 🎉

Примечание к обслуживанию: (v2.x) Изменено на основной (main) ветви обслуживания

• Обновлено зависимость org.springframework.boot:spring-boot-dependencies до v3.1.0
• Обновлено зависимость org.springframework.cloud:spring-cloud-dependencies до v2022.0.3
• Включены характеристики основной (main) ветви

⭐ Обновлено

• Добавлена машина распределения номеров MongoDB (MongoMachineIdDistributor), поддерживающая как синхронные, так и реактивные драйверы.

cosid:
  machine:
    enabled: true
    distributor:
      type: mongo

Обновлено

• Функционал: Добавлен MongoDB распределитель диапазонов