ConnectionMigrationOptions

class ConnectionMigrationOptions


A class configuring Cronet's connection migration functionality.

Connection migration stops open connections to servers from being destroyed when the client device switches its L4 connectivity (typically the IP address as a result of using a different network). This is particularly common with mobile devices losing wifi connectivity and switching to cellular data, or vice versa (a.k.a. the parking lot problem). QUIC uses connection identifiers which are independent of the underlying transport layer to make this possible. If the client connects to a new network and wants to preserve the existing connection, they can do so by using a connection identifier the server knows to be a continuation of the existing connection.

The features are only available for QUIC connections and the server needs to support connection migration.

Summary

Nested types

Builder for ConnectionMigrationOptions.

An annotation for APIs which are not considered stable yet.

Public functions

builder

java-static fun builder(): ConnectionMigrationOptions.Builder!

getAllowNonDefaultNetworkUsage

fun getAllowNonDefaultNetworkUsage(): Boolean?

getAllowServerMigration

fun getAllowServerMigration(): Boolean?

getEnableDefaultNetworkMigration

fun getEnableDefaultNetworkMigration(): Boolean?

getEnablePathDegradationMigration

fun getEnablePathDegradationMigration(): Boolean?

getIdleMigrationPeriodSeconds

fun getIdleMigrationPeriodSeconds(): Long?

getMaxPathDegradingEagerMigrationsCount

fun getMaxPathDegradingEagerMigrationsCount(): Int?

getMaxTimeOnNonDefaultNetworkSeconds

fun getMaxTimeOnNonDefaultNetworkSeconds(): Long?

getMaxWriteErrorEagerMigrationsCount

fun getMaxWriteErrorEagerMigrationsCount(): Int?

getMigrateIdleConnections

fun getMigrateIdleConnections(): Boolean?

getRetryPreHandshakeErrorsOnAlternateNetwork

fun getRetryPreHandshakeErrorsOnAlternateNetwork(): Boolean?