Java

import com.toggleai.sdk.ToggleAIClient;
import com.toggleai.sdk.ToggleAIOptions;
import com.toggleai.sdk.models.Payloads.EvaluationContext;
import com.toggleai.sdk.models.Payloads.FlagEvaluationResult;

public class Application {
    public static void main(String[] args) {
        // Instantiate Options
        ToggleAIOptions options = new ToggleAIOptions();
        options.setClientId("pk_live_xxx");
        options.setSecret("sk_live_xxx");
        options.setPollingIntervalMs(30000);

        ToggleAIClient client = new ToggleAIClient(options);
        
        // Initialize client (fetches rules, starts background thread pool)
        client.init();

        // Create evaluation context
        EvaluationContext ctx = new EvaluationContext("user_123", Map.of("plan", "premium"));

        // 1. Evaluate Feature Flag (Synchronous local evaluation)
        FlagEvaluationResult result = client.getFlag("new-checkout", ctx);
        if (result.enabled) {
            System.out.println("Show new checkout layout");
        }

        // 2. Typed Flag Value
        String buttonColor = client.getFlagValue("button-color", ctx, "#000000", String.class);

        // 3. Remote Config Value
        int timeout = client.getConfig("api_timeout_ms", 5000, Integer.class);

        // Graceful shutdown (terminates scheduler thread pools and flushes logs)
        client.close();
    }
}

@Configuration
public class ToggleAIConfig {

    @Value("${toggleai.client-id}")
    private String clientId;

    @Value("${toggleai.secret}")
    private String secret;

    @Bean(destroyMethod = "close")
    public ToggleAIClient toggleAIClient() {
        ToggleAIOptions options = new ToggleAIOptions();
        options.setClientId(clientId);
        options.setSecret(secret);
        options.setPollingIntervalMs(30000);

        ToggleAIClient client = new ToggleAIClient(options);
        client.init(); // Blocks until initial config is fetched successfully
        return client;
    }
}

@RestController
@RequestMapping("/api")
public class CheckoutController {

    @Autowired
    private ToggleAIClient client;

    @GetMapping("/checkout")
    public ResponseEntity<?> checkout(@RequestParam String userId) {
        EvaluationContext ctx = new EvaluationContext(userId, Map.of("platform", "web"));
        
        boolean showNew = client.getFlag("new-checkout", ctx).enabled;
        
        if (showNew) {
            return ResponseEntity.ok(Map.of("ui", "new"));
        }
        return ResponseEntity.ok(Map.of("ui", "legacy"));
    }
}

import com.toggleai.sdk.ToggleAIException;

try {
    client.init();
} catch (ToggleAIException e) {
    switch (e.getCode()) {
        case "INVALID_KEY":   System.err.println("Verify your API key pair."); break;
        case "NETWORK_ERROR": System.err.println("Cannot reach ToggleAI servers."); break;
        case "RATE_LIMITED":  System.err.println("Too many requests."); break;
        default:              System.err.println("Initialization failed: " + e.getMessage());
    }
}