AI conditionals-spring-boot: расширяем возможности @Conditional

[AI]

В мире Spring Boot почти каждый сталкивался с аннотациями @ConditionalOnProperty, @ConditionalOnBean и их собратьями. Они помогают конфигурировать бины динамически, но стандартные условия это только вершина айсберга. Что если вам нужен гибкий, декларативный, строго-типизированный, который понимает Collection, Map, Enum и т.д.?

Именно для этого я разработал conditionals-spring-boot - маленькую библиотеку для расширенных conditional-аннотаций, полностью интегрируемую с Spring Boot 3 и Java 17.

Почему стандартные условия не всегда работают​

В Spring Boot @ConditionalOnProperty позволяет проверять простые свойства, но:

• 
  Нельзя писать простые сравнения и матчи с помощью аннотаций (@ConditionalOnExpression не в счет).
  
  
• 
  Нельзя строго типизировать значение (в обычном Spring Boot есть только String и boolean).
  

Что умеет моя библиотека​

1. Поддержка многих часто используемых типов:​

Ниже можно увидеть несколько примеров использования аннотаций библиотеки:

@ConditionalOnStringProperty​

@ConditionalOnStringProperty(
        name = "app.region",
        havingValue = "eu",
        trim = true
)

@ConditionalOnStringProperty(
        name = "app.region",
        havingValue = "EU",
        ignoreCase = true
)

@ConditionalOnStringProperty(
        name = "app.version",
        havingValue = "v\\d+\\.\\d+",
        matchType = StringMatchType.MATCHES
)

@ConditionalOnIntegerProperty​

@ConditionalOnIntegerProperty(
        name = "app.threads",
        havingValue = 4
)

@ConditionalOnIntegerProperty(
        name = "app.threads",
        havingValue = 16,
        matchType = ComparableMatchType.LESS_THAN
)

@ConditionalOnFloatProperty​

@ConditionalOnFloatProperty(
        name = "app.ratio",
        havingValue = 0.5f
)

@ConditionalOnFloatProperty(
        name = "app.ratio",
        havingValue = 0.7F,
        matchType = ComparableMatchType.GREATER_THAN_OR_EQUAL
)

@ConditionalOnDurationProperty​

@ConditionalOnDurationProperty(
        name = "app.timeout",
        havingValue = "5s",
        matchType = ComparableMatchType.GREATER_THAN
)

@ConditionalOnDurationProperty(
        name = "app.timeout",
        havingValue = "10s"
)

@ConditionalOnCharacterProperty(
        name = "app.letter",
        havingValue = 'A'
)

@ConditionalOnCollectionProperty​

@ConditionalOnCollectionProperty(
        name = "app.tags",
        havingValue = {"red", "blue"},
        matchType = CollectionMatchType.CONTAINS_ALL
)

@ConditionalOnCollectionProperty(
        name = "app.tags",
        havingValue = {"yellow", "green"},
        matchType = CollectionMatchType.CONTAINS_ANY
)

@ConditionalOnCollectionProperty(
        name = "app.tags",
        size = 3
)

@ConditionalOnMapProperty​

@ConditionalOnMapProperty(
        name = "app.labels",
        havingValue = {                         // массив ключ-значение
                "env", "prod",
                 "region", "eu"
        },
        matchType = MapMatchType.CONTAINS_ALL
)

@ConditionalOnMapProperty(
        name = "app.labels",
        havingValue = {"env", "prod"},  // массив ключ-значение
        matchType = MapMatchType.CONTAINS_ANY
)

@ConditionalOnEnumProperty​

@ConditionalOnEnumProperty(
        name = "app.labels",
        havingValue = "info",               // не кейс-сенситив
        enumType = LogLevel.class
)

enum LogLevel {
    TRACE, DEBUG, INFO, WARN, ERROR
}

2. Repeatable и контейнерные аннотации​

Практически все аннотации можно повторять (кроме @ConditionalOnOs и @ConditionalOnPortAvailable).

3. Унифицированная спецификация через PropertySpec​

4. Проверку ОС:​

@ConditionalOnOs("linux")

5. Проверку занятости порта:​

@ConditionalOnPortAvailable(8080)

Внутри библиотеки все property-based условия описаны через единый контракт PropertySpec + PropertySpecMatcher. Это минимизирует копипасту и упрощает тестирование.

Кому это будет полезно​

• 
  Разработчикам библиотек и модулей для Spring Boot.
  
  
• 
  Командам, которые пишут DSL на основе configuration properties.
  
  
• 
  Тем, кто сталкивался с boilerplate и ограничениями стандартных @Conditional аннотаций.
  

Заключение​

Если вам интересно попробовать, документация и примеры доступны на GitHub. (и поставьте звёздочку 😀)