LocationListManagerExample.kt

Go to the documentation of this file.

import kotlinx.coroutines.delay
import kotlinx.coroutines.runBlocking
import kotlinx.coroutines.GlobalScope
import kotlinx.coroutines.launch
 
/**
 * LocationListManager usage example for Kotlin
 * Demonstrates working with location list management, downloading locations from server, and location information
 */
class LocationListManagerExample {
    private var sdk: NavigineSdk? = null
    private var locationListManager: LocationListManager? = null
    private var locationListListener: LocationListListener? = null
 
    init {
        initializeSdk()
        setupLocationListListener()
    }
 
    /**
     * Initialize SDK and get managers
     */
    private fun initializeSdk() {
        try {
            // [kotlin_NavigineSdk_getInstance]
            // Get SDK instance
            sdk = NavigineSdk.getInstance()
            // [kotlin_NavigineSdk_getInstance]
 
            // [kotlin_NavigineSdk_setUserHash]
            // Set user hash
            sdk?.setUserHash("USER-HASH-HERE")
            // [kotlin_NavigineSdk_setUserHash]
 
            // [kotlin_NavigineSdk_setServer]
            // Set server URL (optional)
            sdk?.setServer("https://custom.navigine.com")
            // [kotlin_NavigineSdk_setServer]
 
            // [kotlin_NavigineSdk_getLocationListManager]
            // Get LocationListManager for working with location lists
            locationListManager = sdk?.getLocationListManager()
            // [kotlin_NavigineSdk_getLocationListManager]
 
            if (locationListManager != null) {
                println("LocationListManager successfully initialized")
            }
        } catch (e: Exception) {
            System.err.println("Error initializing SDK: ${e.message}")
        }
    }
 
    /**
     * Setup location list listener
     */
    private fun setupLocationListListener() {
        locationListListener = object : LocationListListener() {
            // [kotlin_LocationListListener_onLocationListLoaded]
            override fun onLocationListLoaded(locationInfos: Map<Int, LocationInfo>) {
                println("Location list loaded")
                demonstrateLocationList(locationInfos)
            }
            // [kotlin_LocationListListener_onLocationListLoaded]
 
            // [kotlin_LocationListListener_onLocationListFailed]
            override fun onLocationListFailed(error: java.lang.Error) {
                println("Location list failed: ${error.message}")
                demonstrateErrorHandling(error)
            }
            // [kotlin_LocationListListener_onLocationListFailed]
        }
    }
 
    /**
     * Demonstrate LocationListManager methods
     */
    fun demonstrateLocationListManagerMethods() {
        val manager = locationListManager ?: run {
            System.err.println("LocationListManager not initialized")
            return
        }
 
        val listener = locationListListener ?: return
 
        // [kotlin_LocationListManager_addLocationListListener]
        // Add location list listener
        manager.addLocationListListener(listener)
        println("Added location list listener")
        // [kotlin_LocationListManager_addLocationListListener]
 
        // [kotlin_LocationListManager_updateLocationList]
        // Force reload location list
        manager.updateLocationList()
        println("Requested location list update")
        // [kotlin_LocationListManager_updateLocationList]
 
        // [kotlin_LocationListManager_getLocationList]
        // Get current location list
        val currentLocationList = manager.getLocationList()
        println("Current location list contains ${currentLocationList.size} locations")
        demonstrateLocationList(currentLocationList)
        // [kotlin_LocationListManager_getLocationList]
 
        // Simulate some time passing for location list updates
        GlobalScope.launch {
            delay(2000)
            
            // [kotlin_LocationListManager_removeLocationListListener]
            // Remove location list listener
            manager.removeLocationListListener(listener)
            println("Removed location list listener")
            // [kotlin_LocationListManager_removeLocationListListener]
        }
    }
 
    /**
     * Demonstrate location list
     */
    fun demonstrateLocationList(locationInfos: Map<Int, LocationInfo>) {
        if (locationInfos.isEmpty()) {
            println("Location list is empty")
            return
        }
 
        println("=== Location List ===")
        locationInfos.forEach { (locationId, locationInfo) ->
            demonstrateLocationInfo(locationInfo)
        }
        println("====================")
    }
 
    /**
     * Demonstrate LocationInfo usage
     */
    fun demonstrateLocationInfo(locationInfo: LocationInfo) {
        // [kotlin_LocationInfo_getId]
        // Get location ID
        val id = locationInfo.id
        println("Location ID: $id")
        // [kotlin_LocationInfo_getId]
 
        // [kotlin_LocationInfo_getVersion]
        // Get location version
        val version = locationInfo.version
        println("Location version: $version")
        // [kotlin_LocationInfo_getVersion]
 
        // [kotlin_LocationInfo_getName]
        // Get location name
        val name = locationInfo.name
        println("Location name: $name")
        // [kotlin_LocationInfo_getName]
 
        println("---")
    }
 
    /**
     * Demonstrate error handling
     */
    fun demonstrateErrorHandling(error: java.lang.Error) {
        println("Handling location list error:")
        println("  Error message: ${error.message}")
        println("  Error type: ${error.javaClass.simpleName}")
    }
 
