ConnectionMigrationOptions.Builder

@ConnectionMigrationOptions.Experimental
public ConnectionMigrationOptions.Builder allowNonDefaultNetworkUsage(boolean enable)

Imposta se le connessioni possono essere migrate a una rete alternativa quando Cronet rileva un degrado del percorso attualmente in uso.

Nota: questa impostazione può comportare l'invio di richieste su reti a consumo non predefinite. Assicurati di utilizzare le reti a consumo con parsimonia e di ottimizzare parametri come setMaxPathDegradingNonDefaultNetworkMigrationsCount e setMaxTimeOnNonDefaultNetworkSeconds per limitare il tempo sulle reti non predefinite.

@ConnectionMigrationOptions.Experimental
public ConnectionMigrationOptions.Builder allowServerMigration(boolean allowServerMigration)

Consente la possibilità di migrare le connessioni a un indirizzo server alternativo su richiesta del server.

public ConnectionMigrationOptions build()

Crea e restituisce l'istanza ConnectionMigrationOptions finale, in base ai valori di questo builder.

public ConnectionMigrationOptions.Builder enableDefaultNetworkMigration(
    boolean enableDefaultNetworkConnectionMigration
)

Consente la possibilità di migrare le connessioni in caso di modifica della rete predefinita. Se abilitata, le connessioni QUIC attive verranno migrate alla nuova rete quando la piattaforma indica che la rete predefinita sta cambiando.

public ConnectionMigrationOptions.Builder enablePathDegradationMigration(boolean enable)

Consente la possibilità di migrare le connessioni se il percorso attuale ha prestazioni scadenti.

A seconda di altre configurazioni, questa operazione può comportare la migrazione delle connessioni all'interno della stessa rete predefinita o a una rete non predefinita.

@ConnectionMigrationOptions.Experimental
public ConnectionMigrationOptions.Builder migrateIdleConnections(boolean migrateIdleConnections)

Configura se la migrazione delle connessioni inattive deve essere abilitata o meno.

Se impostato su true, verranno migrate anche le connessioni inattive, a condizione che non siano inattive da troppo tempo. L'impostazione è condivisa per tutti i tipi di migrazione delle connessioni. Il periodo di inattività massimo per il quale le connessioni verranno comunque migrate può essere personalizzato utilizzando setIdleConnectionMigrationPeriodSeconds.

@ConnectionMigrationOptions.Experimental
public ConnectionMigrationOptions.Builder retryPreHandshakeErrorsOnNonDefaultNetwork(
    boolean retryPreHandshakeErrorsOnAlternateNetwork
)

Imposta se le connessioni con errori di pre-handshake devono essere riprovate su una rete alternativa.

Se è true, è possibile stabilire una nuova connessione a una rete alternativa se non riesce sulla rete predefinita prima che venga confermato l'handshake.

Nota: analogamente a allowNonDefaultNetworkUsage, questa impostazione può comportare l'invio di richieste su reti a consumo non predefinite. Utilizza con cautela.

@ConnectionMigrationOptions.Experimental
public ConnectionMigrationOptions.Builder setIdleConnectionMigrationPeriodSeconds(
    long idleConnectionMigrationPeriodSeconds
)

Imposta il periodo di inattività massimo in secondi per il quale le connessioni verranno comunque migrate. L'impostazione è condivisa per tutti i tipi di migrazione delle connessioni.

È pertinente solo se migrateIdleConnections è abilitato.

@ConnectionMigrationOptions.Experimental
public ConnectionMigrationOptions.Builder setMaxPathDegradingNonDefaultNetworkMigrationsCount(
    int maxPathDegradingEagerMigrationsCount
)

Imposta il numero massimo di migrazioni alla rete non predefinita in caso di degrado del percorso per la connessione esistente. Conteggio cumulativo per rete per connessione.

È pertinente solo se allowNonDefaultNetworkUsage è abilitato.

@ConnectionMigrationOptions.Experimental
public ConnectionMigrationOptions.Builder setMaxTimeOnNonDefaultNetworkSeconds(
    long maxTimeOnNonDefaultNetworkSeconds
)

Imposta il periodo massimo per il quale le connessioni migrate in modo eager devono rimanere sulla rete non predefinita prima di essere migrate di nuovo. Questo tempo non è cumulativo: ogni migrazione dalla rete predefinita per ogni connessione viene misurata e confrontata separatamente con questo valore.

È pertinente solo se allowNonDefaultNetworkUsage è abilitato.

@ConnectionMigrationOptions.Experimental
public ConnectionMigrationOptions.Builder setMaxWriteErrorNonDefaultNetworkMigrationsCount(
    int maxWriteErrorEagerMigrationsCount
)

Imposta il numero massimo di migrazioni alla rete non predefinita in caso di errori di scrittura. Conteggio cumulativo per rete per connessione.

È pertinente solo se allowNonDefaultNetworkUsage è abilitato.