Java SDK

Java SDK для можно. — клиентская библиотека для JVM-приложений. Оценивает флаги локально, синхронно, и интегрируется со Spring Boot через авто-конфигурацию. Совместим с JDK 17+ (артефакт собирается под Java 17), работает в любых JVM-фреймворках.

Установка

Gradle (Kotlin DSL)

repositories {
    mavenCentral()
}

dependencies {
    implementation("dev.mozhno:mozhno-client-java:1.1.1")
}

Gradle (Groovy DSL)

repositories {
    mavenCentral()
}

dependencies {
    implementation 'dev.mozhno:mozhno-client-java:1.1.1'
}

Совет: актуальную версию смотрите на странице релизов.

Системные требования

Требование	Минимальная версия
JDK	17+
Совместимость	Любой JVM-фреймворк (Spring Boot, Quarkus, Micronaut, Vanilla Java)

Конфигурация

Конфигурация создаётся через билдер MozhnoConfig.builder(), затем на её основе создаётся клиент DefaultMozhnoClient. Создавайте один экземпляр клиента и переиспользуйте его во всём приложении:

import dev.mozhno.sdk.MozhnoClient;
import dev.mozhno.sdk.MozhnoConfig;
import dev.mozhno.sdk.MozhnoContext;
import dev.mozhno.sdk.DefaultMozhnoClient;

MozhnoConfig config = MozhnoConfig.builder()
    .appName("my-app")
    .instanceId("instance-1")
    .mozhnoUrl("https://mozhno.example.com")
    .apiKey("<api-key>")
    .fetchTogglesInterval(15)
    .sendMetricsInterval(60)
    .environment("production")
    .build();

MozhnoClient client = new DefaultMozhnoClient(config);
client.start();

Параметры билдера

Метод	Тип	Обязательно	По умолчанию	Описание
appName(String)	String	Да	—	Идентификатор приложения
instanceId(String)	String	Да	—	Уникальный идентификатор экземпляра
mozhnoUrl(String)	String	Да	—	Базовый URL сервера можно.
apiKey(String)	String	Да	—	API-ключ окружения
fetchTogglesInterval(int)	int	Нет	15 сек	Интервал опроса флагов
sendMetricsInterval(int)	int	Нет	60 сек	Интервал отправки метрик
environment(String)	String	Нет	null	Имя окружения
disableMetrics(boolean)	boolean	Нет	false	Отключить отправку метрик
synchronousFetchOnInitialisation(boolean)	boolean	Нет	false	Блокировать на первичной загрузке правил
stickyAnonId(boolean)	boolean	Нет	true	Автогенерация стабильного анонимного ID для роллаута
contextProvider(MozhnoContextProvider)	—	Нет	null	Кастомный провайдер контекста
proxy(java.net.Proxy)	Proxy	Нет	null	HTTP-прокси

Интеграция со Spring Boot

SDK предоставляет авто-конфигурацию MozhnoAutoConfiguration. Настройка через application.yml:

mozhno:
  url: https://mozhno.example.com
  api-key: <api-key>
  app-name: my-app
  instance-id: ${random.uuid}
  environment: production
  fetch-toggles-interval: 15
  send-metrics-interval: 60
  sticky-anon-id: true

Клиент автоматически создаётся и доступен как Spring-бин:

@Service
public class CheckoutService {

    private final MozhnoClient mozhnoClient;

    public CheckoutService(MozhnoClient mozhnoClient) {
        this.mozhnoClient = mozhnoClient;
    }

    public boolean isNewCheckoutEnabled(String userId) {
        MozhnoContext context = MozhnoContext.builder()
            .userId(userId)
            .addProperty("country", "RU")
            .build();
        return mozhnoClient.isEnabled("new-checkout", context);
    }
}

MozhnoContext

Объект контекста на основе билдера для передачи атрибутов в момент оценки.

import dev.mozhno.sdk.MozhnoContext;

MozhnoContext context = MozhnoContext.builder()
    .userId("user-12345")
    .sessionId("session-abc")
    .addProperty("country", "RU")
    .addProperty("plan", "enterprise")
    .addProperty("appVersion", "2.4.1")
    .build();

Все значения атрибутов — строки. Для числовых сравнений задайте contextType: number в правилах таргетинга.

Анонимные пользователи и роллаут

Для процентного роллаута SDK использует userId, затем sessionId как идентификатор корзины. Если в контексте нет ни одного, клиент автоматически генерирует стабильный anonymousId (случайный UUID при старте клиента) и использует его — анонимные запросы распределяются по корзинам равномерно и стабильно для каждого экземпляра приложения. Отключить поведение можно через stickyAnonId(false) (или mozhno.sticky-anon-id: false в Spring) — тогда все анонимные запросы без идентификатора попадут в одну группу, а SDK выведет предупреждение в лог. Подробнее о поведении при обновлении SDK — в гайде по роллауту.

Методы билдера контекста

Метод	Описание
userId(String)	Идентификатор пользователя (используется для хеширования при процентном роллауте)
sessionId(String)	Идентификатор сессии (запасной ключ для хеширования)
appName(String)	Имя приложения
environment(String)	Имя окружения
addProperty(String key, String value)	Произвольный атрибут

Что дальше?

• JavaScript / TypeScript SDK — установка и интеграция с React
• Обзор SDK — архитектура и общие концепции
• Таргетинг — настройка правил и сегментов
• Быстрый старт — создание первого флага