Transmitir dados para o Atlas - Kotlin SDK

Definir um objeto assimétrico

Você pode sincronizar dados unidirecionalmente quando esse objeto é um AsymmetricRealmObject. Defina um objeto assimétrico implementando a interface AsymmetricRealmObject :

// Implements the `AsymmetricRealmObject` interface
class WeatherSensor : AsymmetricRealmObject {
    @PersistedName("_id")
    @PrimaryKey
    var id: ObjectId = ObjectId()
    var deviceId: String = ""
    var temperatureInFarenheit: Float = 0.0F
    var barometricPressureInHg: Float = 0.0F
    var windSpeedInMph: Int = 0
}

Conecte-se e autentique-se com um App Services App

Para transmitir dados do cliente para seu aplicativo de backend, você deve conectar-se a um backend do App Services e autenticar um usuário.

val app = App.create(YOUR_APP_ID)
val user = app.login(credentials)

A ingestão de dados é uma funcionalidade do Flexible Sync, portanto, o aplicativo ao qual você se conecta deve usar o Flexible Sync.

Abrir um Realm

Depois de ter um usuário autenticado, você pode abrir um Realm sincronizado usando um SyncConfiguration. Especifique os tipos AsymmetricRealmObject que você deseja sincronizar.

val config = SyncConfiguration.create(user, setOf(WeatherSensor::class))
val realm = Realm.open(config)
Log.v("Successfully opened realm: ${realm.configuration.name}")

Ao contrário da sincronização bidirecional, a ingestão de dados não usa uma assinatura de Flexible Sync . Se você tiver objetos não assimétricos no mesmo território, poderá adicionar uma query de assinatura do Flexible Sync apenas para esses objetos.

Criar objetos assimétricos

Depois de abrir um Realm, você pode criar um AsymmetricRealmObject dentro de uma transação de escrita usando o método de extensão insert() :

// Open a write transaction
realm.write {
    // Create a new asymmetric object
    val weatherSensor = WeatherSensor().apply {
        deviceId = "WX1278UIT"
        temperatureInFarenheit = 6.7F
        barometricPressureInHg = 29.65F
        windSpeedInMph = 2
    }
    // Insert the object into the realm with the insert() extension method
    insert(weatherSensor)
// WeatherSensor object is inserted into the realm, then synced to the
// App Services backend. You CANNOT access the object locally because it's
// deleted from the local realm after sync is complete.
}

Você não pode ler esses objetos. Depois de criados, eles são sincronizados com o backend do App Services e o reconhecimento de data center vinculado do Atlas.

O Atlas Device Sync gerencia o ciclo de vida desses dados por completo. Ele é mantido no dispositivo até que a sincronização da ingestão de dados seja concluída e, em seguida, é removido do dispositivo.