Interface IInitializationCallback

This interface is used with IP2LocationService.Builder.buildAsync(IInitializationCallback) to receive notification when service initialization completes. The callback is invoked exactly once, either on success or failure.

Thread Safety

The callback is invoked from the initialization thread, not the thread that called buildAsync(). Implementations should be thread-safe if they interact with shared state.

Success Handling

On successful initialization:

• success is true
• error is null
• The service is ready to accept lookups
• Scheduled updates are running

Failure Handling

On initialization failure:

• success is false
• error contains the exception that caused the failure
• The service may be partially initialized (call IP2LocationService.dispose())
• Lookups will return error status until databases are loaded

Usage Example

IP2LocationService service = new IP2LocationService.Builder()
    .downloadToken("your-token")
    .database(Database.DB11_FULL)
    .buildAsync((svc, success, error) -> {
        if (success) {
            System.out.println("Service ready for lookups!");
        } else {
            System.err.println("Initialization failed: " + error.getMessage());
            // Optionally retry or fall back to alternative
        }
    });

// Service reference is available immediately, but may not be ready
// Use awaitReady() if you need to block until initialization completes
service.awaitReady(30, TimeUnit.SECONDS);

Lambda Usage

As a functional interface, callbacks can be expressed as lambdas:

// Simple success check
builder.buildAsync((svc, ok, err) -> {
    if (ok) startAcceptingRequests();
});

// With logging
builder.buildAsync((svc, ok, err) -> {
    if (ok) {
        log.info("IP2Location ready: IPv4={}, IPv6={}", 
                 svc.isIPv4Ready(), svc.isIPv6Ready());
    } else {
        log.error("IP2Location init failed", err);
    }
});