com.statsig.Statsig Maven / Gradle / Ivy

Go to download
Show more of this group Show more artifacts with this name
Show all versions of serversdk-test Show documentation
A Server SDK for macOS platform
There is a newer version: 0.28.0
package com.statsig;

import com.google.gson.Gson;
import com.statsig.internal.GsonUtil;

import java.util.Map;
import java.util.concurrent.CompletableFuture;

public class Statsig implements AutoCloseable {
    private static final Gson gson = GsonUtil.getGson();

    private final int statsigRef;

    /**
     * Instantiates a new Statsig instance that connects to Statsig Service.
     * 
     * It is recommended to create a single instance for the entire application's lifecycle. In rare situations where
     * the application requires feature evaluation from different Statsig projects or environments, you may instantiate
     * multiple instances. However, these should be maintained throughout the application's lifecycle, rather than
     * being created for each request or thread.
     *
     * @param sdkKey  secret key to connect to Statsig Service
     * @param options a customized instance of StatsigOptions that configures the behavior of the
     *                Statsig instance.
     */
    public Statsig(String sdkKey, StatsigOptions options) {
        this.statsigRef = StatsigJNI.statsigCreate(sdkKey, options.getRef());
    }

    public int getRef() {
        return statsigRef;
    }

    public CompletableFuture initialize() {
        CompletableFuture future = new CompletableFuture<>();
        Runnable callback = () -> {
            // Complete the future when the native operation is done
            future.complete(null);
        };

        StatsigJNI.statsigInitialize(statsigRef, callback);
        return future;
    }

    public boolean checkGate(StatsigUser user, String gateName) {
        return StatsigJNI.statsigCheckGate(statsigRef, user.getRef(), gateName);
    }

    public String getExperiment(StatsigUser user, String experimentName) {
        String experJson = StatsigJNI.statsigGetExperiment(statsigRef, user.getRef(), experimentName);
        return experJson;
        //return gson.fromJson(experJson, Experiment.class);
    }

    public DynamicConfig getDynamicConfig(StatsigUser user, String configName) {
        String configJson = StatsigJNI.statsigGetDynamicConfig(statsigRef, user.getRef(), configName);
        return gson.fromJson(configJson, DynamicConfig.class);
    }

    public Layer getLayer(StatsigUser user, String layerName) {
        String layerJson = StatsigJNI.statsigGetLayer(statsigRef, user.getRef(), layerName);
        return gson.fromJson(layerJson, Layer.class);
    }

    public FeatureGate getFeatureGate(StatsigUser user, String gateName) {
        String gateJson = StatsigJNI.statsigGetFeatureGate(statsigRef, user.getRef(), gateName);
        FeatureGate featureGate = gson.fromJson(gateJson, FeatureGate.class);
        featureGate.setRawJson(gateJson);
        return featureGate;
    }

    public void logEvent(StatsigUser user, String eventName, String value, Map metadata) {
        StatsigJNI.statsigLogEvent(statsigRef, user.getRef(), eventName, value, metadata);
    }

    public CompletableFuture flushEvents() {
        CompletableFuture future = new CompletableFuture<>();
        Runnable callback = () -> {
            future.complete(null);
        };

        StatsigJNI.statsigFlushEvents(statsigRef, callback);
        return future;
    }

    public String getClientInitializeResponse(StatsigUser user) {
        return StatsigJNI.statsigGetClientInitResponse(statsigRef, user.getRef());
    }

    public CompletableFuture shutdown() {
        CompletableFuture future = new CompletableFuture<>();
        Runnable callback = () -> {
            // Complete the future when the native operation is done
            future.complete(null);
        };

        StatsigJNI.statsigShutdown(statsigRef, callback);
        this.close();
        return future;
    }

    @Override
    public void close() {
        if (statsigRef != 0) {
            StatsigJNI.statsigRelease(statsigRef);
        }
    }
}