Under-Utils
stable 1.0.4 1.0.5-SNAPSHOT
starter

Spring Starter

under-utils-spring-starter

请求上下文、限流、防重复提交、本地 store 和基础 SPI 自动装配。

依赖

under-utils-spring-starter Maven 坐标 
<dependency>
    <groupId>io.github.yexianglun-d</groupId>
    <artifactId>under-utils-spring-starter</artifactId>
    <version>1.0.4</version>
</dependency>

适用场景

普通 Spring Boot 服务的首选轻量入口。

能力边界

文档来源 under-utils-spring-starter/README.md
API 入口 查看 Spring Starter 相关 API
设计约束 保留失败语义、配置 key 和 public API 兼容性说明，不以营销描述替代真实边界。
无 Redis 依赖 该能力来自当前模块 README 或 API Review，页面下方同步展示原始 README 内容。
本地状态主动清理 该能力来自当前模块 README 或 API Review，页面下方同步展示原始 README 内容。
保持 under.utils.* 配置前缀 该能力来自当前模块 README 或 API Review，页面下方同步展示原始 README 内容。

README 同步内容

来源：under-utils-spring-starter/README.md，构建时自动读取并渲染。

Spring Boot 自动装配模块，只接入 under-utils-spring 的本地横切能力，不引入 under-utils-redis 和 Redisson。

适合只需要请求上下文、限流、防重复提交、服务层幂等、操作 key 和本地状态存储的服务。

依赖

<dependency>
    <groupId>io.github.yexianglun-d</groupId>
    <artifactId>under-utils-spring-starter</artifactId>
    <version>1.0.4</version>
</dependency>

自动装配 Bean

默认 Bean：

  • CurrentUserProvider
  • CurrentTenantProvider
  • TraceIdProvider
  • OperationKeyResolver
  • IdempotentKeyResolver
  • IdempotencyResultCodec
  • OperationContextFilter
  • OperationContextTaskDecorator
  • RateLimitAspect
  • PreventRepeatAspect
  • IdempotentAspect
  • local RateLimitStore
  • local RepeatSubmitStore
  • local IdempotencyStore

默认不会注册 GlobalExceptionHandler，避免接管业务已有响应契约。

配置

under:
  utils:
    web:
      operation-context:
        enabled: true
        task-decorator-enabled: true
        trusted-identity-headers: false
        trusted-proxy-headers: false
      exception-handling:
        enabled: false
      rate-limit:
        enabled: true
        store: local
      repeat-submit:
        enabled: true
        store: local
    idempotent:
      enabled: true
      store: local
      key-prefix: "under-utils:idempotent:"
      processing-ttl: 30s
      result-ttl: 5m
      local-max-entries: 100000
      local-cleanup-interval: 1s

trusted-identity-headers 只有在服务位于可信网关之后，且网关会清洗 X-User-Id / X-Tenant-Id 时才应开启。 trusted-proxy-headers 只有在可信网关会清洗 X-Forwarded-For / X-Real-IP 时才应开启；默认使用 servlet container 提供的 remote address。

exception-handling.enabled=true 后，starter 才会注册 GlobalExceptionHandler 并返回 Under-Utils Result 响应模型。

退让规则

starter 不会替换业务项目中同角色 Bean。常见退让点：

  • CurrentUserProvider
  • CurrentTenantProvider
  • TraceIdProvider
  • OperationKeyResolver
  • IdempotentKeyResolver
  • TaskDecorator
  • RateLimitStore
  • RepeatSubmitStore
  • IdempotencyStore
  • IdempotencyResultCodec

多实例服务如果需要集群级限流、防重复提交或服务层幂等，应使用 under-utils-redis-starter，或自行实现对应 store。