ConnectionMigrationOptions

public class ConnectionMigrationOptions extends Object

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.

See Also

• Connection Migration specification

Nested Class Summary

class	ConnectionMigrationOptions.Builder		Builder for ConnectionMigrationOptions.
@interface	ConnectionMigrationOptions.Experimental

Public Constructor Summary

ConnectionMigrationOptions(ConnectionMigrationOptions.Builder builder)

Public Method Summary

static ConnectionMigrationOptions.Builder	builder()
Boolean	getAllowNonDefaultNetworkUsage()
Boolean	getAllowServerMigration()
Boolean	getEnableDefaultNetworkMigration()
Boolean	getEnablePathDegradationMigration()
Long	getIdleMigrationPeriodSeconds()
Integer	getMaxPathDegradingEagerMigrationsCount()
Long	getMaxTimeOnNonDefaultNetworkSeconds()
Integer	getMaxWriteErrorEagerMigrationsCount()
Boolean	getMigrateIdleConnections()
Boolean	getRetryPreHandshakeErrorsOnAlternateNetwork()

Inherited Method Summary

From class java.lang.Object

Object	clone()
boolean	equals(Object arg0)
void	finalize()
final Class<?>	getClass()
int	hashCode()
final void	notify()
final void	notifyAll()
String	toString()
final void	wait(long arg0, int arg1)
final void	wait(long arg0)
final void	wait()

Public Constructors

public ConnectionMigrationOptions (ConnectionMigrationOptions.Builder builder)

Parameters

builder

Public Methods

public static ConnectionMigrationOptions.Builder builder ()

public Boolean getAllowNonDefaultNetworkUsage ()

public Boolean getAllowServerMigration ()

public Boolean getEnableDefaultNetworkMigration ()

public Boolean getEnablePathDegradationMigration ()

public Long getIdleMigrationPeriodSeconds ()

public Integer getMaxPathDegradingEagerMigrationsCount ()

public Long getMaxTimeOnNonDefaultNetworkSeconds ()

public Integer getMaxWriteErrorEagerMigrationsCount ()

public Boolean getMigrateIdleConnections ()

public Boolean getRetryPreHandshakeErrorsOnAlternateNetwork ()