    /**
     * Demonstrate advanced location list management features
     */
    suspend fun demonstrateAdvancedLocationListFeatures() {
        println("=== Advanced Location List Features ===")
 
        val manager = locationListManager ?: return
 
        // Add multiple listeners
        val listener1 = object : LocationListListener() {
            override fun onLocationListLoaded(locationInfos: Map<Int, LocationInfo>) {
                println("Listener 1: Location list loaded - ${locationInfos.size} locations")
            }
 
            override fun onLocationListFailed(error: java.lang.Error) {
                println("Listener 1: Location list failed - ${error.message}")
            }
        }
 
        val listener2 = object : LocationListListener() {
            override fun onLocationListLoaded(locationInfos: Map<Int, LocationInfo>) {
                println("Listener 2: Location list loaded - ${locationInfos.size} locations")
            }
 
            override fun onLocationListFailed(error: java.lang.Error) {
                println("Listener 2: Location list failed - ${error.message}")
            }
        }
 
        // [kotlin_LocationListManager_addLocationListListener_1]
        // Add first location list listener
        manager.addLocationListListener(listener1)
        println("Added first location list listener")
        // [kotlin_LocationListManager_addLocationListListener_1]
 
        delay(1000)
 
        // [kotlin_LocationListManager_addLocationListListener_2]
        // Add second location list listener
        manager.addLocationListListener(listener2)
        println("Added second location list listener")
        // [kotlin_LocationListManager_addLocationListListener_2]
 
        // Force update to trigger listeners
        manager.updateLocationList()
 
        // Wait for location list updates
        delay(3000)
 
        // Remove listeners
        // [kotlin_LocationListManager_removeLocationListListener_1]
        // Remove first location list listener
        manager.removeLocationListListener(listener1)
        println("Removed first location list listener")
        // [kotlin_LocationListManager_removeLocationListListener_1]
 
        delay(1000)
 
        // [kotlin_LocationListManager_removeLocationListListener_2]
        // Remove second location list listener
        manager.removeLocationListListener(listener2)
        println("Removed second location list listener")
        // [kotlin_LocationListManager_removeLocationListListener_2]
    }
 
    /**
     * Demonstrate location list simulation
     */
    fun demonstrateLocationListSimulation() {
        println("=== Location List Simulation ===")
 
        // Simulate different types of locations
        val simulatedLocations = mapOf(
            1001 to LocationInfo(1001, 1, "Shopping Mall"),
            1002 to LocationInfo(1002, 2, "Office Building"),
            1003 to LocationInfo(1003, 1, "Airport Terminal"),
            1004 to LocationInfo(1004, 3, "University Campus")
        )
 
        // Simulate location list loading
        GlobalScope.launch {
            delay(1000)
            println("Simulated location list loaded")
            demonstrateLocationList(simulatedLocations)
        }
 
        // Simulate location list update
        GlobalScope.launch {
            delay(3000)
            val updatedLocations = mapOf(
                1001 to LocationInfo(1001, 2, "Shopping Mall - Updated"),
                1002 to LocationInfo(1002, 3, "Office Building - Updated"),
                1003 to LocationInfo(1003, 2, "Airport Terminal - Updated"),
                1004 to LocationInfo(1004, 4, "University Campus - Updated"),
                1005 to LocationInfo(1005, 1, "New Hospital")
            )
            println("Simulated location list updated")
            demonstrateLocationList(updatedLocations)
        }
    }
 
    /**
     * Demonstrate location list listener management
     */
    fun demonstrateLocationListListenerManagement() {
        println("=== Location List Listener Management ===")
 
        val manager = locationListManager ?: return
 
        // Create a test listener
        val testListener = object : LocationListListener() {
            override fun onLocationListLoaded(locationInfos: Map<Int, LocationInfo>) {
                println("Test listener received location list: ${locationInfos.size} locations")
            }
 
            override fun onLocationListFailed(error: java.lang.Error) {
                println("Test listener received error: ${error.message}")
            }
        }
 
        // Add listener
        manager.addLocationListListener(testListener)
        println("Added test location list listener")
 
        // Force update to trigger listener
        manager.updateLocationList()
 
        // Simulate some time passing
        GlobalScope.launch {
            delay(2000)
            
            // Remove listener
            manager.removeLocationListListener(testListener)
            println("Removed test location list listener")
        }
    }
 
    /**
     * Main demonstration method
     */
    suspend fun runExample() {
        println("=== LocationListManager Example ===")
        
        demonstrateLocationListManagerMethods()
        demonstrateLocationListListenerManagement()
        demonstrateAdvancedLocationListFeatures()
        demonstrateLocationListSimulation()
        
        // Wait a bit for location list operations
        delay(5000)
        
        println("=== Example completed ===")
    }
}
 
/**
 * Function to run the example
 */
fun main() = runBlocking {
    val example = LocationListManagerExample()
    example.runExample()
}